URLSearchParams: set()-Methode

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.

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

Specification
URL Standard
# dom-urlsearchparams-set

Browser-Kompatibilität

BCD tables only load in the browser