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 的一个用例是向运行时提供有关模块预期格式的信息。
// 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.
// ...
}
}
为您推荐与 typescript 相关的帖子: