Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

URL.searchParams

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨avril 2018⁩.

La propriété en lecture seule searchParams de l'interface URL retourne un objet URLSearchParams permettant d'accéder aux arguments décodés de la requête GET contenue dans l'URL.

Note : Cette fonctionnalité est disponible via les Web Workers.

Syntaxe

js
var urlSearchParams = URL.searchParams;

Value

Un objet URLSearchParams.

Exemples

Si l'URL de votre page est https://example.com/?nom=Jonathan%20Smith&age=18 vous pouvez extraire les paramètres 'nom' et 'age' en utilisant:

js
let params = new URL(document.location).searchParams;
let name = params.get("nom"); // la chaine de caractère "Jonathan Smith".
let age = parseInt(params.get("age")); // le nombre 18

Spécifications

Specification
URL
# dom-url-searchparams

Compatibilité des navigateurs