闭包编译器：--language_in 和--language_out 选项的用途？

Question

Google's Closure Compiler 有以下 CLI 选项：

• --language_in – 设置输入源符合的语言规范。
• --language_out – 设置输出应符合的语言规范。

---

语言

--language_in是什么意思？我认为它是以下之一：

1. 源代码确实符合指定语言的声明/承诺。编译器不会验证它是否存在；它只是相信它确实如此。
2. 用于验证源代码是否符合指定语言的编译器指令。如果没有，编译器会报错。

This documentation 似乎暗示意思#1：

项目可以使用--language_in 标志指定他们打算使用的 Ecmascript 语言版本。

但是，this documentation 表示含义 #2（我假设 language webservice 选项连接到 --language_in CLI 选项）：

language 参数指的是在检查代码中的错误时采用哪个版本的 ECMAScript。

ECMASCRIPT3 – 假设符合 ECMAScript 3 的情况下检查代码，并使用仅存在于 ECMAScript 5 中的功能为代码提供错误。

如果我使用webservice 编译此代码：

// ==ClosureCompiler==
// @output_file_name default.js
// @compilation_level ADVANCED_OPTIMIZATIONS
// @language ECMASCRIPT3
// ==/ClosureCompiler==

var x = Object.freeze({
    y: 3,
    z: 4
});

console.log(x);

它不会给出Object.freeze() doesn't exist in ECMAScript 3 的错误。为什么不呢？

---

外语

同样，--language_out 是什么意思？我认为这意味着：

• 编译器必须生成符合指定语言的输出的指令。

但是如果我编译这段代码：

var x = Object.freeze({
    y: 3,
    z: 4
});

console.log(x);

使用此 CLI 命令，指定 --language_out ECMASCRIPT3:

java -jar compiler.jar \
    --js test.js \
    --js_output_file test.min.js \
    --language_out ECMASCRIPT3 \
    --compilation_level ADVANCED_OPTIMIZATIONS \
    --warning_level VERBOSE \
    --summary_detail_level 3

不会引发错误或警告：

0 error(s), 0 warning(s), 100.0% typed

编译后的代码是：

var a=Object.freeze({y:3,z:4});console.log(a);

所以输出不符合ECMASCRIPT3（因为它包含Object.freeze()）。为什么不呢？

Answer 1

对Object.freeze() 的调用不是句法 错误。编译器无法知道您的代码是否在某个时候扩展了 Object 原型。因此Object.freeze() 是完全有效的 ECMAScript 3 代码。

同样，

var x = {};
x.something();

是完全有效的代码。它会在运行时抛出异常，但不是语法错误。

应该说明这些选项的 ES5 特性是在对象字面量中使用保留字作为属性名称：

var x = { if: "hello world" };

另一个是 getter/setter 初始化器：

var x = { get hello() { return "world"; } };