Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

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 ⁨abril de 2018⁩.

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
# dom-url-searchparams

Compatibilidade de browser