Global_Objects/Array/includes を更新

- Markdown へ変換
- 2021/08/03 時点の英語版に同期

1 files changed, 72 insertions, 87 deletions

diff --git a/files/ja/web/javascript/reference/global_objects/array/includes/index.md b/files/ja/web/javascript/reference/global_objects/array/includes/index.md
index b78bb5d20e..e96597dcd1 100644
--- a/files/ja/web/javascript/reference/global_objects/array/includes/index.md
+++ b/files/ja/web/javascript/reference/global_objects/array/includes/index.md
@@ -4,79 +4,80 @@ slug: Web/JavaScript/Reference/Global_Objects/Array/includes
 tags:
   - Array
   - JavaScript
-  - Method
-  - Prototype
-  - Reference
+  - メソッド
+  - プロトタイプ
+  - リファレンス
   - inArray
   - in_array
-  - polyfill
-  - メソッド
+  - ポリフィル
+browser-compat: javascript.builtins.Array.includes
 translation_of: Web/JavaScript/Reference/Global_Objects/Array/includes
 ---
-<div>{{JSRef}}</div>
+{{JSRef}}
+
+**`includes()`** メソッドは、特定の要素が配列に含まれているかどうかを `true` または `false` で返します。
+
+{{EmbedInteractiveExample("pages/js/array-includes.html")}}
 
-<p><code><strong>includes()</strong></code> メソッドは、特定の要素が配列に含まれているかどうかを <code>true</code> または <code>false</code> で返します。</p>
+## 構文
 
-<div>{{EmbedInteractiveExample("pages/js/array-includes.html")}}</div>
+```js
+includes(searchElement)
+includes(searchElement, fromIndex)
+```
 
-<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、<a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div>
+### 引数
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+- `searchElement`
 
-<pre class="syntaxbox notranslate"><var>arr</var>.includes(<var>valueToFind</var>[, <var>fromIndex</var>])
-</pre>
+  - : 検索する値です。
 
-<h3 id="Parameters" name="Parameters">引数</h3>
+    > **Note:** 文字列や文字を比較する場合、`includes()` は*大文字と小文字を区別します*。
 
-<dl>
- <dt><code><var>valueToFind</var></code></dt>
- <dd>
- <p>検索する値です。</p>
+- `fromIndex` {{optional_inline}}
 
- <div class="blockIndicator note">
- <p><strong>メモ:</strong> 文字列や文字を比較するとき、<code>includes()</code> は<em>大文字と小文字を区別します</em>。</p>
- </div>
- </dd>
- <dt><code><var>fromIndex</var></code> {{optional_inline}}</dt>
- <dd>この配列内で <code><var>valueToFind</var></code> を探し始める位置です。</dd>
- <dd>検索される最初の文字は、<code><var>fromIndex</var></code> が正の値の場合は、<code><var>fromIndex</var></code> で見つかり、<code><var>fromIndex</var></code> が負の数の場合は (<code><var>fromIndex</var></code> の{{interwiki("wikipedia", "絶対値")}}だけ配列の末尾から文字数を戻った位置が検索開始地点となり)、<code><var>fromIndex</var></code> または <code><var>arr</var>.length + fromIndex</code> で見つかります。</dd>
- <dd>既定値は 0 です。</dd>
-</dl>
+  - : `searchElement` の検索を始める配列内の位置です。
 
-<h3 id="Return_value" name="Return_value">返値</h3>
+    検索される最初の要素は、`fromIndex` が正の値の場合は `fromIndex` の位置に、`fromIndex` が負の値の場合は `arr.length + fromIndex` の位置になります (検索を開始する配列の端からの要素数として fromIndex の{{interwiki("wikipedia", "絶対値")}}を使用します)。
 
-<p>{{jsxref("Boolean")}} で、<code>true</code> は <code><var>valueToFind</var></code> の値が配列内 (または、<code><var>fromIndex</var></code> が指定された場合はそれで示された配列の部分) から見つかった場合です。</p>
+    既定値は `0` です。
 
-<p>ゼロの値はすべて、符号にかかわらず等しいとみなされます (つまり、<code>-0</code> は <code>0</code> と <code>+0</code> の両方に等しいとみなされます) が、<code>false</code> は <code>0</code> と同じとはみなされ<em>ません</em>。</p>
+### 返値
 
-<div class="note">
-<p><strong>注:</strong> 技術的に言えば、<code>includes()</code> は <code><a href="/ja/docs/Web/JavaScript/Equality_comparisons_and_sameness#Same-value-zero_equality">sameValueZero</a></code> アルゴリズムを使用して、指定された要素が見つかったかどうかを確認しています。</p>
-</div>
+論理型で、`searchElement` の値が配列内 (`fromIndex` が指定されていた場合は、配列のその位置以降の部分) にあった場合は `true` を返します。
 
-<h2 id="Examples" name="Examples">例</h2>
+ゼロの値は符号に関わらず、すべて等しいとみなされます (すなわち、`-0` は `0` とも `+0` 友等しいとみなされます) が、`false` は `0` と同じとはみなされ*ません*。
 
-<pre class="brush: js notranslate">[1, 2, 3].includes(2)      // true
-[1, 2, 3].includes(4)      // false
-[1, 2, 3].includes(3, 3)   // false
-[1, 2, 3].includes(3, -1)  // true
-[1, 2, NaN].includes(NaN)  // true
-</pre>
+> **Note:** 技術的に言えば、`includes()` は [`sameValueZero`](/ja/docs/Web/JavaScript/Equality_comparisons_and_sameness#same-value-zero_equality) アルゴリズムを使用して、指定された要素が見つかったかどうかを確認しています。
 
-<h3 id="fromIndex_is_greater_than_or_equal_to_the_array_length" name="fromIndex_is_greater_than_or_equal_to_the_array_length"><code><var>fromIndex</var></code> が配列の長さと同じか大きい場合</h3>
+## 例
 
-<p><code><var>fromIndex</var></code> が配列の長さと同じか大きい場合は配列を検索せずに <code>false</code> を返します。</p>
+```js
+[1, 2, 3].includes(2)         // true
+[1, 2, 3].includes(4)         // false
+[1, 2, 3].includes(3, 3)      // false
+[1, 2, 3].includes(3, -1)     // true
+[1, 2, NaN].includes(NaN)     // true
+["1", "2", "3"].includes(3)   // false
+```
 
-<pre class="brush: js notranslate">let arr = ['a', 'b', 'c']
+### `fromIndex` が配列の長さと同じか大きい場合
+
+`fromIndex` が配列の長さと同じか大きい場合は、配列を検索せずに `false` を返します。
+
+```js
+let arr = ['a', 'b', 'c']
 
 arr.includes('c', 3)    // false
 arr.includes('c', 100)  // false
-</pre>
+```
 
-<h3 id="Computed_index_is_less_than_0" name="Computed_index_is_less_than_0">計算値のインデックスが 0 より小さい場合</h3>
+### 計算された位置が 0 より小さい場合
 
-<p><code><var>fromIndex</var></code> が負の値である場合、計算値のインデックスは配列内で <code><var>valueToFind</var></code> の円策を開始する位置として使用するよう計算されます。計算値のインデックスが <code>-1 * <var>arr</var>.length</code> 以下の場合は、配列全体が検索されます。</p>
+`fromIndex` が負の値である場合、`searchElement` の検索を開始するための配列内の位置として、計算により位置が算出されます。計算された位置が `0` 以下の場合は、配列全体が検索されます。
 
-<pre class="brush: js notranslate">// 配列の長さは 3
+```js
+// 配列の長さは 3
 // fromIndex は -100
 // 補正されたインデックスは 3 + (-100) = -97
 
@@ -86,50 +87,34 @@ arr.includes('a', -100) // true
 arr.includes('b', -100) // true
 arr.includes('c', -100) // true
 arr.includes('a', -2)   // false
-</pre>
+```
 
-<h3 id="includes_used_as_a_generic_method" name="includes_used_as_a_generic_method">ジェネリックメソッドとして使用される includes()</h3>
+### ジェネリックメソッドとして使用される includes()
 
-<p><code>includes()</code> メソッドは意図的にジェネリックになっています。<code>this</code> が Array オブジェクトであることは必須ではないので、他の種類のオブジェクト (例えば配列風オブジェクト) にも適用することができます。</p>
+`includes()` メソッドは意図的にジェネリックになっています。`this` が Array オブジェクトであることは必須ではないので、他の種類のオブジェクト (例えば配列風オブジェクト) にも適用することができます。
 
-<p>以下の例は、<code>includes()</code> メソッドが関数の <a href="/ja/docs/Web/JavaScript/Reference/Functions/arguments">arguments</a> オブジェクトに対して使用される様子を示しています。</p>
+以下の例は、`includes()` メソッドが関数の [arguments](/ja/docs/Web/JavaScript/Reference/Functions/arguments) オブジェクトに対して使用される様子を示しています。
 
-<pre class="brush: js notranslate">(function() {
+```js
+(function() {
   console.log(Array.prototype.includes.call(arguments, 'a'))  // true
   console.log(Array.prototype.includes.call(arguments, 'd'))  // false
-})('a','b','c') </pre>
-
-<div class="hidden">
-<p>参照記事にポリフィルを追加しないでください。詳細や議論については、<a href="https://discourse.mozilla.org/t/mdn-rfc-001-mdn-wiki-pages-shouldnt-be-a-distributor-of-polyfills/24500">https://discourse.mozilla.org/t/mdn-rfc-001-mdn-wiki-pages-shouldnt-be-a-distributor-of-polyfills/24500</a> を参照して下さい。</p>
-</div>
-
-<h2 id="Specifications" name="Specifications">仕様</h2>
-
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('ESDraft', '#sec-array.prototype.includes', 'Array.prototype.includes')}}</td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
-
-<div>
-<p>{{Compat("javascript.builtins.Array.includes")}}</p>
-</div>
-
-<h2 id="See_also" name="See_also">関連情報</h2>
-
-<ul>
- <li>{{jsxref("TypedArray.prototype.includes()")}}</li>
- <li>{{jsxref("String.prototype.includes()")}}</li>
- <li>{{jsxref("Array.prototype.indexOf()")}}</li>
- <li>{{jsxref("Array.prototype.find()")}}</li>
- <li>{{jsxref("Array.prototype.findIndex()")}}</li>
-</ul>
+})('a','b','c') 
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- `Array.prototype.includes` のポリフィルは [`core-js`](https://github.com/zloirock/core-js#ecmascript-array) で利用できます
+- {{jsxref("TypedArray.prototype.includes()")}}
+- {{jsxref("String.prototype.includes()")}}
+- {{jsxref("Array.prototype.indexOf()")}}
+- {{jsxref("Array.prototype.find()")}}
+- {{jsxref("Array.prototype.findIndex()")}}