1 / 4概念
Syntax
判断一段 JavaScript 是否可靠,不看语法能不能写出来,而看是否清楚每个表达式的值:它属于哪种类型,为什么会变成另一种类型,与谁相等。本页建立值模型,后面几页都以它为前提。
1 概念
1.1 一句话定义
JavaScript 只有八种运行时类型。每个表达式先求值成这八种之一,再由转换算法和相等算法决定后续行为。类型标注不参与运行时,因此错误只可能在两处出现:你算错的值,或你误判的类型。
1.2 它解决什么问题
- 统一的值模型:任何数据都归入八种类型之一,没有第九种。
- 可推导的行为:转换与相等有明确算法,可以逐步算出结果,不靠经验。
- 可定位的误差:数值用二进制浮点,字符串用 UTF-16 码元,误差来源可算。
- 一致的文本处理:字符串 API 与正则共享同一套码元模型。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
函数、参数、闭包、this | Functions and Scope |
| 对象、属性描述符、原型链、class | Objects and Prototypes |
| 数组方法、Map/Set、迭代协议 | Collections and Iteration |
| Error 家族、ESM 与 CJS | Errors and Modules |
| Promise、事件循环、并发控制 | Async and Concurrency |
| 类型标注、收窄、泛型 | TS Type System |
Intl、Date、JSON 的完整 API | Standard Library |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 原始值 | 七种不可变值 | 访问属性时临时装箱,不等于对象 |
| 装箱 | 原始值临时转成包装对象 | 只在下标或属性访问时发生 |
| 隐式转换 | 运算符触发的 ToPrimitive/ToNumber/ToString | 与显式转换的结果不同 |
| 显式转换 | Number、String、Boolean | 各自有一套独立的解析规则 |
=== | 严格相等,不做转换 | 与 Object.is 在 ±0 与 NaN 上不同 |
== | 宽松相等,先转换再比较 | 转换链长,结果难推理 |
| falsy | 八个假值 | 其余全真,包括 '0' 与 [] |
| 自动分号插入 | ASI | 换行不等于分号,只在特定位置补 |
| 码元 | UTF-16 code unit | 一个 emoji 常占两个码元 |
| 字面量 | 源码中直接写出的值 | 与构造函数创建的结果不同 |
2 机制
2.1 心智模型
源码先切成词法单元,再组成表达式和语句。表达式求值得到一个值,值只有两类:原始值与对象。原始值按值比较,对象按引用比较。之后的一切行为由三步决定:转换、相等、运算。
2.2 机制拆解
- 表达式与语句:表达式产生值,语句不产生;表达式语句可以出现在语句位置,反向不行。
- 自动分号插入:只有当下一个词法单元无法继续当前语句时才补分号;
return、throw、break、continue、yield后换行会立即补,导致返回值被截断。 - ToPrimitive:依次尝试
Symbol.toPrimitive、valueOf、toString。提示参数决定顺序:+用default,模板字符串用string。 - 相等:
===先比类型再比值;==先按类型对做转换再比;Object.is区分+0与-0,且NaN等于自身。 - 数字:IEEE-754 双精度,53 位有效位;整数在 ±(2^53−1) 内安全。
- 字符串:UTF-16 码元序列,
length数的是码元,不是字符。 - 正则:模式加标志决定语义;
g与y带lastIndex状态。
2.3 完整枚举
八种运行时类型,这是完整集合:
| 类型 | typeof 结果 | 相等方式 | 常见陷阱 |
|---|---|---|---|
undefined | 'undefined' | 值比较 | 与 null 宽松相等 |
null | 'object' | 值比较 | typeof 误判;null == 0 为假 |
boolean | 'boolean' | 值比较 | 字符串 'false' 是真值 |
number | 'number' | 值比较,NaN 不自等 | 二进制浮点误差 |
bigint | 'bigint' | 值比较 | 不能与 number 混算 |
string | 'string' | 值比较 | 长度按码元;NFC 归一化 |
symbol | 'symbol' | 唯一 | 隐式转字符串抛错 |
object | 'object' 或 'function' | 引用比较 | 可变;typeof null 也是 'object' |
八个假值,这是完整集合,其余一切为真:
| 假值 | 备注 |
|---|---|
false | 布尔假 |
0 | 正零 |
-0 | 负零,String(-0) 得 '0' |
0n | 零 BigInt |
'' | 空字符串 |
null | 空值 |
undefined | 未定义 |
NaN | 非数,自己也不等于自己 |
四个容易误判为假、实际为真的值:'0'、'false'、[]、{}。
四套相等算法:
| 算法 | 例子 | 用途 |
|---|---|---|
=== | NaN === NaN 为假;0 === -0 为真 | 默认比较 |
== | null == undefined 真;'' == 0 真 | 只在判空时可用 |
Object.is | Object.is(NaN, NaN) 真;Object.is(0, -0) 假 | 区分 ±0 与 NaN |
| SameValueZero | Set、Map、includes 使用 | 集合成员判断 |
转换函数的行为差异:
| 写法 | '' | ' 12 ' | '12px' | null | [] |
|---|---|---|---|---|---|
Number(x) | 0 | 12 | NaN | 0 | 0 |
parseInt(x, 10) | NaN | 12 | 12 | NaN | NaN |
parseFloat(x) | NaN | 12 | 12 | NaN | NaN |
String(x) | '' | ' 12 ' | '12px' | 'null' | '' |
Number('') 返回 0,这是空值被当有效数字的最常见入口。
正则的八个标志,这是完整集合:
| 标志 | 含义 | 典型用途 |
|---|---|---|
d | 记录匹配下标 | 高亮片段 |
g | 全局,带 lastIndex | 批量替换 |
i | 忽略大小写 | 关键字匹配 |
m | 多行,^/$ 按行 | 逐行解析 |
s | . 匹配换行 | 跨行块 |
u | Unicode 码点模式 | emoji、属性转义 |
v | Unicode 集合运算 | 字符类交集与差集 |
y | 粘性,必须从 lastIndex 开始 | 词法扫描 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 安全整数 | ±9 007 199 254 740 991 | 即 2^53−1,超出后相邻整数不可区分 |
| 双精度有效位 | 53 位二进制,约 15–17 位十进制 | 金额不能用小数直接算 |
| 字符串长度 | UTF-16 码元数 | '😀'.length 为 2 |
| 正则最坏回溯 | 指数级 | 嵌套量词配长输入会卡死 |
| 数组长度上限 | 2^32−1 | 实际受内存限制 |
| BigInt 精度 | 任意 | 不能与 number 混算,不能 JSON.stringify |
3 实践
3.1 最小示例
把金额字符串解析成整数分。主题是值与转换:正则负责形状,Number 负责数值,Number.isSafeInteger 负责边界。
const AMOUNT = /^(?<sign>[+-])?(?<whole>\d{1,15})(?:\.(?<frac>\d{1,2}))?$/u;
function toCents(input: unknown): number {
if (typeof input !== 'string') throw new TypeError('amount shall be a string');
const match = AMOUNT.exec(input.trim());
if (!match) throw new RangeError(`invalid amount: ${String(input)}`);
const {sign, whole, frac = ''} = match.groups as {
sign?: string;
whole: string;
frac?: string;
};
const cents = Number(whole) * 100 + Number(frac.padEnd(2, '0'));
if (!Number.isSafeInteger(cents)) throw new RangeError('amount is out of safe range');
return sign === '-' ? -cents : cents;
}
toCents('12.3'); // 1230
toCents('-0.05'); // -5
toCents('1e3'); // RangeError: invalid amount
追踪 '12.3':正则给出 whole 为 '12'、frac 为 '3';'3'.padEnd(2, '0') 得 '30';12 * 100 + 30 得 1230;最终是安全整数,返回 1230。
追踪 '1e3':whole 匹配 '1' 后还剩 'e3',正则要求结尾,因此不匹配。Number('1e3') 会得到 1000,正则不会。这是显式解析与隐式转换的分界线。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 判断整数 | Number.isInteger(x) | 不转换,字符串返回假 |
| 判断安全整数 | Number.isSafeInteger(x) | 超过 2^53 返回假 |
| 判断 NaN | Number.isNaN(x) | 全局 isNaN 会先转换 |
| 判断有限 | Number.isFinite(x) | 排除 NaN、±Infinity |
| 判空 | x == null | 同时命中 null 与 undefined |
| 默认值 | x ?? fallback | 只对 null/undefined 生效 |
| 可选访问 | a?.b?.() | 短路,返回 undefined |
| 精确相等 | Object.is(a, b) | 区分 ±0,NaN 自等 |
| 解析整数 | Number.parseInt(s, 10) | 显式写基数 |
| 格式化 | new Intl.NumberFormat(locale) | 本地化,不手拼 |
3.3 标准流程
- 先确定这个值的外部形状:字符串、数字还是对象。
- 边界处用
unknown接住,再用正则或显式转换收窄。 - 数值转换后立刻校验
isSafeInteger或isFinite,不要延后。 - 比较统一用
===;需要区分±0或NaN时改用Object.is。 - 需要人读的输出走
Intl,需要机器读的输出走toString。 - 用单测钉住边界:空串、空格、
0、-0、超长数字、emoji。
3.4 与相邻技术的组合
- 函数与作用域:默认参数只在
undefined时生效,null不会触发。 - 对象与原型:属性名总是字符串或 symbol,数字下标会被转成字符串。
- 集合与迭代:
Set与Map用 SameValueZero,因此NaN可作成员。 - 错误与模块:类型转换失败应抛
TypeError或RangeError,不要返回哨兵值。 - TypeScript:类型标注不改变运行时,
as number不会把字符串变成数字。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 数值表示 | number / bigint / 字符串十进制 / 整数分 | 精度与互操作性 |
| 相等算法 | === / Object.is / SameValueZero | 边界值行为 |
| 文本单元 | 码元 / 码点 / 字素簇 | 长度与截断位置 |
| 匹配方式 | 正则 / 手写解析 / 结构化格式 | 可读性与性能 |
| 输出格式 | Intl / toFixed / 手拼 | 本地化正确性 |
3.6 决策规则
- 默认用
===;比较±0或NaN时用Object.is。 - 金额用整数最小单位;超过 2^53 用字符串或
bigint。 - 外部字符串先正则或显式转换,不用
+做隐式转换。 - 需要捕获组时用命名组;不要依赖
lastIndex管理状态。 - 面向人的数字与日期用
Intl;序列化用toString。 - 涉及用户输入的正则必须限制回溯,不做嵌套量词。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
number | 快,内建运算齐全 | 精度有限 | 一般计算 |
bigint | 任意精度 | 不能混算,无 Math | 大整数、金额 |
| 整数分 | 精确且快 | 需手动缩放 | 电商金额 |
| 十进制库 | 完整十进制语义 | 体积与依赖 | 金融计算 |
| 字符串十进制 | 传输无损 | 需自行解析 | 跨语言接口 |
| 正则解析 | 形状与数值一次校验 | 回溯风险 | 固定格式输入 |
Intl | 本地化正确 | 需传 locale | 展示层 |
3.8 何时不该用
- 一次性脚本里不要为精度引入十进制库。
- 不要用「正则解析 HTML、JSON、YAML」;这些格式有边界情况,正则只适合固定形状。
- 不要为了少写一个函数而用
eval或new Function。 - 不要用
new Number、new String、new Boolean创建包装对象。 - 不要在热路径里反复构造
Intl实例,缓存一份即可。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
0.1 + 0.2 !== 0.3 | 二进制浮点 | 整数分或十进制库 |
| 金额显示多出小数位 | 小数直接累加 | 全程用最小单位 |
| 空输入被当作 0 | Number('') 得 0 | 先判空再转换 |
parseInt('1,000') 得 1 | 前缀解析遇到逗号停 | 先清洗再用 Number |
['1','2','3'].map(parseInt) 得 [1, NaN, NaN] | map 把下标当基数传入 | 写 map(Number) |
'😀'.length 得 2 | UTF-16 码元 | Array.from 或 Intl.Segmenter |
| 同一正则第二次匹配位置错 | g 复用 lastIndex | matchAll 或新建实例 |
null >= 0 为真但 null == 0 为假 | 关系比较与相等用不同算法 | 只比对 === 并显式判空 |
| 大 ID 末尾变 0 | 超过 2^53 | 用字符串传输 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
满屏 == | 转换链难推理 | ===,判空用 x == null |
+x 隐式转数字 | 空串、空格静默通过 | Number() 加校验 |
parseInt 不写基数 | 旧引擎按 0 前缀转八进制 | 显式传 10 |
用 + 拼字符串又算数 | 类型来回翻转 | 分两步,先转再算 |
isNaN 全局版 | 先转换再判断 | Number.isNaN |
| 手写千分位与货币符号 | 本地化错误 | Intl.NumberFormat |
用 \d 匹配任意数字字符 | 只匹配 ASCII 且算码元 | u 标志加属性转义 |
4.3 可观测信号
单测断言里 Object.is 的失败数、NaN 出现在报表或缓存键的频次、金额与时长校验的拒绝率、正则匹配耗时尖峰、字符串长度分布异常。
4.4 安全 / 性能 / 一致性边界
- 正则拒绝服务:用户输入进入嵌套量词的表达式会指数回溯,必须限流或换解析器。
- 原型污染入口:
JSON.parse得到的__proto__键在合并时会改写原型,本页只需知道转换不是唯一入口。 - 序列化边界:
bigint不能JSON.stringify,会抛TypeError;undefined与函数在对象里被丢弃。 - 一致性边界:同一份数据在不同 locale 下格式化结果不同,缓存键要带 locale。