URLSearchParams.get()

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

Esta é uma tecnologia experimental
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.

 

O métod get()  da interface URLSearchParams,  retorna o primeiro valor associado ao parametro de busca fornecido.

Syntax

URLSearchParams.get(name)

Parâmetros

name
O nome do parâmetro à ser retornado.

Retorno

Um USVString se o parâmetro de pesquisa for encontrado; Caso contrário, null.

Exemplo

Se a URL da sua página é https://example.com/?name=Jonathan&age=18 você pode obter o parâmetro 'name' e 'age'  usando:

let params = new URLSearchParams(document.location.search.substring(1));
let name = params.get("name"); // retorna a string "Jonathan"
let age = parseInt(params.get("age"), 10); // retorna o número 18

Buscar um  parâmetro que não esteja presente na string de pesquisa, retornará  null:

let address = params.get("address"); // null

Especificações

Especificação Status Comment
URL
The definition of 'get()' in that specification.
Padrão em tempo real Definição inicial.

Browser compatibility

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!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 49.0 (Yes) Não suportado (Yes) ?
Feature Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support Não suportado 49.0 (Yes) Não suportado (Yes) ? 49.0

Etiquetas do documento e colaboradores

Colaboradores desta página: DanieleCastilho
Última atualização por: DanieleCastilho,