BackgroundFetchUpdateUIEvent: updateUI() method
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.
The updateUI()
method of the BackgroundFetchUpdateUIEvent
interface updates the title and icon in the user interface to show the status of a background fetch.
This method may only be run once, to notify the user on a failed or a successful fetch.
Syntax
js
updateUI()
updateUI(options)
Parameters
Return value
A Promise
.
Exceptions
InvalidStateError
DOMException
-
Thrown if any of the following are true:
- The
isTrusted
property isfalse
. - The
BackgroundFetchUpdateUIEvent
UI updated flag is already set, indicating that theupdateUI()
method has already been called. - The
BackgroundFetchUpdateUIEvent
is not active.
- The
Examples
The following example demonstrates updating the UI with a title and image icon on a successful fetch.
js
addEventListener("backgroundfetchsuccess", (event) => {
event.updateUI({
title: "Episode 5 ready to listen!",
icon: {
src: "path/to/success.ico",
sizes: "16x16 32x32 64x64",
},
});
});
Specifications
Specification |
---|
Background Fetch # background-fetch-update-ui-event-update-ui |
Browser compatibility
BCD tables only load in the browser