Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Node.js24.x】Array::toReversed()メソッドの使い方

toReversedメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

toReversedメソッドは、Arrayクラスに属し、配列の要素の順序を反転させた新しい配列を生成して返すメソッドです。このメソッドの最も重要な特徴は、元の配列の内容を一切変更しない「非破壊的」である点です。

従来のreverse()メソッドが呼び出し元の配列を直接変更するのに対し、toReversed()は元の配列のコピーを作成し、そのコピーの要素を逆順に並べ替えてから、新しい配列として返します。これにより、元のデータの状態を維持しながら、逆順のデータが必要な場合に安全かつ効率的に処理を行うことができます。例えば、ユーザーインターフェースでリストの表示順序を一時的に変更したいが、元のデータソースはそのままにしておきたい場合や、元のデータに影響を与えずに特定の検証を行いたい場合などに非常に有用です。

この挙動は、プログラムの予期せぬ副作用を防ぎ、コードの信頼性と保守性を向上させる上で重要です。Node.js環境ではバージョン24から利用可能であり、ECMAScript 2023で導入された新しい配列操作メソッドの一つとして、モダンなJavaScript開発において配列操作の選択肢を広げます。元のデータを保護しながら配列を操作したい場合に積極的に利用することが推奨されます。

構文(syntax)

1const originalArray = [1, 2, 3, 4, 5];
2const reversedArray = originalArray.toReversed();
3
4console.log(reversedArray);
5console.log(originalArray);

引数(parameters)

引数なし

引数はありません

戻り値(return)

Array

元の配列の要素を逆順にした新しい配列を返します。元の配列は変更されません。

関連コンテンツ

関連プログラミング言語