Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

URLSearchParams.sort() : trier les paramètres par nom

URLSearchParams.sort() classe les paramètres par nom et modifie l’objet. Les entrées ayant le même nom conservent leur ordre initial.

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

Syntaxe

params.sort()

params.sort() trie par ordre croissant selon les unités de code UTF-16 des noms, et non selon les valeurs. Le tri tient compte des majuscules et des minuscules ; il n’est ni adapté à la langue ni numérique. Il est stable : les entrées ayant le même nom conservent leur ordre. La méthode ne prend aucun argument, modifie l’objet et renvoie undefined.

L’appel sur url.searchParams met à jour l’URL ; une nouvelle sérialisation peut modifier l’encodage, par exemple remplacer %20 par +. Pour conserver l’original, créez une copie avec new URLSearchParams(params). Il s’agit d’une API Web définie par le URL Standard, et non d’une méthode ECMAScript.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources