小白教程
所有教程
关于
Search
172.70.178.11
172.70.178.11
参数设置
贡献
退出
操作
编辑
移动
保护
信息
历史
删除
查看“TypeScript 声明文件”的源代码
本页内容
上一节:
TypeScript_模块
下一节:
TypeScript_测验
因为以下原因,您没有权限编辑本页:
您请求的操作仅限属于该用户组的用户执行:
用户
您可以查看和复制此页面的源代码。
{{DISPLAYTITLE:TypeScript 声明文件}}[[Category:TypeScript 教程|21]] = TypeScript 声明文件 = TypeScript 作为 JavaScript 的超集,在开发过程中不可避免要引用其他第三方的 JavaScript 的库。虽然通过直接引用可以调用库的类和方法,但是却无法使用TypeScript 诸如类型检查等特性功能。为了解决这个问题,需要将这些库里的函数和方法体去掉后只保留导出类型声明,而产生了一个描述 JavaScript 库和模块信息的声明文件。通过引用这个声明文件,就可以借用 TypeScript 的各种特性来使用库文件了。 假如我们想使用第三方库,比如 jQuery,我们通常这样获取一个 id 是 foo 的元素: <pre>$('#foo'); // 或 jQuery('#foo');</pre> 但是在 TypeScript 中,我们并不知道 $ 或 jQuery 是什么东西: <pre>jQuery('#foo'); // index.ts(1,1): error TS2304: Cannot find name 'jQuery'.</pre> 这时,我们需要使用 declare 关键字来定义它的类型,帮助 TypeScript 判断我们传入的参数类型对不对: <pre>declare var jQuery: (selector: string) => any; jQuery('#foo');</pre> declare 定义的类型只会用于编译时的检查,编译结果中会被删除。 上例的编译结果是: <pre>jQuery('#foo');</pre> === 声明文件 === 声明文件以 .d.ts 为后缀,例如: <pre>xiaobai.d.ts</pre> 声明文件或模块的语法格式如下: <pre>declare module Module_Name { }</pre> TypeScript 引入声明文件语法格式: <pre>/// <reference path = " xiaobai.d.ts" /></pre> 当然,很多流行的第三方库的声明文件不需要我们定义了,比如 jQuery 已经有人帮我们定义好了:[https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/jquery/index.d.ts jQuery in DefinitelyTyped]。 == 以下定义一个第三方库来演示: == CalcThirdPartyJsLib.js 文件代码: == <sample title="" desc="" lang="typescript" hererun="1"> var xiaoBai; (function(xiaoBai) { 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; } xiaoBai.Calc = Calc; return Calc; })(xiaoBai || (xiaoBai = {})); var test = new xiaoBai.Calc(); </sample> 如果我们想在 TypeScript 中引用上面的代码,则需要设置声明文件 Calc.d.ts,代码如下: == Calc.d.ts 文件代码: == <sample title="" desc="" lang="typescript" hererun="1"> declare module xiaoBai { export class Calc { doSum(limit:number) : number; } } </sample> 声明文件不包含实现,它只是类型声明,把声明文件加入到 TypeScript 中: == CalcTest.ts 文件代码: == <sample title="" desc="" lang="typescript" hererun="1"> /// <reference path = "Calc.d.ts" /> var obj = new xiaoBai.Calc(); // obj.doSum("Hello"); // 编译错误 console.log(obj.doSum(10)); </sample> 下面这行导致编译错误,因为我们需要传入数字参数: <pre>obj.doSum("Hello");</pre> 使用 tsc 命令来编译以上代码文件: <pre>tsc CalcTest.ts</pre> 生成的 JavaScript 代码如下: == CalcTest.js 文件代码: == <sample title="" desc="" lang="typescript" hererun="1"> /// <reference path = "Calc.d.ts" /> var obj = new xiaoBai.Calc(); //obj.doSum("Hello"); // 编译错误 console.log(obj.doSum(10)); </sample> 最后我们编写一个 xiaobai.html 文件,引入 CalcTest.js 文件及第三方库 CalcThirdPartyJsLib.js: <sample title="" desc="" lang="typescript" hererun="1"> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>小白教程(xiaobai.wang)</title> <script src = "CalcThirdPartyJsLib.js"></script> <script src = "CalcTest.js"></script> </head> <body> <h1>声明文件测试</h1> <p>菜鸟测试一下。</p> </body> </html> </sample> 浏览器打开该文件输出结果如下:
返回至“
TypeScript 声明文件
”。
上一节:
TypeScript_模块
下一节:
TypeScript_测验