¿Qué hace $ .when.apply ($, someArray)?

Estoy leyendo sobre diferidos y promesas y sigo encontrándome $.when.apply($, someArray). No tengo claro qué hace esto exactamente, buscando una explicación de que una línea funciona exactamente (no todo el fragmento de código). Aquí hay algo de contexto:

var data = [1,2,3,4]; // the ids coming back from serviceA
var processItemsDeferred = [];

for(var i = 0; i < data.length; i++){
  processItemsDeferred.push(processItem(data[i]));
}

$.when.apply($, processItemsDeferred).then(everythingDone); 

function processItem(data) {
  var dfd = $.Deferred();
  console.log('called processItem');

  //in the real world, this would probably make an AJAX call.
  setTimeout(function() { dfd.resolve() }, 2000);    

  return dfd.promise();
}

function everythingDone(){
  console.log('processed all items');
}

.applyse usa para llamar a una función con una matriz de argumentos. Toma cada elemento de la matriz y usa cada uno como parámetro de la función. .applytambién puede cambiar el contexto ( this) dentro de una función.

Entonces, tomemos $.when. Se usa para decir "cuando todas estas promesas se resuelvan ... haz algo". Requiere un número infinito (variable) de parámetros.

En su caso, tiene una serie de promesas; no sabe a cuántos parámetros está pasando $.when. Pasar la matriz en sí a $.whenno funcionaría, porque espera que sus parámetros sean promesas, no una matriz.

Ahí es donde .applyentra en juego . Toma la matriz y llama $.whencon cada elemento como parámetro (y se asegura de que thisesté configurado en jQuery/ $), entonces todo funciona :-)

$ .when toma cualquier número de parámetros y se resuelve cuando todos se han resuelto.

anyFunction .apply (thisValue, arrayParameters) llama a la función anyFunction configurando su contexto (thisValue será el this dentro de esa llamada de función) y pasa todos los objetos en arrayParameters como parámetros individuales.

Por ejemplo:

$.when.apply($, [def1, def2])

Es lo mismo que:

$.when(def1, def2)

Pero la aplican forma de llamar le permite pasar una matriz de número desconocido de parámetros. (En su código, está diciendo que sus datos provienen de un servicio, entonces esa es la única forma de llamar a $ .when )

Aquí, el código completamente documentado.

// 1. Declare an array of 4 elements
var data = [1,2,3,4]; // the ids coming back from serviceA
// 2. Declare an array of Deferred objects
var processItemsDeferred = [];

// 3. For each element of data, create a Deferred push push it to the array
for(var i = 0; i < data.length; i++){
  processItemsDeferred.push(processItem(data[i]));
}

// 4. WHEN ALL Deferred objects in the array are resolved THEN call the function
//    Note : same as $.when(processItemsDeferred[0], processItemsDeferred[1], ...).then(everythingDone);
$.when.apply($, processItemsDeferred).then(everythingDone); 

// 3.1. Function called by the loop to create a Deferred object (data is numeric)
function processItem(data) {
  // 3.1.1. Create the Deferred object and output some debug
  var dfd = $.Deferred();
  console.log('called processItem');

  // 3.1.2. After some timeout, resolve the current Deferred
  //in the real world, this would probably make an AJAX call.
  setTimeout(function() { dfd.resolve() }, 2000);    

  // 3.1.3. Return that Deferred (to be inserted into the array)
  return dfd.promise();
}

// 4.1. Function called when all deferred are resolved
function everythingDone(){
  // 4.1.1. Do some debug trace
  console.log('processed all items');
}

Lamentablemente no puedo estar de acuerdo con ustedes.

$.when.apply($, processItemsDeferred).always(everythingDone);

Llamará everythingDonetan pronto como se rechace uno de los aplazados , incluso si hay otros aplazados pendientes .

Aquí está el script completo (recomiendo http://jsfiddle.net/ ):

var data = [1,2,3,4]; // the ids coming back from serviceA
var processItemsDeferred = [];

for(var i = 0; i < data.length; i++){
  processItemsDeferred.push(processItem(data[i]));
}

processItemsDeferred.push($.Deferred().reject());
//processItemsDeferred.push($.Deferred().resolve());

$.when.apply($, processItemsDeferred).always(everythingDone); 

function processItem(data) {
  var dfd = $.Deferred();
  console.log('called processItem');

  //in the real world, this would probably make an AJAX call.
  setTimeout(function() { dfd.resolve(); }, 2000);    

  return dfd.promise();
}

function everythingDone(){
  alert('processed all items');
}

¿Es esto un error? Me gustaría usar esto como lo describió el caballero arriba.

Quizás alguien pueda encontrar esto útil:

$.when.apply($, processItemsDeferred).then(everythingDone).fail(noGood);

EverythingDone no se llama en caso de rechazo

$ .when solo hace posible que se llame a una devolución de llamada cuando todas las promesas que se le pasan se resuelven / rechazan. Normalmente, $ .cuando toma un número variable de argumentos, usar .apply hace posible pasarle una matriz de argumentos, es muy poderoso. Para obtener más información sobre .apply: https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Function/apply

Gracias por tu elegante solución:

var promise;

for(var i = 0; i < data.length; i++){
  promise = $.when(promise, processItem(data[i]));
}

promise.then(everythingDone);

Solo un punto: cuando se usa resolveWithpara obtener algunos parámetros, se rompe debido a la promesa inicial establecida en indefinida. Lo que hice para que funcionara:

// Start with an empty resolved promise - undefined does the same thing!
var promise;

for(var i = 0; i < data.length; i++){
  if(i==0) promise = processItem(data[i]);
  else promise = $.when(promise, processItem(data[i]));
}

promise.then(everythingDone);