no-throw-literal

禁止将字面量作为异常抛出

建议只throwError对象本身或使用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 中引入。

资源

编辑此页面