From d98359f2276e09a35e96c6ed1995d1c0fbd7246b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 16 Jan 2022 18:34:21 +0900 Subject: Web/JavaScript/Reference/Global_Objects/Array/findIndex を変換準備 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../global_objects/array/findindex/index.html | 189 --------------------- .../global_objects/array/findindex/index.md | 189 +++++++++++++++++++++ 2 files changed, 189 insertions(+), 189 deletions(-) delete mode 100644 files/ja/web/javascript/reference/global_objects/array/findindex/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/array/findindex/index.md (limited to 'files/ja/web/javascript') diff --git a/files/ja/web/javascript/reference/global_objects/array/findindex/index.html b/files/ja/web/javascript/reference/global_objects/array/findindex/index.html deleted file mode 100644 index 959882e111..0000000000 --- a/files/ja/web/javascript/reference/global_objects/array/findindex/index.html +++ /dev/null @@ -1,189 +0,0 @@ ---- -title: Array.prototype.findIndex() -slug: Web/JavaScript/Reference/Global_Objects/Array/findIndex -tags: - - Array - - ECMAScript2015 - - JavaScript - - Method - - Prototype - - polyfill - - メソッド - - 配列 -translation_of: Web/JavaScript/Reference/Global_Objects/Array/findIndex ---- -
{{JSRef}}
- -

findIndex() メソッドは、配列内の指定されたテスト関数を満たす最初の要素の位置を返します。テスト関数を満たす要素がない場合を含め、それ以外の場合は -1 を返します。

- -
{{EmbedInteractiveExample("pages/js/array-findindex.html","shorter")}}
- - - -

{{jsxref("Array.find", "find()")}} メソッドも参照してください。このメソッドは、配列内で見つかった要素の位置ではなく、値 を返します。

- -

構文

- -
arr.findIndex(callback( element[, index[, array]] )[, thisArg])
-
- -

引数

- -
-
callback
-
-

配列内のそれぞれの値に対して実行される関数で、条件を満たす要素が発見されたことを示す true が返るまで続けられます。

- -

３つの引数を取ります。

- -
-
element
-
配列内で現在処理されている要素。
-
index {{optional_inline}}
-
配列内で現在処理されている要素の位置。
-
array {{optional_inline}}
-
findIndex() を呼び出した元の配列。
-
-
-
thisArg {{optional_inline}}
-
任意で、 callback を実行する時に this として使うオブジェクト。
-
- -

返値

- -

テストを満たした配列の要素の位置を返します。それ以外の場合は、 -1 を返します。

- -

解説

- -

findIndex() メソッドは、配列のそれぞれの位置に対して callback を１回ずつ呼び出し、 callback が{{Glossary("truthy", "真値")}}を返すものを見つけるまで繰り返します。

- -

そのような要素が見つかると、 findIndex() はすぐにその要素の位置を返します。 callback が真値を返すと (または配列の length が 0 であると)、 findIndex() は -1 を返します。

- -
-

極端な場合の警告: {{jsxref("Array.some()")}} などの他の配列メソッドとは異なり、 callback は値が割り当てられていない位置でも実行されます。

-
- -

callback は３つの引数で呼び出されます。

- -
    -
  1. その要素の値
    2. -
  2. その要素の位置
    3. -
  3. 走査されている配列オブジェクト
    4. -
- -

findIndex に thisArg 引数を与えた場合、各 callback の呼び出し時に、その与えたオブジェクトが、this として使用されます。この引数を省略した場合、this は {{jsxref("undefined")}} になります。

- -

findIndex() で処理される要素の範囲は、 callback が最初に呼び出される前に設定されます。 callback は最初の findIndex() の呼び出し以降に配列に追加された要素は処理しません。配列内で未処理の既存の要素が callback によって変更された場合、 callback へ渡される値は findIndex() がその要素の位置を処理する時点での値になります。

- -

削除された値も処理対象になります。

- -

ポリフィル

- -
// https://tc39.github.io/ecma262/#sec-array.prototype.findindex
-if (!Array.prototype.findIndex) {
-  Object.defineProperty(Array.prototype, 'findIndex', {
-    value: function(predicate) {
-     // 1. Let O be ? ToObject(this value).
-      if (this == null) {
-        throw new TypeError('"this" is null or not defined');
-      }
-
-      var o = Object(this);
-
-      // 2. Let len be ? ToLength(? Get(O, "length")).
-      var len = o.length >>> 0;
-
-      // 3. If IsCallable(predicate) is false, throw a TypeError exception.
-      if (typeof predicate !== 'function') {
-        throw new TypeError('predicate must be a function');
-      }
-
-      // 4. If thisArg was supplied, let T be thisArg; else let T be undefined.
-      var thisArg = arguments[1];
-
-      // 5. Let k be 0.
-      var k = 0;
-
-      // 6. Repeat, while k < len
-      while (k < len) {
-        // a. Let Pk be ! ToString(k).
-        // b. Let kValue be ? Get(O, Pk).
-        // c. Let testResult be ToBoolean(? Call(predicate, T, « kValue, k, O »)).
-        // d. If testResult is true, return k.
-        var kValue = o[k];
-        if (predicate.call(thisArg, kValue, k, o)) {
-          return k;
-        }
-        // e. Increase k by 1.
-        k++;
-      }
-
-      // 7. Return -1.
-      return -1;
-    },
-    configurable: true,
-    writable: true
-  });
-}
-
- -

もし、本当に {{jsxref("Object.defineProperty")}} に対応していない古い JavaScript エンジンに対応する必要があるのであれば、 Array.prototype メソッドに対してポリフィルを使用しないようにしないと、これらを列挙不可能にすることができません。

- -

例

- -

配列内の素数の位置を検索する

- -

次の例では、配列の中で素数の入った最初の要素の位置を返し、素数が見つからなかった場合は -1 を返します。

- -
function isPrime(num) {
-  for (let i = 2; num > i; i++) {
-    if (num % i == 0) {
-      return false;
-    }
-  }
-  return num > 1;
-}
-
-console.log([4, 6, 8, 9, 12].findIndex(isPrime)); // -1, not found
-console.log([4, 6, 7, 9, 12].findIndex(isPrime)); // 2 (array[2] is 7)
-
- -

アロー関数を使用して位置を検索する

- -

次の例では、アロー関数を使用してフルーツの位置を検索しています。

- -
const fruits = ["apple", "banana", "cantaloupe", "blueberries", "grapefruit"];
-
-const index = fruits.findIndex(fruit => fruit === "blueberries");
-
-console.log(index); // 3
-console.log(fruits[index]); // blueberries
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-array.prototype.findindex', 'Array.prototype.findIndex')}}
- -

ブラウザーの互換性

- -
-

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

-
- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/array/findindex/index.md b/files/ja/web/javascript/reference/global_objects/array/findindex/index.md new file mode 100644 index 0000000000..959882e111 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/array/findindex/index.md @@ -0,0 +1,189 @@ +--- +title: Array.prototype.findIndex() +slug: Web/JavaScript/Reference/Global_Objects/Array/findIndex +tags: + - Array + - ECMAScript2015 + - JavaScript + - Method + - Prototype + - polyfill + - メソッド + - 配列 +translation_of: Web/JavaScript/Reference/Global_Objects/Array/findIndex +--- +
{{JSRef}}
+ +

findIndex() メソッドは、配列内の指定されたテスト関数を満たす最初の要素の位置を返します。テスト関数を満たす要素がない場合を含め、それ以外の場合は -1 を返します。

+ +
{{EmbedInteractiveExample("pages/js/array-findindex.html","shorter")}}
+ + + +

{{jsxref("Array.find", "find()")}} メソッドも参照してください。このメソッドは、配列内で見つかった要素の位置ではなく、値 を返します。

+ +

構文

+ +
arr.findIndex(callback( element[, index[, array]] )[, thisArg])
+
+ +

引数

+ +
+
callback
+
+

配列内のそれぞれの値に対して実行される関数で、条件を満たす要素が発見されたことを示す true が返るまで続けられます。

+ +

３つの引数を取ります。

+ +
+
element
+
配列内で現在処理されている要素。
+
index {{optional_inline}}
+
配列内で現在処理されている要素の位置。
+
array {{optional_inline}}
+
findIndex() を呼び出した元の配列。
+
+
+
thisArg {{optional_inline}}
+
任意で、 callback を実行する時に this として使うオブジェクト。
+
+ +

返値

+ +

テストを満たした配列の要素の位置を返します。それ以外の場合は、 -1 を返します。

+ +

解説

+ +

findIndex() メソッドは、配列のそれぞれの位置に対して callback を１回ずつ呼び出し、 callback が{{Glossary("truthy", "真値")}}を返すものを見つけるまで繰り返します。

+ +

そのような要素が見つかると、 findIndex() はすぐにその要素の位置を返します。 callback が真値を返すと (または配列の length が 0 であると)、 findIndex() は -1 を返します。

+ +
+

極端な場合の警告: {{jsxref("Array.some()")}} などの他の配列メソッドとは異なり、 callback は値が割り当てられていない位置でも実行されます。

+
+ +

callback は３つの引数で呼び出されます。

+ +
    +
  1. その要素の値
    2. +
  2. その要素の位置
    3. +
  3. 走査されている配列オブジェクト
    4. +
+ +

findIndex に thisArg 引数を与えた場合、各 callback の呼び出し時に、その与えたオブジェクトが、this として使用されます。この引数を省略した場合、this は {{jsxref("undefined")}} になります。

+ +

findIndex() で処理される要素の範囲は、 callback が最初に呼び出される前に設定されます。 callback は最初の findIndex() の呼び出し以降に配列に追加された要素は処理しません。配列内で未処理の既存の要素が callback によって変更された場合、 callback へ渡される値は findIndex() がその要素の位置を処理する時点での値になります。

+ +

削除された値も処理対象になります。

+ +

ポリフィル

+ +
// https://tc39.github.io/ecma262/#sec-array.prototype.findindex
+if (!Array.prototype.findIndex) {
+  Object.defineProperty(Array.prototype, 'findIndex', {
+    value: function(predicate) {
+     // 1. Let O be ? ToObject(this value).
+      if (this == null) {
+        throw new TypeError('"this" is null or not defined');
+      }
+
+      var o = Object(this);
+
+      // 2. Let len be ? ToLength(? Get(O, "length")).
+      var len = o.length >>> 0;
+
+      // 3. If IsCallable(predicate) is false, throw a TypeError exception.
+      if (typeof predicate !== 'function') {
+        throw new TypeError('predicate must be a function');
+      }
+
+      // 4. If thisArg was supplied, let T be thisArg; else let T be undefined.
+      var thisArg = arguments[1];
+
+      // 5. Let k be 0.
+      var k = 0;
+
+      // 6. Repeat, while k < len
+      while (k < len) {
+        // a. Let Pk be ! ToString(k).
+        // b. Let kValue be ? Get(O, Pk).
+        // c. Let testResult be ToBoolean(? Call(predicate, T, « kValue, k, O »)).
+        // d. If testResult is true, return k.
+        var kValue = o[k];
+        if (predicate.call(thisArg, kValue, k, o)) {
+          return k;
+        }
+        // e. Increase k by 1.
+        k++;
+      }
+
+      // 7. Return -1.
+      return -1;
+    },
+    configurable: true,
+    writable: true
+  });
+}
+
+ +

もし、本当に {{jsxref("Object.defineProperty")}} に対応していない古い JavaScript エンジンに対応する必要があるのであれば、 Array.prototype メソッドに対してポリフィルを使用しないようにしないと、これらを列挙不可能にすることができません。

+ +

例

+ +

配列内の素数の位置を検索する

+ +

次の例では、配列の中で素数の入った最初の要素の位置を返し、素数が見つからなかった場合は -1 を返します。

+ +
function isPrime(num) {
+  for (let i = 2; num > i; i++) {
+    if (num % i == 0) {
+      return false;
+    }
+  }
+  return num > 1;
+}
+
+console.log([4, 6, 8, 9, 12].findIndex(isPrime)); // -1, not found
+console.log([4, 6, 7, 9, 12].findIndex(isPrime)); // 2 (array[2] is 7)
+
+ +

アロー関数を使用して位置を検索する

+ +

次の例では、アロー関数を使用してフルーツの位置を検索しています。

+ +
const fruits = ["apple", "banana", "cantaloupe", "blueberries", "grapefruit"];
+
+const index = fruits.findIndex(fruit => fruit === "blueberries");
+
+console.log(index); // 3
+console.log(fruits[index]); // blueberries
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-array.prototype.findindex', 'Array.prototype.findIndex')}}
+ +

ブラウザーの互換性

+ +
+

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

+
+ +

関連情報

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