URLSearchParams.get()

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

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

 

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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,