Могу ли я передать обещания jQuery.when() или только отложить?

Question

documentation для jQuery.when() говорит, что эта функция принимает Отсрочки. Тем не менее, он также говорит о том, что позже:

Если один аргумент передается jQuery.when(), и это не Отложенный или Promise ...

, который, кажется, подразумевает, что он также может принимать Обещания. Но обещания не откладываются - у них есть подмножество методов Отсрочки. Думаю, вы могли бы сказать, что Отсрочка - это обещание, но обещание не отложено.

Вопросы:

1. Может $ .when() принимает либо посылы или Deferreds? Кажется, это работает в моем тестировании.
2. Есть ли ошибка в документе? Я думаю, он должен сказать, что $ .when() берет Обещания, а не только Отсрочки.

Answer 1

Что документация пытается передать то, что $.when() будет принимать значение, которое не является ни jQuery.Deferred(), jQuery.promise() ни Promise; значение будет рассматриваться как разрешенный jQuery.Deferred(), который описан в следующей части предложений

Если один аргумент передается jQuery.when() и это не будущими периодами или обещание, это будет рассматриваться как разрешенные Отложенные и любые прикрепленные файлы doneCallbacks будут выполнены немедленно.

Например

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

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

Answer 2

Я думаю, вы могли бы сказать, что Отложенный это обещание, но обещание не Отложенный.

На самом деле это совершенно разные интерфейсы, только jQuery смешивается в API обещаний с их отсрочкой. См. What are the differences between Deferred, Promise and Future in JavaScript?

Может ли $.when() выполнить обещания или отложить?

Да, это может быть и то, и другое. Но обратите внимание, что, когда вы уже знаете, что имеете обещание или отложенный, нет смысла звонить на него $.when.

Есть ли ошибка в документе?

Да, очевидно. И это даже не правда, что он рассматривает только отсрочки и обещания как асинхронные ценности - скорее, это делает какую-то проверку на утиную печать.Вы хотите, чтобы взглянуть на actual implementation:

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

Затем он вызывает promise method (или another promise method, или действительно любой .promise метод) на значение и ожидает, что возвращаемый объект, чтобы иметь соответствующие змеевидных методы для добавления слушатели.