javascript - 如何在 Closure Compiler 中将 node_modules 定义为 extern？

Question

我有一个想要使用 Closure Compiler 编译的 Node.js 项目。我不希望它在浏览器中运行/使用 browserify。我主要想要类型检查的实用程序。我最初使用以下方法使编译器正常工作:

java -jar compiler.jar -W VERBOSE 
                       --language_in ECMASCRIPT5_STRICT 
                       --externs closure-externs.js 
                       --js="lib/**.js"

closure-externs.js 手动定义了我在 Node.js 中以相当粗略的方式使用的变量和函数:

// closure-externs.js

/** @constructor */function Buffer(something){}
function require(path){}
var process = {};
[...]

事实证明，这只能靠运气。文件之间没有依赖跟踪，因此您可能会遇到返回类型 {Foo} 并且编译器会提示它不存在的情况(取决于机器，取决于编译顺序)。然后我发现我做错了，应该使用 --process_common_js_modules 所以编译器会在我 require("foo") 的地方进行依赖跟踪。我目前正在像这样调用编译器:

java -jar compiler.jar -W VERBOSE 
                       --language_in ECMASCRIPT5_STRICT 
                       --externs externs/fs.js 
                       --js="lib/**.js"
                       --process_common_js_modules 
                       --common_js_entry_module app.js

但这失败了:

 ERROR - required entry point "module$crypto" never provided
 ERROR - required entry point "module$dgram" never provided
 ERROR - required entry point "module$extend" never provided
 ERROR - required entry point "module$fs" never provided
 ERROR - required entry point "module$net" never provided
 ERROR - required entry point "module$q" never provided

其中一些模块是 Node.js 的原生模块(例如 fs)，而其他模块则包含在 node_modules 中，例如 q。我不想通过编译器运行这些外部模块，所以我知道我需要为它们设置 externs 文件。我知道有https://github.com/dcodeIO/node.js-closure-compiler-externs对于常见的 Node.js externs，我知道如何在编译器上调用它们，但是由于某种原因，当我执行类似 --externs externs/fs.js 之类的操作时，module$ 的错误fs 仍然存在。我做错了什么？

我知道还有其他标志，例如 --module 和 --common_js_module_path_prefix 但我不确定是否需要使用它们才能使其正常工作。我的 Google-fu 在这里没有找到任何关于正确咒语的答案。 :(

Answer 1

问题是您希望编译器以某种方式识别某些 require 调用是内部的，即编译器应将所需的模块作为源来处理，而其他模块是外部的，因此应该是留下一个。目前没有很好的方法来处理这种情况。

解决方法

使用后处理添加外部需求语句

在这种情况下，您将完全省略对外部模块的任何 require 语句。编译器只会处理带有内部 require 语句和模块的代码。编译后，您将在外部 require 语句之前添加:

要前置的 header JS

var crypto = require('crypto');

待编译源码

console.log(crypto);

因为 crypto 是在 extern 中声明的，所以编译器会正确识别类型和符号名称。

别名需要调用

当指定 --process_common_js_modules 时，编译器会识别 require 语句并以与宏在其他语言中的工作方式类似的方式扩展它们。通过为应该保留在外部的 require 语句起别名，编译器将无法识别它们，因此不会扩展它们。

待编译源码

var externalRequire = require;
/** @suppress {duplicate} this is already defined in externs */
var crypto = externalRequire('crypto');
console.log(crypto)