URL.searchParams

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)

A propriedade searchParams da interface URL retorna um objeto URLSearchParams permitindo acesso ao GET decodificando os argumentos que contém na URL.

Nota: This feature is available in Web Workers.

Valor

Um objeto URLSearchParams.

Exemplos

Se a URl da sua página é https://example.com/?name=Jonathan%20Smith&age=18 você pode analisar os parâmetros name e age utilizando:

js
let params = new URL(document.location).searchParams;
let name = params.get("name"); // é a string "Jonathan Smith".
let age = parseInt(params.get("age")); // é o número 18

Especificações

Specification
URL Standard
# dom-url-searchparams

Compatibilidade de browser

BCD tables only load in the browser