TypeScript 中的 lib

说明 lib 如何决定 TypeScript 默认提供哪些内建 API 类型定义，以及为什么 Node 项目经常要关心 DOM 类型是否被引入。

#tech / dev #resource / typescript #type / concept #status / growing

[!info] related notes

所属 MOC: TypeScript MOC

配置入口: tsconfig 使用详解

并列概念: TypeScript 中的 target, TypeScript 中的 noEmit

一句话定义

lib 用来决定 TypeScript 默认把哪些 JavaScript / 平台 API 的类型定义加入当前项目。

TypeScript 不只理解语法，还会预置一批标准库类型。

例如：

这些是否存在、以什么类型存在，和 lib 直接相关。

官方文档说明：

如果你没有手写 lib，TypeScript 会根据 target 推出一组默认库。

{
  "compilerOptions": {
    "target": "ES2020",
    "lib": ["ES2020", "DOM"]
  }
}

通常需要：

很多时候并不希望默认带上浏览器 DOM 类型，以避免：

哪怕类型里有 Promise 或 Map，运行时环境也未必真的有对应实现。

官方文档明确说，两者可以 mix and match。

这意味着你可以：