WebSocket: sự kiện message

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: This feature is available in Web Workers.

Sự kiện message được kích hoạt khi dữ liệu được nhận qua WebSocket.

Cú pháp

Dùng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt một thuộc tính trình xử lý sự kiện.

js
addEventListener("message", (event) => { })

onmessage = (event) => { }

Kiểu sự kiện

Một MessageEvent. Kế thừa từ Event.

Event MessageEvent

Thuộc tính sự kiện

Ngoài các thuộc tính liệt kê bên dưới, các thuộc tính từ giao diện cha, Event, cũng có sẵn.

data Read only

Dữ liệu do bộ phát thông điệp gửi. Kiểu của thuộc tính này phụ thuộc vào kiểu thông điệp WebSocket và giá trị của WebSocket.binaryType.

  • Nếu kiểu thông điệp là "text", trường này là một chuỗi.
  • Nếu kiểu thông điệp là "binary", kiểu của thuộc tính này có thể được suy ra từ binaryType của socket này:
    • ArrayBuffer nếu binaryType"arraybuffer",
    • Blob nếu binaryType"blob". Kiểu này không có kiểu phương tiện đi kèm (Blob.type"").
origin Read only

Một chuỗi biểu thị origin của bộ phát thông điệp.

Các thuộc tính khác từ giao diện MessageEvent vẫn có mặt, nhưng không liên quan tới API WebSocket và được giữ ở giá trị mặc định:

Ví dụ

js
// Tạo kết nối WebSocket.
const socket = new WebSocket("ws://localhost:8080");

// Lắng nghe thông điệp
socket.addEventListener("message", (event) => {
  console.log("Thông điệp từ máy chủ ", event.data);
});

Thông số kỹ thuật

Thông số kỹ thuật
WebSockets
# dom-websocket-onmessage

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

Xem thêm