SyncManager: register() method

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Note: This feature is available in Web Workers.

Phương thức register() của giao diện SyncManager đăng ký một sự kiện đồng bộ, kích hoạt sự kiện sync bên trong service worker liên quan ngay khi có kết nối mạng.

Cú pháp

js
register(tag)

Tham số

tag

Định danh cho sự kiện đồng bộ này. Đây sẽ là giá trị của thuộc tính tag của SyncEvent được truyền vào trình xử lý sự kiện sync của service worker.

Giá trị trả về

Một Promise phân giải thành undefined.

Ngoại lệ

InvalidStateError DOMException

Được ném ra nếu service worker hiện tại chưa hoạt động.

NotAllowedError DOMException

Được ném ra nếu đồng bộ nền đã bị người dùng tắt.

Ví dụ

Hàm bất đồng bộ sau đăng ký đồng bộ nền từ một ngữ cảnh duyệt web:

js
async function syncMessagesLater() {
  const registration = await navigator.serviceWorker.ready;
  try {
    await registration.sync.register("sync-messages");
  } catch {
    console.log("Background Sync could not be registered!");
  }
}

Thông số kỹ thuật

Thông số kỹ thuật
Web Background Synchronization
# dom-syncmanager-register

Tương thích trình duyệt