TypedArray.prototype.toSorted()

基线 2023

新可用

自 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 ]
// Unlike plain Arrays, a compare function is not required
// to sort the numbers numerically.
console.log(numbers); // Uint8Array [ 40, 1, 5, 200 ]

规范

规范
ECMAScript 语言规范
# sec-%typedarray%.prototype.tosorted

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅