Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

URLSearchParams: set()-Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die set()-Methode des URLSearchParams-Interfaces legt den Wert fest, der mit einem gegebenen Suchparameter assoziiert ist. Gibt es mehrere übereinstimmende Werte, löscht diese Methode die anderen. Existiert der Suchparameter nicht, erstellt diese Methode ihn.

Syntax

js
set(name, value)

Parameter

name

Der Name des festzulegenden Parameters.

value

Der Wert des festzulegenden Parameters.

Rückgabewert

Keiner (undefined).

Beispiele

js
let url = new URL("https://example.com?foo=1&bar=2");
let params = new URLSearchParams(url.search);

// Add a third parameter.
params.set("baz", 3);
params.toString(); // "foo=1&bar=2&baz=3"

Spezifikationen

Spezifikation
URL
# dom-urlsearchparams-set

Browser-Kompatibilität