WebSocket()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Le constructeur WebSocket() renvoie un nouvel objet WebSocket.

Syntaxe

js
var aWebSocket = new WebSocket(url [, protocols]);

Paramètres

url

L'URL à laquelle se connecter. Cela devrait être l'URL à laquelle le serveur WebSocket répondra.

protocols Facultatif

Une valeur qui est une chaîne de caractères représentant un seul protocole ou un tableau de chaînes de caractères représentant une liste de protocoles. Ces chaînes de caractères indiquent des sous-protocoles : un serveur donné pourra implémenter différents sous-protocoles WebSocket (on peut vouloir qu'un serveur soit capable de gérér différents types d'interaction selon le protocol indiqué). Si cette valeur est absence, c'est un tableau vide qui est utilisé par défaut : [].

Exceptions levées

SECURITY_ERR

Le port ciblé par la tentative de connexion est bloqué.

SyntaxError

L'URL est invalide.

Spécifications

Specification
WebSockets Standard
# ref-for-dom-websocket-websocket①

Compatibilité des navigateurs

BCD tables only load in the browser