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

CKTIS / JavaScript

URLSearchParams.getAll(): todos os valores de um parâmetro

getAll(name) devolve um array com todos os valores do parâmetro de consulta com o nome indicado, preservando a ordem e os valores 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.getAll(name)

params.getAll(name) devolve um array de cadeias de caracteres para o nome de parâmetro indicado. Preserva a ordem e os valores repetidos; a comparação dos nomes distingue maiúsculas de minúsculas.

Se o nome não existir, o resultado é []. Já um parâmetro existente com um valor vazio produz [""]. Em contrapartida, get(name) devolve apenas o primeiro valor ou null.

O resultado é um array separado: modificá-lo não altera os parâmetros. Este método é uma API Web definida pelo URL Standard, e não uma funcionalidade de uma edição específica de ECMAScript. Confirme a sua disponibilidade no ambiente de destino; o Node 24 não comprova o suporte nos browsers.

Exemplos

const params = new URLSearchParams('tag=js&tag=web&tag=js&empty=');
console.log(JSON.stringify(params.getAll('tag')));
console.log(JSON.stringify(params.getAll('missing')));
console.log(JSON.stringify(params.getAll('empty')));

Resultado

["js","web","js"]
[]
[""]

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