no-misleading-character-class

禁止在字符类语法中使用由多个代码点组成的字符

Unicode 包括由多个代码点组成的字符。RegExp 字符类语法 (/[abc]/) 无法将由多个代码点组成的字符视为一个字符；这些字符将被分解为每个代码点。例如，❇️ 由 ❇ (U+2747) 和 VARIATION SELECTOR-16 (U+FE0F) 组成。如果此字符位于 RegExp 字符类中，它将匹配 ❇ (U+2747) 或 VARIATION SELECTOR-16 (U+FE0F)，而不是 ❇️。

此规则报告在字符类语法中包含多个代码点字符的正则表达式。此规则将以下字符视为多个代码点字符。

带有组合字符的字符

组合字符是属于 Mc、Me 和 Mn 之一的字符 Unicode 通用类别。

/^[Á]$/u.test("Á"); //→ false
/^[❇️]$/u.test("❇️"); //→ false
1
2

带有 Emoji 修饰符的字符

/^[👶🏻]$/u.test("👶🏻"); //→ false
/^[👶🏽]$/u.test("👶🏽"); //→ false
1
2

一对区域指示符符号

/^[🇯🇵]$/u.test("🇯🇵"); //→ false
1

ZWJ 连接的字符

/^[👨‍👩‍👦]$/u.test("👨‍👩‍👦"); //→ false
1

没有 Unicode 标志的代理对

/^[👍]$/.test("👍"); //→ false

// Surrogate pair is OK if with u flag.
/^[👍]$/u.test("👍"); //→ true
1
2
3
4

规则详情

此规则报告在字符类语法中包含多个代码点字符的正则表达式。

此规则的 错误 代码示例

/*eslint no-misleading-character-class: error */

/^[Á]$/u;
/^[❇️]$/u;
/^[👶🏻]$/u;
/^[🇯🇵]$/u;
/^[👨‍👩‍👦]$/u;
/^[👍]$/;
new RegExp("[🎵]");
1
2
3
4
5
6
7
8
9

此规则的 正确 代码示例

/*eslint no-misleading-character-class: error */

/^[abc]$/;
/^[👍]$/u;
/^[\q{👶🏻}]$/v;
new RegExp("^[]$");
new RegExp(`[Á-${z}]`, "u"); // variable pattern
1
2
3
4
5
6
7

选项

此规则有一个对象选项

• "allowEscape": 当设置为 true 时，只要使用转义序列编写，该规则允许字符类中代码点的任何分组。此选项仅对正则表达式字面量和使用带字面量参数作为模式的 RegExp 构造函数创建的正则表达式有效。

allowEscape

使用 { "allowEscape": true } 选项的此规则的 错误 代码示例

/* eslint no-misleading-character-class: ["error", { "allowEscape": true }] */

/[\👍]/; // backslash can be omitted

new RegExp("[\ud83d" + "\udc4d]");

const pattern = "[\ud83d\udc4d]";
new RegExp(pattern);
1
2
3
4
5
6
7
8

使用 { "allowEscape": true } 选项的此规则的 正确 代码示例

/* eslint no-misleading-character-class: ["error", { "allowEscape": true }] */

/[\ud83d\udc4d]/;
/[\u00B7\u0300-\u036F]/u;
/[👨\u200d👩]/u;
new RegExp("[\x41\u0301]");
new RegExp(`[\u{1F1EF}\u{1F1F5}]`, "u");
new RegExp("[\\u{1F1EF}\\u{1F1F5}]", "u");
1
2
3
4
5
6
7
8

何时不使用它

如果您不想检查 RegExp 字符类语法以获取多个代码点字符，可以关闭此规则。

版本

此规则是在 ESLint v5.3.0 中引入的。

资源

• 规则来源
• 测试来源