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 des HTMLAnchorElement-Interfaces ist eine Suchzeichenfolge, auch query string genannt. Sie ist eine Zeichenkette, die ein "?" gefolgt von den Parametern des href der <a>-Element enthält. Wenn die URL keine Suchanfrage hat, enthält diese Eigenschaft eine leere Zeichenkette, "".
Diese Eigenschaft kann gesetzt werden, um die Abfragezeichenfolge der URL zu ändern. Beim Setzen wird ein einzelnes "?" als Präfix zu dem bereitgestellten Wert hinzugefügt, wenn es nicht bereits vorhanden ist. Wenn sie auf "" gesetzt wird, wird die Abfragezeichenfolge entfernt.
Die Abfrage wird beim Setzen prozentcodiert, aber nicht prozentdekoriert beim Lesen.
Moderne Browser bieten
URLSearchParams
und
URL.searchParams
an, um einfach die Parameter aus der Abfragezeichenfolge zu extrahieren.
Weitere Informationen finden Sie unter URL.search.
Wert
Eine Zeichenkette.
Beispiele
Die Suchzeichenfolge aus einem Anker-Link abrufen
// 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'
Erweiterte Analyse 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
- Das
HTMLAnchorElement-Interface, zu dem es gehört.