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 der HTMLAreaElement-Schnittstelle ist eine Suchzeichenkette, auch query string genannt. Es handelt sich dabei um eine Zeichenkette, die ein "?" gefolgt von den Parametern des href-Attributs des <area>-Elements enthält. Wenn die URL keine Suchabfrage besitzt, enthält diese Eigenschaft eine leere Zeichenkette, "".

Diese Eigenschaft kann gesetzt werden, um die Suchzeichenkette der URL zu ändern. Beim Setzen wird der Wert mit einem vorangestellten "?" versehen, falls dieser nicht bereits vorhanden ist. Wird der Wert auf "" gesetzt, wird die Suchzeichenkette entfernt.

Die Suchzeichenkette wird beim Setzen percent-codiert, jedoch beim Lesen nicht percent-decodiert.

Moderne Browser bieten URLSearchParams und URL.searchParams, um das Parsen der Parameter aus der Suchzeichenkette zu erleichtern.

Weitere Informationen finden Sie unter URL.search.

Wert

Ein Zeichenkette.

Beispiele

js
// An <area id="myArea" href="/en-US/docs/HTMLAreaElement?q=123"> element is in the document
const area = document.getElementById("myArea");
area.search; // returns '?q=123'

Erweiterte Analyse mit URLSearchParams

Alternativ kann URLSearchParams verwendet werden:

js
let params = new URLSearchParams(queryString);
let q = parseInt(params.get("q")); // returns the number 123

Spezifikationen

Specification
HTML
# dom-hyperlink-search-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch