HTMLAreaElement: search-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die search-Eigenschaft des HTMLAreaElement-Interfaces ist ein Suchstring, auch Query-String genannt, der eine Zeichenkette enthält, die mit einem "?" beginnt, gefolgt von den Parametern des href-Attributs des -Elements. Wenn die URL keine Suchanfrage enthält, enthält diese Eigenschaft einen leeren String, "".
Diese Eigenschaft kann gesetzt werden, um den Query-String der URL zu ändern. Beim Setzen wird ein einzelnes "?"-Präfix zum bereitgestellten Wert hinzugefügt, falls noch nicht vorhanden. Ein leerer Wert "" entfernt den Query-String.
Der Query wird beim Setzen prozentkodiert, beim Lesen jedoch nicht prozentdekodiert.
Moderne Browser bieten
URLSearchParams
und
URL.searchParams
an, um das Auslesen der Parameter aus dem Query-String zu erleichtern.
Weitere Informationen finden Sie unter URL.search.
Wert
Ein String.
Beispiele
Den Such-String von einem Area-Link abrufen
// An element is in the document
const area = document.getElementById("myArea");
area.search; // returns '?q=123'
Fortgeschrittenes Parsen mit URLSearchParams
Alternativ kann URLSearchParams verwendet werden:
let params = new URLSearchParams(queryString);
let q = parseInt(params.get("q"), 10); // returns the number 123
Spezifikationen
| Specification |
|---|
| HTML # dom-hyperlink-search-dev |
Browser-Kompatibilität
Siehe auch
- Das
HTMLAreaElement-Interface, zu dem es gehört.