SyntaxError

SyntaxError 对象代表尝试解析语法上不合法的代码的错误。

描述

当Javascript语言解析代码时,Javascript引擎发现了不符合语法规范的tokens或token顺序时抛出SyntaxError.

语法

new SyntaxError([message[, fileName[, lineNumber]]])

参数

message
可选的. 可阅读的错误描述信息
fileName
可选的. 包含引发异常的代码的文件名
lineNumber
可选的. 包含引发异常的代码的行号

属性

SyntaxError.prototype
允许SyntaxError对象添加属性.

方法

全局 SyntaxError 自身不包含任何方法, 但从原型链中继承了一些方法.

SyntaxError 实例

属性

SyntaxError.prototype.constructor
创建实例的构造函数.
SyntaxError.prototype.message
错误信息. 尽管 ECMA-262 指出, SyntaxError 应该提供其子什么的信息属性,但在 SpiderMonkey 中, 仍是继承自Error.prototype.message.
SyntaxError.prototype.name
错误的名称.继承自 Error.
SyntaxError.prototype.fileName
抛出该异常的文件路径.继承自 Error.
SyntaxError.prototype.lineNumber
抛出该异常的文件的行号. 继承自 Error.
SyntaxError.prototype.columnNumber
抛出该异常的文件的列数. 继承自 Error.
SyntaxError.prototype.stack
栈追踪信息. 继承自 Error.

方法

示例

捕获 SyntaxError

try {
  eval('hoo bar');
} catch (e) {
  console.log(e instanceof SyntaxError); // true
  console.log(e.message);                // "missing ; before statement"
  console.log(e.name);                   // "SyntaxError"
  console.log(e.fileName);               // "Scratchpad/1"
  console.log(e.lineNumber);             // 1
  console.log(e.columnNumber);           // 4
  console.log(e.stack);                  // "@Scratchpad/1:2:3\n"
}

创建 SyntaxError

try {
  throw new SyntaxError('Hello', 'someFile.js', 10);
} catch (e) {
  console.log(e instanceof SyntaxError); // true
  console.log(e.message);                // "Hello"
  console.log(e.name);                   // "SyntaxError"
  console.log(e.fileName);               // "someFile.js"
  console.log(e.lineNumber);             // 10
  console.log(e.columnNumber);           // 0
  console.log(e.stack);                  // "@Scratchpad/2:11:9\n"
}

规范

Specification Status Comment
ECMAScript 3rd Edition (ECMA-262) Standard Initial definition.
ECMAScript 5.1 (ECMA-262)
SyntaxError
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
SyntaxError
Standard  

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

相关链接

文档标签和贡献者