URLSearchParams: append() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。

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

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

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

構文

append(name, value)

引数

name: 追加するパラメーターの名前。
value: 追加するパラメーターの値。

返値

なし (undefined)。

例

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'

仕様書

仕様書
URL # dom-urlsearchparams-append

ブラウザーの互換性

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって 2026年2月17日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

URLSearchParams: append() メソッド

構文

引数

返値

例

仕様書

ブラウザーの互換性

関連情報

MDN の改良に協力