BackgroundFetchRecord
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Note: This feature is available in Web Workers.
The BackgroundFetchRecord interface of the Background Fetch API represents an individual request and response.
A BackgroundFetchRecord is created by the BackgroundFetchRegistration.matchAll() method, therefore there is no constructor for this interface.
There will be one BackgroundFetchRecord for each resource requested by fetch().
Instance properties
requestRead only-
Returns a
Request. responseReadyRead only-
Returns a promise that resolves with a
Response.
Examples
In this example an individual BackgroundFetchRecord is returned using BackgroundFetchRegistration.matchAll(). The BackgroundFetchRecord.request and BackgroundFetchRecord.responseReady are returned and logged to the console.
bgFetch.match("/ep-5.mp3").then(async (record) => {
if (!record) {
console.log("No record found");
return;
}
console.log(`Here's the request`, record.request);
const response = await record.responseReady;
console.log(`And here's the response`, response);
});
Specifications
| Specification |
|---|
| Background Fetch # background-fetch-record-interface |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
BackgroundFetchRecord
|
|
|
|
|
|
|
|
|
|
|
|
|
request
|
|
|
|
|
|
|
|
|
|
|
|
|
responseReady
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.