TypeScript 5.3 正式发布

TypeScript 5.3 已正式发布。

主要变化

• 支持 import attributes 提案的最近更新

• 在 Import Types 中提供对resolution-mode的稳定支持
• 为所有 Module Modes 提供resolution-mode支持

• switch (true)Narrowing

• Narrowing On Comparisons to Booleans

• 检查对实例字段的super属性访问

• 针对类型的交互式嵌套提示 (Interactive Inlay Hints)

• 跳过 JSDoc 解析以进行优化

• 合并tsserverlibrary.js和typescript.js

import attributes

import attributes 的一个用例是向运行时提供有关模块预期格式的信息。

// We only want this to be interpreted as JSON,
// not a runnable/malicious JavaScript file with a `.json` extension.
import obj from "./something.json" with { type: "json" };

TypeScript 不会检查这些属性的内容，因为它们是特定于主机的，因此不会对它们进行检查，只是让浏览器和运行时处理它们（可能会出错）。

// TypeScript is fine with this.
// But your browser? Probably not.
import * as foo from "./foo.js" with { type: "fluffy bunny" };

动态 import () 调用也可以通过第二个参数使用 import 属性。

const obj = await import("./something.json", {
    with: { type: "json" }
});

第二个参数的预期类型由一个名为ImportCallOptions的类型定义，默认情况下，该类型只期望调用一个属性with。

请注意，导入属性是从早期的 "导入断言"（import assertions）提案演变而来的，该提案已在 TypeScript 4.5 中实现。最明显的区别是使用了with关键字而非assert关键字。但不太明显的区别是，运行时现在可以自由使用属性来指导导入路径的解析和解释，而导入断言只能在加载模块后断言某些特性。

随着时间的推移，TypeScript 将淘汰旧的导入断言语法，转而使用建议的导入属性语法。使用 assert 的现有代码应迁移到 with 关键字。需要导入属性的新代码应只使用with关键字。

switch (true)Narrowing

TypeScript 5.3 可以根据switch (true)中每个case子句的条件执行 narrowing。

function f(x: unknown) {
    switch (true) {
        case typeof x === "string":
            // 'x' is a 'string' here
            console.log(x.toUpperCase());
            // falls through...

        case Array.isArray(x):
            // 'x' is a 'string | any[]' here.
            console.log(x.length);
            // falls through...

        default:
          // 'x' is 'unknown' here.
          // ...
    }
}

详情查看发布公告。