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

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
forEach

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Has more compatibility info.

See also

  • The URL interface.