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 des URLSearchParams Interfaces fügt ein bestimmtes Schlüssel/Wert-Paar als neuen Suchparameter hinzu.

Wie im folgenden Beispiel gezeigt, erscheint derselbe Schlüssel in der Parameterzeichenkette mehrfach, wenn er mehrmals hinzugefügt wird, und zwar für jeden Wert.

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

Hinzufügen desselben Parameters mehrfach

js
const url = new URL("https://example.com?foo=1&bar=2");
const 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
# dom-urlsearchparams-append

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch