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