--- title: Array.prototype.values() slug: Web/JavaScript/Reference/Global_Objects/Array/values tags: - Array - ECMAScript 2015 - JavaScript - Ітератор - Масив - метод - прототип translation_of: Web/JavaScript/Reference/Global_Objects/Array/values ---
{{JSRef}}

Метод values() повертає новий об'єкт ітератора масиву (Array Iterator), який містить значення кожного елемента масиву.

{{EmbedInteractiveExample("pages/js/array-values.html")}}

var a = ['a', 'б', 'в', 'г', 'ґ'];
var iterator = a.values();

console.log(iterator.next().value); // а
console.log(iterator.next().value); // б
console.log(iterator.next().value); // в
console.log(iterator.next().value); // г
console.log(iterator.next().value); // ґ

Синтаксис

arr.values()

Значення, що повертається

Новий об'єкт ітератора масиву.

Приклади

Перебір за допомогою циклу for...of

var arr = ['а', 'б', 'в', 'г', 'ґ'];
var iterator = arr.values();

for (let letter of iterator) {
  console.log(letter);
}

Array.prototype.values є реалізацією за замовчуванням для Array.prototype[Symbol.iterator].

Array.prototype.values === Array.prototype[Symbol.iterator]      //true

TODO: please write about why we need it, use cases.

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

Специфікація Статус Коментар
{{SpecName('ES2015', '#sec-array.prototype.values', 'Array.prototype.values')}} {{Spec2('ES2015')}} Початкове визначення.
{{SpecName('ESDraft', '#sec-array.prototype.values', 'Array.prototype.values')}} {{Spec2('ESDraft')}}

Сумісність з веб-переглядачами

{{Compat("javascript.builtins.Array.values")}}

Див. також