# webSocket

WebSockets is an advanced technology that makes it possible to open an interactive communication session between the user's H5/iOS/android and a server. With this API, you can send messages to a server and receive event-driven responses without having to poll the server for a reply

# API

# WebSocket

create websocket

# WebSocket(url, protocol)

• @url, string, the URL to which to connect.
• @protocol, string, the websocket protocol.

const ws = weex.requireModule('webSocket');
ws.WebSocket('ws://echo.websocket.org','');

# send

Transmits data to the server over the WebSocket connection

# send(data)

• @data, string, a text string to send to the server.

const ws = weex.requireModule('webSocket');
ws.WebSocket('ws://echo.websocket.org','');
ws.send('some message.');

# close

Closes the WebSocket connection or connection attempt, if any. If the connection is already CLOSED, this method does nothing.

# close(code, reason)

• @code, number, the status code explaining why the connection is being closed.
• @reason, string, a string explaining why the connection is closing

const ws = weex.requireModule('webSocket');
ws.WebSocket('ws://echo.websocket.org','');
ws.close();

# onopen

An event listener to be called when the WebSocket connection's readyState changes to OPEN; this indicates that the connection is ready to send and receive data.

# onopen(options)

• @options, object, an empty object

const ws = weex.requireModule('webSocket')
ws.WebSocket('ws://echo.websocket.org','');
ws.onopen(function(event) {
console.log('onopen', event);
});

# onmessage

An event listener to be called when a message is received from the server

# onmessage(options)

• @options, object, the server message options.
  • data, string, the listener received message.

const ws = weex.requireModule('webSocket')
ws.WebSocket('ws://echo.websocket.org','');
ws.onmessage(function(event) {
  console.log('onmessage', event);
});

# onclose

An event listener to be called when the WebSocket connection's readyState changes to CLOSED

# onclose(options)

• @options, object, the CloseEvent is sent to clients using WebSockets when the connection is closed.
  • code, number, returns an unsigned short containing the close code send by the server.
  • reason, string, returns a string indicating the reason the server closed the connection.
  • wasClean, boolen, returns a Boolean that Indicates whether or not the connection was cleanly closed.

const ws = weex.requireModule('webSocket')
ws.WebSocket('ws://echo.websocket.org','');
ws.onclose(function(event) {
  console.log('onclose', event);
});

# onerror

An event listener to be called when an error occurs.

# onerror(options)

• @options, object, the error event.
  • data, string, the listener received error data.

const ws = weex.requireModule('webSocket')
ws.WebSocket('ws://echo.websocket.org','');
ws.onerror(function(event) {
  console.log('onerror', event);
});

Demos

• Demo
• Chat Demo