Node.js / 系统课时
使用全局对象
使用全局对象
Node.js 提供了一组无需 import 或 require 就能使用的能力,例如 globalThis、console、定时器和 queueMicrotask。这些名字看起来都像“全局变量”,但并非所有模块环境中的特殊变量都属于全局对象,混淆边界很容易造成模块迁移问题。
学习目标
- 掌握
globalThis、console和定时器的基本用法 - 知道什么时候应该取消定时器并避免共享全局状态
- 区分真正的全局对象属性与 CommonJS 模块局部变量
优先使用 globalThis 访问全局对象
globalThis 是标准化的全局对象访问方式,适合需要同时兼容 Node.js 与其他 JavaScript 环境的代码。Node.js 也提供 global,但新代码如果没有 Node.js 专属需求,直接使用 globalThis 更容易迁移。
console.log(typeof globalThis);
console.log(globalThis === global);
globalThis.appMode = "development";
console.log(globalThis.appMode);
delete globalThis.appMode;
console.log(globalThis.appMode);预期输出
object
true
development
undefined这个示例也展示了全局状态的风险:任意模块都可以修改 globalThis.appMode。真实项目中,配置、数据库连接和业务状态通常应由模块导出并显式传递,而不是挂到全局对象上;测试时也能因此减少相互污染。
用 console 输出不同级别的信息
console 可以直接使用,不需要导入。开发阶段最常见的是 console.log()、console.warn() 和 console.error();计时可以使用 console.time(label) 与 console.timeEnd(label),两次调用必须使用相同的 label。
| 用法 | 适合场景 | 可直接检查的结果 |
|---|---|---|
console.log(value) |
普通调试信息 | 输出到标准输出 |
console.warn(message) |
可继续运行的异常情况 | 输出警告信息 |
console.error(error) |
错误或失败信息 | 输出到标准错误 |
console.time("load") |
开始测量一段代码 | 建立名为 load 的计时器 |
console.timeEnd("load") |
结束同名计时 | 输出实际耗时 |
日志进入生产环境后通常需要结构化字段、日志级别和持久化方案,因此不要把大量临时 console.log() 当成完整日志系统。学习阶段则可以用它直接观察变量、执行顺序和错误对象。
定时器要保留句柄并能够取消
setTimeout() 和 setInterval() 都返回定时器句柄,可以交给 clearTimeout() 或 clearInterval() 取消。只创建、不清理的重复定时器可能持续占用资源,服务关闭、请求取消或组件销毁时尤其需要处理。
const cancelledTimer = setTimeout(() => {
console.log("this should not run");
}, 50);
clearTimeout(cancelledTimer);
queueMicrotask(() => {
console.log("microtask");
});
setTimeout(() => {
console.log("timer kept");
}, 10);
console.log("sync");预期输出
sync
microtask
timer kept第一个定时器在触发前被取消,所以不会输出。queueMicrotask() 安排的回调会在当前同步代码结束后执行,而这里 10 ms 的定时器需要等待计时条件满足并由事件循环调度。
不要把模块局部变量误认为全局变量
在传统 CommonJS 文件中,require、module、exports、__filename 和 __dirname 可以直接使用,但它们是 Node.js 为当前模块提供的局部能力,并不是 globalThis 上的普通全局属性。ES Module 环境的可用名称又不同,例如默认没有 CommonJS 的 require 和 __dirname。
| 名称 | CommonJS 文件 | ES Module 文件 | globalThis 属性 |
|---|---|---|---|
console |
可用 | 可用 | 是 |
setTimeout |
可用 | 可用 | 是 |
globalThis |
可用 | 可用 | 是 |
require |
可用 | 默认不可用 | 否 |
__dirname |
可用 | 默认不可用 | 否 |
因此,判断一个名字是不是“全局能力”时,可以先检查它是否属于 globalThis,再确认当前文件采用 CommonJS 还是 ES Module。这样在修改 package.json 的模块类型或把旧代码迁移到 ESM 时,更容易提前发现边界差异。