TS-声明合并

TS声明合并是指将两个或者两个以上的具有相同名称的独立声明合并成一个定义，且该定义具有所合并的声明的所有功能。
TS声明可分为：

• 合并接口声明
• 合并命名空间
• 命名空间和类、函数、枚举合并
• 不可合并部分
• 模态扩展
• 全局扩展

接口声明合并

• 非函数成员接口合并

interface People {
  name: string;
}
interface People {
  age: number
}
//合并后的接口
interface People {
  name: string,
  age: number
}

• 函数成员合并

interface Cloner {
  clone(animal: Animal): Animal;
}

interface Cloner {
  clone(animal: Sheep): Sheep;
}

interface Cloner {
  clone(animal: Dog): Dog;
  clone(animal: Cat): Cat;
}
//合并后的接口
interface Cloner {
  clone(animal: Dog): Dog;
  clone(animal: Cat): Cat;
  clone(animal: Sheep): Sheep;
  clone(animal: Animal): Animal;
}
//注意： 1.合并后接口属性的排序方式：每组接口里的声明顺序保持不变，但各组接口之间的顺序是后来的接口重载出现在靠前位置
2.如果接口的函数参数含有单个字符串文字类型，它将会排到重载列表的顶部

合并命名空间

namespace Animals {
  export class Zebra {}
}

namespace Animals {
  export interface Legged {
    numberOfLegs: number;
  }
  export class Dog {}
}
//合并为
namespace Animals {
  export interface Legged {
    numberOfLegs: number;
  }

  export class Zebra {}
  export class Dog {}
}
//注意：非导出成员仅在其原有的（合并前的）命名空间内可见。
//这就是说合并之后，从其它命名空间合并进来的成员无法访问非导出成员。
namespace Animal {
  let haveMuscles = true;
  export let havename = false;
  export function animalsHaveMuscles() {
    return haveMuscles;
  }
}

namespace Animal {
  export function doAnimalsHaveMuscles() {
    //return haveMuscles; // Error,是不能访问的因为 haveMuscles没被导出
    return havename;// OK，havename被export导出
  }
}

命名空间和类、函数、枚举合并

命名空间和类的合并

class Album {
    label: Album.AlbumLabel; //可访问合并后导出的类
}
namespace Album {
    export class AlbumLabel { }
}

命名空间和函数的合并

function buildLabel(name: string): string {
  return buildLabel.prefix + name + buildLabel.suffix; //可访问合并中的命名空间中的属性
}

namespace buildLabel {
  export let suffix = "";
  export let prefix = "Hello, ";
}

console.log(buildLabel("Sam Smith"));

命名空间和枚举合并

enum Color {
    red = 1,
    green = 2,
    blue = 4
}

namespace Color {
    export function mixColor(colorName: string): number {
        if (colorName == "white") {
            return Color.red + Color.green + Color.blue; //可以访问合并的枚举类型属性
        }
        else if (colorName == "red") {
            return Color.red ;
        }
        else if (colorName == "white") {
            return Color.red + Color.blue;
        }else{
          return 1;
        }
    }
}

不可合并部分

TS中类不能与其他类或变量合并；详细可以参考TypeScript中的Mixins；

模块扩展

js中可在对象原型上拓展现有的属性和方法，TS中可以通过模块扩展来实现

  // observable.ts
export class Observable<T> {
  // ... implementation left as an exercise for the reader ...
}

// map.ts
import { Observable } from "./observable";
declare module "./observable" {
  interface Observable<T> {
    map<U>(f: (x: T) => U): Observable<U>;
  }
}
Observable.prototype.map = function (f) {
  // ... another exercise for the reader
};

// consumer.ts
import { Observable } from "./observable";
import "./map";
let o: Observable<number>;
o.map((x) => x.toFixed());

全局扩展

TS可以从模块内部将声明添加到全局范围：

// observable.ts
export class Observable<T> {
  // ... still no implementation ...
}

declare global {
  interface Array<T> {
    toObservable(): Observable<T>;
  }
}

Array.prototype.toObservable = function () {
  // ...
};
添加后全局可使用Array.prototype.toObservable方法；