JavaScript 如果要替名称加上命名空间,不外乎就是利用对象或是模块来达成。但在 TypeScript 中,有 namespace 关键字可以让我们快速地添加命名空间来用。

namespace 关键字的用法很简单,如下:

namespace 命名空间的名称(可以用句号连接多个名称) {
    程序叙述区块
}

若要将 namespace 程序区块中的名称暴露出来,与模块一样,是在 var、let、const、function、class、interface、enum、type 关键字前加上 export 关键字。当然,namespace 程序区块中也还可以再使用 namespace 关键字来创建程序叙述区块,且 namespace 关键字前也是可以加上 export 关键字来将其暴露的。

例如:

namespace org.magiclen {
    export namespace A {
        export function f() {
            console.log("A");
        }
    }

    export namespace B {
        export function f() {
            console.log("B");
        }
    }

    export namespace AB {
        export function f() {
            A.f();
            B.f();
        }
    }
}

org.magiclen.A.f();
org.magiclen.B.f();
org.magiclen.AB.f();

以上程序的输出结果如下:

A
B
A
B

扩充命名空间

我们可以创建出相同名称的 namespace 程序叙述区块,替已存在的命名空间扩充原本不存在的名称。

例如:

namespace org.magiclen {
    export namespace A {
        export function f() {
            console.log("A");
        }
    }
    export namespace A {
        export function f2() {
            console.log("A");
        }
    }

    export namespace B {
        export function f() {
            console.log("B");
        }
    }

    export namespace AB {
        export function f() {
            A.f();
            B.f();
        }
    }
}

namespace org.magiclen.A {
    export function ff() {
        console.log("AA");
    }
}

namespace org.magiclen {
    export function f() {
        console.log("Hello!");
    }
}

org.magiclen.A.f();
org.magiclen.B.f();
org.magiclen.AB.f();

org.magiclen.A.ff();
org.magiclen.f();

命名空间除了可以拿来扩充同名的命名空间之外,也可以拿来扩充同名的函数、类别、界面、枚举和类型别名下的名称。有点诡异,但十分方便。例如:

type T = number | string;

namespace T {
    export const n = 1;
}

console.log(T.n);

function f() {

}

namespace f {
    export const s = "2";
}

console.log(f.s);

命名空间的网页应用

实际编译以下 TypeScript 程序:

namespace A {
    export function f() {
        console.log("A");
    }
}

会得到这样的 JavaScript 程序:

var A;
(function (A) {
    function f() {
        console.log('A');
    }
    A.f = f;
})(A || (A = {}));

A 命名空间实际上在 JavaScript 中会是一个变量 A。也就是说,利用这样的性质,我们可以很容易地在网页浏览器上透过命名空间产生的变量,来访问这个变量下的名称。

举例来说,现在有以下两个文件:

namespace A {
    export function f() {
        console.log("A");
    }
}
namespace B {
    export function f() {
        console.log("B");
    }
}

以上两个文件虽然都不是 TypeScript 模块(因为最外层并没有使用 export 关键字),但是它们的 f 函数在网页中并不会有冲突,可以透过全域变量 A 和 B 来调用它们。如下:

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8"/>
        <script src="a.js"></script>
        <script src="b.js"></script>
    </head>
    <body>
        <script>
            A.f();
            B.f();
        </script>
    </body>
</html>

总结

至此我们已经把 TypeScript 能够声明的名称类型(变量、常数、函数、类别、界面、枚举、类型别名、模块、命名空间)都学全了。只是有些名称可以当作类型,有些名称可以当作值,有些名称又可以当作命名空间来用,实在很混乱。在此用以下表格做个归纳:

名称类型 命名空间 类型 值 例子
var 否 否 是
var name = "MagicLen";

console.log(name);
let 否 否 是
let name = "MagicLen";

console.log(name);
const 否 否 是
const name = "MagicLen";

console.log(name);
function 否 否 是
function f() {}

console.log(f);
class 否 是 是
class C {}

console.log(C);

let o: C = new C();
interface 否 是 否
interface I {}

class C implements I {}

let o: I = new C();
enum 否 是 是
enum E { // it can not be a const enum
    V
}

console.log(E);

let o: E = E.V;
type 否 是 否
type I = {};

let o: I;
import 是 否 是
import * as fs from "node:fs";

console.log(fs);
namespace 是 否 是
namespace NS {
    export function f() {}
}

NS.f();

在下一个章节中,我们要来学习 TypeScript 的装饰器(Decorator)。

下一章:装饰器(Decorator)。