如何在Closure Compiler中将node_modules定义为externs？

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因此编译器将在I进行依赖项跟踪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_moduleslike中q。我不想通过编译器运行这些外部模块，所以我知道我需要externs为它们设置文件。我知道对于常见的Node.js
externs 有https://github.com/dcodeIO/node.js-closure-compiler-
externs，我知道如何在编译器上调用它们，但是由于某些原因，当我执行类似操作时--externs externs/fs.js错误module$fs仍然存在。我究竟做错了什么？

我知道还有其他类似的标志--module，--common_js_module_path_prefix但是我不确定是否需要使用它们来使它正常工作。我的Google-
fu无法在此处针对正确的咒语提出任何答案。:(

Answer 1

问题是您希望编译器以某种方式认识到某些require调用是内部的，即所需的模块应由编译器作为源进行处理，而其他模块是外部的，因此应单独放置。当前没有一个很好的方法来处理这种情况。

使用后处理添加外部Require语句

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

标头JS将被添加

var crypto = require('crypto');

源代码要编译

console.log(crypto);

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

别名需要通话

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

源代码要编译

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