前端开发离不开第三方库，而 TypeScript 成为了越来越多的前端开发者的首选。但是，当我们需要使用 JavaScript 库时，就需要使用声明文件。如果该库没有声明文件，我们就需要自己编写声明文件，这样会很浪费时间和精力。因此，社区中出现了一些工具，帮助我们自动生成声明文件。下面我们来介绍一个有用的工具 —— dts-downlevel。
什么是 dts-downlevel
dts-downlevel 是一个为 TypeScript 自动生成低版本声明文件的工具，它可以根据指定的 TypeScript 版本，将 TypeScript 的高版本声明文件降级到低版本声明文件。
开始使用 dts-downlevel
首先，我们需要全局安装 dts-downlevel ：
npm install -g dts-downlevel
安装后，我们可以在命令行中使用 dts-downlevel 命令。
基本使用
如果我们对于一个库所需的最低 TypeScript 版本已知，我们可以直接使用如下命令生成相应的低版本声明文件：
dts-downlevel my-library.d.ts
其中，my-library.d.ts 是我们需要降级的 TypeScript 声明文件的文件名。运行该命令后，它将会自动生成一个降级后的声明文件，即 my-library.d.ts <= [TypeScript version]。
例如：
dts-downlevel my-library.d.ts --tsVersion 2.9
该命令将生成一个兼容 TypeScript 2.9 的声明文件 my-library.d.ts <= 2.9。
设置当前项目的最低 TypeScript 版本
除了可以通过命令行参数指定 TypeScript 版本，还可以通过在 tsconfig.json 文件中配置 dts-downlevel 来设置当前项目的最低 TypeScript 版本。
在 tsconfig.json 中增加如下配置：
{
...
"dtsDownlevel": {
"lowTsVersion": "2.9"
}
}设置当前项目的最低 TypeScript 版本为 2.9。之后每次运行 dts-downlevel 命令不指定 --tsVersion 参数，则会采用该配置。
高级使用
dts-downlevel 还提供了更多个性化配置，具体可以通过 dts-downlevel --help 查看帮助文档。
示例代码
我们以 lodash 库为例进行演示。
在命令行中运行：
npm install --save lodash npm install -g dts-downlevel
在项目根目录创建 tsconfig.json，增加如下配置：
-- -------------------- ---- -------
-
------------------ -
---
--
---
--------------- -
--------------- -----
-
-在命令行中运行：
dts-downlevel node_modules/lodash/lodash.d.ts
成功后，将在 node_modules/lodash 下生成一个名为 lodash.d.ts <= 3.9 的降级后的声明文件。
最后，我们的项目中只需要引入相应的声明文件，即可完美运行。
/// <reference path="./node_modules/lodash/lodash.d.ts <= 3.9"/> import _ from 'lodash'; _.chunk([1, 2, 3, 4, 5], 2);
这样，我们就可以顺利地使用 lodash 库了。
总结
dts-downlevel 可以帮助我们自动生成兼容低版本 TypeScript 的声明文件，它不仅可以为我们减少更多的工作量，同时还可以帮助我们更好地理解库的使用。希望本篇文章对你有所帮助！
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/106091