ts 声明合并

239 阅读3分钟

合并接口

interface Box { height: number; width: number; } 
interface Box { scale: number; } 
let box: Box = {height: 5, width: 6, scale: 10};

接口的非函数的成员应该是唯一的。如果它们不是唯一的,那么它们必须是相同的类型。如果两个接口中同时声明了同名的非函数成员且它们的类型不同,则编译器会报错。

对于函数成员,每个同名函数声明都会被当成这个函数的一个重载。 同时需要注意,当接口 A与后来的接口 A合并时,后面的接口具有更高的优先级

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; 
}

注意每组接口里的声明顺序保持不变,但各组接口之间的顺序是后来的接口重载出现在靠前位置。

这个规则有一个例外是当出现特殊的函数签名时。 如果签名里有一个参数的类型是 单一的字符串字面量(比如,不是字符串字面量的联合类型),那么它将会被提升到重载列表的最顶端。

interface Document { 
    createElement(tagName: any): Element; 
} 
interface Document { 
    createElement(tagName: "div"): HTMLDivElement; 
    createElement(tagName: "span"): HTMLSpanElement; 
} 
interface Document { 
    createElement(tagName: string): HTMLElement; 
    createElement(tagName: "canvas"): HTMLCanvasElement; 
}
// 合并后
interface Document { 
    createElement(tagName: "canvas"): HTMLCanvasElement; 
    createElement(tagName: "div"): HTMLDivElement; 
    createElement(tagName: "span"): HTMLSpanElement; 
    createElement(tagName: string): HTMLElement; 
    createElement(tagName: any): Element; 
}

命名空间合并

对于命名空间的合并,模块导出的同名接口进行合并,构成单一命名空间内含合并后的接口。

对于命名空间里值的合并,如果当前已经存在给定名字的命名空间,那么后来的命名空间的导出成员会被加到已经存在的那个模块里。

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 function animalsHaveMuscles() { 
        return haveMuscles; 
    } 
} 
namespace Animal { 
    export function doAnimalsHaveMuscles() { 
        return haveMuscles; // Error, because haveMuscles is not accessible here 
    }
}

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

合并命名空间和类

class Album { 
    label: Album.AlbumLabel; 
}
namespace Album { 
    export class AlbumLabel { } 
}

合并规则与上面 合并命名空间小节里讲的规则一致,我们必须导出 AlbumLabel类,好让合并的类能访问。 合并结果是一个类并带有一个内部类。 你也可以使用命名空间为类增加一些静态属性。

除了内部类的模式,你在JavaScript里,创建一个函数稍后扩展它增加一些属性也是很常见的。 TypeScript使用声明合并来达到这个目的并保证类型安全。

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) {
        if (colorName == "yellow") {
            return Color.red + Color.green;
        }
        else if (colorName == "white") {
            return Color.red + Color.green + Color.blue;
        }
        else if (colorName == "magenta") {
            return Color.red + Color.blue;
        }
        else if (colorName == "cyan") {
            return Color.green + Color.blue;
        }
    }
}

非法合并

类不能与其它类或变量合并