TypeScript 函数类型标注与可选参数的艺术

TypeScript 函数类型标注的魅力

TypeScript 作为一门强类型的语言，为函数参数和返回值类型提供了明确的标注。这种标注不仅可以提高代码的可读性，还有助于捕获类型错误，防止潜在的运行时错误。

函数类型标注的语法非常简单，只需要在函数名后紧跟一个冒号，然后指定函数参数类型和返回值类型即可。例如：

function add(a: number, b: number): number {
  return a + b;
}

这个函数接收两个数字类型的参数，并返回一个数字类型的返回值。

TypeScript 可选参数的灵活性

在 TypeScript 中，我们可以使用问号 (?) 来标记一个参数为可选参数。这允许我们在调用函数时省略该参数，函数仍然可以正常执行。

可选参数的语法也很简单，只需要在参数名后紧跟一个问号即可。例如：

function greet(name?: string) {
  if (name) {
    console.log(`Hello, ${name}!`);
  } else {
    console.log('Hello, world!');
  }
}

这个函数接收一个可选的字符串参数 name，如果 name 参数被省略，则函数会打印出 "Hello, world!"。

函数类型标注与可选参数的组合使用

函数类型标注和可选参数可以组合使用，为我们提供了更加灵活的函数定义方式。例如，我们可以定义一个函数，接收两个数字类型的参数，其中第一个参数是必须的，第二个参数是可选的，并返回一个数字类型的返回值。

function subtract(a: number, b?: number): number {
  if (b) {
    return a - b;
  } else {
    return -a;
  }
}

这个函数可以被调用两次：

subtract(10, 5); // 返回 5
subtract(10); // 返回 -10

TypeScript 文档的函数类型标注与可选参数

在 TypeScript 文档中，函数类型标注和可选参数的使用非常普遍。这使得文档更加清晰易读，读者可以一目了然地了解函数的用法。

例如，在 TypeScript 文档中，Array.prototype.push() 方法的定义如下：

push(...items: T[]): number;

这个方法接收一个或多个 T 类型的参数，并返回一个数字，表示数组的新长度。

结语

函数类型标注和可选参数是 TypeScript 中非常有用的特性，可以帮助我们编写更加严谨、易读、易维护的代码。在 TypeScript 文档中，函数类型标注和可选参数的使用也非常普遍，这使得文档更加清晰易读。