Node.js / 系统课时

使用全局对象

使用全局对象

Node.js 提供了一组无需 import 或 require 就能使用的能力,例如 globalThis、console、定时器和 queueMicrotask。这些名字看起来都像“全局变量”,但并非所有模块环境中的特殊变量都属于全局对象,混淆边界很容易造成模块迁移问题。

学习目标

  • 掌握 globalThis、console 和定时器的基本用法
  • 知道什么时候应该取消定时器并避免共享全局状态
  • 区分真正的全局对象属性与 CommonJS 模块局部变量

优先使用 globalThis 访问全局对象

globalThis 是标准化的全局对象访问方式,适合需要同时兼容 Node.js 与其他 JavaScript 环境的代码。Node.js 也提供 global,但新代码如果没有 Node.js 专属需求,直接使用 globalThis 更容易迁移。

js
console.log(typeof globalThis);
console.log(globalThis === global);

globalThis.appMode = "development";
console.log(globalThis.appMode);

delete globalThis.appMode;
console.log(globalThis.appMode);

预期输出

text
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() 取消。只创建、不清理的重复定时器可能持续占用资源,服务关闭、请求取消或组件销毁时尤其需要处理。

js
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");

预期输出

text
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 时,更容易提前发现边界差异。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用全局对象

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通