no-throw-literal

禁止抛出字面量作为异常

通常认为，只throw Error对象本身或使用Error对象作为基对象的自定义异常对象是最佳实践。Error对象的根本好处是它们会自动跟踪其构建和来源。

此规则限制了可以作为异常抛出的内容。在最初创建时，它只阻止抛出字面量（因此得名），但现在已扩展到仅允许可能为Error对象的表达式。

规则详情

此规则旨在通过禁止抛出字面量和其他不可能是Error对象的表达式来维护抛出异常时的前后一致性。

此规则的错误代码示例

/*eslint no-throw-literal: "error"*/

throw "error";

throw 0;

throw undefined;

throw null;

var err = new Error();
throw "an " + err;
// err is recast to a string literal

var err = new Error();
throw `${err}`

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

此规则的正确代码示例

在游乐场中打开

/*eslint no-throw-literal: "error"*/

throw new Error();

throw new Error("error");

var e = new Error("error");
throw e;

try {
    throw new Error("error");
} catch (e) {
    throw e;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

已知限制

由于静态分析的限制，此规则无法保证您只会抛出Error对象。

此规则的正确代码示例，但不抛出Error对象

在游乐场中打开

/*eslint no-throw-literal: "error"*/

var err = "error";
throw err;

function foo(bar) {
    console.log(bar);
}
throw foo("error");

throw new String("error");

var baz = {
    bar: "error"
};
throw baz.bar;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

版本

此规则在 ESLint v0.15.0 中引入。

资源

编辑此页面