MDN self-hosted library · e01.org

URLSearchParams: forEach() method

URL API

URL API

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

  • : 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.