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.
addEventListener("message", (event) => { })
onmessage = (event) => { }
Kiểu sự kiện
Một MessageEvent. Kế thừa từ Event.
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.
dataRead 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ừ
binaryTypecủa socket này:ArrayBuffernếubinaryTypelà"arraybuffer",BlobnếubinaryTypelà"blob". Kiểu này không có kiểu phương tiện đi kèm (Blob.typelà"").
originRead 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:
lastEventIdRead onlysourceRead onlyportsRead only
Ví dụ
// 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> |