Standort: 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 der Location-Schnittstelle ist eine Suchzeichenfolge, auch bekannt als Abfragezeichenfolge, die eine Zeichenfolge mit einem "?" ist, gefolgt von den Parametern der URL des Standorts. Wenn die URL keine Suchanfrage hat, enthält diese Eigenschaft eine leere Zeichenfolge, "".
Diese Eigenschaft kann gesetzt werden, um die Abfragezeichenfolge der URL zu ändern. Beim Setzen wird ein einzelnes "?"-Präfix zum bereitgestellten Wert hinzugefügt, falls nicht bereits vorhanden. Das Setzen auf "" entfernt die Abfragezeichenfolge.
Die Abfrage wird beim Setzen prozentkodiert, aber beim Lesen nicht dekodiert.
Moderne Browser bieten
URLSearchParams
und
URL.searchParams
an, um das Auslesen der Parameter aus der Abfragezeichenfolge zu erleichtern.
Siehe URL.search für weitere Informationen.
Wert
Eine Zeichenfolge.
Beispiele
// Let an <a id="myAnchor" href="/en-US/docs/Location.search?q=123"> element be in the document
const anchor = document.getElementById("myAnchor");
const queryString = anchor.search; // Returns:'?q=123'
// Further parsing:
const params = new URLSearchParams(queryString);
const q = parseInt(params.get("q"), 10); // is the number 123
Spezifikationen
| Specification |
|---|
| HTML # dom-location-search-dev |