Array.observe()

Сводка

Метод Array.observe() используется для асинхронного обзора изменений в массивах, подобно тому, как метод Object.observe() используется для тех же целей для объектов. Он предоставляет поток изменений в порядке их возникновения.

Синтаксис

Array.observe(arr, callback)

Параметры

arr
Обозреваемый массив.
callback
Функция, вызываемая на каждое сделанное изменение со следующими аргументами:
changes
Массив объектов, каждый из которых представляет одно изменение. Эти объекты обладают следующими свойствами:
  • name: название изменённого свойства.
  • object: изменённый массив, после применения этого изменения.
  • type: строка, указывающая тип произошедшего изменения. Может быть одной из "add", "update", "delete" или "splice".
  • oldValue: только для типов "update" и "delete". Значение до изменения.
  • index: только для типа "splice". Индекс, по которому произошло изменение.
  • removed: только для типа "splice". Массив с удалёнными элементами.
  • addedCount: только для типа "splice". Количество добавленных элементов.

Описание

Функция callback вызывается каждый раз, когда с массивом arr происходят какие-либо изменения. Параметром в неё передаётся массив со всеми произошедшими изменениями в порядке их возникновения.

Изменения через методы объекта Array, например, посредством метода Array.prototype.pop(), будут зарегистрированы как изменения типа "splice". Присваивание по индексу, в результате которого размер массива не изменится, может быть зарегистрировано, как изменение типа "update".

Примеры

Пример: журналирование всех трёх типов событий

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}]

Спецификации

Черновое предложение к обсуждению для ECMAScript 7.

Совместимость с браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка 36 Нет Нет Нет Нет
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка Нет (Да) Нет Нет Нет Нет

Смотрите также

Связанные темы
  1. Стандартные встроенные объекты
  2. Array
  3. Свойства
    1. Array.length
    2. Array.prototype
    3. Array.prototype[@@unscopables]
  4. Методы
    1. Array.from()
    2. Array.isArray()
    3. Array.observe()
    4. Array.of()
    5. Array.prototype.concat()
    6. Array.prototype.copyWithin()
    7. Array.prototype.entries()
    8. Array.prototype.every()
    9. Array.prototype.fill()
    10. Array.prototype.filter()
    11. Array.prototype.find()
    12. Array.prototype.findIndex()
    13. Array.prototype.flat()
    14. Array.prototype.flatMap()
    15. Array.prototype.forEach()
    16. Array.prototype.includes()
    17. Array.prototype.indexOf()
    18. Array.prototype.join()
    19. Array.prototype.keys()
    20. Array.prototype.lastIndexOf()
    21. Array.prototype.map()
    22. Array.prototype.pop()
    23. Array.prototype.push()
    24. Array.prototype.reduce()
    25. Array.prototype.reduceRight()
    26. Array.prototype.reverse()
    27. Array.prototype.shift()
    28. Array.prototype.slice()
    29. Array.prototype.some()
    30. Array.prototype.sort()
    31. Array.prototype.splice()
    32. Array.prototype.toLocaleString()
    33. Array.prototype.toSource()
    34. Array.prototype.toString()
    35. Array.prototype.unshift()
    36. Array.prototype.values()
    37. Array.prototype[@@iterator]()
    38. Array.unobserve() [Перевести]
    39. get Array[@@species]
  5. Наследование:
  6. Function
  7. Свойства
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  8. Методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Свойства
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Методы
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()