URLSearchParams: forEach() method

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

Note: This feature is available in Web Workers

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

No specification found

No specification data found for api.URLSearchParams.forEach.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

BCD tables only load in the browser

See also

  • The URL interface.