HTMLAreaElement : 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 HTMLAreaElement est une chaîne de recherche, aussi appelée chaîne de requête, qui est une chaîne de caractères contenant un "?" suivi des paramètres du href de l'élément <area>. Si l'URL ne possède pas de chaîne de recherche, 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'écriture, un préfixe "?" est ajouté à la valeur fournie si elle n'est pas déjà présente. La définir à "" 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
Obtenir la chaîne de recherche depuis un lien area
// Un élément <area id="myArea" href="/fr/docs/Web/API/HTMLAreaElement?q=123"> est dans le document
const area = document.getElementById("myArea");
area.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
Voir aussi
- L'interface
HTMLAreaElementà laquelle elle appartient.