ServiceWorkerGlobalScope: sự kiện backgroundfetchfail
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.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is only available in Service Workers.
Sự kiện backgroundfetchfail của giao diện ServiceWorkerGlobalScope được kích hoạt khi một thao tác background fetch đã thất bại: nghĩa là, khi ít nhất một yêu cầu mạng trong fetch không hoàn thành thành công.
Sự kiện này không thể hủy và không nổi bọt.
Cú pháp
Sử dụng tên sự kiện trong các phương thức như addEventListener(), hoặc thiết lập một thuộc tính trình xử lý sự kiện.
addEventListener("backgroundfetchfail", (event) => { })
onbackgroundfetchfail = (event) => { }
Loại sự kiện
Thuộc tính sự kiện
Kế thừa các thuộc tính từ giao diện cha, BackgroundFetchEvent.
BackgroundFetchUpdateUIEvent.updateUI()-
Cập nhật UI của phần tử mà trình duyệt hiển thị để cho biết tiến trình của thao tác fetch.
Mô tả
Khi một thao tác background fetch thất bại (nghĩa là ít nhất một trong các yêu cầu mạng riêng lẻ không hoàn thành thành công), trình duyệt khởi động service worker nếu cần thiết, và kích hoạt sự kiện backgroundfetchfail trong phạm vi toàn cục của service worker.
Trong background fetch API, trình duyệt hiển thị một phần tử UI cho người dùng để cho biết tiến trình của thao tác. Trong trình xử lý backgroundfetchfail, service worker có thể cập nhật UI đó để cho thấy thao tác đã thất bại. Để làm điều này, trình xử lý gọi phương thức updateUI() của sự kiện, truyền vào một tiêu đề và/hoặc biểu tượng mới.
Trong trình xử lý cho backgroundfetchfail này, service worker cũng có thể dọn dẹp bất kỳ dữ liệu liên quan nào cho thao tác. Nó cũng có thể lấy và lưu trữ bất kỳ phản hồi thành công nào (ví dụ: sử dụng API Cache). Để truy cập dữ liệu phản hồi, service worker sử dụng thuộc tính registration của sự kiện.
Ví dụ
Cập nhật UI
Trình xử lý sự kiện này cập nhật UI để cho người dùng biết thao tác đã thất bại.
addEventListener("backgroundfetchfail", (event) => {
event.updateUI({ title: "Could not complete download" });
});
Đặc tả kỹ thuật
| Specification |
|---|
| Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchfail |