WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URL.searchParams — Abfrageparameter

URL.searchParams stellt Abfrageparameter als URLSearchParams-Objekt bereit, das mit der URL verknüpft ist.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

url.searchParams

URL.searchParams ist eine Instanzeigenschaft von URL, keine statische Methode. Die Eigenschaft ist schreibgeschützt, aber das zurückgegebene URLSearchParams-Objekt ist veränderbar. Änderungen aktualisieren die URL; wiederholte Lesezugriffe geben dasselbe Objekt zurück.

get() gibt den ersten Wert oder null zurück; getAll() verarbeitet wiederholte Namen. set() ersetzt die Werte eines Namens durch einen einzelnen Wert.

Die Serialisierung verwendet application/x-www-form-urlencoded: Ein Leerzeichen wird zu +. Dies ist eine WHATWG-Web-API und keine Funktion einer ECMAScript-Version; die Browserkompatibilität muss separat geprüft werden.

Beispiele

const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);

Ergebnis

js,web
https://example.com/?tag=api&q=hello+world

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen