TypedArray.prototype.toSorted()

Метод toSorted() экземпляров TypedArray является копирующей версией метода sort(). Он возвращает новый типизированный массив с элементами, отсортированными в порядке возрастания. Этот метод имеет тот же алгоритм, что и Array.prototype.toSorted(), за исключением того, что по умолчанию он сортирует значения численно, а не как строки.

Синтаксис

toSorted()
toSorted(compareFn)

Параметры

compareFn Необязательный

Функция, определяющая порядок элементов. Если опущена, элементы типизированного массива сортируются в числовом порядке. См. sort() для получения дополнительной информации.

Возвращаемое значение

Новый типизированный массив с элементами, отсортированными в порядке возрастания.

Описание

См. Array.prototype.toSorted() для получения более подробной информации. Этот метод не является универсальным и может быть вызван только для экземпляров типизированных массивов.

Примеры

Сортировка массива

Дополнительные примеры см. также в описании метода Array.prototype.sort().

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 ]

Спецификации

Совместимость с браузерами

См. также

• Polyfill of TypedArray.prototype.toSorted in core-js
• Руководство по типизированным массивам JavaScript
• TypedArray.prototype.sort()
• TypedArray.prototype.toReversed()
• TypedArray.prototype.with()
• Array.prototype.toSorted()