Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URLSearchParams.sort(): sortowanie parametrów według nazw

URLSearchParams.sort() porządkuje parametry według nazw, zmieniając obiekt. Zachowuje kolejność wpisów o jednakowych nazwach.

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

Składnia

params.sort()

params.sort() sortuje rosnąco według jednostek kodowych UTF-16 nazw, nie wartości. Rozróżnia wielkość liter; nie stosuje porządku językowego ani liczbowego. Sortowanie jest stabilne: wpisy o jednakowych nazwach zachowują kolejność. Metoda nie przyjmuje argumentów, zmienia obiekt i zwraca undefined.

Wywołanie na url.searchParams aktualizuje URL; ponowna serializacja może zmienić kodowanie, np. %20 na +. Aby zachować oryginał, utwórz kopię przez new URLSearchParams(params). To Web API zdefiniowane w URL Standard, nie metoda ECMAScript.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła