TypedArray.prototype.toSorted()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2023年7月以降、すべてのブラウザーで利用可能です。
toSorted() は TypedArray インスタンスのメソッドで、 sort() メソッドのコピーメソッド版です。これは、要素を昇順にソートした新しい型付き配列を返します。このメソッドは Array.prototype.toSorted() と同じアルゴリズムですが、既定で文字列としてではなく数値として値をソートする点が異なります。
構文
js
toSorted()
toSorted(compareFn)
引数
compareFn省略可-
要素の順序を決定する関数。省略された場合、型付き配列の要素は値に基づいてソートされます。詳しくは
sort()を参照してください。
返値
要素を昇順にソートした新しい型付き配列です。
解説
詳細については、 Array.prototype.toSorted() をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。
例
配列のソート
その他の例については、 Array.prototype.sort() メソッドもご覧ください。
js
const numbers = new Uint8Array([40, 1, 5, 200]);
const numberSorted = numbers.toSorted();
console.log(numberSorted); // Uint8Array [ 1, 5, 40, 200 ]
// 通常の配列とは異なり、数値の並べ替えでは比較関数が
// 要求されません。
console.log(numbers); // Uint8Array [ 40, 1, 5, 200 ]
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-%typedarray%.prototype.tosorted |
ブラウザーの互換性
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。