javascript - 引用 ts-check JS 文件的定义

Question

我有一个混合 TS/JS 项目 - 最终我们将采用完整的 TS，但目前还有很长的路要走。

与此同时，我们正在使用 // @ts-check JS 文件中的指令和 <script>标签，非常强大。

我想在JS文件中引用一些TS定义，如下所示:

// @ts-check
/// <reference path="MyInterface.d.ts" />

/** @type {MyInterface}  */
let x = ...

只有这个不起作用 - TS 类型检查(和 VS2017 的智能感知)认为 x是 any .

我想要 x 上的类型定义的智能感知和警告时 x.propName被称为但是 MyInterface没有propName .

我知道我可以替换 <reference path="MyInterface.d.ts" />带有 JS 文档 @typedef ，但我有很多定义文件，并且不希望定义重复。

有什么办法可以制作@ts-check引用.d.ts文件？

Answer 1

official recommendation 使用导入类型:

// @ts-check

/** @type {import("./MyInterface").MyInterface} */
let x = ...;

或者，您可以使用@typedef 为导入的类型指定名称:

// @ts-check

/** @typedef {import("./MyInterface").MyInterface} MyInterface

/** @type {MyInterface} */
let x = ...;