声明文件


这篇指南的目的是教你如何书写高质量的TypeScript声明文件。

在这篇指南里,我们假设你对TypeScript已经有了基本的了解。
如果没有,请先阅读TypeScript手册
来了解一些基本知识,尤其是类型和命名空间部分。

章节

这篇指南被分成了以下章节。

结构

结构一节将帮助你了解常见库的格式以及如何为每种格式书写正确的声明文件。
如果你在编辑一个已经存在的文件,那么你可能不需要阅读此章节。
如果你在书写新的声明文件,那么你必须阅读此章节以理解库的不同格式是如何影响声明文件的书写的。

举例

很多时候,我们只能通过一些示例来了解第三方库是如何工作的,同时我们需要为这样的库书写声明文件。
举例一节展示了很多常见的API模式以及如何为它们书写声明文件。
这篇指南是针对TypeScript初学者的,它们可能还不了解TypeScript里的所有语言结构。

Js中文网 – 前端进阶资源分享 www.javascriptC.com,typescript 中文文档
一个帮助开发者成长的社区,你想要的,在这里都能找到

规范

声明文件里有很多常见的错误是很容易避免的。
规范一节指出了常见的错误,
描述了如何发现它们,
与怎样去修复。
每个人都要阅读这个章节以了解如何避免常见错误。

深入

对于那些对声明文件底层工作机制感兴趣的老手们,
深入一节解释了很多高级书写声明文件的高级概念,
以及展示了如何利用这些概念来创建整洁和直观的声明文件。

模版

模版一节里,你能找到一些声明文件,它们可以帮助你快速开始
当你在书写一个新声明文件的时候。
参考结构这篇文档来找到应该使用哪个模版文件。

发布到npm

发布一节讲解了如何发布声明文件为npm包,及如何管理包的依赖。

查找与安装声明文件

对于JavaScript库的使用者来讲,使用一节提供了一些简单步骤来定位与安装相应的声明文件。

看完两件小事

如果你觉得这篇文章对你挺有启发,我想请你帮我两个小忙:

  1. 关注我们的 GitHub 博客,让我们成为长期关系
  2. 把这篇文章分享给你的朋友 / 交流群,让更多的人看到,一起进步,一起成长!
  3. 关注公众号 「IT平头哥联盟」,公众号后台回复「资源」 免费领取我精心整理的前端进阶资源教程

JS中文网是中国领先的新一代开发者社区和专业的技术媒体,一个帮助开发者成长的社区,目前已经覆盖和服务了超过 300 万开发者,你每天都可以在这里找到技术世界的头条内容。欢迎热爱技术的你一起加入交流与学习,JS中文网的使命是帮助开发者用代码改变世界