HTMLAnchorElement : propriété search
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 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
// 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 :
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
Chargement…
Voir aussi
- L'interface
HTMLAnchorElementà laquelle cette propriété appartient.