2023/09/08 時点の英語版に同期 (#16806)

* 2023/09/08 時点の英語版に同期

* 「汎用的」のリンク先を修正

files/ja/web/javascript/reference/global_objects/array/copywithin/index.md

@@ -2,63 +2,68 @@
 title: Array.prototype.copyWithin()
 slug: Web/JavaScript/Reference/Global_Objects/Array/copyWithin
 l10n:
-  sourceCommit: 968e6f1f3b6f977a09e116a0ac552459b741eac3
+  sourceCommit: 688f606b78fb7e375e5680cc1ae49c5b9d0bc0ea
 ---
 
 {{JSRef}}
 
-**`copyWithin()`** メソッドは、サイズを変更せずに、配列の一部を同じ配列内の別の場所にシャローコピーして返します。
+**`copyWithin()`** は {{jsxref("Array")}} インスタンスのメソッドで、この配列の一部を配列内の他の場所にシャローコピーし、この配列を長さを変更せずに返します。
 
 {{EmbedInteractiveExample("pages/js/array-copywithin.html")}}
 
 ## 構文
 
-```js
-copyWithin(target);
-copyWithin(target, start);
-copyWithin(target, start, end);
+```js-nolint
+copyWithin(target, start)
+copyWithin(target, start, end)
 ```
 
 ### 引数
 
 - `target`
-
-  - : シーケンスのコピー先となる、0 から始まる位置です。負の場合、`target` は最後から数えられます。
-
-    `target` が `arr.length` 以上の場合、何もコピーされません。 `target` が `start` より後に配置されている場合、コピーされたシーケンスは `arr.length` に合うように切り詰められます。
-
-- `start` {{optional_inline}}
-
-  - : 要素のコピー元の始まりを表す、0 から始まる位置です。負の場合、 `start` は最後から数えられます。
-
-    `start` が省略された場合、`copyWithin` は最初の要素からコピーします（つまり、初期値は 0 です）。
-
+  - : 並びのコピー先となる 0 から始まるインデックスで、[整数に変換されます](/ja/docs/Web/JavaScript/Reference/Global_Objects/Number#整数への変換)。これは `start` にある要素がコピーされる場所に対応し、`start` から `end` までのすべての要素が後続のインデックスにコピーされます。
+    - 負のインデックスの場合は、配列の末尾から逆に数えます。 `target < 0` の場合は、 `target + array.length` が使用されます。
+    - `target < -array.length` の場合は、 `0` が使用されます。
+    - `target >= array.length` の場合は、何もコピーされません。
+    - `target` が正規化後の `start` の後に位置している場合、コピーは `array.length` の末尾までしか行われません（言い換えれば、 `copyWithin()` は配列を拡張しません）。
+- `start`
+  - : 要素のコピー元の始まりを表す 0 から始まるインデックスで、[整数に変換されます](/ja/docs/Web/JavaScript/Reference/Global_Objects/Number#整数への変換)。
+    - 負のインデックスの場合は、配列の末尾から逆に数えます。 `start < 0` の場合は、 `start + array.length` が使用されます。
+    - `start < -array.length` の場合は、 `0` が使用されます。
+    - `start >= array.length` の場合は、何もコピーされません。
 - `end` {{optional_inline}}
-
-  - : 要素のコピー元の末尾を表す、0 から始まるインデックスです。 `copyWithin` のコピーは `end` を含みません。負の場合、 `end` は最後から数えられます。
-
-  `end` が省略された場合、 `copyWithin` は最後までコピーします（つまり、初期値は `arr.length` です）。
+  - : 要素のコピー元の末尾を表す 0 から始まるインデックスで、[整数に変換されます](/ja/docs/Web/JavaScript/Reference/Global_Objects/Number#整数への変換)。 `copyWithin()` のコピーは `end` の手前まで行います。
+    - 負のインデックスの場合は、配列の末尾から逆に数えます。 `end < 0` の場合は、 `end + array.length` が使用されます。
+    - `end < -array.length` の場合は、 `0` が使用されます。
+    - `end >= array.length` の場合、または `end` が省略された場合は、 `array.length` が使用され、末尾までのすべての要素がコピーされます。
+    - 正規化後に `end` が `start` よりも前か同じ位置になったときは、何もコピーされません。
 
 ### 返値
 
 変更された配列です。
 
 ## 解説
 
-`copyWithin()` メソッドは C 言語や C++ の `memmove` のような動きをし、{{jsxref("Array")}} のデータを移動するための高いパフォーマンスのメソッドです。これは特に {{jsxref("TypedArray/copyWithin", "TypedArray")}} の同名メソッドに当てはまります。シーケンスはコピーされ貼り付けられる処理が一命令で行われます。コピー＆ペースト領域が重なっている場合でも、ペーストされたシーケンスはコピーされた値を持ちます。
+`copyWithin()` メソッドは C や C++ の `memmove` のような動きをし、 {{jsxref("Array")}} のデータを移動するための高いパフォーマンスのメソッドです。これは特に {{jsxref("TypedArray/copyWithin", "TypedArray")}} の同名メソッドに当てはまります。データの並びがコピーされ貼り付けられる処理が一命令で行われます。コピー元と貼り付け先で領域が重なっていたとしても、貼り付け先の並びはコピーされた値になります。
+
+`undefined` は整数に変換されると `0` になるため、 `start` 引数を省略すると `0` を渡したのと同じ効果があり、配列全体が対象とする位置にコピーされます（右の境界が切り取られ、左の境界が複製される右シフトと同じです）。この動作はコードの読み手を混乱させる可能性があるので、代わりに `start` として `0` を明示的に渡してください。
+
+```js
+console.log([1, 2, 3, 4, 5].copyWithin(2));
+// [1, 2, 1, 2, 3]; すべての要素を右に 2 つずらす
+```
+
+`copyWithin()` は[変更を行うメソッド](/ja/docs/Web/JavaScript/Reference/Global_Objects/Array#コピーメソッドと変更メソッド)です。 `this` の長さは変更しませんが、 `this` の内容を変更し、必要に応じて新しいプロパティを作成します。
 
-`copyWithin()` は変更を行うメソッドです。 `this` の長さは変更しませんが、 `this` の内容を変更し、必要に応じて新しいプロパティを作成します。
+`copyWithin()` メソッドは空のスロットを保持します。コピー元の範囲が[疎配列](/ja/docs/Web/JavaScript/Guide/Indexed_collections#疎配列)であった場合、空のスロットに対応するインデックスは[削除](/ja/docs/Web/JavaScript/Reference/Operators/delete)され、空のスロットになります。
 
-`Array.prototype.copyWithin()` 関数は、意図的に一般化されています。 `this` 値が {{jsxref("Array")}} オブジェクトである必要はありません。
+`copyWithin()` メソッドは[汎用的](/ja/docs/Web/JavaScript/Reference/Global_Objects/Array#汎用的な配列メソッド)です。このメソッドは `this` の値に `length` プロパティと整数のキーを持ったプロパティがあることだけを求めます。文字列も配列風オブジェクトですが、文字列は不変なので、このメソッドを適用するのは適していません。
 
 ## 例
 
-### copyWithin の使用
+### copyWithin() の使用
 
 ```js
-console.log([1, 2, 3, 4, 5].copyWithin(-2));
-// [1, 2, 3, 1, 2]
-
 console.log([1, 2, 3, 4, 5].copyWithin(0, 3));
 // [4, 5, 3, 4, 5]
 
@@ -67,9 +72,30 @@ console.log([1, 2, 3, 4, 5].copyWithin(0, 3, 4));
 
 console.log([1, 2, 3, 4, 5].copyWithin(-2, -3, -1));
 // [1, 2, 3, 3, 4]
+```
+
+### 疎配列に対する copyWithin() の使用
+
+`copyWithin()` は空のスロットを広めます。
 
-console.log([].copyWithin.call({ length: 5, 3: 1 }, 0, 3));
-// {0: 1, 3: 1, length: 5}
+```js
+console.log([1, , 3].copyWithin(2, 1, 2)); // [1, empty, empty]
+```
+
+### 配列ではないオブジェクトに対する copyWithin() の呼び出し
+
+`copyWithin()` メソッドは `this` の `length` プロパティを読み込んで、関係する整数のインデックスを操作します。
+
+```js
+const arrayLike = {
+  length: 5,
+  3: 1,
+};
+console.log(Array.prototype.copyWithin.call(arrayLike, 0, 3));
+// { '0': 1, '3': 1, length: 5 }
+console.log(Array.prototype.copyWithin.call(arrayLike, 3, 1));
+// { '0': 1, length: 5 }
+// コピー元が空のスロットであるため、 '3' プロパティは削除される
 ```
 
 ## 仕様書
@@ -83,5 +109,6 @@ console.log([].copyWithin.call({ length: 5, 3: 1 }, 0, 3));
 ## 関連情報
 
 - [`Array.prototype.copyWithin` のポリフィル (`core-js`)](https://github.com/zloirock/core-js#ecmascript-array)
-- [ポリフィル](https://github.com/behnammodi/polyfill/blob/master/array.polyfill.js)
+- [インデックス付きコレクション](/ja/docs/Web/JavaScript/Guide/Indexed_collections)ガイド
 - {{jsxref("Array")}}
+- {{jsxref("TypedArray.prototype.copyWithin()")}}