1. Mozilla
  2. Add-ons
  3. Browser extensions
  4. JavaScript APIs
  5. webRequest
  6. webRequest.HttpHeaders

webRequest.HttpHeaders

An array of HTTP headers. Each header is represented as an object with two properties: name and either value or binaryValue.

Type

An array of objects. Each object has the following properties:

name

string. Name of the HTTP header.

value Optional

string. Value of the HTTP header if it can be represented by UTF-8. Either this property or binaryValue must be present.

binaryValue Optional

array of integer. Value of the HTTP header if it cannot be represented by UTF-8, represented as bytes (0..255). Either this property or value must be present.

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
HttpHeaders
Chrome – Full support
Chrome 17 (Release date: 2012-02-08)
footnote Full support
Edge – Full support
Edge 14 (Release date: 2016-08-02)
footnote Full support
Firefox – Full support
Firefox 45 (Release date: 2016-03-08)
footnote Full support
Opera – Full support
Opera 15 (Release date: 2013-07-02)
footnote Full support
Safari – Full support
Safari 14 (Release date: 2020-09-16)
footnote Full support
Firefox for Android – Full support
Firefox for Android 48 (Release date: 2016-08-02)
footnote Full support
Safari on iOS – Full support
Safari on iOS 18 (Release date: 2024-09-16)
footnote Full support

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

Full support

Note: This API is based on Chromium's chrome.webRequest API. This documentation is derived from web_request.json in the Chromium code.

This page was last modified on by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.