Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

URLSearchParams.sort(): ordenar parâmetros por nome

URLSearchParams.sort() ordena os parâmetros pelo nome e altera o objeto. As entradas com nomes idênticos mantêm a ordem original.

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

Sintaxe

params.sort()

params.sort() ordena por ordem crescente segundo as unidades de código UTF-16 dos nomes, não dos valores. Distingue maiúsculas de minúsculas; não tem em conta a língua nem ordena numericamente. A ordenação é estável: as entradas com nomes idênticos mantêm a sua ordem. O método não recebe argumentos, altera o objeto e devolve undefined.

A chamada em url.searchParams atualiza o URL; uma nova serialização pode alterar a codificação, por exemplo, de %20 para +. Para preservar o original, cria uma cópia com new URLSearchParams(params). Esta é uma Web API definida pelo URL Standard, não um método ECMAScript.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes