aboutsummaryrefslogtreecommitdiff
path: root/files/uk/web/javascript/reference/global_objects/array/values/index.html
blob: 8df5438b95ef0b9397a2523e8ad93d9e0d283f89 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
---
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
---
<div>{{JSRef}}</div>

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

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

<pre class="brush: js">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); // ґ</pre>

<h2 id="Синтаксис">Синтаксис</h2>

<pre class="syntaxbox"><var>arr</var>.values()</pre>

<h3 id="Значення_що_повертається">Значення, що повертається</h3>

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

<h2 id="Приклади">Приклади</h2>

<h3 id="Перебір_за_допомогою_циклу_for...of">Перебір за допомогою циклу <code><a href="/uk/docs/Web/JavaScript/Reference/Statements/for...of">for...of</a></code></h3>

<pre class="brush: js">var arr = ['а', 'б', 'в', 'г', 'ґ'];
var iterator = arr.values();

for (let letter of iterator) {
  console.log(letter);
}
</pre>

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

<pre class="brush: js">Array.prototype.values === Array.prototype[Symbol.iterator]      //true</pre>

<p><strong>TODO</strong>: please write about why we need it, use cases.</p>

<h2 id="Специфікації">Специфікації</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Специфікація</th>
   <th scope="col">Статус</th>
   <th scope="col">Коментар</th>
  </tr>
  <tr>
   <td>{{SpecName('ES2015', '#sec-array.prototype.values', 'Array.prototype.values')}}</td>
   <td>{{Spec2('ES2015')}}</td>
   <td>Початкове визначення.</td>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-array.prototype.values', 'Array.prototype.values')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2>

<div>


<p>{{Compat("javascript.builtins.Array.values")}}</p>
</div>

<h2 id="Див._також">Див. також</h2>

<ul>
 <li>{{jsxref("Array.prototype.keys()")}}</li>
 <li>{{jsxref("Array.prototype.entries()")}}</li>
 <li>{{jsxref("Array.prototype.forEach()")}}</li>
 <li>{{jsxref("Array.prototype.every()")}}</li>
 <li>{{jsxref("Array.prototype.some()")}}</li>
</ul>