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

CKTIS / JavaScript

URLSearchParams.prototype.toString — serializar parâmetros de consulta

A chamada `params.toString()` devolve os parâmetros de consulta como texto, sem um `?` inicial. Utiliza a codificação de formulários e preserva a ordem e os nomes repetidos.

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.toString()

URLSearchParams.prototype.toString é o método de instância que serializa os parâmetros de consulta. Chama-o sem argumentos com params.toString(). Já a propriedade URLSearchParams.toString do construtor refere-se ao método herdado Function.prototype.toString, que não serializa os parâmetros.

O método de instância devolve o texto dos parâmetros sem um ? inicial, e não um URL completo. Uma lista vazia produz "".

A serialização utiliza application/x-www-form-urlencoded e UTF-8: um espaço passa a + e um + literal passa a %2B. Fornece valores não codificados para evitar que % seja codificado novamente.

Os pares são unidos com &, e os nomes e valores com =. A ordem e os nomes repetidos são preservados; um valor vazio produz name=. O método não ordena nem altera os parâmetros. Esta é uma API Web do URL Standard, não uma funcionalidade definida pelo ECMAScript.

Exemplos

const params = new URLSearchParams([
  ["q", "a b+c"],
  ["tag", "js"],
  ["tag", "web"],
  ["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));

Resultado

q=a+b%2Bc&tag=js&tag=web&empty=
""

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