WebSocket: phương thức send()
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.
Phương thức WebSocket.send() xếp hàng dữ liệu đã chỉ định để truyền tới máy chủ qua kết nối WebSocket, làm tăng giá trị bufferedAmount theo số byte cần để chứa dữ liệu. Nếu dữ liệu không thể gửi đi (ví dụ, vì nó cần được đệm nhưng bộ đệm đã đầy), socket sẽ tự động đóng.
Trình duyệt sẽ ném ngoại lệ nếu bạn gọi send() khi kết nối đang ở trạng thái CONNECTING. Nếu bạn gọi send() khi kết nối đang ở trạng thái CLOSING hoặc CLOSED, trình duyệt sẽ âm thầm loại bỏ dữ liệu.
Cú pháp
send(data)
Tham số
data-
Dữ liệu cần gửi tới máy chủ. Nó có thể là một trong các kiểu sau:
string-
Một chuỗi văn bản. Chuỗi được thêm vào bộ đệm ở định dạng UTF-8, và giá trị của
bufferedAmounttăng theo số byte cần để biểu diễn chuỗi UTF-8 đó. ArrayBuffer-
Bạn có thể gửi dữ liệu nhị phân cơ bản được dùng bởi một đối tượng typed array; nội dung nhị phân của nó được xếp hàng trong bộ đệm, làm tăng giá trị
bufferedAmounttheo số byte cần thiết. Blob-
Chỉ định một
Blobsẽ xếp hàng dữ liệu thô của blob để truyền trong một khung nhị phân (Blob.typebị bỏ qua). Giá trịbufferedAmounttăng theo kích thước byte của dữ liệu thô đó. TypedArrayhoặcDataView-
Bạn có thể gửi bất kỳ đối tượng typed array của JavaScript nào như một khung nhị phân; nội dung nhị phân của nó được xếp hàng trong bộ đệm, làm tăng giá trị
bufferedAmounttheo số byte cần thiết.
Giá trị trả về
Không có (undefined).
Ngoại lệ
InvalidStateErrorDOMException-
Được ném ra nếu
WebSocket.readyStatelàCONNECTING.
Thông số kỹ thuật
| Specification |
|---|
| WebSockets # ref-for-dom-websocket-send① |