← 返回首页

Array.prototype.toReversed() - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

Array.prototype.toReversed()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2023年7月.

toReversed() は Array インスタンスのメソッドで、 reverse() メソッドに対応するコピーメソッドです。これは、要素を逆順に並べた新しい配列を返します。

In this article

構文

js

toReversed()

引数

なし。

返値

要素を逆順に格納した新しい配列です。

解説

toReversed() メソッドは、呼び出した配列オブジェクトの要素を逆順に並べ替えて新しい配列を返します。

疎配列に対して使用した場合、 toReversed() メソッドは空のスロットを undefined という値があるものとして反復処理します。

toReversed() メソッドは汎用です。 this の値が length プロパティを持っており、整数のキーのプロパティがあることのみを期待します。

例

配列内の要素を反転

次の例では、 3 つの要素を格納した配列 items を作成し、次に items の逆の配列を新しく作成します。このとき items 配列は変更されません。

js
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 になります。

js
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 までの整数のキーを持つ各プロパティを降順に訪れ、現在のプロパティの値を配列の末尾に追加して返します。

js
const arrayLike = {
  length: 3,
  unrelated: "foo",
  2: 4,
};
console.log(Array.prototype.toReversed.call(arrayLike));
// [4, undefined, undefined]
// '0' と '1' インデックスは存在しませんので、未定義となります。

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-array.prototype.toreversed

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

関連情報

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年8月9日 by MDN contributors.

View this page on GitHub • Report a problem with this content

標準組み込みオブジェクト
Array
コンストラクター
1. Array()
静的メソッド
静的プロパティ
1. [Symbol.species]
インスタンスメソッド
インスタンスプロパティ
1. length
2. [Symbol.unscopables]
継承
Object/Function
静的メソッド
静的プロパティ
インスタンスメソッド
インスタンスプロパティ
1. __proto__
2. constructor