理解在 TypeScript 中注释函数类型的各种语法

主要观点:在为 TypeScript 函数编写类型注释时常需反复思考,为使未来更直观,需理解 TypeScript 提供的各种函数注释语法。
关键信息:

  • 可归结为两种注释方式:分别为函数参数和返回值注释类型,或注释包含函数的变量类型。
  • 介绍了 JavaScript 中定义函数的方式,如函数声明、函数表达式(含匿名和具名)、箭头函数表达式(匿名箭头函数在顶层非法,最好用作回调或赋值给变量)。
  • 详细说明了两种注释函数的语法:

    • 语法 1:注释函数参数及其返回值,各种函数形式均可,返回值类型置于参数列表和函数体之间,函数声明只能通过此方式注释。
    • 语法 2:注释包含函数表达式的变量,称为函数类型表达式,格式类似箭头函数表达式,可定义为类型以提高可读性。
    • 语法 3:将函数表达式注释为对象类型,作为边缘情况,通过 call signature 注释可调用函数,可能存在不健全用例。

    重要细节:在不同语法中,注释的位置和格式有所不同,需注意区分和正确使用。

阅读 8
0 条评论