このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Array.prototype.toReversed()
Baseline 2023Newly available
Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
toReversed() はArray インスタンスのメソッドで、reverse() メソッドに対応するコピーメソッドです。これは、要素を逆順に並べた新しい配列を返します。
構文
toReversed()引数
なし。
返値
要素を逆順に格納した新しい配列です。
解説
toReversed() メソッドは、呼び出した配列オブジェクトの要素を逆順に並べ替えて新しい配列を返します。
疎配列に対して使用した場合、toReversed() メソッドは空のスロットをundefined という値があるものとして反復処理します。
toReversed() メソッドは汎用です。this の値がlength プロパティを持っており、整数のキーのプロパティがあることのみを期待します。
例
配列内の要素を反転
次の例では、 3 つの要素を格納した配列items を作成し、次にitems の逆の配列を新しく作成します。このときitems 配列は変更されません。
const items = [1, 2, 3];console.log(items); // [1, 2, 3]const reversedItems = items.toReversed();console.log(reversedItems); // [3, 2, 1]console.log(items); // [1, 2, 3]疎配列に対する toReversed() の使用
toReversed() の返値は決して疎配列にはなりません。空のスロットは返す配列のundefined になります。
console.log([1, , 3].toReversed()); // [3, undefined, 1]console.log([1, , 3, 4].toReversed()); // [4, 3, undefined, 1]配列以外のオブジェクトに対する toReversed() の呼び出し
toReversed() メソッドはthis のlength プロパティを読み取ります。そして、length - 1 から0 までの整数のキーを持つ各プロパティを降順に訪れ、現在のプロパティの値を配列の末尾に追加して返します。
const arrayLike = { length: 3, unrelated: "foo", 2: 4,};console.log(Array.prototype.toReversed.call(arrayLike));// [4, undefined, undefined]// '0' と '1' インデックスは存在しませんので、未定義となります。仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.toreversed |