TypedArray.prototype.toSorted()
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月.
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 ]
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.tosorted |