URLSearchParams: append() メソッド

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.

メモ: この機能はウェブワーカー内で利用可能です。

append() は URLSearchParams インターフェイスのメソッドで、指定されたキー/値のペアを新しい検索パラメーターとして追加します。

下にある例に示すように、同じキーが複数回追加された場合、各値がパラメーター文字列に複数回現れます。

構文

js
append(name, value)

引数

name

追加するパラメーターの名前。

value

追加するパラメーターの値。

返値

なし (undefined)。

例

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

// 2番目の foo パラメーターを追加します。
params.append("foo", 4);
// クエリー文字列はこうなる: 'foo=1&bar=2&foo=4'

仕様書

Specification
URL Standard
# dom-urlsearchparams-append

ブラウザーの互換性

BCD tables only load in the browser

関連項目