Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

WebSocket()

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

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
# ref-for-dom-websocket-websocket①

Compatibilité des navigateurs