Oggetto WebSocket

Processore di conversione del protocollo del pacchetto WebSocket

Viene utilizzato per convertire il protocollo HTTP in un messaggio di protocollo a pacchetto WebSocket. Metodo di creazione:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
var ws = require('ws');
var http = require('http');

var serv = new http.Server(8811, ws.upgrade((conn) => {
    conn.onmessage = msg => {
        conn.send(new Date());
    };
}));

serv.run(r => 0);

var sock = new ws.Socket('ws://127.0.0.1:8811');
sock.on('open', () => {
    setInterval(() => {
        sock.send('get date');
    }, 1000);
});

sock.onmessage = evt => {
    console.log(evt.data);
}

Eredità

Costruttore

WebSocket

Costruttore WebSocket

1
2
3
new WebSocket(String url,
    String protocol = "",
    String origin = "");

Parametri di chiamata:

url: Stringa, specifica il server connesso
protocol: Stringa, specifica il protocollo di handshake, il valore predefinito è ""
origin: String, specifica la sorgente da simulare durante l'handshake, il valore predefinito è ""

Costruttore WebSocket

1
2
new WebSocket(String url,
    Object opts);

Parametri di chiamata:

url: Stringa, specifica il server connesso
opts: Oggetto, opzione di connessione, il valore predefinito è {}

opts contiene opzioni aggiuntive richieste e il contenuto supportato è il seguente:

1
2
3
4
5
6
7
8{
    "protocol": "", // 指定握手协议，缺省为空
    "origin": "", // 指定握手时模拟的源，缺省为空
    "perMessageDeflate": false, // 指定是否支持压缩，缺省不支持
    "maxPayload": 67108864, // 指定最大数据包尺寸，缺省为 67108864
    "httpClient": hc, // 自定义 httpClient 对象，缺省使用全局 httpClient
    "headers": // 指定 http(s) 连接时携带的 header，缺省为 {}，
}

Proprietà statiche

defaultMaxListeners

Intero, il numero massimo globale predefinito di ascoltatori

1
static Integer WebSocket.defaultMaxListeners;

Attributi dei membri

url

Stringa, interroga il server connesso all'oggetto corrente

1
readonly String WebSocket.url;

protocol

Stringa, interroga il protocollo quando l'oggetto corrente è connesso

1
readonly String WebSocket.protocol;

origin

Stringa, interroga l'origine della connessione all'oggetto corrente

1
readonly String WebSocket.origin;

readyState

Intero, interroga lo stato di connessione dell'oggetto corrente, vedi ws

1readonly Integer WebSocket.readyState;

onopen

Evento di successo della connessione di funzione, query e associazione, equivalente a on("open", func);

1
Function WebSocket.onopen;

onmessage

Funzione, interrogazione e associazione dell'evento di ricezione del messaggio dell'altra parte, equivalente a on("messaggio", func);

1
Function WebSocket.onmessage;

onclose

Funzione, interroga e associa l'evento di chiusura della connessione, equivalente a on("close", func);

1
Function WebSocket.onclose;

onerror

Eventi di errore di funzione, query e associazione, equivalenti a on("error", func);

1
Function WebSocket.onerror;

Funzione membro

close

Chiudere la connessione corrente, questa operazione invierà un pacchetto CLOSE all'altra parte e attenderà che l'altra parte risponda

1
2
WebSocket.close(Integer code = 1000,
    String reason = "");

Parametri di chiamata:

code: Intero, specificare il codice da chiudere, il valore consentito è 3000-4999 o 1000, il valore predefinito è 1000
reason: String, specifica il motivo della chiusura, il valore predefinito è ""

send

Invia un messaggio all'altra parte

1
WebSocket.send(String data);

Parametri di chiamata:

data: Stringa, specifica il testo inviato

Invia un dato binario all'altra parte

1WebSocket.send(Buffer data);

Parametri di chiamata:

data: Buffer, Specificare i dati binari da inviare

ref

Mantieni l'uscita del processo fibjs e impedisci l'uscita del processo fibjs durante l'associazione degli oggetti

1WebSocket WebSocket.ref();

Risultato di ritorno:

WebSocket, Restituisce l'oggetto corrente

unref

Consenti l'uscita del processo fibjs e l'uscita del processo fibjs durante l'associazione dell'oggetto

1WebSocket WebSocket.unref();

Risultato di ritorno:

WebSocket, Restituisce l'oggetto corrente

on

Associa un gestore di eventi all'oggetto

1
2
Object WebSocket.on(String ev,
    Function func);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento
func: Funzione, specifica la funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Associa un gestore di eventi all'oggetto

1
Object WebSocket.on(Object map);

Parametri di chiamata:

map: Oggetto, specificare la relazione di mappatura dell'evento, il nome della proprietà dell'oggetto verrà utilizzato come nome dell'evento e il valore della proprietà verrà utilizzato come funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

addListener

Associa un gestore di eventi all'oggetto

1
2
Object WebSocket.addListener(String ev,
    Function func);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento
func: Funzione, specifica la funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Associa un gestore di eventi all'oggetto

1
Object WebSocket.addListener(Object map);

Parametri di chiamata:

map: Oggetto, specificare la relazione di mappatura dell'evento, il nome della proprietà dell'oggetto verrà utilizzato come nome dell'evento e il valore della proprietà verrà utilizzato come funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

prependListener

Associa un gestore di eventi all'inizio dell'oggetto

1
2
Object WebSocket.prependListener(String ev,
    Function func);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento
func: Funzione, specifica la funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Associa un gestore di eventi all'inizio dell'oggetto

1
Object WebSocket.prependListener(Object map);

Parametri di chiamata:

map: Oggetto, specificare la relazione di mappatura dell'evento, il nome della proprietà dell'oggetto verrà utilizzato come nome dell'evento e il valore della proprietà verrà utilizzato come funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

once

Associa una funzione di elaborazione dell'evento una tantum all'oggetto, la funzione di elaborazione una tantum verrà attivata solo una volta

1
2
Object WebSocket.once(String ev,
    Function func);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento
func: Funzione, specifica la funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Associa una funzione di elaborazione dell'evento una tantum all'oggetto, la funzione di elaborazione una tantum verrà attivata solo una volta

1
Object WebSocket.once(Object map);

Parametri di chiamata:

map: Oggetto, specificare la relazione di mappatura dell'evento, il nome della proprietà dell'oggetto verrà utilizzato come nome dell'evento e il valore della proprietà verrà utilizzato come funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

prependOnceListener

Associa un gestore di eventi all'inizio dell'oggetto

1
2
Object WebSocket.prependOnceListener(String ev,
    Function func);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento
func: Funzione, specifica la funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Associa un gestore di eventi all'inizio dell'oggetto

1
Object WebSocket.prependOnceListener(Object map);

Parametri di chiamata:

map: Oggetto, specificare la relazione di mappatura dell'evento, il nome della proprietà dell'oggetto verrà utilizzato come nome dell'evento e il valore della proprietà verrà utilizzato come funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

off

Annulla la funzione specificata dalla coda di elaborazione dell'oggetto

1
2
Object WebSocket.off(String ev,
    Function func);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento
func: Funzione, specifica la funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Annulla tutte le funzioni nella coda di elaborazione dell'oggetto

1
Object WebSocket.off(String ev);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Annulla la funzione specificata dalla coda di elaborazione dell'oggetto

1
Object WebSocket.off(Object map);

Parametri di chiamata:

map: Oggetto, specificare la relazione di mappatura dell'evento, il nome della proprietà dell'oggetto viene utilizzato come nome dell'evento e il valore della proprietà viene utilizzato come funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

removeListener

Annulla la funzione specificata dalla coda di elaborazione dell'oggetto

1
2
Object WebSocket.removeListener(String ev,
    Function func);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento
func: Funzione, specifica la funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Annulla tutte le funzioni nella coda di elaborazione dell'oggetto

1
Object WebSocket.removeListener(String ev);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Annulla la funzione specificata dalla coda di elaborazione dell'oggetto

1
Object WebSocket.removeListener(Object map);

Parametri di chiamata:

map: Oggetto, specificare la relazione di mappatura dell'evento, il nome della proprietà dell'oggetto viene utilizzato come nome dell'evento e il valore della proprietà viene utilizzato come funzione di elaborazione dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

removeAllListeners

Annulla tutti i listener di tutti gli eventi dalla coda di elaborazione dell'oggetto.Se viene specificato un evento, rimuovere tutti i listener dell'evento specificato.

1
Object WebSocket.removeAllListeners(String ev);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

Annulla tutti i listener di tutti gli eventi dalla coda di elaborazione dell'oggetto.Se viene specificato un evento, rimuovere tutti i listener dell'evento specificato.

1
Object WebSocket.removeAllListeners(Array evs = []);

Parametri di chiamata:

evs: Array, specifica il nome dell'evento

Risultato di ritorno:

Object, Restituisce l'oggetto evento stesso, che è conveniente per la chiamata a catena

setMaxListeners

Il limite predefinito del numero di ascoltatori, solo per compatibilità

1WebSocket.setMaxListeners(Integer n);

Parametri di chiamata:

n: Intero, specifica il numero di eventi

getMaxListeners

Ottieni il limite predefinito del numero di ascoltatori, solo per compatibilità

1Integer WebSocket.getMaxListeners();

Risultato di ritorno:

Integer, Torna al numero limite predefinito

listeners

Array di ascoltatori per l'evento specificato dell'oggetto query

1
Array WebSocket.listeners(String ev);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento

Risultato di ritorno:

Array, Restituisce un array di ascoltatori per l'evento specificato

listenerCount

Il numero di ascoltatori per l'evento specificato dell'oggetto query

1
Integer WebSocket.listenerCount(String ev);

Parametri di chiamata:

ev: Stringa, specifica il nome dell'evento

Risultato di ritorno:

Integer, Restituisce il numero di ascoltatori per l'evento specificato

Il numero di ascoltatori per l'evento specificato dell'oggetto query

1
2Integer WebSocket.listenerCount(Value o,
    String ev);

Parametri di chiamata:

o: Valore, specifica l'oggetto della query
ev: Stringa, specifica il nome dell'evento

Risultato di ritorno:

Integer, Restituisce il numero di ascoltatori per l'evento specificato

eventNames

Interroga il nome dell'evento dell'ascoltatore

1
Array WebSocket.eventNames();

Risultato di ritorno:

Array, Restituisce un array di nomi di eventi

emit

Attiva attivamente un evento

1
2
Boolean WebSocket.emit(String ev,
    ...args);

Parametri di chiamata:

ev: Stringa, nome dell'evento
args: ..., parametri dell'evento, che verranno passati al gestore dell'evento

Risultato di ritorno:

Boolean, Ritorna allo stato di attivazione dell'evento, restituisce true se c'è un evento di risposta, altrimenti restituisce false

toString

Restituisce la rappresentazione in stringa dell'oggetto, generalmente restituisce "[Native Object]", l'oggetto può essere re-implementato secondo le proprie caratteristiche

1
String WebSocket.toString();

Risultato di ritorno:

String, Restituisce la rappresentazione di stringa dell'oggetto

toJSON

Restituisce la rappresentazione in formato JSON dell'oggetto, generalmente restituisce una raccolta di attributi leggibili definiti dall'oggetto

1
Value WebSocket.toJSON(String key = "");

Parametri di chiamata:

key: Stringa, inutilizzata

Risultato di ritorno:

Value, Restituisce un valore contenente JSON serializzabile

Guida allo sviluppo

Modulo base

Oggetti incorporati

Modulo comunitario

Oggetto WebSocket

Eredità

Costruttore

WebSocket

Proprietà statiche

defaultMaxListeners

Attributi dei membri

url

protocol

origin

readyState

onopen

onmessage

onclose

onerror

Funzione membro

close

send

ref

unref

on

addListener

prependListener

once

prependOnceListener

off

removeListener

removeAllListeners

setMaxListeners

getMaxListeners

listeners

listenerCount

eventNames

emit

toString

toJSON