我可以将 Promises 传递给 jQuery.when()，还是只传递 Deferreds？

Question

jQuery.when() 的documentation 表示此函数需要延迟。但是，它后来也说：

如果将单个参数传递给 jQuery.when() 并且它不是 Deferred 或 Promise...

这似乎暗示它也可以接受 Promises。但是 Promise 不是 Deferreds——它们有 Deferred 方法的一个子集。我想你可以说 Deferred 是 Promise，但 Promise 不是 Deferred。

问题：

1. $.when() 可以接受 Promise 或 Deferreds 吗？这似乎在我的测试中有效。
2. 文档中是否存在错误？我认为应该说 $.when() 接受 Promises，而不仅仅是 Deferreds。

Answer 1

文档试图传达的是$.when() 将接受既不是jQuery.Deferred()、jQuery.promise() 也不是Promise 的值；该值将被视为已解析的jQuery.Deferred()，这将在句子的下一部分进行描述

如果将单个参数传递给 jQuery.when() 并且它不是 Deferred 或 Promise，将被视为已解决的 Deferred 和 任何附加的 doneCallbacks 都会立即执行。

例如

$.when(1).then(function(data) {
  alert(data)
})

<script src="https://code.jquery.com/jquery-git.js">
</script>

Answer 2

我想你可以说 Deferred 是 Promise，但 Promise 不是 Deferred。

实际上它们是完全不同的接口，只是将 jQuery 混入了 promise API 到它们的 deferred 中。见What are the differences between Deferred, Promise and Future in JavaScript?

$.when() 可以接受 Promise 或 Deferreds 吗？

是的，两者都可以。但是请注意，当您已经知道有一个 promise 或 deferred 时，调用 $.when 是没有意义的。

文档中有错误吗？

是的，显然。甚至它只是将延迟和承诺视为异步值，这甚至不是事实——而是它进行了某种鸭子类型检查。你会想看看actual implementation：

if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) )

然后它调用该值的promise method（或another promise method，或实际上任何.promise 方法）并期望返回的对象具有相应的可链接方法来添加侦听器。