WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URLSearchParams.sort(): Parameter nach Namen sortieren

URLSearchParams.sort() ordnet Parameter nach ihrem Namen und verändert dabei das Objekt. Einträge mit identischen Namen behalten ihre ursprüngliche Reihenfolge.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

params.sort()

params.sort() sortiert aufsteigend nach den UTF-16-Codeeinheiten der Namen, nicht nach den Werten. Die Sortierung unterscheidet Groß- und Kleinschreibung und berücksichtigt weder Sprache noch Zahlenwerte. Sie ist stabil: Einträge mit identischen Namen behalten ihre Reihenfolge. Die Methode akzeptiert keine Argumente, verändert das Objekt und gibt undefined zurück.

Wird die Methode auf url.searchParams aufgerufen, wird die URL aktualisiert; eine erneute Serialisierung kann die Kodierung ändern, zum Beispiel %20 in +. Um das Original zu erhalten, erstelle mit new URLSearchParams(params) eine Kopie. Dies ist eine in der URL Standard definierte Web-API und keine ECMAScript-Methode.

Beispiele

const params = new URLSearchParams('b=2&a=z&a=1&A=0');
const result = params.sort();
console.log(params.toString());
console.log(result);

Ergebnis

A=0&a=z&a=1&b=2
undefined

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen