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

HTMLAnchorElement : propriété search

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨juillet 2015⁩.

La propriété search de l'interface HTMLAnchorElement est une chaîne de recherche, aussi appelée chaîne de requête (query string en anglais), qui est une chaîne contenant "?" suivie des paramètres du href de l'élément <a>. Si l'URL ne possède pas de chaîne de requête, cette propriété contient une chaîne vide ("").

Cette propriété peut être définie pour modifier la chaîne de requête de l'URL. Lors de l'affectation, un préfixe "?" unique est ajouté à la valeur fournie, si ce n'est pas déjà le cas. Lui attribuer "" supprime la chaîne de requête.

La requête est encodée en pourcentage lors de l'écriture, mais n'est pas décodée lors de la lecture.

Les navigateurs modernes proposent URLSearchParams et URL.searchParams pour faciliter l'extraction des paramètres de la chaîne de requête.

Voir URL.search pour plus d'informations.

Valeur

Une chaîne de caractères.

Exemples

Récupérer la chaîne de recherche depuis un lien d'ancre

js
// Un élément <a id="myAnchor" href="/fr/docs/HTMLAnchorElement?q=123"> est présent dans le document
const anchor = document.getElementById("myAnchor");
anchor.search; // retourne '?q=123'

Analyse avancée avec URLSearchParams

On peut aussi utiliser URLSearchParams :

js
let params = new URLSearchParams(queryString);
let q = parseInt(params.get("q"), 10); // retourne le nombre 123

Spécifications

Specification
HTML
# dom-hyperlink-search-dev

Compatibilité des navigateurs

Voir aussi