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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
append

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch