URLSearchParams

A interface URLSearchParams define métodos de utilização para trabalhar com query string de uma URL.

Uma implementação do objeto URLSearchParams pode diretamente ser usado em uma estrutura for...of, em vez de entries() (en-US): for (var p of mySearchParams) é equivalente de for (var p of mySearchParams.entries()).

Construtor

URLSearchParams() (en-US): Construtor retorna um objeto URLSearchParams.

Propriedades

Esta interface não herda nenhuma propriedade.

Métodos

Esta interface não herda nenhum método.

URLSearchParams.append() (en-US): Acrescenta um par de chave/valor específica com um novo parâmetro de busca.
URLSearchParams.delete() (en-US): Exclui o parâmetro de busca informado, e seu valor associado, da lista de parâmetros de busca.
URLSearchParams.entries() (en-US): Retorna um iterator permitindo obter por todos os pares de chave/valor contidos neste objeto.
URLSearchParams.get(): Retorna o primeiro valor associado ao parâmetro de busca informado.
URLSearchParams.getAll() (en-US): Retorna todos os valores associados com o parâmetro de busca encontrado.
URLSearchParams.has() (en-US): Retorna um Boolean indicando se cada um dos parâmetros de busca existe.
URLSearchParams.keys() (en-US): Retorna um iterator permitindo obter todas as chaves dos pares de chave/valor contido neste objeto.
URLSearchParams.set() (en-US): Define o valor associado ao parâmetro de busca com o valor informado. Se tiver mutios valores, exclua os outros.
URLSearchParams.toString() (en-US): Retorna uma string contendo uma query string adequada pra usar numa URL.
URLSearchParams.values(): Retorna um iterator permitindo obter todos os valores dos pares de chave/valor contido neste objeto.

Exemplo

var stringParams = "q=URLUtils.searchParams&topic=api"
var paramsBusca = new URLSearchParams(stringParams);

//Iterar os parâmetros de busca.
for (let p of paramsBusca) {
  console.log(p);
}

paramsBusca.has("topic") === true; // true
paramsBusca.get("topic") === "api"; // true
paramsBusca.getAll("topic"); // ["api"]
paramsBusca.get("foo") === null; // true
paramsBusca.append("topic", "webdev");
paramsBusca.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
paramsBusca.set("topic", "More webdev");
paramsBusca.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
paramsBusca.delete("topic");
paramsBusca.toString(); // "q=URLUtils.searchParams"

Especificações

Especificação	Situação	Comentário
URL The definition of 'URLSearchParams' in that specification.	Padrão em tempo real	Initial definition.

Compatibilidade com navegadores

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar! (en-US)

Desktop
Dispositivo móvel

Característica	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Suporte básico	49	29.0 (29.0)	Não suportado	36	Não suportado
`entries()`, `keys()`, `values()`, e suporte de `for...of`	49	44.0 (44.0)	Não suportado	36	Não suportado

Característica	Android	Android Webview	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile	Chrome for Android
Suporte básico	Não suportado	49	29.0 (29.0)	Não suportado	?	Não suportado	49
`entries()`, `keys()`, `values()`, e suporte de `for...of`	Não suportado	49	44.0 (44.0)	Não suportado	?	Não suportado	49

Veja também

Outras interfaces relacionadas com URL: URL, URLUtils.
Google Developers: Easy URL manipulation with URLSearchParams