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.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/pt-br/web/api/url_api/index.md)

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