URLSearchParams: delete() メソッド

delete() は URLSearchParams インターフェイスのメソッドで、すべての検索パラメーターのリストから、指定された検索パラメーターとそれに関連するすべての値を削除します。

パラメーター名とオプションの値は、パラメーターの照合に使用されます。パラメーター名のみが指定された場合、その名前に一致するすべての検索パラメーターが、関連する値とともに削除されます。パラメーター名と値の両方が指定された場合、パラメーター名と値の両方に一致するすべての検索パラメーターが削除されます。

注: この機能は Web Worker 内で利用可能です。

構文

delete(name)
delete(name, value)

引数

name: 削除するパラメーターの名前。
value 省略可: パラメーターを削除するために、指定された名前とともにパラメーターが一致しなければならない値。

<pre id="log"></pre>

const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}

const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);
log(`Query string (before):\t ${params}`);
params.delete("foo");
log(`Query string (after):\t ${params}`);

以下のログは、foo という名前を持つパラメータがすべて削除されていることを示しています。

指定した名前と値を持つパラメーターの削除

この例では、特定の名前と値に一致するクエリーパラメーターを削除する方法を示します。

<pre id="log"></pre>

const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}

const url = new URL("https://example.com?foo=1&bar=2&foo=3&foo=1");
const params = new URLSearchParams(url.search);
log(`Query string (before):\t ${params}`);
params.delete("foo", "1");
log(`Query string (after):\t ${params}`);

パラメーターの name と value の両方が一致するパラメーターがすべて削除されるはずです（上記のように、同じ名前と値を持つパラメーターを 2 つ指定する理由はありません）。

ブラウザーが value オプションに対応している場合、"after" の文字列は bar=2&foo=3 となります。そうでない場合、結果は前の例 (bar=2) と同じになります。

仕様書

Specification
URL Standard # dom-urlsearchparams-delete

ブラウザーの互換性

BCD tables only load in the browser

URLSearchParams: delete() メソッド

構文

引数

返値

例

指定された名前のすべてのパラメーターを削除

指定した名前と値を持つパラメーターの削除

仕様書

ブラウザーの互換性

関連情報