From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../global_objects/array/@@iterator/index.html | 126 +++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 files/ja/web/javascript/reference/global_objects/array/@@iterator/index.html (limited to 'files/ja/web/javascript/reference/global_objects/array/@@iterator') diff --git a/files/ja/web/javascript/reference/global_objects/array/@@iterator/index.html b/files/ja/web/javascript/reference/global_objects/array/@@iterator/index.html new file mode 100644 index 0000000000..df8c0269be --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/array/@@iterator/index.html @@ -0,0 +1,126 @@ +--- +title: 'Array.prototype[@@iterator]()' +slug: Web/JavaScript/Reference/Global_Objects/Array/@@iterator +tags: + - Array + - Beginner + - ECMAScript 2015 + - Iterator + - JavaScript + - Method + - Prototype + - Reference + - イテレーター + - メソッド +translation_of: Web/JavaScript/Reference/Global_Objects/Array/@@iterator +--- +
{{JSRef}}
+ +

@@iterator メソッドは反復プロトコルの一部であり、値の列を同期的に反復する方法を定義します。

+ +

@@iterator プロパティの初期値は {{jsxref("Array.prototype.values()", "values()")}} プロパティの初期値と同じ関数オブジェクトです。

+ +

構文

+ +
arr[Symbol.iterator]()
+ +

返値

+ +

{{jsxref("Array.prototype.values()", "values()")}} イテレーター によって与えられる初期値です。既定では、 arr[Symbol.iterator] を使うと {{jsxref("Array.prototype.values()", "values()")}} を返します。

+ +

例

+ +

for...of ループを用いた反復

+ +

HTML

+ +
<ul id="letterResult">
+</ul>
+ +

JavaScript

+ +
var arr = ['a', 'b', 'c'];
+var eArr = arr[Symbol.iterator]();
+var letterResult = document.getElementById('letterResult');
+// your browser must support for..of loop
+// and let-scoped variables in for loops
+// const and var could also be used
+for (let letter of eArr) {
+ letterResult.innerHTML += "<li>" + letter + "</li>";
+}
+
+ +

結果

+ +

{{EmbedLiveSample('Iteration_using_for...of_loop', '', '', '', 'Web/JavaScript/Reference/Global_Objects/Array/@@iterator')}}

+ +

他の反復方法

+ +
var arr = ['a', 'b', 'c', 'd', 'e'];
+var eArr = arr[Symbol.iterator]();
+console.log(eArr.next().value); // a
+console.log(eArr.next().value); // b
+console.log(eArr.next().value); // c
+console.log(eArr.next().value); // d
+console.log(eArr.next().value); // e
+
+ +

括弧表記の使用法

+ +

この構文をドット記法 (Array.prototype.values()) よりも優先して使用する場合は、事前にどのようなオブジェクトになるのかが分からない場合です。イテレータを受け取り、その値を反復処理する関数があるが、そのオブジェクトが [Iterable].prototype.values メソッドを持っているかどうかわからない場合です。これはStringオブジェクトのような組み込みオブジェクトでも、カスタムオブジェクトでもよいでしょう。これは String オブジェクトのような組込みオブジェクトや、独自オブジェクトである可能性があります。

+ +
function logIterable(it) {
+  var iterator = it[Symbol.iterator]();
+  // your browser must support for..of loop
+  // and let-scoped variables in for loops
+  // const and var could also be used
+  for (let letter of iterator) {
+      console.log(letter);
+  }
+}
+
+// Array
+logIterable(['a', 'b', 'c']);
+// a
+// b
+// c
+
+// string
+logIterable('abc');
+// a
+// b
+// c
+
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-array.prototype-@@iterator', 'Array.prototype[@@iterator]()')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("javascript.builtins.Array.@@iterator")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf