函数类型

函数声明

在 JavaScript 中，有两种常见的定义函数的方式——函数声明（Function Declaration）和函数表达式（Function Expression）

// 函数声明
function sum(x, y) {
  return x + y;
}

// 函数表达式
let newSum = function(x, y) {
  return x + y;
}

一个函数有输入和输出，要在 TypeScript 中对其进行约束，需要把输入和输出都考虑到，其中函数声明类型的定义比较简单：

function sun(x: number, y: number): number {
  return x + y;
}

function sum(x: number, y: number): number {
    return x + y;
}
sum(1, 2, 3);
sum(1);
// Supplied parameters do not match any signature of call target

函数表达式

如果我们现在写一个对函数表达式的定义，可能会这样写：

let sum = function(x: number, y: number): number {
  return x + y;
}

这样写是可以通过编译的，不过事实上，上面的代码只是对等号后边的匿名函数进行了类型定义，而等号的左边的 sum，是通过赋值操作进行 类型推断 推断的类型，如果需要我们手动给它添加类型，应该是这样：

let sum: (x: number, y: number) => number = function(x: number, y: number): number {
  return x + y;
}

用接口定义函数

我们也可以用接口的方式定义一个函数符合的形状：

interface User {
  (age: number): boolean;
}

let isUnderAge: User;
isUnderAge = function(age: number) {
  return age < 18
}

采用函数表达式|接口定义函数的方式时，对等号左侧进行类型限制，可以保证以后对函数名赋值时保证参数个数、参数类型、返回值类型不变。

可选参数

前面提到，输入多余的（或者少于要求的）参数，是不允许的。那么如何定义可选的参数呢？

与接口中的可选属性类似，我们用 ? 表示可选的参数：

function allName(firstName: string, lastName?: string): string {
  if (lastName) {
    return firstName + ' ' + lastName;
   } else {
     return firstName;
   }
}
let tomcat = allName('Hardon', 'James');
let tom = allName('Kobe');

参数默认值

在 ES6 中，我们允许给函数的参数添加默认值，TypeScript 会将添加了默认值的参数识别为可选参数：

function allName(firstName: string, lastName: string = 'Bryant'): string {
  return firstName + ' ' + lastName;
}
let tomcat = allName('Hardon', 'James');
let tom = allName('Kobe');

此时就不受「可选参数必须接在必需参数后面」的限制了,上面代码编译后如下所示：

function allName(firstName, lastName) {
  if (lastName === void 0) { 
    lastName = 'Bryant';
  }
  return firstName + ' ' + lastName;
}
var tomcat = allName('Hardon', 'James');
var tom = allName('Kobe');

剩余参数

ES6中可以使用 ...rest 方式来获取函数中剩余的参数。

function push(array, ...items) {
  items.forEach(item => {
    array.push(item);
  })
}
let a: any[] = [];
push(a, 1, 2, 3);

事实上，items 是一个数组。所以我们可以用数组的类型来定义它：

function push(array: any[], ...items: any[]) {
  items.forEach(function(item) {
    array.push(item);
  });
}

let a = [];
push(a, 1, 2, 3);

重载

重载允许一个函数接受不同数量或类型参数的时候，做出不同处理。

比如，我们需要实现一个函数 reverse，输入数字 123 的时候，输出反转的数字 321，输入字符串 'hello' 的时候，输出反转的字符串 'olleh'。

利用联合类型我们可以这样实现它：

function reverse(x: number | string): number | string | void {
 if (typeof x === 'number') {
   return Number(x.toString().split('').reverse().join(''));
  } else if (typeof x === 'string') {
   return x.split('').reverse().join('');
  }
}

然而这样有一个缺点，就是不能够精确的表达，输入为数字的时候，输出也应该为数字，输入为字符串的时候，输出也应该为字符串。

这时，我们可以使用重载定义多个 reverse 的函数类型：

function reverse(x: number): number;
function reverse(x: string): string;
function reverse(x: number | string): number | string | void {
 if (typeof x === 'number') {
   return Number(x.toString().split('').reverse().join(''));
  } else if (typeof x === 'string') {
   return x.split('').reverse().join('');
  }
}

上例中，我们重复定义了多次函数 reverse，前几次都是函数定义，最后一次是函数实现。在编辑器的代码提示中，可以正确的看到前两个提示。

注意，TypeScript 会优先从最前面的函数定义开始匹配，所以多个函数定义如果有包含关系，需要优先把精确的定义写在前面。

上面代码在编译后会变成：

function reverse(x) {
    if (typeof x === 'number') {
        return Number(x.toString().split('').reverse().join(''));
    }
    else if (typeof x === 'string') {
        return x.split('').reverse().join('');
    }
}