TypedArray.prototype.toSorted()

Baseline 2023
Newly available

Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

TypedArray 实例的 toSorted() 方法是 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® 2025 Language Specification
# sec-%typedarray%.prototype.tosorted

浏览器兼容性

BCD tables only load in the browser

参见