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 中引入的。

资源

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