URLSearchParams: forEach() method

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

Browser compatibility

See also

• The URL interface.