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.