URLSearchParams: forEach() method

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.

Note: This feature is available in Web Workers.

The forEach() method of the URLSearchParams interface allows iteration through all values contained in this object via a callback function.

Syntax

forEach(callback) forEach(callback, thisArg)

Parameters

callback

Function to execute on each element, which is passed the following arguments:

value: The value of the current entry being processed in the URLSearchParams object.
key: The key of the current entry being processed in the URLSearchParams object.
searchParams: The URLSearchParams object the forEach() was called upon.

thisArg Optional

Value to use as this when executing callback.

Return value

None (undefined).

Examples

// Create a test URLSearchParams object const searchParams = new URLSearchParams("key1=value1&key2=value2");  // Log the values searchParams.forEach((value, key) => {   console.log(value, key); });

The result is:

value1 key1 value2 key2

Specifications

Specification
URL # dom-urlsearchparams-urlsearchparams