connectSocket

title: Taro.connectSocket(option)

sidebar_label: connectSocket

Creates a WebSocket connection. Read related instructions before use.

Number of Concurrent Connections

• In version 1.7.0 or later, up to 5 WebSocket connections can exist at the same time.

• Before version 1.7.0, a mini program can only have one WebSocket connection at a time.If a WebSocket connection already exists, it will be automatically disabled and a new one will be created.

Reference

Type

(option: Option) => Promise<SocketTask>

Parameters

Option

Sample Code

Example 1

Taro.connectSocket({
  url: 'wss://example.qq.com',
  header:{
    'content-type': 'application/json'
  },
  protocols: ['protocol1']
})

Example 2

Taro.connectSocket({
  url: 'ws://echo.websocket.org/echo',
  success: function () {
    console.log('connect success')
  }
}).then(task => {
  task.onOpen(function () {
    console.log('onOpen')
    task.send({ data: 'xxx' })
  })
  task.onMessage(function (msg) {
    console.log('onMessage: ', msg)
    task.close()
  })
  task.onError(function () {
    console.log('onError')
  })
  task.onClose(function (e) {
    console.log('onClose: ', e)
  })
})

API Support