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


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

string. Name of the HTTP header.
string. Value of the HTTP header if it can be represented by UTF-8. Either this property or binaryValue must be present.
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 Firefox for Android Opera
Basic Support Yes Yes 45.0 48.0 33


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

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: wbamberg
 Last updated by: wbamberg,