JavaScript比较参数该看哪份官方文档

一、常见混淆辨析：MDN 与 ECMA-262 究竟谁是“官方文档”？

在技术交流与日常开发中，常能听到两种截然不同但各自看似合理的说法：一种观点认为“MDN 是 Mozilla 的网站，不是真正具有法律效力的官方规范，查参数必须以 ECMA 规范为准”；另一种观点则认为“MDN 就是 JavaScript 的官方中文文档，日常所有问题都只要看 MDN”。这两种说法都包含了合理的前提，但也都有需要明确修正的边界。

认为“MDN 足够权威”的合理性在于，MDN Web Docs 早已不再是 Mozilla 单一公司的项目，而是由 Mozilla、Google、Microsoft、W3C 以及众多贡献者通过 Open Web Docs 组织共同维护的开放文档标准。它不仅详细列举了每一个内置函数所接收的参数、类型、默认值，还附带了极其详尽的浏览器兼容性数据（Browser Compatibility Data）和实用代码用例。在 95% 以上的应用开发场景下，MDN 提供了最高效、最符合工程实际的参考。

然而，MDN 的定位是开发者参考（Developer Reference），而非规范标准（Normative Specification）。当代码遇到微小却致命的参数边界行为时，MDN 往往只会给出一句简短的结论（例如“使用同值零比较”），而不会展开伪代码算法的所有分支。此时，唯一具备最终法律效力和技术仲裁权的，是由 Ecma 国际 TC39 委员会制定的 ECMA-262 规范。浏览器引擎（如 Chrome 的 V8、Safari 的 JavaScriptCore）必须严格遵循 ECMA-262 中的算法步骤实现参数处理；任何与 ECMA-262 步骤不一致的表现都会被登记为引擎 Bug。

二、查阅决策流程：四步选定目标官方文档

当我们在编写或调试代码时对“参数如何被处理”或“两个参数为何判定不相等”产生疑问，无需盲目翻阅成百上千页的技术规范。按照以下步骤，可以在两分钟内锁定正确的权威文档来源。

三、文档体系与分工关系

为了精准阅读文档，理解 JavaScript 生态中的文档分层至关重要。国际规范制定、文档工程化提炼与引擎底层执行构成了紧密的协同链条。

如上图所示，规范层（ECMA-262 与 WHATWG）负责制定严密的数学化伪代码逻辑，规定函数对传入参数从类型校验（Type Check）、抽象操作转换（如 ToNumber、ToPrimitive）到比对算法（Equality Algorithm）的完整流水线。

开发者参考层（MDN）通过通俗的技术语言对上述规范进行解读，向工程师呈现易于消化的参数表格与应用范式。运行时引擎（V8、JSC、SpiderMonkey）则作为执行者，对规范做出原生实现。

四、核心原理辨析：内置方法背后的四大比较算法

许多开发者在查看方法参数文档时，最大的困惑往往不是“参数叫什么名字”，而是“该方法到底用什么规则来比较传入的参数”。例如，为什么 indexOf 找不到数组中的 NaN，而 includes 却可以？

这个差异直接来源于 ECMA-262 规范第 7.2 节中定义的四大核心相等性算法。各内置方法在规范中明确绑定了不同的比对算法：

1. 典型参数对比代码示例

通过以下直观的代码片段，我们可以验证不同内置方法对传入参数的比较差异：

// 示例 1：Array.prototype.indexOf 与 includes 的参数比较差异
const arr = [1, NaN, -0];

// indexOf 采用 IsStrictlyEqual (===)
// NaN === NaN 为 false，因此返回 -1
console.log(arr.indexOf(NaN)); // 输出: -1

// includes 采用 SameValueZero
// SameValueZero(NaN, NaN) 为 true，因此成功识别
console.log(arr.includes(NaN)); // 输出: true

// 两者对正负零均视作相等
console.log(arr.includes(+0)); // 输出: true

// 示例 2：Object.is 的完全同值比较 (SameValue)
console.log(Object.is(+0, -0)); // 输出: false (精准区分符号位)
console.log(+0 === -0);          // 输出: true
console.log(Object.is(NaN, NaN)); // 输出: true

// 示例 3：Map 与 Set 内部键值比对采用 SameValueZero
const set = new Set();
set.add(-0);
console.log(set.has(+0)); // 输出: true (不会重复添加 +0)
set.add(NaN);
console.log(set.has(NaN)); // 输出: true (NaN 能够正常去重)

当你在 MDN 上查阅 Array.prototype.includes 时，MDN 在参数与算法说明中会写道：“includes() 使用零值相等（SameValueZero）算法确定是否能找到元素”。如果你想进一步知道什么是 SameValueZero，MDN 会提供链接直接导向其专属导引页《Equality comparisons and sameness》或 ECMA-262 规范的 §7.2.13 节。这就是两个官方文档协同工作的标准方式。

五、实操演示：如何从 MDN 顺藤摸瓜检索 ECMA-262 规范

阅读 ECMA-262 并不需要从头阅读整本数千页的规范，而是通过“锚点跳转法”进行准确定位：

1. 打开 MDN 对应文档页：在浏览器输入 mdn Array.prototype.includes，进入正文。
2. 阅读 Parameters（参数）列表：MDN 会将传入参数逐一列出。例如 searchElement（需要查找的元素）和可选的 fromIndex（开始搜索的索引）。
3. 滚至页面下方的 Specifications（规范）区域：每一个成熟的 MDN 方法页面底部都有一张规范对照表，明确标有 ECMAScript Language Specification 以及对应的锚点链接（例如 #sec-array.prototype.includes）。
4. 点击直达 TC39 官方规范页面：点击后直接跳转至 https://tc39.es/ecma262/ 的对应算法小节。
5. 阅读算法步骤中的传参调用：在规范的步骤列表中，你会清晰看到如下伪代码：
   Let same be SameValueZero(searchElement, elementK).
If same is true, return true.
   任何文字描述都无法比这行伪代码更明确地回答参数是按什么规则比对的。

六、宿主环境的特殊性：Web API 与 WebIDL 参数

还有一类常见的参数比对与传递问题发生在浏览器 Web API 中，例如 fetch() 的配置参数、addEventListener 的事件监听选项等。这部分内容完全不在 ECMA-262 中定义。

Web API 由 WHATWG（Web Hypertext Application Technology Working Group）与 W3C 负责制定规范。浏览器在将 JavaScript 参数传递给宿主 C++ 核心时，使用的是 WebIDL（Web 接口定义语言） 规范。

七、总结速查清单

结合日常开发与深度调试需求，我们将不同场景下推荐查阅的官方文档整理为速查清单：

掌握这种“日常以 MDN 为纲、边界以 ECMA-262 为本、宿主看 WHATWG”的查阅习惯，不仅能快速解决日常开发中的传参疑惑，更能在排查棘手边界问题时做到心中有数、有据可依。