旧版本的 TypeScript 分析 JSDoc 注释时，它们会使用扫描器/分词器将注释分解为细粒度的标记并将内容拼凑在一起。这可能有助于规范化注释文本，这样多个空格就会合并为一个。但这也意味着解析器和扫描器会经常来回跳转，从而增加 JSDoc 解析的开销。

6 月 1 日，TypeScript 5.1 正式发布。以下是该版本中新增的主要功能：

(相关资料图)

可以通过以下 npm 命令来安装最新版本：

npm install -D typescript

改进函数返回值类型undefined的类型推断

在 JavaScript 中，如果函数没有返回值，就会返回undefined：

function foo() {  // 没有 return}// x = undefinedlet x = foo();

然而，在以前版本的 TypeScript 中，只有返回值类型为void和any的函数可以没有return语句。这意味着即使明确知道这个函数是返回undefined的，也需要至少有一个return语句。如下所示：

// ✅ 推断 f1 返回 voidfunction f1() {  // no returns}// ✅ void 不需要 return 语句function f2(): void {  // no returns}//  ✅ any 不需要 return 语句function f3(): any {  // no returns}// ❌ 声明类型既不是 void 也不是 any 的函数必须返回一个值。function f4(): undefined {  // no returns}

有些时候，我们可能希望函数返回undefined。在以前的版本中，可能需要显式返回一个undefined或者显式添加一个return语句。如下所示：

declare function takesFunction(f: () => undefined): undefined;// ❌ 类型“() => void”的参数不能赋给类型“() => undefined”的参数。不能将类型“void”分配给类型“undefined”。takesFunction(() => {  // no returns});// ❌ 其声明类型不为 "void" 或 "any" 的函数必须返回值。takesFunction((): undefined => {  // no returns});// ❌ 类型“() => void”的参数不能赋给类型“() => undefined”的参数。不能将类型“void”分配给类型“undefined”。takesFunction(() => {  return;});// ✅ 显式返回 undefinedtakesFunction(() => {  return undefined;});// ✅ 显式添加 return 语句takesFunction((): undefined => {  return;});

在 TypeScript 5.1 中，允许返回undefined的函数没有return语句。如下所示：

// ✅function f4(): undefined {  // no returns}// ✅takesFunction((): undefined => {  // no returns});

如果函数没有return并且被传递给期望返回undefined的函数参数，TypeScript 会推断该函数的返回类型为undefined。

// ✅takesFunction(function f() {  //                   ^ 返回值类型为 undefined  // no returns});// ✅takesFunction(function f() {  //                   ^ 返回值类型为 undefined  return;});

为了解决另一个类似的痛点，在 TypeScript 的–noImplicitReturns选项下，仅返回undefined的函数现在具有与 void 类似的异常，因为并非每个代码路径都必须以显式return结束。

// ✅ 启用 "--noImplicitReturns"function f(): undefined {  if (Math.random()) {    // ...    return;  }}

getter和setter支持设置不同类型

TypeScript 4.3 使得 get 和 set 访问器对可以指定两种不同的类型成为可能。

interface Serializer {  set value(v: string | number | boolean);  get value(): string;}declare let box: Serializer;// 允许赋值为 "boolean"box.value = true;// 类型为 "string"console.log(box.value.toUpperCase());

最初要求get类型必须是set类型的子类型。以下写法是有效的：

box.value = box.value;

但是，有许多现有的和提议的 API 在它们的 getter 和 setter 之间具有完全不相关的类型。例如，考虑一个最常见的例子——DOM 和 CSSStyleRule API 中的style属性。每个样式规则都有一个style属性，即CSSStyleDeclaration；但是，如果尝试写入该属性，它只能使用字符串才有效。

TypeScript 5.1 现在允许 get 和 set 访问器属性设置不同的类型，前提是它们具有显式类型注释。虽然此版本的 TypeScript 尚未更改这些内置接口的类型，但现在可以通过以下方式定义CSSStyleRule：

interface CSSStyleRule {    get style(): CSSStyleDeclaration;    set style(newValue: string);}

也允许以下方式使用：

class SafeBox {    #value: string | undefined;    // 只接受字符串    set value(newValue: string) {    }    // 必须检查 undefined    get value(): string | undefined {        return this.#value;    }}

这就类似于在–exactOptionalProperties下检查可选属性的方式。

JSX 元素和 JSX 标签类型之间解耦类型检查

TypeScript 对 JSX 的一个痛点是它对每个 JSX 元素标签类型的要求。此版本的 TypeScript 使 JSX 库可以更准确地描述 JSX 组件可以返回的内容，这具体意味着可以在 React 中使用异步服务端组件。

例如，有以下 JSX 元素：

//  自闭合的 JSX 标签// 带有开始/结束标签的常规元素

当对或进行类型检查时，TypeScript 总是会查找名为 JSX 的命名空间，并从中获取一个名为Element的类型，也就是在查找JSX.Element。

但是为了检查Foo或Bar本身是否是有效的标签名称，TypeScript 会粗略地获取由Foo或Bar返回或构造的类型，并检查与JSX.Element的兼容性（或者如果类型是可构造的，则检查另一种称为JSX.ElementClass的类型）。

这个限制意味着如果组件返回比JSX.Element更广泛的类型，则无法使用组件。例如，JSX 库可能可以接受一个返回字符串或Promise的组件。举一个具体的例子，React 的未来版本提议对返回 Promise 的组件提供有限支持，但是现有版本的TypeScript 无法表达这种类型，除非彻底放宽JSX.Element的类型限制。

import * as React from "react";async function Foo() {    return 
;}let element = ;//             ~~~// “Foo”不能用作 JSX 组件。其返回类型 "Promise" 不是有效的 JSX 元素。

为了向库提供一种表达方式，TypeScript 5.1 现在会查找名为JSX.ElementType的类型。ElementType精确指定什么可以有效用作 JSX 元素中的标签。因此，现在它的类型可能会被定义为类似于以下这样：

namespace JSX {    export type ElementType =        // 所有有效的小写标签        keyof IntrinsicAttributes        // 函数组件        (props: any) => Element        // 类组件        new (props: any) => ElementClass;    export interface IntrinsictAttributes extends /*...*/ {}    export type Element = /*...*/;    export type ClassElement = /*...*/;}

带命名空间的 JSX 标签

TypeScript 现在支持在使用 JSX 时使用带命名空间的属性名。

import * as React from "react";// 这两个是等价的：const x = ;const y = ;interface FooProps {    "a:b": string;}function Foo(props: FooProps) {    return 
{props["a:b"]}
;}

当名称的第一部分是小写字母时，在JSX.IntrinsicAttributes上以类似的方式查找命名空间标签名称。

// 在某些库的代码中或在该库的扩展中：namespace JSX {    interface IntrinsicElements {        ["a:b"]: { prop: string };    }}// 在我们的代码中：let x = ;

typeRoots 在模块解析中被查询

当 TypeScript 指定的模块查找策略无法解析路径时，它现在将解析相对于指定 typeRoots 的包。

JSX 标签支持链接光标

TypeScript 现在支持 JSX 标签名称的链接编辑。也就是在编辑开始/结束标签时，会自动修改结束/开始标签。

这项新功能应该适用于 TypeScript 和 JavaScript 文件，并且可以在 Visual Studio Code Insiders 中启用。在 Visual Studio Code 中，勾选Editor: Linked Editing选项即可：

或者在 JSON 设置文件中配置editor.linkedEditing：

{  // ...  "editor.linkedEditing": true,}

Visual Studio 17.7 Preview 1 也将支持此功能。

@ParamJSDoc 标签中支持代码补全

在 TypeScript 和 JavaScript 文件中输入@param标签时，TypeScript 现在提供代码补全。

优化

避免不必要的类型实例化

TypeScript 5.1 现在避免在已知不包含对外部类型参数的引用的对象类型中执行类型实例化。这有可能减少许多不必要的计算，并将 material-ui 的文档目录的类型检查时间减少 50% 以上。

联合字面量类型检查优化

在检查源类型是否属于联合类型时，TypeScript首先将使用该源类型的内部类型标识符进行快速查找。如果查找失败，则TypeScript会针对联合类型中的每种类型检查其兼容性。当将字面类型与仅包含字面类型的联合类型相关联时，TypeScript现在可以避免针对联合类型中的每种其他类型进行完整遍历。

这种优化可以将此问题中的代码的类型检查时间从约 45 秒减少到约 0.4 秒。

进行JSDoc解析时减少对扫描器的调用

当旧版本的 TypeScript 分析 JSDoc 注释时，它们会使用扫描器/分词器将注释分解为细粒度的标记并将内容拼凑在一起。这可能有助于规范化注释文本，这样多个空格就会合并为一个。但这也意味着解析器和扫描器会经常来回跳转，从而增加 JSDoc 解析的开销。

TypeScript 5.1 在将 JSDoc 注释分解为扫描器/分词器方面更改了逻辑。扫描器现在将更大的内容块直接返回给解析器，以便根据需要进行处理。

这些更改已将几个 10Mb 的主要是注释的 JavaScript 文件的解析时间缩短了大约一半。

参考：https://devblogs.microsoft.com/typescript/announcing-typescript-5-1/

关键词：