WebSocket

O objeto WebSocket provê uma API para criação e gerenciamento de uma conexão WebSocket com um servidor, bem como o envio e recebimento de dados através dessa conexão.

O construtor do WebSocket aceita um parâmetro obrigatório e um opcional:

WebSocket WebSocket(
  in DOMString url,
  in optional DOMString protocols
);

WebSocket WebSocket(
  in DOMString url,
  in optional DOMString[] protocols
);

url

A URL da devida conexão; esta deve ser a URL da qual o servidor WebSocket irá responder.

protocols Optional

Um único protocolo em formato texto ou uma lista de textos de protocolo. Estes textos são usados para indicar sub-protocolos, assim então um único servidor pode implementar múltiplos sub-protocolos WebSocket (por exemplo, você pode querer um servidor capaz de manipular diferentes tipos de interações dependendo do protocolo especificado). se você não especificar um protocolo em texto, será assumido um texto vazio.

O construtor pode lançar exceções:

SECURITY_ERR

A porta a qual a conexão está sendo executada está bloqueada.

Visão Geral do método

Atributos

Constantes

Estados de constantes prontas

Essas constantes são usadas pelo atributo readyState para descrever o estado da conexão do WebSocket.

Métodos

close()

Fecha a conexão do WebSocket ou a tentativa de conexão, se houver. Se a conexão já for CLOSED , este método não faz nada.

void close(
  É opcional: unsigned short code,
  É opcional: DOMString reason
);

Parametros

code Optional

Um valor numérico que indica o código de status explicando por que a conexão está sendo fechada. Se esse parâmetro não for especificado, é assumido um valor padrão de 1000 (indicando um fechamento "completo da transação"). Veja a lista de status de códigos na CloseEvent página de valores permitidos.

reason Optional

Uma string legível para humanos que explica por que a conexão está se fechando. Esta seqüência de caracteres não deve ter mais de 123 bytes de texto UTF-8 (não caracteres).

Exceções lançadas

INVALID_ACCESS_ERR

Foi especificado um códigoinválido.

SYNTAX_ERR

A string reason é muito longa ou contém substitutos não comparados.

send()

Transmite dados para o servidor através da conexão WebSocket.

void send(
  in DOMString data
);

void send(
  in ArrayBuffer data
);

void send(
  in Blob data
); 

Parametros

data

Uma sequência de texto para enviar para o servidor.

Exceções lançadas

INVALID_STATE_ERR

A conexão não está atualmente OPEN .

SYNTAX_ERR

Os dados são uma string que tem substituto não comparado.

Especificações

Navegador Compatível

[1] Iniciado no Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3), o construtor está prefixado. Você precisará usar MozWebSocket() : var mySocket = new MozWebSocket("http://www.example.com/socketserver");

As extensões atribuídas não eram suportadas no Gecko até Gecko 8.0.

Antes do Gecko 11.0 (Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8), as mensagens de saída enviadas usavam o método send(), eram limitadas a 16MB. Agora elas podem ter até 2GB de tamanho.

Veja também

• Escrevendo aplicativos clientes do WebSocket