TypeScript 项目里怎样为同级 JS 文件创建类型定义

在TypeScript项目中，有时我们需要为同级的JavaScript（JS）文件创建类型定义，以便在TypeScript代码中正确地使用和理解这些JS文件中的内容。这对于提高代码的可维护性和开发效率非常有帮助。下面将介绍具体的方法。

我们需要创建一个类型定义文件。在TypeScript中，类型定义文件通常以.d.ts为扩展名。假设我们有一个名为example.js的JavaScript文件，我们可以在同级目录下创建一个名为example.d.ts的文件。

在example.d.ts文件中，我们可以使用declare关键字来声明模块和其中的变量、函数等类型信息。例如，如果example.js文件中导出了一个名为add的函数，用于计算两个数字的和，我们可以在example.d.ts中这样定义：

declare module './example.js' {
  export function add(a: number, b: number): number;
}

这里我们使用declare module声明了example.js模块，并定义了add函数的参数类型和返回值类型。

接下来，在TypeScript文件中，当我们需要使用example.js中的函数时，就可以正确地获取到类型提示了。例如：

import { add } from './example.js';

const result = add(1, 2);
console.log(result);

在这个例子中，当我们调用add函数时，TypeScript会根据我们在类型定义文件中定义的类型信息进行检查。如果传入的参数类型不正确，编译器会给出相应的错误提示。

需要注意的是，如果example.js文件中的内容发生了变化，比如添加了新的函数或者修改了函数的参数和返回值类型，我们也需要相应地更新example.d.ts文件中的类型定义，以保持类型的一致性。

另外，对于一些复杂的JavaScript库，可能需要更详细和复杂的类型定义。此时，我们可以参考官方文档或者已有的类型定义库，来帮助我们更准确地创建类型定义。

通过为同级JS文件创建类型定义，我们可以在TypeScript项目中更好地利用JavaScript代码，同时享受TypeScript带来的类型检查和代码提示等优势，提高开发的质量和效率。