ServiceWorkerContainer

Thuộc tính instance

ServiceWorkerContainer.controller Read only

Một đối tượng ServiceWorker đại diện cho service worker đang hoạt động kiểm soát trang hiện tại hoặc null nếu trang không có service worker đang hoạt động hoặc đang kích hoạt.

ServiceWorkerContainer.ready Read only

Trả về một Promise sẽ resolve với ServiceWorkerRegistration liên kết với trang hiện tại, nhưng chỉ khi có một service worker đang hoạt động. Điều này cung cấp một cơ chế để trì hoãn việc thực thi mã cho đến khi service worker hoạt động.

Phương thức instance

ServiceWorkerContainer.getRegistration()

Lấy một đối tượng ServiceWorkerRegistration có scope phù hợp với URL tài liệu được cung cấp. Phương thức trả về một Promise resolve thành một ServiceWorkerRegistration hoặc undefined.

ServiceWorkerContainer.getRegistrations()

Trả về tất cả các đối tượng ServiceWorkerRegistration liên kết với ServiceWorkerContainer trong một mảng. Phương thức trả về một Promise resolve thành một mảng các ServiceWorkerRegistration.

ServiceWorkerContainer.register()

Tạo hoặc cập nhật một ServiceWorkerRegistration cho scriptURL đã cho.

ServiceWorkerContainer.startMessages()

Khởi động rõ ràng luồng tin nhắn được phân phối từ service worker đến các trang thuộc quyền kiểm soát của nó (ví dụ: được gửi qua Client.postMessage()). Điều này có thể được sử dụng để phản hồi các tin nhắn đã gửi sớm hơn, ngay cả khi nội dung của trang đó chưa tải xong.

Sự kiện

controllerchange

Được kích hoạt khi ServiceWorkerRegistration liên kết với tài liệu có được một worker active mới.

message

Được kích hoạt khi các tin nhắn đến được nhận bởi đối tượng ServiceWorkerContainer (ví dụ: thông qua lệnh gọi MessagePort.postMessage()).

messageerror

Được kích hoạt khi các tin nhắn đến không thể được giải tuần tự hóa bởi đối tượng ServiceWorkerContainer (ví dụ: thông qua lệnh gọi MessagePort.postMessage()).

Ví dụ

Ví dụ dưới đây trước tiên kiểm tra xem trình duyệt có hỗ trợ service workers không. Nếu được hỗ trợ, mã sẽ đăng ký service worker và xác định xem trang có đang được service worker kiểm soát tích cực không. Nếu không, nó sẽ nhắc người dùng tải lại trang để service worker có thể kiểm soát. Mã cũng báo cáo mọi lỗi đăng ký.

if ("serviceWorker" in navigator) {
  // Register a service worker hosted at the root of the
  // site using the default scope.
  navigator.serviceWorker
    .register("/sw.js")
    .then((registration) => {
      console.log("Service worker registration succeeded:", registration);

      // At this point, you can optionally do something
      // with registration. See https://mdn.go-mizu.dev/vi/docs/Web/API/ServiceWorkerRegistration
    })
    .catch((error) => {
      console.error(`Service worker registration failed: ${error}`);
    });

  // Independent of the registration, let's also display
  // information about whether the current page is controlled
  // by an existing service worker, and when that
  // controller changes.

  // First, do a one-off check if there's currently a
  // service worker in control.
  if (navigator.serviceWorker.controller) {
    console.log(
      "This page is currently controlled by:",
      navigator.serviceWorker.controller,
    );
  }

  // Then, register a handler to detect when a new or
  // updated service worker takes control.
  navigator.serviceWorker.oncontrollerchange = () => {
    console.log(
      "This page is now controlled by",
      navigator.serviceWorker.controller,
    );
  };
} else {
  console.log("Service workers are not supported.");
}

Đặc tả kỹ thuật

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

Xem thêm

• Sử dụng Service Workers
• Ví dụ mã cơ bản về service workers
• Sử dụng web workers