Google Closure Compiler 数组的类型注释

Question

在使用 Google Closure Compiler 时，我发现了一种情况，我无法强制编译器对错误的变量类型发出警告。我使用了以下示例：

/** @typedef ({name: string, token: string}) */
var pendingItem;

/** @type (Array.<pendingItem>) */
var pending = [];

// NOTICE: the token is intentionally misspelled as "toke" to cause a warning
var dummyItem = {
  name: 'NameHere',
  toke: 'SomeToken' 
};

// This should cause a warning, because of the 
// type mismatch (toke instead of token)
pending.push(dummyItem);

// Do something useful so that the whole code wouldn't be optimized to 0 bytes
alert(pending.length);

它可以完美编译，而不是给出预期的类型警告。但如果您使用：

pending[1] = {
  name: 'Second Name',
  toke: 'Second Token'
}

您会收到预期的类型不匹配警告。

我知道这可能是因为 push 没有定义类型检查，因为它是一个内置函数。预计将 pending 定义为 pendingItem 数组会强制执行此操作，但默认情况下不会。

问题是是否以及如何向已定义的函数（例如 push）添加类型检查，以便在上面的示例中发出警告。我还了解到，实现类似结果的一种方法是在 dummyItem 之前添加 /** @type {pendingItem} */ 以强制类型，但出于教育目的，我想知道如何向 push 等函数添加类型检查（或者可能对 pending 本身进行更严格的定义）。

还有人可以解释重命名对象属性背后的逻辑是什么吗？如果编译上面的示例，它不会重命名 dummyItem 的属性 name，但会将 token 重命名为 a< /代码>。

Answer 1

要强制对 push 进行类型检查，必须在代码中使用正确的类型重新定义它。请注意，使用对象文字表示法，您必须使用 @type 而不是 @param 来定义类型，因为我们将函数分配给对象的参数，而不是定义功能正常。在这种情况下，它将如下所示：

/** @type {function(pendingItem)} */
pending.push = function(item) {
  Array.prototype.push.call(pending, item);
};

现在，当尝试编译以下内容时：

// Still an intentionally misspelled "toke"
var dummyItem = {
  name: 'NameHere',
  toke: 'SomeToken' 
};

// First warning
pending.push(dummyItem);

// Second warning
pending[1] = {
  name: 'Second name',
  toke: 'Second Token'
};

然后，两者都会生成类型不匹配警告，如预期的那样。

认为它可能对未来的某人有用。