docs: 在 JS/TS 基础规范的魔法数字检查规则中补充数量类型数字无需抽离的说明

This commit is contained in:
Lyda
2026-04-29 10:12:10 +08:00
parent 8ac6f10679
commit f4d8dd91b4
+5 -13
View File
@@ -47,19 +47,11 @@ function getuserinfo() {
> - severity `warn` > - severity `warn`
- 检查数字、正则字面量,不检查其他(比如 布尔字面量、对象字面量、函数字面量、数组字面量、字符串字面量 - 检查**数字字面量**和**正则字面量**,不检查布尔、对象、函数、数组、字符串字面量
- 这块只检查含义不明确的字面量,比如 0 1 500 等,像是 'user' 'admin' 'active' 'inactive' 等是合理的 - 检查含义不明确的数字,如 `0``1``2` 等;
- 无需检查单词是否完整拼写 - `throw` / `new Error` 的错误信息无需审查
- throw 的错误信息无需审查 - `console.*``log` / `error` / `warn` / `info` / `debug` / `trace`)的内容无需审查
- new Error 的错误信息无需审查 - 语义自明的数量类数字无需抽取常量,例如:时间戳、毫秒时长、元素数量、尺寸等一眼可理解的值
- console.log 的打印代码无需审查
- console.error 的错误信息无需审查
- console.warn 的错误信息无需审查
- console.info 的错误信息无需审查
- console.debug 的错误信息无需审查
- console.trace 的错误信息无需审查
- 无需考虑类型是否合理匹配
- 你需要自行的判断这个字面量的值开发是否可以理解,比如说参数的时间戳、毫秒时长、数量、长度、高度这些如果一看就是可以理解的数量数字也无需抽出常量
### Example: 魔法数字 ### Example: 魔法数字