二稿核验说明(2026-10-15):本文为“河洛序”教程二稿,已按官方规范与文档修订。旧实验日志单独标为“一稿留存输出”,不代表本次在Windows上的复跑;本次环境与结果见本批核验记录。示例中的“星河笔记”、账号、订单、价格与政策均为虚构教学数据。
一句话定义
JavaScript是由ECMAScript规范定义核心语义的动态语言,可运行于浏览器、Node.js等宿主。单个JavaScript执行代理通常按事件循环调度任务,但Worker可在其他线程执行;浏览器也能运行WebAssembly。
为什么重要
- 这些前端框架及许多网页交互使用JavaScript;AI 应用的聊天界面、流式渲染都要写 JS。
- Node.js 生态里有大量 AI SDK 与 Agent 框架(Vercel AI SDK、LangChain.js 等)。
- 它的几个“反直觉”机制(事件循环、数字精度、类型转换)是线上 bug 的常见来源,下面一次跑清楚。
原理 / 图解
ECMAScript 语言规范:https://tc39.es/ecma262/;HTML 标准中的事件循环:https://html.spec.whatwg.org/multipage/webappapis.html#event-loops;MDN JavaScript 指南:https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide;Node.js 事件循环说明:https://nodejs.org/en/learn/asynchronous-work/event-loop-timers-and-nexttick
关键点:在单个执行代理内,通常一次只执行一个任务;Worker可另行执行;“异步”指等待期间不阻塞,而不是并行计算。长时间的同步计算会冻结页面和所有回调。
适用边界与核验要点
浏览器任务队列与Node事件循环不是完全相同的调度器。图示用于解释本例Promise和timer的顺序,不承诺所有I/O、nextTick、setImmediate在所有上下文的先后。Promise.all并发不等于CPU并行,也不自动限流或在一个请求失败后取消其他请求。Number之外还有BigInt;JSON.parse已损失的精度不能靠之后BigInt(number)恢复,本例正则只用于固定格式教学,通用接口宜把大整数ID传成字符串。
本次检索核对的主要依据(2026-10-15):
可运行示例
Node执行事件循环、闭包、数字精度与异步等待实验。标注的Node20及计时来自一稿日志;不同宿主和执行上下文的任务顺序需要分别验证。
// 文件:examples/web/17_javascript.mjs
// JavaScript 核心机制实验:事件循环、闭包、数字精度、大整数 JSON、类型转换、并发 await。
console.log("Node", process.version);
console.log("① 事件循环:同步代码 → 微任务(Promise) → 宏任务(setTimeout)");
const order = [];
setTimeout(() => order.push("setTimeout 0"), 0);
Promise.resolve().then(() => order.push("Promise.then"));
queueMicrotask(() => order.push("queueMicrotask"));
order.push("同步代码");
await new Promise(r => setTimeout(r, 10));
console.log(" 执行顺序:", order.join(" → "));
console.log("② 闭包与 var/let");
const fv = [], fl = [];
for (var i = 0; i < 3; i++) fv.push(() => i);
for (let j = 0; j < 3; j++) fl.push(() => j);
console.log(" var:", fv.map(f => f()), " let:", fl.map(f => f()));
console.log("③ number 类型都是 IEEE 754 双精度浮点(整数也是)");
console.log(" 0.1 + 0.2 =", 0.1 + 0.2, "| === 0.3 ?", 0.1 + 0.2 === 0.3);
console.log(" Number.MAX_SAFE_INTEGER =", Number.MAX_SAFE_INTEGER);
const raw = '{"id": 1849302847561928374, "tokens": 12}';
console.log(" JSON.parse 大整数 id:", JSON.parse(raw).id, "← 末几位已经变了");
console.log(" 用 BigInt 手工解析:", BigInt(raw.match(/"id": (\d+)/)[1]).toString());
console.log("④ 宽松相等 == 的类型转换");
for (const [a, b] of [["0", 0], ["", 0], [null, undefined], [[], false], ["1", true]])
console.log(` ${JSON.stringify(a)} == ${JSON.stringify(b)} → ${a == b} ===: ${a === b}`);
console.log("⑤ async/await:串行 vs 并发(模拟 3 次 200ms 的 API 调用)");
const call = (n) => new Promise(r => setTimeout(() => r(n), 200));
let t = performance.now(); for (const n of [1, 2, 3]) await call(n);
console.log(` for...await 串行: ${(performance.now() - t).toFixed(0)} ms`);
t = performance.now(); await Promise.all([1, 2, 3].map(call));
console.log(` Promise.all 并发: ${(performance.now() - t).toFixed(0)} ms`);
console.log("⑥ 一个耗时 300ms 的同步循环会挡住所有定时器");
t = performance.now(); let fired;
setTimeout(() => { fired = performance.now() - t; }, 10);
const end = performance.now() + 300; while (performance.now() < end) {}
await new Promise(r => setTimeout(r, 20));
console.log(` 预定 10ms 后执行的定时器,实际在 ${fired.toFixed(0)} ms 后才执行`);
一稿留存输出
以下日志按一稿保留,来自一稿声称的原环境;不是本次复跑结果。二稿代码改动后可产生不同输出,实际复跑状态以本批核验记录为准。
Node v20.19.2
① 事件循环:同步代码 → 微任务(Promise) → 宏任务(setTimeout)
执行顺序: 同步代码 → Promise.then → queueMicrotask → setTimeout 0
② 闭包与 var/let
var: [ 3, 3, 3 ] let: [ 0, 1, 2 ]
③ number 类型都是 IEEE 754 双精度浮点(整数也是)
0.1 + 0.2 = 0.30000000000000004 | === 0.3 ? false
Number.MAX_SAFE_INTEGER = 9007199254740991
JSON.parse 大整数 id: 1849302847561928400 ← 末几位已经变了
用 BigInt 手工解析: 1849302847561928374
④ 宽松相等 == 的类型转换
"0" == 0 → true ===: false
"" == 0 → true ===: false
null == undefined → true ===: false
[] == false → true ===: false
"1" == true → true ===: false
⑤ async/await:串行 vs 并发(模拟 3 次 200ms 的 API 调用)
for...await 串行: 602 ms
Promise.all 并发: 203 ms
⑥ 一个耗时 300ms 的同步循环会挡住所有定时器
预定 10ms 后执行的定时器,实际在 301 ms 后才执行
- ① 顺序是“同步代码 → Promise.then → queueMicrotask → setTimeout 0”:即使延时为 0,宏任务也要等所有微任务执行完。
Promise.then和queueMicrotask进入同一个微任务队列,按注册先后执行。 - ②
var是函数作用域,三个闭包共享同一个i,循环结束时为 3;let每轮迭代创建新绑定,得到 0、1、2。新代码通常优先采用let/const,同时理解现有var代码的作用域。 - ③
0.1 + 0.2得0.30000000000000004。更危险的是大整数:超过Number.MAX_SAFE_INTEGER(9007199254740991,即 2^53−1)的 id 经JSON.parse后从1849302847561928374变成了1849302847561928400——数据库主键、雪花 id 在前端被悄悄改掉。对策:服务端把大整数 id 序列化为字符串,或用 BigInt 解析MDNNumber.MAX_SAFE_INTEGER:https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER。 - ④
==会做类型转换,[] == false、"" == 0都为true;===全部为false。 - ⑤ 三次 200ms 的调用,
for...await串行 603ms,Promise.all并发 202ms——互相独立的请求可在限流、成本和取消策略允许的范围内并发发出。 - ⑥ 300ms 的同步循环让本该 10ms 后触发的定时器推迟到 302ms。浏览器里这意味着页面卡顿 300ms;在该Node执行代理上则会延迟需要其处理的请求和回调(与 k6.web.fastapi 中 async 里调用阻塞函数是同一个原理)。
自测
问题: 先JSON.parse得到近似数字,再BigInt(parsed.id),能恢复服务器原始64位ID吗?
参考答案: 不能。舍入已经发生。应让接口使用字符串,或使用保留原始数字文本的专用解析方案;不要把示例正则当通用JSON解析器。
常见误区
- “JavaScript 和 Java 有关系”:除了名字和部分语法外观,没有关系。
- “
async函数在后台线程运行”:不是;它运行在同一个线程,只在await处让出。CPU 密集任务应放 Web Worker / worker_threadshttps://nodejs.org/api/worker_threads.html。 - “
setTimeout(fn, 0)立即执行”:见 ①、⑥。 - “JSON 里的数字前后端都一样”:见 ③;JSON 规范不限制数字精度,但 JS 解析时受双精度限制RFC 8259 §6:https://www.rfc-editor.org/rfc/rfc8259#section-6。
与 AI 开发的关系
- 前端流式显示 LLM 输出:用
fetch+ReadableStream或EventSource读 SSE,逐块追加到页面;注意用textContent而非innerHTML(见 k6.web.html)。 - token 计数、logprob 等数字通常不会超过安全整数范围,但对话 id、消息 id若是 64 位整数,务必以字符串传输。
- 想在浏览器端直接跑小模型,可以用 WebGPU/WASM 方案(如 transformers.js),计算放在 Worker 中避免冻结界面https://huggingface.co/docs/transformers.js。
延伸阅读
- 《现代 JavaScript 教程》(中文):https://zh.javascript.info/
- MDN 并发模型与事件循环:https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Event_loop
- JavaScript/TypeScript 生态(包管理、运行时、构建工具)见 k6.lang.js-ts-ecosystem。
尚未验证的范围
- 没有穷举Node各阶段、nextTick与setImmediate在不同上下文的顺序,也未用真实API验证并发限流。
本次示例运行范围
2026-10-15:通过。本地Node与锁定依赖执行;DOM演示使用jsdom,不包含真实浏览器布局。
“一稿留存输出”保留原字,不是二稿代码新生成的结果;其原结论须结合二稿修订与边界阅读。
配套代码与核验资料