← 返回首页

Array.prototype.toReversed() - JavaScript | MDN

サイドバーを切り替え

配色

OS のデフォルト
ライト
ダーク

日本語

言語を記憶もっと知る

Array.prototype.toReversed()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年7月以降、すべてのブラウザーで利用可能です。

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

目次

構文

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

仕様書

仕様書

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

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

関連情報

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2025年8月9日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

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