eqeqeq

要求使用=== 和 !==

建议使用类型安全的相等运算符=== 和 !==，而不是它们的常规对应运算符== 和 !=。

这样做的原因是== 和 != 会进行类型强制，这遵循相当模糊的抽象相等比较算法。例如，以下语句都被认为是true

• [] == false
• [] == ![]
• 3 == "03"

如果其中一个出现在a == b 这样的看似无害的语句中，则实际问题非常难以发现。

规则详情

此规则旨在消除类型不安全的相等运算符。

此规则的错误代码示例

/*eslint eqeqeq: "error"*/

if (x == 42) { }

if ("" == text) { }

if (obj.getStuff() != undefined) { }
1
2
3
4
5
6
7

命令行上的--fix 选项会自动修复此规则报告的一些问题。只有当其中一个操作数是typeof 表达式，或者两个操作数都是相同类型的字面量时，问题才会被修复。

选项

always

"always" 选项（默认）在每种情况下（除非您选择加入对null 的更具体处理[见下文]）强制使用=== 和 !==。

"always" 选项的错误代码示例

/*eslint eqeqeq: ["error", "always"]*/

a == b
foo == true
bananas != 1
value == undefined
typeof foo == 'undefined'
'hello' != 'world'
0 == 0
true == true
foo == null

1
2
3
4
5
6
7
8
9
10
11
12

"always" 选项的正确代码示例

/*eslint eqeqeq: ["error", "always"]*/

a === b
foo === true
bananas !== 1
value === undefined
typeof foo === 'undefined'
'hello' !== 'world'
0 === 0
true === true
foo === null

1
2
3
4
5
6
7
8
9
10
11
12

此规则可以选择接受第二个参数，该参数应为包含以下支持属性的对象

• "null"：自定义此规则如何处理null 字面量。可能的取值
  • always（默认） - 始终使用 === 或 !==。
  • never - 从不将 === 或 !== 用于null。
  • ignore - 不要将此规则应用于null。

smart

"smart" 选项强制使用=== 和 !==，除了以下情况

• 比较两个字面量值
• 评估typeof 的值
• 与null 进行比较

"smart" 选项的错误代码示例

/*eslint eqeqeq: ["error", "smart"]*/

// comparing two variables requires ===
a == b

// only one side is a literal
foo == true
bananas != 1

// comparing to undefined requires ===
value == undefined
1
2
3
4
5
6
7
8
9
10
11

"smart" 选项的正确代码示例

/*eslint eqeqeq: ["error", "smart"]*/

typeof foo == 'undefined'
'hello' != 'world'
0 == 0
true == true
foo == null
1
2
3
4
5
6
7

allow-null

已弃用：不要使用此选项，而是使用"always" 并传递一个值为"ignore" 的"null" 选项属性。这将告诉 ESLint 始终强制执行严格相等，除非与null 字面量进行比较。

["error", "always", {"null": "ignore"}]
1

何时不使用它

如果您不想强制使用相等运算符的样式，则可以安全地禁用此规则。

版本

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

资源

• 规则源代码
• 测试源代码