Array.prototype.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() の返値は決して疎配列にはなりません。空のスロットは返す配列の undefined になります。

console.log([1, , 3].toReversed()); // [3, undefined, 1]
console.log([1, , 3, 4].toReversed()); // [4, 3, undefined, 1]

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' インデックスは存在しませんので、未定義となります。

• Array.prototype.toReversed のポリフィル (core-js)
• インデックス付きコレクションのガイド
• Array.prototype.reverse()
• Array.prototype.toSorted()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toReversed()