Diesearch-Eigenschaft desURL-Interfaces ist eine Suchzeichenfolge, auchAbfragezeichenfolge (query string) genannt. Sie besteht aus einer Zeichenkette, die ein"?" gefolgt von den Parametern der URL enthält. Falls die URL keine Suchabfrage enthält, gibt diese Eigenschaft einen leeren String,"", zurück.

Diese Eigenschaft kann gesetzt werden, um die Abfragezeichenfolge der URL zu ändern. Beim Setzen wird ein einzelnes"?"-Präfix zur bereitgestellten Zeichenkette hinzugefügt, falls es nicht bereits vorhanden ist. Wenn sie auf"" gesetzt wird, wird die Abfragezeichenfolge entfernt.

Die Abfrage wirdprozentcodiert, wenn sie gesetzt wird, aber nicht prozentdecodiert, wenn sie gelesen wird.

Moderne Browser bieten dieURL.searchParams-Eigenschaft, um das Parsen der Parameter aus der Abfragezeichenfolge zu erleichtern.

Wert

Ein String.

Beispiele

Grundlegende Nutzung

const url = new URL(  "https://developer.mozilla.org/en-US/docs/Web/API/URL/search?q=123",);console.log(url.search); // Logs "?q=123"

Interaktion mit searchParams

DieURL.searchParams-Eigenschaft stellt diesearch-Zeichenfolge als einURLSearchParams-Objekt dar. Wenn diesesURLSearchParams aktualisiert wird, wird diesearch-Eigenschaft der URL entsprechend ihrer Serialisierung aktualisiert. Allerdings kodiertURL.search eine Teilmenge von Zeichen, dieURLSearchParams kodiert, und kodiert Leerzeichen als%20 statt als+. Dies kann zu unerwarteten Interaktionen führen—wenn SiesearchParams aktualisieren, selbst mit den gleichen Werten, könnte die URL unterschiedlich serialisiert werden.

const url = new URL("https://example.com/?a=b ~");console.log(url.href); // "https://example.com/?a=b%20~"console.log(url.searchParams.toString()); // "a=b+%7E"// This should be a no-op, but it changes the URL's query to the// serialization of its searchParamsurl.searchParams.sort();console.log(url.href); // "https://example.com/?a=b+%7E"const url2 = new URL("https://example.com?search=1234&param=my%20param");console.log(url2.search); // "?search=1234&param=my%20param"url2.searchParams.delete("search");console.log(url2.search); // "?param=my+param"

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DasURL-Interface, zu dem es gehört.