ServiceWorker: phương thức postMessage()

Cú pháp

postMessage(message)
postMessage(message, transfer)
postMessage(message, options)

Tham số

message

Đối tượng cần chuyển đến worker; đối tượng này sẽ nằm trong trường data của sự kiện được chuyển đến sự kiện message. Đây có thể là bất kỳ đối tượng JavaScript nào được xử lý bởi thuật toán sao chép theo cấu trúc.

Tham số message là bắt buộc. Nếu dữ liệu cần truyền đến worker không quan trọng, phải truyền rõ ràng null hoặc undefined.

Note: Service worker không nằm trong cùng nhóm agent với client của nó, do đó không thể chia sẻ bộ nhớ. Các đối tượng SharedArrayBuffer, hoặc các buffer view được hỗ trợ bởi nó, không thể được đăng qua các nhóm agent. Việc cố gắng làm vậy sẽ tạo ra sự kiện messageerror chứa DOMException DataCloneError ở đầu nhận.

transfer Optional

Một mảng các đối tượng có thể chuyển nhượng tùy chọn để chuyển quyền sở hữu. Quyền sở hữu của các đối tượng này được chuyển cho phía đích và chúng không còn khả dụng ở phía gửi. Các đối tượng có thể chuyển nhượng này nên được đính kèm vào thông điệp; nếu không chúng sẽ được di chuyển nhưng thực sự không thể truy cập ở đầu nhận.

options Optional

Một đối tượng tùy chọn chứa các thuộc tính sau:

transfer Optional

Có ý nghĩa giống như tham số transfer.

Giá trị trả về

Không có (undefined).

Ngoại lệ

SyntaxError

Được ném ra nếu tham số message không được cung cấp.

Ví dụ

Trong ví dụ này, một ServiceWorker được tạo và một thông điệp được gửi ngay lập tức:

navigator.serviceWorker.register("service-worker.js");

navigator.serviceWorker.ready.then((registration) => {
  registration.active.postMessage(
    "Test message sent immediately after creation",
  );
});

Để nhận thông điệp, service worker, trong service-worker.js, phải lắng nghe sự kiện message trên phạm vi toàn cục của nó.

// Đoạn này phải nằm trong `service-worker.js`
addEventListener("message", (event) => {
  console.log(`Message received: ${event.data}`);
});

Lưu ý rằng service worker có thể gửi thông điệp trở lại luồng chính bằng cách sử dụng phương thức postMessage(). Để nhận nó, luồng chính cần lắng nghe sự kiện message trên đối tượng ServiceWorkerContainer.

Đặc tả kỹ thuật

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

Xem thêm

• Giao diện ServiceWorker mà nó thuộc về.
• Phương thức đối ứng postMessage() mà service worker phải sử dụng để gửi thông điệp trở lại ServiceWorkerContainer được liên kết.