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 Standard # dom-urlsearchparams-urlsearchparams

Browser compatibility

BCD tables only load in the browser