URLSearchParams.get()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Experimental: 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
Specification |
---|
URL Standard # dom-urlsearchparams-get |
Compatibilidade com navegadores
BCD tables only load in the browser