@wahr/capacitor-websocket-client

Capacitor WebSocket Client Plugin.

Install

npm install @wahr/capacitor-websocket-client
npx cap sync

Platform support

• Web
• Android

Unfortunately, we do not have a macOS device, but we are working hard.

Example

Single connect

await WebSocket.onOpen({}, (message, err) => {
    //do something...
    console.log("onOpen event have a bug: ", err?.toString())
})

await WebSocket.onMessage({}, (message, err) => {
    //do something...
    console.log(`received message content: ${message?.data}`)
})

await WebSocket.connect({url: "ws://example.com"})

setTimeout(async () => {
    await WebSocket.send({data: "hello world!"})
}, 2000);

Multiple connect

await WebSocket.onOpen({id: "chat-websocket"}, (message, err) => {
    //do something...
    console.log("onOpen event have a bug: ", err?.toString())
})

await WebSocket.connect({url: "ws://example.com/chat", id: "chat-websocket"})

await WebSocket.onMessage({id: "notify-websocket"}, (message, err) => {
    //do something...
    console.log(`received notify content: ${message?.data}`)
})

await WebSocket.connect({url: "ws://example.com/notify", id: "notify-websocket"})

setTimeout(async () => {
    await WebSocket.send({data: "hello world!", id: "chat-websocket"})
    await WebSocket.send({data: "connect notify.", id: "notify-websocket"})
}, 2000)

API

connect(options
:
ConnectionOptions
) =>
Promise<void>

close(options ? : CloseOptions | undefined)
=>
Promise<void>

send(options
:
SendMessageOptions
) =>
Promise<void>

onOpen(options
:
OnOpenOptions, callback
:
OnOpenCallback
) =>
Promise<void>

onMessage(options
:
OnMessageOptions, callback
:
OnMessageCallback
) =>
Promise<void>

onClose(options
:
OnCloseOptions, callback
:
OnCloseCallback
) =>
Promise<void>

onError(options
:
OnErrorOptions, callback
:
OnErrorCallback
) =>
Promise<void>