webRequest.ResourceType
This type is a string, which represents the context in which a resource was fetched in a web request.
It's used to filter the requests you listen to using the webRequest API. For example: you can listen to requests only for images, or only for scripts.
Type
Values of this type are strings. Possible values are:
beacon
- Requests sent through the Beacon API.
csp_report
- Requests sent to the
report-uri
given in theContent-Security-Policy
header, when an attempt to violate the policy is detected. font
- Web fonts loaded for a
@font-face
CSS rule. image
- Resources loaded to be rendered as image, except for
imageset
on browsers that support that type (see browser compatibility below). imageset
- Images loaded by a
<picture>
element or given in an<img>
element'ssrcset
attribute. main_frame
- Top-level documents loaded into a tab.
media
- Resources loaded by a
<video>
or<audio>
element. object
- Resources loaded by an
<object>
or<embed>
element. - Browsers that don't have a dedicated
object_subrequest
type (see browser compatibility below), also label subsequent requests sent by the plugin asobject
. object_subrequest
- Requests sent by plugins.
ping
- Requests sent to the URL given in a hyperlink's
ping
attribute, when the hyperlink is followed. - Browsers that don't have a dedicated
beacon
type (see browser compatibility below), also label requests sent through the Beacon API asping
. script
- Code that is loaded to be executed by a
<script>
element or running in a Worker. speculative
- In a speculative connection the browser has determined that a request to a URI may be coming soon, so it starts a TCP and/or TLS handshake immediately, so it is ready more quickly when the resource is actually requested.
stylesheet
- CSS stylesheets loaded to describe the representation of a document.
sub_frame
- Documents loaded into an
<iframe>
or<frame>
element. web_manifest
- Web App Manifests loaded for websites that can be installed to the homescreen.
websocket
- Requests initiating a connection to a server through the WebSocket API.
xbl
- XBL bindings loaded to extend the behavior of elements in a document.
xml_dtd
- DTDs loaded for an XML document.
xmlhttprequest
- Requests sent by an
XMLHttpRequest
object or through the Fetch API. xslt
- XSLT stylesheets loaded for transforming an XML document.
other
- Resources that aren't covered by any other available type.
Browser compatibility
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
ResourceType | ChromeFull support44 | EdgeFull support79 | FirefoxFull support45 | OperaFull support31 | SafariNo supportNo | Firefox for AndroidFull support48 |
beacon | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support45 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support48 |
csp_report | ChromeFull support58 | EdgeFull support79 | FirefoxFull support45 | OperaFull support45 | SafariNo supportNo | Firefox for AndroidFull support48 |
font | ChromeFull support49 | EdgeFull support79 | FirefoxFull support45 | OperaFull support36 | SafariNo supportNo | Firefox for AndroidFull support48 |
imageset | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support45 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support48 |
media | ChromeFull support58 | EdgeFull support79 | FirefoxFull support45 | OperaFull support45 | SafariNo supportNo | Firefox for AndroidFull support48 |
object_subrequest | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support55
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support55
|
ping | ChromeFull support49
| EdgeFull support79 | FirefoxFull support45 | OperaFull support36
| SafariNo supportNo
| Firefox for AndroidFull support48 |
speculative | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support63 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support63 |
web_manifest | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support45 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support48 |
websocket | ChromeFull support58 | EdgeFull support79 | FirefoxFull support45 | OperaFull support45 | SafariNo supportNo | Firefox for AndroidFull support48 |
xbl | ChromeNo supportNo | EdgeNo supportNo | FirefoxNo support45 — 78 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support48 |
xml_dtd | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support45 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support48 |
xslt | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support45 | OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support48 |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Acknowledgements
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.