Array.prototype.toSorted()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2023 browserübergreifend verfügbar.

Die toSorted() Methode von Array Instanzen ist die kopierende Version der sort() Methode. Sie gibt ein neues Array zurück, bei dem die Elemente in aufsteigender Reihenfolge sortiert sind.

In diesem Artikel

Eine Funktion, die die Reihenfolge der Elemente bestimmt. Wird sie weggelassen, werden die Array-Elemente in Zeichenfolgen umgewandelt und dann gemäß jedem Zeichen-Unicode-Codepunktwert sortiert. Siehe sort() für weitere Informationen.

Rückgabewert

Ein neues Array, bei dem die Elemente in aufsteigender Reihenfolge sortiert sind.

Beschreibung

Siehe sort() für weitere Informationen über den compareFn Parameter.

Bei Verwendung auf sparse Arrays behandelt die toSorted() Methode leere Plätze, als hätten sie den Wert undefined.

Die toSorted() Methode ist generisch. Sie erwartet lediglich, dass der this Wert eine length Eigenschaft und integer-gekoppelte Eigenschaften hat.

Beispiele

Ein Array sortieren

js
const months = ["Mar", "Jan", "Feb", "Dec"];
const sortedMonths = months.toSorted();
console.log(sortedMonths); // ['Dec', 'Feb', 'Jan', 'Mar']
console.log(months); // ['Mar', 'Jan', 'Feb', 'Dec']

const values = [1, 10, 21, 2];
const sortedValues = values.toSorted((a, b) => a - b);
console.log(sortedValues); // [1, 2, 10, 21]
console.log(values); // [1, 10, 21, 2]

Für weitere Anwendungsbeispiele siehe sort().

Verwenden von toSorted() auf sparse Arrays

Leere Plätze werden sortiert, als hätten sie den Wert undefined. Sie werden immer ans Ende des Arrays sortiert und compareFn wird nicht für sie aufgerufen.

js
console.log(["a", "c", , "b"].toSorted()); // ['a', 'b', 'c', undefined]
console.log([, undefined, "a", "b"].toSorted()); // ["a", "b", undefined, undefined]

Aufrufen von toSorted() auf Nicht-Array-Objekten

Die toSorted() Methode liest die length Eigenschaft von this. Sie sammelt dann alle existierenden integer-gekoppelten Eigenschaften im Bereich von 0 bis length - 1, sortiert sie und schreibt sie in ein neues Array.

js
const arrayLike = {
  length: 3,
  unrelated: "foo",
  0: 5,
  2: 4,
  3: 3, // ignored by toSorted() since length is 3
};
console.log(Array.prototype.toSorted.call(arrayLike));
// [4, 5, undefined]

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Array
Konstruktor
1. Array()
Statische Methoden
Statische Eigenschaften
1. [Symbol.species]
Instanzmethoden
Instanzeigenschaften
1. length
2. [Symbol.unscopables]
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor

Array.prototype.toSorted()

In diesem Artikel

Syntax

Parameter