HTMLAnchorElement: search-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die search-Eigenschaft der Schnittstelle HTMLAnchorElement ist eine Suchzeichenfolge, auch Query String genannt. Sie enthält ein "?", gefolgt von den Parametern des href-Attributs des <a>-Elements. Wenn die URL keine Suchabfrage enthält, enthält diese Eigenschaft eine leere Zeichenfolge, "".
Diese Eigenschaft kann festgelegt werden, um den Query String der URL zu ändern. Beim Festlegen wird dem angegebenen Wert ein einzelnes Präfix "?" hinzugefügt, sofern es nicht bereits vorhanden ist. Das Festlegen auf "" entfernt den Query String.
Die Abfrage wird beim Festlegen prozentkodiert, beim Lesen jedoch nicht prozentdekodiert.
Die Eigenschaft URL.searchParams ist ein URLSearchParams-Objekt, das das Parsen der Parameter aus dem Query String ermöglicht. Siehe auch URL.search.
Wert
Eine Zeichenfolge.
Beispiele
Abrufen der Suchzeichenfolge aus einem Anchor-Link
// An <a id="myAnchor" href="/en-US/docs/HTMLAnchorElement?q=123"> element is in the document
const anchor = document.getElementById("myAnchor");
anchor.search; // returns '?q=123'
Erweitertes 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
| Spezifikation |
|---|
| HTML # dom-hyperlink-search-dev |
Browser-Kompatibilität
Siehe auch
- Die Schnittstelle
HTMLAnchorElement, zu der sie gehört.