Versions

require-unicode-regexp

Enforce the use of u flag on RegExp

正则 u 标志有两个作用。

  1. 使正则表达式正确处理 UTF-16 代用对

    特别是,字符范围语法得到正确的行为。

    /^[👍]$/.test("👍") //→ false
    /^[👍]$/u.test("👍") //→ true
    
  2. 使正则表达式尽早抛出语法错误,因为禁用附件 B 扩展

    由于历史原因,JavaScript 正则表达式对语法错误是宽容的。例如,/\w{1, 2/ 是一个语法错误,但是 JavaScript 并没有抛出这个错误。它匹配的是诸如 "a{1, 2" 这样的字符串。这样的恢复逻辑在附件 B 中进行了定义。

    u 标志禁用了附件 B 定义的恢复逻辑。因此,你可以提前发现错误。这类似于严格模式

因此,u 标志可以让我们更好地使用正则表达式工作。

规则细节

这条规则的目的是在正则表达式上强制使用 u 标志。

使用此规则的错误示例:

/*eslint require-unicode-regexp: error */

const a = /aaa/
const b = /bbb/gi
const c = new RegExp("ccc")
const d = new RegExp("ddd", "gi")

使用此规则的正确示例:

/*eslint require-unicode-regexp: error */

const a = /aaa/u
const b = /bbb/giu
const c = new RegExp("ccc", "u")
const d = new RegExp("ddd", "giu")

// This rule ignores RegExp calls if the flags could not be evaluated to a static value.
function f(flags) {
    return new RegExp("eee", flags)
}

何时不用

如果你不想通知没有 u 标志的正则表达式,你可以安全地禁用此规则。

Version

This rule was introduced in ESLint v5.3.0.

Resources