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

CKTIS / JavaScript

URLSearchParams.append(): adicionar parâmetros de consulta

append(name, value) adiciona um par no fim dos parâmetros de consulta, preservando os valores anteriores com o mesmo nome.

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.append(name, value)

params.append(name, value) altera o objeto e devolve undefined, pelo que não é possível encadear chamadas. Ambos os argumentos são obrigatórios.

append() preserva os duplicados e a ordem. get() lê o primeiro valor e getAll() lê todos. Em contrapartida, set() substitui o primeiro valor e remove os restantes com esse nome.

Passa texto não codificado. toString() utiliza a codificação application/x-www-form-urlencoded: um espaço passa a + e um + literal passa a %2B; o resultado não inclui ?. Uma chamada através de url.searchParams atualiza o objeto URL associado. Esta Web API é definida pelo URL Standard, não pelo próprio ECMAScript.

Exemplos

const params = new URLSearchParams("tag=web");
const result = params.append("tag", "JavaScript basics");
console.log(params.toString());
console.log(JSON.stringify(params.getAll("tag")));
console.log(result);

Resultado

tag=web&tag=JavaScript+basics
["web","JavaScript basics"]
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