在確保我們創(chuàng)建的變量不會(huì)泄露至全局變量中,我們以前曾采用過(guò)這種代碼組織形式:
(function(someObj){
someObj.age = 18;
})(someObj || someObj = {});
但在基于文件模塊的項(xiàng)目中,我們無(wú)須擔(dān)心這一點(diǎn),此種方式,適合用于合理的函數(shù)邏輯分組中,在 TypeScript 中,提供了 namespace 關(guān)鍵字來(lái)描述這種分組,在 typescript 編譯器進(jìn)行編譯過(guò)后,命名空間也就被編譯成了上述示例那樣的代碼。
命名空間的聲明
TypeScript 的命名空間只對(duì)外暴露需要在外部訪問(wèn)的對(duì)象,命名空間內(nèi)的對(duì)象通過(guò) export 關(guān)鍵字對(duì)外暴露,比如我們?cè)谝粋€(gè)名叫 utils.ts 的文件里聲明一個(gè)命名空間:
// utils.ts
namespace Utils {
export interface IPerson {
name: string;
age: number;
}
}
命名空間的使用
通過(guò) namespace 關(guān)鍵字聲明命名空間,在命名空間外部需要通過(guò)完全限定名訪問(wèn)這些對(duì)象,通常情況下,聲明的命名空間代碼和調(diào)用的代碼不在同一個(gè)文件里,因此在其他文件中使用,注意引入的路徑要寫正確,此處我們?cè)谕?jí)目錄中任意一個(gè) ts 文件中使用我們剛定義的命名空間:
/// <reference path="utils.ts" />
const me: Utils.IPerson = {
name: 'funlee',
age: 18
}
console.log(me); // {name: 'funlee', age: 18}
如上述代碼所示,通過(guò) reference 注釋引用命名空間,即可通過(guò)完全限定名進(jìn)行訪問(wèn),我們也可以通過(guò) import 導(dǎo)入模塊的形式,引入命名空間:
import './utils'
const me: Utils.IPerson = {
name: 'funlee',
age: 18
}
console.log(me); // {name: 'funlee', age: 18}
多文件的命名空間
就像普通的 JS 模塊文件可以相互引用一樣,包含 namespace 的命名空間文件也可以相互引入,還可以組合成一個(gè)更大的命名空間,下面是一個(gè)簡(jiǎn)單的示例,所有文件都在同一目錄下,你也可參考官方示例:
utils.ts
namespace Utils {
export interface IAnimal {
name: string;
say(): void;
}
}
animal.ts
/// <reference path="utils.ts" />
export namespace Animal {
export class Dog implements Utils.IAnimal{
name: string;
constructor(theName: string) {
this.name = theName;
}
say() {
console.log(`${this.name}: 汪汪汪`)
}
}
}
index.ts
import {Animal} from './animal';
const he = new Animal.Dog('Jack');
he.say(); // Jack: 汪汪汪