BackgroundFetchUpdateUIEvent: phương thức updateUI()
Khả dụng hạn chế
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 only available in Service Workers.
Phương thức updateUI() của giao diện BackgroundFetchUpdateUIEvent cập nhật tiêu đề và biểu tượng trong giao diện người dùng để hiển thị trạng thái của một thao tác tìm nạp nền.
Phương thức này chỉ có thể được chạy một lần để thông báo cho người dùng về một thao tác tìm nạp thành công hoặc thất bại.
Cú pháp
updateUI()
updateUI(options)
Tham số
optionsOptional-
Một đối tượng chứa bất kỳ mục nào sau đây:
iconsOptional-
Danh sách gồm một hoặc nhiều tài nguyên hình ảnh, chứa các biểu tượng để dùng trong giao diện người dùng. Một tài nguyên hình ảnh là một đối tượng chứa:
src-
Một chuỗi là URL của một hình ảnh.
sizesOptional-
Một chuỗi tương đương với thuộc tính
sizescủa phần tử<link>. typeOptional-
Một chuỗi chứa kiểu MIME của hình ảnh.
labelOptional-
Một chuỗi cung cấp tên cho hình ảnh liên kết.
titleOptional-
Một chuỗi chứa tiêu đề mới của giao diện người dùng.
Giá trị trả về
Một Promise.
Ngoại lệ
InvalidStateErrorDOMException-
Được ném ra nếu bất kỳ điều nào sau đây là đúng:
- Thuộc tính
isTrustedlàfalse. - Cờ cập nhật UI của
BackgroundFetchUpdateUIEventđã được thiết lập, cho biết phương thứcupdateUI()đã được gọi trước đó. BackgroundFetchUpdateUIEventkhông còn hoạt động.
- Thuộc tính
Ví dụ
Ví dụ sau minh họa việc cập nhật giao diện người dùng bằng tiêu đề và biểu tượng hình ảnh khi thao tác tìm nạp thành công.
addEventListener("backgroundfetchsuccess", (event) => {
event.updateUI({
title: "Episode 5 ready to listen!",
icon: {
src: "path/to/success.ico",
sizes: "16x16 32x32 64x64",
},
});
});
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Background Fetch # background-fetch-update-ui-event-update-ui |