Firefox Tomorrow

web api instance method

URLSearchParams: forEach() method

View on MDN ↗

Available in 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

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also

  • The URL interface.