如何开发出更好的JavaScript模块-创新互联

不少人都曾经在 npm 上发布过自己开发的 JavaScript 模块，而在使用一些模块的过程中，我经常产生“这个模块很有用，但如果能 xxx 就更好了”的想法。所以，本文将站在模块使用者的角度总结一下，如何能让模块变得更好用。

提供 ES6 模块的入口

webpack 和 rollup 都支持对 ES6 模块做一些静态优化（例如 Tree Shaking 和 Scope Hoisting），它们都会优先读取 package.json 中的 module 字段作为 ES6 模块的入口，若没有 module 才会读取 main 字段作为 CommonJS 模块的入口。通常的做法是：使用 ES6 语法编写源码，然后用模块打包工具结合语法转换工具生成 CommonJS 模块和 ES6 模块，这样就可以同时提供 main 和 module 字段了。

提供 TypeScript 的类型声明文件

如果你的用户使用了 TypeScript 但你的模块没有提供声明文件，他们就不得不在项目中添加一段代码避免 TypeScript 的编译错误；另外，这样做并不只是对使用 TypeScript 的用户友好，因为大部分代码编辑器（Webstorm、VS Code 等）都能识别 TypeScript 的类型声明，它们可以据此提供更精准的代码提示并在用户传入错误的参数个数或类型时给出提示。

最好的做法是使用 TypeScript 编写你的模块，编译时会自动生成类型声明。除此之外，你也可以参照文档手动维护一份声明文件。你可以在你的模块根目录下添加 index.d.ts 文件，或者在 package.json 中声明 typings 字段提供声明文件的位置。

让模块同时在 Node.js 与浏览器中运行

你可以通过检测是否有名为 window 的全局变量（例如 !!typeof window）来判断模块当前是运行在 Node.js 还是浏览器中，然后使用不同的方式实现你的功能。

这种方法比较常见，但如果用户使用了模块打包工具，这样做会导致 Node.js 与浏览器的实现方式都会被包含在最终的输出文件中。针对这个问题，开源社区提出了在 package.json 中添加 browser 字段的提议，目前 webpack 和 rollup 都已经支持这个字段了。

browser 字段有两种使用方式：

给 browser 字段提供一个文件路径作为在浏览器端使用时的模块入口，但需要注意的是，打包工具会优先使用 browser 字段指定的文件路径作为模块入口，所以你的 module 字段会被忽略，这会导致打包工具不会优化你的代码。详细信息请参考这个问题。

如果你只想替换其中一些文件，你可以声明一个对象。

举个例子，假设你的模块里有两个文件：http.js 和 xhr.js，第一个文件使用 Node.js 中的 http 模块发起请求，另一个使用浏览器中的 XMLHTTPRequest 实现了同样的功能。为了使用适当的文件，你的模块代码中应该始终 require(‘./path/to/http.js')，并在 package.json 中声明：

{
 "browser": {

  "./path/to/http.js": "./path/to/xhr.js"
 }
}

另外有需要云服务器可以了解下创新互联scvps.cn，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。