JavaScript(浏览器与 Node.js 的通用语言)

JavaScript是由ECMAScript规范定义核心语义的动态语言,可运行于浏览器、Node.js等宿主。单个JavaScript执行代理通常按事件循环调度任务,但Worker可在其他线程执行;浏览器也能运行WebAssembly。

二稿核验说明(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

图 1

关键点:在单个执行代理内,通常一次只执行一个任务;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 解析MDN Number.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。

延伸阅读

尚未验证的范围

  • 没有穷举Node各阶段、nextTick与setImmediate在不同上下文的顺序,也未用真实API验证并发限流。

本次示例运行范围

2026-10-15:通过。本地Node与锁定依赖执行;DOM演示使用jsdom,不包含真实浏览器布局。

查看本次日志。

“一稿留存输出”保留原字,不是二稿代码新生成的结果;其原结论须结合二稿修订与边界阅读。

配套代码与核验资料

继续浏览基础 返回知识 →返回顶部 ↑
本篇目录
教程图解100%
教程图解