• 高级类型
  • 交叉类型(Intersection Types)
  • 联合类型(Union Types)
  • 类型保护与区分类型(Type Guards and Differentiating Types)
    • 用户自定义的类型保护
    • typeof类型保护
    • instanceof类型保护
  • 可以为null的类型
    • 可选参数和可选属性
    • 类型保护和类型断言
  • 类型别名
    • 接口 vs. 类型别名
  • 字符串字面量类型
  • 数字字面量类型
  • 枚举成员类型
  • 可辨识联合(Discriminated Unions)
    • 完整性检查
  • 多态的 this类型
  • 索引类型(Index types)
    • 索引类型和字符串索引签名
  • 映射类型
    • 由映射类型进行推断
      • 预定义的有条件类型
        • 示例

    高级类型

    交叉类型(Intersection Types)

    交叉类型是将多个类型合并为一个类型。 这让我们可以把现有的多种类型叠加到一起成为一种类型,它包含了所需的所有类型的特性。 例如, Person & Serializable & Loggable同时是 Person Serializable Loggable。 就是说这个类型的对象同时拥有了这三种类型的成员。

    我们大多是在混入(mixins)或其它不适合典型面向对象模型的地方看到交叉类型的使用。 (在JavaScript里发生这种情况的场合很多!) 下面是如何创建混入的一个简单例子:

    1. function extend<T, U>(first: T, second: U): T & U {
    2. let result = <T & U>{};
    3. for (let id in first) {
    4. (<any>result)[id] = (<any>first)[id];
    5. }
    6. for (let id in second) {
    7. if (!result.hasOwnProperty(id)) {
    8. (<any>result)[id] = (<any>second)[id];
    9. }
    10. }
    11. return result;
    12. }
    13. class Person {
    14. constructor(public name: string) { }
    15. }
    16. interface Loggable {
    17. log(): void;
    18. }
    19. class ConsoleLogger implements Loggable {
    20. log() {
    21. // ...
    22. }
    23. }
    24. var jim = extend(new Person("Jim"), new ConsoleLogger());
    25. var n = jim.name;
    26. jim.log();

    联合类型(Union Types)

    联合类型与交叉类型很有关联,但是使用上却完全不同。 偶尔你会遇到这种情况,一个代码库希望传入 numberstring类型的参数。 例如下面的函数:

    1. /**
    2. * Takes a string and adds "padding" to the left.
    3. * If 'padding' is a string, then 'padding' is appended to the left side.
    4. * If 'padding' is a number, then that number of spaces is added to the left side.
    5. */
    6. function padLeft(value: string, padding: any) {
    7. if (typeof padding === "number") {
    8. return Array(padding + 1).join(" ") + value;
    9. }
    10. if (typeof padding === "string") {
    11. return padding + value;
    12. }
    13. throw new Error(`Expected string or number, got '${padding}'.`);
    14. }
    15. padLeft("Hello world", 4); // returns " Hello world"

    padLeft存在一个问题, padding参数的类型指定成了 any。 这就是说我们可以传入一个既不是 number也不是 string类型的参数,但是TypeScript却不报错。

    1. let indentedString = padLeft("Hello world", true); // 编译阶段通过,运行时报错

    在传统的面向对象语言里,我们可能会将这两种类型抽象成有层级的类型。 这么做显然是非常清晰的,但同时也存在了过度设计。 padLeft原始版本的好处之一是允许我们传入原始类型。 这样做的话使用起来既简单又方便。 如果我们就是想使用已经存在的函数的话,这种新的方式就不适用了。

    代替 any, 我们可以使用 联合类型做为 padding的参数:

    1. /**
    2. * Takes a string and adds "padding" to the left.
    3. * If 'padding' is a string, then 'padding' is appended to the left side.
    4. * If 'padding' is a number, then that number of spaces is added to the left side.
    5. */
    6. function padLeft(value: string, padding: string | number) {
    7. // ...
    8. }
    9. let indentedString = padLeft("Hello world", true); // errors during compilation

    联合类型表示一个值可以是几种类型之一。 我们用竖线( |)分隔每个类型,所以 number | string | boolean表示一个值可以是 numberstring,或 boolean

    如果一个值是联合类型,我们只能访问此联合类型的所有类型里共有的成员。

    1. interface Bird {
    2. fly();
    3. layEggs();
    4. }
    5. interface Fish {
    6. swim();
    7. layEggs();
    8. }
    9. function getSmallPet(): Fish | Bird {
    10. // ...
    11. }
    12. let pet = getSmallPet();
    13. pet.layEggs(); // okay
    14. pet.swim(); // errors

    这里的联合类型可能有点复杂,但是你很容易就习惯了。 如果一个值的类型是 A | B,我们能够 确定的是它包含了 A B中共有的成员。 这个例子里, Bird具有一个 fly成员。 我们不能确定一个 Bird | Fish类型的变量是否有 fly方法。 如果变量在运行时是 Fish类型,那么调用 pet.fly()就出错了。

    类型保护与区分类型(Type Guards and Differentiating Types)

    联合类型适合于那些值可以为不同类型的情况。 但当我们想确切地了解是否为 Fish时怎么办? JavaScript里常用来区分2个可能值的方法是检查成员是否存在。 如之前提及的,我们只能访问联合类型中共同拥有的成员。

    1. let pet = getSmallPet();
    2. // 每一个成员访问都会报错
    3. if (pet.swim) {
    4. pet.swim();
    5. }
    6. else if (pet.fly) {
    7. pet.fly();
    8. }

    为了让这段代码工作,我们要使用类型断言:

    1. let pet = getSmallPet();
    2. if ((<Fish>pet).swim) {
    3. (<Fish>pet).swim();
    4. }
    5. else {
    6. (<Bird>pet).fly();
    7. }

    用户自定义的类型保护

    这里可以注意到我们不得不多次使用类型断言。 假若我们一旦检查过类型,就能在之后的每个分支里清楚地知道 pet的类型的话就好了。

    TypeScript里的 类型保护机制让它成为了现实。 类型保护就是一些表达式,它们会在运行时检查以确保在某个作用域里的类型。 要定义一个类型保护,我们只要简单地定义一个函数,它的返回值是一个 类型谓词

    1. function isFish(pet: Fish | Bird): pet is Fish {
    2. return (<Fish>pet).swim !== undefined;
    3. }

    在这个例子里, pet is Fish就是类型谓词。 谓词为 parameterName is Type这种形式, parameterName必须是来自于当前函数签名里的一个参数名。

    每当使用一些变量调用 isFish时,TypeScript会将变量缩减为那个具体的类型,只要这个类型与变量的原始类型是兼容的。

    1. // 'swim' 和 'fly' 调用都没有问题了
    2. if (isFish(pet)) {
    3. pet.swim();
    4. }
    5. else {
    6. pet.fly();
    7. }

    注意TypeScript不仅知道在 if分支里 petFish类型; 它还清楚在 else分支里,一定 不是 Fish类型,一定是 Bird类型。

    typeof类型保护

    现在我们回过头来看看怎么使用联合类型书写 padLeft代码。 我们可以像下面这样利用类型断言来写:

    1. function isNumber(x: any): x is number {
    2. return typeof x === "number";
    3. }
    4. function isString(x: any): x is string {
    5. return typeof x === "string";
    6. }
    7. function padLeft(value: string, padding: string | number) {
    8. if (isNumber(padding)) {
    9. return Array(padding + 1).join(" ") + value;
    10. }
    11. if (isString(padding)) {
    12. return padding + value;
    13. }
    14. throw new Error(`Expected string or number, got '${padding}'.`);
    15. }

    然而,必须要定义一个函数来判断类型是否是原始类型,这太痛苦了。 幸运的是,现在我们不必将 typeof x === "number"抽象成一个函数,因为TypeScript可以将它识别为一个类型保护。 也就是说我们可以直接在代码里检查类型了。

    1. function padLeft(value: string, padding: string | number) {
    2. if (typeof padding === "number") {
    3. return Array(padding + 1).join(" ") + value;
    4. }
    5. if (typeof padding === "string") {
    6. return padding + value;
    7. }
    8. throw new Error(`Expected string or number, got '${padding}'.`);
    9. }

    这些 typeof类型保护只有两种形式能被识别: typeof v === "typename"typeof v !== "typename""typename"必须是 "number""string""boolean""symbol"。 但是TypeScript并不会阻止你与其它字符串比较,语言不会把那些表达式识别为类型保护。

    instanceof类型保护

    如果你已经阅读了 typeof类型保护并且对JavaScript里的 instanceof操作符熟悉的话,你可能已经猜到了这节要讲的内容。

    instanceof类型保护是通过构造函数来细化类型的一种方式。 比如,我们借鉴一下之前字符串填充的例子:

    1. interface Padder {
    2. getPaddingString(): string
    3. }
    4. class SpaceRepeatingPadder implements Padder {
    5. constructor(private numSpaces: number) { }
    6. getPaddingString() {
    7. return Array(this.numSpaces + 1).join(" ");
    8. }
    9. }
    10. class StringPadder implements Padder {
    11. constructor(private value: string) { }
    12. getPaddingString() {
    13. return this.value;
    14. }
    15. }
    16. function getRandomPadder() {
    17. return Math.random() < 0.5 ?
    18. new SpaceRepeatingPadder(4) :
    19. new StringPadder(" ");
    20. }
    21. // 类型为SpaceRepeatingPadder | StringPadder
    22. let padder: Padder = getRandomPadder();
    23. if (padder instanceof SpaceRepeatingPadder) {
    24. padder; // 类型细化为'SpaceRepeatingPadder'
    25. }
    26. if (padder instanceof StringPadder) {
    27. padder; // 类型细化为'StringPadder'
    28. }

    instanceof的右侧要求是一个构造函数,TypeScript将细化为:

    • 此构造函数的 prototype属性的类型,如果它的类型不为 any的话
    • 构造签名所返回的类型的联合
      以此顺序。

    可以为null的类型

    TypeScript具有两种特殊的类型, nullundefined,它们分别具有值null和undefined. 我们在基础类型一节里已经做过简要说明。 默认情况下,类型检查器认为 nullundefined可以赋值给任何类型。 nullundefined是所有其它类型的一个有效值。 这也意味着,你阻止不了将它们赋值给其它类型,就算是你想要阻止这种情况也不行。 null的发明者,Tony Hoare,称它为 价值亿万美金的错误。

    —strictNullChecks标记可以解决此错误:当你声明一个变量时,它不会自动地包含 nullundefined。 你可以使用联合类型明确的包含它们:

    1. let s = "foo";
    2. s = null; // 错误, 'null'不能赋值给'string'
    3. let sn: string | null = "bar";
    4. sn = null; // 可以
    5. sn = undefined; // error, 'undefined'不能赋值给'string | null'

    注意,按照JavaScript的语义,TypeScript会把 nullundefined区别对待。 string | nullstring | undefinedstring | undefined | null是不同的类型。

    可选参数和可选属性

    使用了 —strictNullChecks,可选参数会被自动地加上 | undefined:

    1. function f(x: number, y?: number) {
    2. return x + (y || 0);
    3. }
    4. f(1, 2);
    5. f(1);
    6. f(1, undefined);
    7. f(1, null); // error, 'null' is not assignable to 'number | undefined'

    可选属性也会有同样的处理:

    1. class C {
    2. a: number;
    3. b?: number;
    4. }
    5. let c = new C();
    6. c.a = 12;
    7. c.a = undefined; // error, 'undefined' is not assignable to 'number'
    8. c.b = 13;
    9. c.b = undefined; // ok
    10. c.b = null; // error, 'null' is not assignable to 'number | undefined'

    类型保护和类型断言

    由于可以为null的类型是通过联合类型实现,那么你需要使用类型保护来去除 null。 幸运地是这与在JavaScript里写的代码一致:

    1. function f(sn: string | null): string {
    2. if (sn == null) {
    3. return "default";
    4. }
    5. else {
    6. return sn;
    7. }
    8. }

    这里很明显地去除了 null,你也可以使用短路运算符:

    1. function f(sn: string | null): string {
    2. return sn || "default";
    3. }

    如果编译器不能够去除 nullundefined,你可以使用类型断言手动去除。 语法是添加 !后缀: identifier!identifier的类型里去除了 nullundefined

    1. function broken(name: string | null): string {
    2. function postfix(epithet: string) {
    3. return name.charAt(0) + '. the ' + epithet; // error, 'name' is possibly null
    4. }
    5. name = name || "Bob";
    6. return postfix("great");
    7. }
    8. function fixed(name: string | null): string {
    9. function postfix(epithet: string) {
    10. return name!.charAt(0) + '. the ' + epithet; // ok
    11. }
    12. name = name || "Bob";
    13. return postfix("great");
    14. }

    本例使用了嵌套函数,因为编译器无法去除嵌套函数的null(除非是立即调用的函数表达式)。 因为它无法跟踪所有对嵌套函数的调用,尤其是你将内层函数做为外层函数的返回值。 如果无法知道函数在哪里被调用,就无法知道调用时 name的类型。

    类型别名

    类型别名会给一个类型起个新名字。 类型别名有时和接口很像,但是可以作用于原始值,联合类型,元组以及其它任何你需要手写的类型。

    1. type Name = string;
    2. type NameResolver = () => string;
    3. type NameOrResolver = Name | NameResolver;
    4. function getName(n: NameOrResolver): Name {
    5. if (typeof n === 'string') {
    6. return n;
    7. }
    8. else {
    9. return n();
    10. }
    11. }

    起别名不会新建一个类型 - 它创建了一个新 名字来引用那个类型。 给原始类型起别名通常没什么用,尽管可以做为文档的一种形式使用。

    同接口一样,类型别名也可以是泛型 - 我们可以添加类型参数并且在别名声明的右侧传入:

    1. type Container<T> = { value: T };

    我们也可以使用类型别名来在属性里引用自己:

    1. type Tree<T> = {
    2. value: T;
    3. left: Tree<T>;
    4. right: Tree<T>;
    5. }

    与交叉类型一起使用,我们可以创建出一些十分稀奇古怪的类型。

    1. type LinkedList<T> = T & { next: LinkedList<T> };
    2. interface Person {
    3. name: string;
    4. }
    5. var people: LinkedList<Person>;
    6. var s = people.name;
    7. var s = people.next.name;
    8. var s = people.next.next.name;
    9. var s = people.next.next.next.name;

    然而,类型别名不能出现在声明右侧的任何地方。

    1. type Yikes = Array<Yikes>; // error

    接口 vs. 类型别名

    像我们提到的,类型别名可以像接口一样;然而,仍有一些细微差别。

    其一,接口创建了一个新的名字,可以在其它任何地方使用。 类型别名并不创建新名字—比如,错误信息就不会使用别名。 在下面的示例代码里,在编译器中将鼠标悬停在 interfaced上,显示它返回的是 Interface,但悬停在 aliased上时,显示的却是对象字面量类型。

    1. type Alias = { num: number }
    2. interface Interface {
    3. num: number;
    4. }
    5. declare function aliased(arg: Alias): Alias;
    6. declare function interfaced(arg: Interface): Interface;

    另一个重要区别是类型别名不能被 extendsimplements(自己也不能 extendsimplements其它类型)。 因为 软件中的对象应该对于扩展是开放的,但是对于修改是封闭的,你应该尽量去使用接口代替类型别名。

    另一方面,如果你无法通过接口来描述一个类型并且需要使用联合类型或元组类型,这时通常会使用类型别名。

    字符串字面量类型

    字符串字面量类型允许你指定字符串必须的固定值。 在实际应用中,字符串字面量类型可以与联合类型,类型保护和类型别名很好的配合。 通过结合使用这些特性,你可以实现类似枚举类型的字符串。

    1. type Easing = "ease-in" | "ease-out" | "ease-in-out";
    2. class UIElement {
    3. animate(dx: number, dy: number, easing: Easing) {
    4. if (easing === "ease-in") {
    5. // ...
    6. }
    7. else if (easing === "ease-out") {
    8. }
    9. else if (easing === "ease-in-out") {
    10. }
    11. else {
    12. // error! should not pass null or undefined.
    13. }
    14. }
    15. }
    16. let button = new UIElement();
    17. button.animate(0, 0, "ease-in");
    18. button.animate(0, 0, "uneasy"); // error: "uneasy" is not allowed here

    你只能从三种允许的字符中选择其一来做为参数传递,传入其它值则会产生错误。

    1. Argument of type '"uneasy"' is not assignable to parameter of type '"ease-in" | "ease-out" | "ease-in-out"'

    字符串字面量类型还可以用于区分函数重载:

    1. function createElement(tagName: "img"): HTMLImageElement;
    2. function createElement(tagName: "input"): HTMLInputElement;
    3. // ... more overloads ...
    4. function createElement(tagName: string): Element {
    5. // ... code goes here ...
    6. }

    数字字面量类型

    TypeScript还具有数字字面量类型。

    1. function rollDie(): 1 | 2 | 3 | 4 | 5 | 6 {
    2. // ...
    3. }

    我们很少直接这样使用,但它们可以用在缩小范围调试bug的时候:

    1. function foo(x: number) {
    2. if (x !== 1 || x !== 2) {
    3. // ~~~~~~~
    4. // Operator '!==' cannot be applied to types '1' and '2'.
    5. }
    6. }

    换句话说,当 x2进行比较的时候,它的值必须为 1,这就意味着上面的比较检查是非法的。

    枚举成员类型

    如我们在 枚举一节里提到的,当每个枚举成员都是用字面量初始化的时候枚举成员是具有类型的。

    在我们谈及“单例类型”的时候,多数是指枚举成员类型和数字/字符串字面量类型,尽管大多数用户会互换使用“单例类型”和“字面量类型”。

    可辨识联合(Discriminated Unions)

    你可以合并单例类型,联合类型,类型保护和类型别名来创建一个叫做 可辨识联合的高级模式,它也称做 标签联合代数数据类型。 可辨识联合在函数式编程很有用处。 一些语言会自动地为你辨识联合;而TypeScript则基于已有的JavaScript模式。 它具有3个要素:

    • 具有普通的单例类型属性— 可辨识的特征
    • 一个类型别名包含了那些类型的联合— 联合
    • 此属性上的类型保护。
    1. interface Square {
    2. kind: "square";
    3. size: number;
    4. }
    5. interface Rectangle {
    6. kind: "rectangle";
    7. width: number;
    8. height: number;
    9. }
    10. interface Circle {
    11. kind: "circle";
    12. radius: number;
    13. }

    首先我们声明了将要联合的接口。 每个接口都有 kind属性但有不同的字符串字面量类型。 kind属性称做 可辨识的特征标签。 其它的属性则特定于各个接口。 注意,目前各个接口间是没有联系的。 下面我们把它们联合到一起:

    1. type Shape = Square | Rectangle | Circle;

    现在我们使用可辨识联合:

    1. function area(s: Shape) {
    2. switch (s.kind) {
    3. case "square": return s.size * s.size;
    4. case "rectangle": return s.height * s.width;
    5. case "circle": return Math.PI * s.radius ** 2;
    6. }
    7. }

    完整性检查

    当没有涵盖所有可辨识联合的变化时,我们想让编译器可以通知我们。 比如,如果我们添加了 TriangleShape,我们同时还需要更新 area:

    1. type Shape = Square | Rectangle | Circle | Triangle;
    2. function area(s: Shape) {
    3. switch (s.kind) {
    4. case "square": return s.size * s.size;
    5. case "rectangle": return s.height * s.width;
    6. case "circle": return Math.PI * s.radius ** 2;
    7. }
    8. // should error here - we didn't handle case "triangle"
    9. }

    有两种方式可以实现。 首先是启用 —strictNullChecks并且指定一个返回值类型:

    1. function area(s: Shape): number { // error: returns number | undefined
    2. switch (s.kind) {
    3. case "square": return s.size * s.size;
    4. case "rectangle": return s.height * s.width;
    5. case "circle": return Math.PI * s.radius ** 2;
    6. }
    7. }

    因为 switch没有包涵所有情况,所以TypeScript认为这个函数有时候会返回 undefined。 如果你明确地指定了返回值类型为 number,那么你会看到一个错误,因为实际上返回值的类型为 number | undefined。 然而,这种方法存在些微妙之处且 —strictNullChecks对旧代码支持不好。

    第二种方法使用 never类型,编译器用它来进行完整性检查:

    1. function assertNever(x: never): never {
    2. throw new Error("Unexpected object: " + x);
    3. }
    4. function area(s: Shape) {
    5. switch (s.kind) {
    6. case "square": return s.size * s.size;
    7. case "rectangle": return s.height * s.width;
    8. case "circle": return Math.PI * s.radius ** 2;
    9. default: return assertNever(s); // error here if there are missing cases
    10. }
    11. }

    这里, assertNever检查 s是否为 never类型—即为除去所有可能情况后剩下的类型。 如果你忘记了某个case,那么 s将具有一个真实的类型并且你会得到一个错误。 这种方式需要你定义一个额外的函数,但是在你忘记某个case的时候也更加明显。

    多态的 this类型

    多态的 this类型表示的是某个包含类或接口的 子类型。 这被称做 F-bounded多态性。 它能很容易的表现连贯接口间的继承,比如。 在计算器的例子里,在每个操作之后都返回 this类型:

    1. class BasicCalculator {
    2. public constructor(protected value: number = 0) { }
    3. public currentValue(): number {
    4. return this.value;
    5. }
    6. public add(operand: number): this {
    7. this.value += operand;
    8. return this;
    9. }
    10. public multiply(operand: number): this {
    11. this.value *= operand;
    12. return this;
    13. }
    14. // ... other operations go here ...
    15. }
    16. let v = new BasicCalculator(2)
    17. .multiply(5)
    18. .add(1)
    19. .currentValue();

    由于这个类使用了 this类型,你可以继承它,新的类可以直接使用之前的方法,不需要做任何的改变。

    1. class ScientificCalculator extends BasicCalculator {
    2. public constructor(value = 0) {
    3. super(value);
    4. }
    5. public sin() {
    6. this.value = Math.sin(this.value);
    7. return this;
    8. }
    9. // ... other operations go here ...
    10. }
    11. let v = new ScientificCalculator(2)
    12. .multiply(5)
    13. .sin()
    14. .add(1)
    15. .currentValue();

    如果没有 this类型, ScientificCalculator就不能够在继承 BasicCalculator的同时还保持接口的连贯性。 multiply将会返回 BasicCalculator,它并没有 sin方法。 然而,使用 this类型, multiply会返回 this,在这里就是 ScientificCalculator

    索引类型(Index types)

    使用索引类型,编译器就能够检查使用了动态属性名的代码。 例如,一个常见的JavaScript模式是从对象中选取属性的子集。

    1. function pluck(o, names) {
    2. return names.map(n => o[n]);
    3. }

    下面是如何在TypeScript里使用此函数,通过 索引类型查询索引访问操作符:

    1. function pluck<T, K extends keyof T>(o: T, names: K[]): T[K][] {
    2. return names.map(n => o[n]);
    3. }
    4. interface Person {
    5. name: string;
    6. age: number;
    7. }
    8. let person: Person = {
    9. name: 'Jarid',
    10. age: 35
    11. };
    12. let strings: string[] = pluck(person, ['name']); // ok, string[]

    编译器会检查 name是否真的是 Person的一个属性。 本例还引入了几个新的类型操作符。 首先是 keyof T索引类型查询操作符。 对于任何类型 Tkeyof T的结果为 T上已知的公共属性名的联合。 例如:

    1. let personProps: keyof Person; // 'name' | 'age'

    keyof Person是完全可以与 'name' | 'age'互相替换的。 不同的是如果你添加了其它的属性到 Person,例如 address: string,那么 keyof Person会自动变为 'name' | 'age' | 'address'。 你可以在像 pluck函数这类上下文里使用 keyof,因为在使用之前你并不清楚可能出现的属性名。 但编译器会检查你是否传入了正确的属性名给 pluck

    1. pluck(person, ['age', 'unknown']); // error, 'unknown' is not in 'name' | 'age'

    第二个操作符是 T[K]索引访问操作符。 在这里,类型语法反映了表达式语法。 这意味着 person['name']具有类型 Person['name'] — 在我们的例子里则为 string类型。 然而,就像索引类型查询一样,你可以在普通的上下文里使用 T[K],这正是它的强大所在。 你只要确保类型变量 K extends keyof T就可以了。 例如下面 getProperty函数的例子:

    1. function getProperty<T, K extends keyof T>(o: T, name: K): T[K] {
    2. return o[name]; // o[name] is of type T[K]
    3. }

    getProperty里的 o: Tname: K,意味着 o[name]: T[K]。 当你返回 T[K]的结果,编译器会实例化键的真实类型,因此 getProperty的返回值类型会随着你需要的属性改变。

    1. let name: string = getProperty(person, 'name');
    2. let age: number = getProperty(person, 'age');
    3. let unknown = getProperty(person, 'unknown'); // error, 'unknown' is not in 'name' | 'age'

    索引类型和字符串索引签名

    keyofT[K]与字符串索引签名进行交互。 如果你有一个带有字符串索引签名的类型,那么 keyof T会是 string。 并且 T[string]为索引签名的类型:

    1. interface Map<T> {
    2. [key: string]: T;
    3. }
    4. let keys: keyof Map<number>; // string
    5. let value: Map<number>['foo']; // number

    映射类型

    一个常见的任务是将一个已知的类型每个属性都变为可选的:

    1. interface PersonPartial {
    2. name?: string;
    3. age?: number;
    4. }

    或者我们想要一个只读版本:

    1. interface PersonReadonly {
    2. readonly name: string;
    3. readonly age: number;
    4. }

    这在JavaScript里经常出现,TypeScript提供了从旧类型中创建新类型的一种方式 — 映射类型。 在映射类型里,新类型以相同的形式去转换旧类型里每个属性。 例如,你可以令每个属性成为 readonly类型或可选的。 下面是一些例子:

    1. type Readonly<T> = {
    2. readonly [P in keyof T]: T[P];
    3. }
    4. type Partial<T> = {
    5. [P in keyof T]?: T[P];
    6. }

    像下面这样使用:

    1. type PersonPartial = Partial<Person>;
    2. type ReadonlyPerson = Readonly<Person>;

    下面来看看最简单的映射类型和它的组成部分:

    1. type Keys = 'option1' | 'option2';
    2. type Flags = { [K in Keys]: boolean };

    它的语法与索引签名的语法类型,内部使用了 for .. in。 具有三个部分:

    • 类型变量 K,它会依次绑定到每个属性。
    • 字符串字面量联合的 Keys,它包含了要迭代的属性名的集合。
    • 属性的结果类型。
      在个简单的例子里, Keys是硬编码的的属性名列表并且属性类型永远是 boolean,因此这个映射类型等同于:
    1. type Flags = {
    2. option1: boolean;
    3. option2: boolean;
    4. }

    在真正的应用里,可能不同于上面的 ReadonlyPartial。 它们会基于一些已存在的类型,且按照一定的方式转换字段。 这就是 keyof和索引访问类型要做的事情:

    1. type NullablePerson = { [P in keyof Person]: Person[P] | null }
    2. type PartialPerson = { [P in keyof Person]?: Person[P] }

    但它更有用的地方是可以有一些通用版本。

    1. type Nullable<T> = { [P in keyof T]: T[P] | null }
    2. type Partial<T> = { [P in keyof T]?: T[P] }

    在这些例子里,属性列表是 keyof T且结果类型是 T[P]的变体。 这是使用通用映射类型的一个好模版。 因为这类转换是 同态的,映射只作用于 T的属性而没有其它的。 编译器知道在添加任何新属性之前可以拷贝所有存在的属性修饰符。 例如,假设 Person.name是只读的,那么 Partial<Person>.name也将是只读的且为可选的。

    下面是另一个例子, T[P]被包装在 Proxy<T>类里:

    1. type Proxy<T> = {
    2. get(): T;
    3. set(value: T): void;
    4. }
    5. type Proxify<T> = {
    6. [P in keyof T]: Proxy<T[P]>;
    7. }
    8. function proxify<T>(o: T): Proxify<T> {
    9. // ... wrap proxies ...
    10. }
    11. let proxyProps = proxify(props);

    注意 Readonly<T>Partial<T>用处不小,因此它们与 PickRecord一同被包含进了TypeScript的标准库里:

    1. type Pick<T, K extends keyof T> = {
    2. [P in K]: T[P];
    3. }
    4. type Record<K extends string, T> = {
    5. [P in K]: T;
    6. }

    ReadonlyPartialPick是同态的,但 Record不是。 因为 Record并不需要输入类型来拷贝属性,所以它不属于同态:

    1. type ThreeStringProps = Record<'prop1' | 'prop2' | 'prop3', string>

    非同态类型本质上会创建新的属性,因此它们不会从它处拷贝属性修饰符。

    由映射类型进行推断

    现在你了解了如何包装一个类型的属性,那么接下来就是如何拆包。 其实这也非常容易:

    1. function unproxify<T>(t: Proxify<T>): T {
    2. let result = {} as T;
    3. for (const k in t) {
    4. result[k] = t[k].get();
    5. }
    6. return result;
    7. }
    8. let originalProps = unproxify(proxyProps);

    注意这个拆包推断只适用于同态的映射类型。 如果映射类型不是同态的,那么需要给拆包函数一个明确的类型参数。

    预定义的有条件类型

    TypeScript 2.8在lib.d.ts里增加了一些预定义的有条件类型:

    • Exclude<T, U> — 从T中剔除可以赋值给U的类型。
    • Extract<T, U> — 提取T中可以赋值给U的类型。
    • NonNullable<T> — 从T中剔除nullundefined
    • ReturnType<T> — 获取函数返回值类型。
    • InstanceType<T> — 获取构造函数类型的实例类型。

    示例

    1. type T00 = Exclude<"a" | "b" | "c" | "d", "a" | "c" | "f">; // "b" | "d"
    2. type T01 = Extract<"a" | "b" | "c" | "d", "a" | "c" | "f">; // "a" | "c"
    3. type T02 = Exclude<string | number | (() => void), Function>; // string | number
    4. type T03 = Extract<string | number | (() => void), Function>; // () => void
    5. type T04 = NonNullable<string | number | undefined>; // string | number
    6. type T05 = NonNullable<(() => string) | string[] | null | undefined>; // (() => string) | string[]
    7. function f1(s: string) {
    8. return { a: 1, b: s };
    9. }
    10. class C {
    11. x = 0;
    12. y = 0;
    13. }
    14. type T10 = ReturnType<() => string>; // string
    15. type T11 = ReturnType<(s: string) => void>; // void
    16. type T12 = ReturnType<(<T>() => T)>; // {}
    17. type T13 = ReturnType<(<T extends U, U extends number[]>() => T)>; // number[]
    18. type T14 = ReturnType<typeof f1>; // { a: number, b: string }
    19. type T15 = ReturnType<any>; // any
    20. type T16 = ReturnType<never>; // any
    21. type T17 = ReturnType<string>; // Error
    22. type T18 = ReturnType<Function>; // Error
    23. type T20 = InstanceType<typeof C>; // C
    24. type T21 = InstanceType<any>; // any
    25. type T22 = InstanceType<never>; // any
    26. type T23 = InstanceType<string>; // Error
    27. type T24 = InstanceType<Function>; // Error
    注意:Exclude类型是建议的Diff类型的一种实现。我们使用Exclude这个名字是为了避免破坏已经定义了Diff的代码,并且我们感觉这个名字能更好地表达类型的语义。我们没有增加Omit<T, K>类型,因为它可以很容易的用Pick<T, Exclude<keyof T, K>>来表示。