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.
The toSorted()
method of TypedArray
instances is the copying version of the sort()
method. It returns a new typed array with the elements sorted in ascending order. This method has the same algorithm as Array.prototype.toSorted()
, except that it sorts the values numerically instead of as strings by default.
Syntax
js
toSorted()
toSorted(compareFn)
Parameters
Return value
A new typed array with the elements sorted in ascending order.
Description
See Array.prototype.toSorted()
for more details. This method is not generic and can only be called on typed array instances.
Examples
Sorting an array
For more examples, see also the Array.prototype.sort()
method.
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 ]
Specifications
Specification |
---|
ECMAScript Language Specification # sec-%typedarray%.prototype.tosorted |
Browser compatibility
BCD tables only load in the browser