Array.observe()

El método Array.observe() se utiliza para poder observar en forma asincrónica los cambios ocurridos en un vector, similar a Object.observe() para los objetos. Provee un flujo ordenado por orden de ocurrencia de los cambios ocurridos en el vector. Es equivalente a invocar Object.observe() con la lista de tipos aceptados: ["add", "update", "delete", "splice"].

Array.observe(arr, callback)

arr

El vector a ser observado.

callback

La función invocada con cada cambio dentro del vector con el siguiente argumento:

changes

Un vector de objetos, cada uno representando un cambio. Las propiedades de estos objetos son:

• name: El nombre de la propiedad que ha cambiado.
• object: El vector modificado, despues de la modificación.
• type: Una cadena de caracteres indicando el tipo de cambio que ocurrió. Estos tipos son: "add", "update", "delete", o "splice".
• oldValue: El valor antes de ser modificado. Solo para  los tipos "update" o "delete".
• index: La posición del vector en la que ocurrio el cambio. Sólo para el tipo "splice".
• removed: Un vector con los elementos borrados. Sólo para el tipo "splice".
• addedCount: La cantidad de elementos agregados. Sólo para el tipo "splice".

La función callback es invocada cada vez que ocurre un cambio en el vector, recibiendo como parámetro, un vector con todos los cambios ocurridos en el orden en que estos fueron realizados.

var arr = ['a', 'b', 'c'];

Array.observe(arr, function(changes) {
  console.log(changes);
});

arr[1] = 'B';
// [{type: 'update', object: <arr>, name: '1', oldValue: 'b'}]

arr[3] = 'd';
// [{type: 'splice', object: <arr>, index: 3, removed: [], addedCount: 1}]

arr.splice(1, 2, 'beta', 'gamma', 'delta');
// [{type: 'splice', object: <arr>, index: 1, removed: ['B', 'c', 'd'], addedCount: 3}]

Strawman proposal for ECMAScript 7.

• Under what condition would Array.observe's “add” event trigger?
• Array.unobserve()
• Object.observe()