Node.js 16 在 2021 年 4 月发布，10 月进入 LTS 阶段。作为前端工具链的运行时基础，Node.js 版本直接影响 Vite、Webpack 5、esbuild 等构建工具的表现。整理一下 v16 中值得关注的特性。

V8 引擎升级到 9.0

Node.js 16 搭载 V8 9.0，带来了几个实用的新 API：

// Array.prototype.at - 支持负索引
const arr = [1, 2, 3, 4, 5]
arr.at(-1)   // 5
arr.at(-2)   // 4

// Object.hasOwn - 替代 hasOwnProperty
const obj = { name: 'test' }
Object.hasOwn(obj, 'name')      // true
Object.hasOwn(obj, 'toString')  // false

// Error.cause - 链式错误追踪
try {
  await fetchUser()
} catch (err) {
  throw new Error('获取用户信息失败', { cause: err })
}

// 捕获时可以追溯原始错误
try {
  main()
} catch (err) {
  console.log(err.message)        // '获取用户信息失败'
  console.log(err.cause.message)  // 原始错误信息
}

Fetch API 实验性支持

Node.js 16 开始实验性地内置 Fetch API（基于 undici）：

// 启用：需要加 --experimental-fetch 标志
// node --experimental-fetch app.js

async function getUser(id) {
  const response = await fetch(`https://api.example.com/users/${id}`)
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`)
  }
  return response.json()
}

// 支持 AbortController
const controller = new AbortController()
setTimeout(() => controller.abort(), 5000)

try {
  const res = await fetch(url, { signal: controller.signal })
} catch (err) {
  if (err.name === 'AbortError') {
    console.log('请求超时')
  }
}

虽然还是实验性功能，但意味着以后不用再装 node-fetch 或 axios 做简单的 HTTP 请求了。

Timers Promises API

timers/promises 模块提供了 Promise 版本的定时器：

import { setTimeout, setInterval } from 'timers/promises'

// 等待 1 秒，不需要 new Promise 包装
await setTimeout(1000)

// 带取消支持
const ac = new AbortController()
setTimeout(1000, null, { signal: ac.signal })
  .catch(err => {
    if (err.name === 'AbortError') console.log('定时器取消')
  })

// async 迭代的 setInterval
for await (const _ of setInterval(1000)) {
  console.log('每秒执行一次')
  if (shouldStop) break
}

AbortController 全局可用

Node.js 16 中 AbortController 变成全局可用，不再需要 polyfill：

// 全局直接使用，不需要 import
const controller = new AbortController()

// 配合 fs 操作（Node.js 16.7+）
import { readFile } from 'fs/promises'

const ac = new AbortController()
const promise = readFile('large-file.txt', { signal: ac.signal })
ac.abort() // 中断文件读取

迁移注意事项

从 Node.js 14 升级到 16，需要注意：

# 1. 检查 node-sass 依赖
# node-sass 需要针对 Node 版本编译二进制文件
# 建议迁移到 dart sass（sass 包）
npm uninstall node-sass
npm install sass

# 2. OpenSSL 3.0 兼容性
# Node.js 16 使用 OpenSSL 3.0，某些旧的加密算法默认禁用
# 如果遇到 ERR_OSSL_EVP_UNSUPPORTED，可以设置：
export NODE_OPTIONS=--openssl-legacy-provider

# 3. npm 版本
# Node.js 16 自带 npm 7/8，lockfile 格式从 v1 升级到 v2
# 团队内统一 Node 版本，避免 lockfile 冲突

小结

• Array.at()、Object.hasOwn()、Error.cause 是最实用的新 API
• Fetch API 内置是趋势，虽然目前还是实验性
• timers/promises 终于让定时器的 Promise 化不再手写
• 从 Node 14 迁移要注意 node-sass 和 OpenSSL 3.0 兼容性
• 建议团队统一使用 nvm 或 fnm 管理 Node 版本