开发
API

SocketTask.onClose

基础库 1.0.0 开始支持本方法,这是一个同步方法。

监听 WebSocket 与服务器连接断开的事件。

语法

SocketTask.onClose(callback)

参数说明

callback

类型默认值必填说明最低支持版本
function连接断开的事件回调1.0.0

回调函数参数说明

object 类型,属性如下:

属性名类型说明最低支持版本
protocolTypestring使用的网络传输层协议1.0.0
socketTypestringwebsocket 类型1.0.0
errMsgstring错误信息1.0.0
reasonstring关闭原因1.81.0
codestring关闭 code1.81.0

返回值

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

<!-- index.ttml -->
<view>
  <button size="default" bindtap="socketConnect">创建 WebSocket</button>
  <button size="default" bindtap="closeSocket">关闭 WebSocket</button>
</view>
let socketTask;
Page({
  socketConnect() {
    socketTask = tt.connectSocket({
      url: "wss://someurl",
      success: (res) => {
        console.log("创建成功", res);
      },
      fail: (res) => {
        console.log("创建失败", res);
      },
    });

    socketTask.onClose((res) => {
      // WebSocket连接已经断开
      console.log("WebSocket 已断开", res);
    });
  },
  closeSocket() {
    // 关闭 websocket 连接
    if (socketTask) {
      socketTask.close();
    }
  },
});

Bug & Tip

  • Bug: IDE 目前没有返回 protocolTypesocketType 字段;
  • Tip:WebSocket 服务器接口地址必须是 wss 协议,且域名必须是后台配置的合法域名。请参考网络请求
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助