2024-08-09 12:04:48 +00:00
|
|
|
/**
|
|
|
|
* @fileoverview Rule to enforce the use of `u` flag on RegExp.
|
|
|
|
* @author Toru Nagashima
|
|
|
|
*/
|
|
|
|
|
|
|
|
"use strict";
|
|
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
// Requirements
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
const {
|
|
|
|
CALL,
|
|
|
|
CONSTRUCT,
|
|
|
|
ReferenceTracker,
|
|
|
|
getStringIfConstant
|
2024-08-21 06:34:30 +00:00
|
|
|
} = require("@eslint-community/eslint-utils");
|
|
|
|
const astUtils = require("./utils/ast-utils.js");
|
|
|
|
const { isValidWithUnicodeFlag } = require("./utils/regular-expressions");
|
2024-08-09 12:04:48 +00:00
|
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
// Rule Definition
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
/** @type {import('../shared/types').Rule} */
|
2024-08-09 12:04:48 +00:00
|
|
|
module.exports = {
|
|
|
|
meta: {
|
|
|
|
type: "suggestion",
|
|
|
|
|
|
|
|
docs: {
|
2024-08-21 06:34:30 +00:00
|
|
|
description: "Enforce the use of `u` or `v` flag on RegExp",
|
2024-08-09 12:04:48 +00:00
|
|
|
recommended: false,
|
2024-08-21 06:34:30 +00:00
|
|
|
url: "https://eslint.org/docs/latest/rules/require-unicode-regexp"
|
2024-08-09 12:04:48 +00:00
|
|
|
},
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
hasSuggestions: true,
|
|
|
|
|
2024-08-09 12:04:48 +00:00
|
|
|
messages: {
|
2024-08-21 06:34:30 +00:00
|
|
|
addUFlag: "Add the 'u' flag.",
|
2024-08-09 12:04:48 +00:00
|
|
|
requireUFlag: "Use the 'u' flag."
|
|
|
|
},
|
|
|
|
|
|
|
|
schema: []
|
|
|
|
},
|
|
|
|
|
|
|
|
create(context) {
|
2024-08-21 06:34:30 +00:00
|
|
|
|
|
|
|
const sourceCode = context.sourceCode;
|
|
|
|
|
2024-08-09 12:04:48 +00:00
|
|
|
return {
|
|
|
|
"Literal[regex]"(node) {
|
|
|
|
const flags = node.regex.flags || "";
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
if (!flags.includes("u") && !flags.includes("v")) {
|
|
|
|
context.report({
|
|
|
|
messageId: "requireUFlag",
|
|
|
|
node,
|
|
|
|
suggest: isValidWithUnicodeFlag(context.languageOptions.ecmaVersion, node.regex.pattern)
|
|
|
|
? [
|
|
|
|
{
|
|
|
|
fix(fixer) {
|
|
|
|
return fixer.insertTextAfter(node, "u");
|
|
|
|
},
|
|
|
|
messageId: "addUFlag"
|
|
|
|
}
|
|
|
|
]
|
|
|
|
: null
|
|
|
|
});
|
2024-08-09 12:04:48 +00:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
Program(node) {
|
|
|
|
const scope = sourceCode.getScope(node);
|
2024-08-09 12:04:48 +00:00
|
|
|
const tracker = new ReferenceTracker(scope);
|
|
|
|
const trackMap = {
|
|
|
|
RegExp: { [CALL]: true, [CONSTRUCT]: true }
|
|
|
|
};
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
for (const { node: refNode } of tracker.iterateGlobalReferences(trackMap)) {
|
|
|
|
const [patternNode, flagsNode] = refNode.arguments;
|
|
|
|
|
|
|
|
if (patternNode && patternNode.type === "SpreadElement") {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
const pattern = getStringIfConstant(patternNode, scope);
|
2024-08-09 12:04:48 +00:00
|
|
|
const flags = getStringIfConstant(flagsNode, scope);
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
if (!flagsNode || (typeof flags === "string" && !flags.includes("u") && !flags.includes("v"))) {
|
|
|
|
context.report({
|
|
|
|
messageId: "requireUFlag",
|
|
|
|
node: refNode,
|
|
|
|
suggest: typeof pattern === "string" && isValidWithUnicodeFlag(context.languageOptions.ecmaVersion, pattern)
|
|
|
|
? [
|
|
|
|
{
|
|
|
|
fix(fixer) {
|
|
|
|
if (flagsNode) {
|
|
|
|
if ((flagsNode.type === "Literal" && typeof flagsNode.value === "string") || flagsNode.type === "TemplateLiteral") {
|
|
|
|
const flagsNodeText = sourceCode.getText(flagsNode);
|
|
|
|
|
|
|
|
return fixer.replaceText(flagsNode, [
|
|
|
|
flagsNodeText.slice(0, flagsNodeText.length - 1),
|
|
|
|
flagsNodeText.slice(flagsNodeText.length - 1)
|
|
|
|
].join("u"));
|
|
|
|
}
|
|
|
|
|
|
|
|
// We intentionally don't suggest concatenating + "u" to non-literals
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
|
|
|
|
const penultimateToken = sourceCode.getLastToken(refNode, { skip: 1 }); // skip closing parenthesis
|
|
|
|
|
|
|
|
return fixer.insertTextAfter(
|
|
|
|
penultimateToken,
|
|
|
|
astUtils.isCommaToken(penultimateToken)
|
|
|
|
? ' "u",'
|
|
|
|
: ', "u"'
|
|
|
|
);
|
|
|
|
},
|
|
|
|
messageId: "addUFlag"
|
|
|
|
}
|
|
|
|
]
|
|
|
|
: null
|
|
|
|
});
|
2024-08-09 12:04:48 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
}
|
|
|
|
};
|