Die toSorted()-Methode von TypedArray-Instanzen ist die kopierende Version der sort()-Methode. Sie gibt ein neues typisiertes Array zurück, dessen Elemente in aufsteigender Reihenfolge sortiert sind. Diese Methode verwendet denselben Algorithmus wie Array.prototype.toSorted(), außer dass sie die Werte standardmäßig numerisch statt als Zeichenfolgen sortiert.

Syntax

toSorted()
toSorted(compareFn)

Parameter

compareFn Optional

Eine Funktion, die die Reihenfolge der Elemente bestimmt. Wenn sie weggelassen wird, werden die Elemente des typisierten Arrays nach ihrem numerischen Wert sortiert. Weitere Informationen finden Sie unter sort().

Rückgabewert

Ein neues typisiertes Array mit den Elementen in aufsteigender Reihenfolge sortiert.

Beschreibung

Weitere Details finden Sie unter Array.prototype.toSorted(). Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen aufgerufen werden.

Beispiele

Sortieren eines Arrays

Weitere Beispiele finden Sie auch bei der Array.prototype.sort()-Methode.

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 ]

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill von TypedArray.prototype.toSorted in core-js
• Leitfaden zu JavaScript typisierten Arrays
• TypedArray.prototype.sort()
• TypedArray.prototype.toReversed()
• TypedArray.prototype.with()
• Array.prototype.toSorted()