URLSearchParams: append() 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 append()-Methode der URLSearchParams Schnittstelle fügt ein spezifisches Schlüssel/Wert-Paar als neuen Suchparameter hinzu.

Wie im untenstehenden Beispiel gezeigt, wird der gleiche Schlüssel, wenn er mehrmals angehängt wird, mehrmals in der Parameterzeichenfolge für jeden Wert erscheinen.

Syntax

js
append(name, value)

Parameter

name

Der Name des Parameters, der hinzugefügt werden soll.

value

Der Wert des Parameters, der hinzugefügt werden soll.

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 second foo parameter.
params.append("foo", 4);
//Query string is now: 'foo=1&bar=2&foo=4'

Spezifikationen

Specification
URL Standard
# dom-urlsearchparams-append

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch