TypeScript 聲明檔

TypeScript 作為 JavaScript 的超集，在開發過程中不可避免要引用其他第三方的 JavaScript 的庫。雖然通過直接引用可以調用庫的類和方法，但是卻無法使用TypeScript 諸如類型檢查等特性功能。為了解決這個問題，需要將這些庫裏的函數和方法體去掉後只保留導出類型聲明，而產生了一個描述 JavaScript 庫和模組資訊的聲明檔。通過引用這個聲明檔，就可以借用 TypeScript 的各種特性來使用庫檔了。

假如我們想使用第三方庫，比如 jQuery，我們通常這樣獲取一個 id 是 foo 的元素：

$('#foo');
// 或

jQuery('#foo');

但是在 TypeScript 中，我們並不知道 $ 或 jQuery 是什麼東西：

jQuery('#foo');

// index.ts(1,1): error TS2304: Cannot find name 'jQuery'.

這時，我們需要使用 declare 關鍵字來定義它的類型，幫助 TypeScript 判斷我們傳入的參數類型對不對：

declare var jQuery: (selector: string) => any;

jQuery('#foo');

declare 定義的類型只會用於編譯時的檢查，編譯結果中會被刪除。

上例的編譯結果是：

jQuery('#foo');

聲明檔

聲明檔以 .d.ts 為尾碼，例如：

zaixian.d.ts

聲明檔或模組的語法格式如下：

declare module Module_Name {
}

TypeScript 引入聲明檔語法格式：

/// <reference path = " zaixian.d.ts" />

當然，很多流行的第三方庫的聲明檔不需要我們定義了，比如 jQuery 已經有人幫我們定義好了：jQuery in DefinitelyTyped。

實例

以下定義一個第三方庫來演示：

CalcThirdPartyJsLib.js 檔代碼：

var zaixian; (function(zaixian) { var Calc = (function () { function Calc() { } }) Calc.prototype.doSum = function (limit) { var sum = 0; for (var i = 0; i <= limit; i++) { sum = sum + i; } return sum; } zaixian.Calc = Calc; return Calc; })(zaixian || (zaixian = {})); var test = new zaixian.Calc();

如果我們想在 TypeScript 中引用上面的代碼，則需要設置聲明檔 Calc.d.ts，代碼如下：

Calc.d.ts 檔代碼：

declare module zaixian { export class Calc { doSum(limit:number) : number; } }

聲明檔不包含實現，它只是類型聲明，把聲明檔加入到 TypeScript 中：

CalcTest.ts 檔代碼：

/// <reference path = "Calc.d.ts" /> var obj = new zaixian.Calc(); // obj.doSum("Hello"); // 編譯錯誤 console.log(obj.doSum(10));

下麵這行導致編譯錯誤，因為我們需要傳入數字參數：

obj.doSum("Hello");

使用 tsc 命令來編譯以上代碼檔：

tsc CalcTest.ts

生成的 JavaScript 代碼如下：

CalcTest.js 檔代碼：

/// <reference path = "Calc.d.ts" /> var obj = new zaixian.Calc(); //obj.doSum("Hello"); // 編譯錯誤 console.log(obj.doSum(10));

最後我們編寫一個 zaixian.html 檔，引入 CalcTest.js 檔及第三方庫 CalcThirdPartyJsLib.js：

實例

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>IT研修(xuhuhu.com)</title> <script src = "CalcThirdPartyJsLib.js"></script> <script src = "CalcTest.js"></script> </head> <body> <h1>聲明檔測試</h1> <p>線上測試一下。</p> </body> </html>
流覽器打開該檔輸出結果如下：