Web Sockets API
WebSocket.send() 方法将需要通过 WebSocket 链接传输至服务器的数据排入队列,并根据所需要传输的 data bytes 的大小来增加 bufferedAmount的值。若数据无法传输(例如数据需要缓存而缓冲区已满)时,套接字会自行关闭。
语法
WebSocket.send("Hello server!");
参数
data- : 用于传输至服务器的数据。它必须是以下类型之一:
- String
- : 文本字符串。字符串将以 UTF-8 格式添加到缓冲区,并且
bufferedAmount将加上该字符串以 UTF-8 格式编码时的字节数的值。
- : 文本字符串。字符串将以 UTF-8 格式添加到缓冲区,并且
- ArrayBuffer
- : 你可以使用类型化数组对象发送底层二进制数据;其二进制数据内存将被缓存于缓冲区,
bufferedAmount将加上所需字节数的值。
- : 你可以使用类型化数组对象发送底层二进制数据;其二进制数据内存将被缓存于缓冲区,
- Blob
- :
Blob类型将队列 blob 中的原始数据以二进制中传输。bufferedAmount将加上原始数据的字节数的值。
- :
- TypedArray
- : 你可以以二进制帧的形式发送任何 JavaScript 类数组对象 ;其二进制数据内容将被队列于缓冲区中。值
bufferedAmount将加上必要字节数的值。
- : 你可以以二进制帧的形式发送任何 JavaScript 类数组对象 ;其二进制数据内容将被队列于缓冲区中。值
- String
- : 用于传输至服务器的数据。它必须是以下类型之一:
异常
INVALID_STATE_ERR- : 当前连接未处于
OPEN状态。
- : 当前连接未处于
SYNTAX_ERR- : 数据是一个包含未配对代理 (unpaired surrogates) 的字符串。
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
