URLSearchParams: forEach() method

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

js
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

js
// 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

See also

  • The URL interface.