WebSocket : évènement message

Syntaxe

Utilisez le nom de l'évènement dans des méthodes telles que addEventListener(), ou définissez une propriété de gestionnaire d'évènements.

addEventListener("message", (event) => { })

onmessage = (event) => { }

Type d'évènement

Un objet MessageEvent. Hérite de l'objet Event.

Propriétés de l'évènement

En plus des propriétés listées ci-dessous, les propriétés de l'interface parente, Event, sont disponibles.

data Lecture seule

Les données envoyées par l'émetteur du message. Le type de cette propriété dépend du type du message WebSocket et de la valeur de WebSocket.binaryType.

• Si le type du message est "text", alors ce champ est une chaîne de caractères.
• Si le type du message est "binary", alors le type de cette propriété peut être déduit du binaryType de ce socket :
  • ArrayBuffer si binaryType vaut "arraybuffer",
  • Blob si binaryType vaut "blob". Cela n'a pas de type média associé (Blob.type vaut "").

origin Lecture seule

Une chaîne de caractères représentant l'origine de l'émetteur du message.

Les autres propriétés de l'interface MessageEvent sont présentes, mais ne concernent pas l'API WebSocket et restent à leurs valeurs par défaut :

• lastEventId Lecture seule
• source Lecture seule
• ports Lecture seule

Exemples

// Crée une connexion WebSocket
const socket = new WebSocket("ws://localhost:8080");

// Écoute les différents messages
socket.addEventListener("message", (event) => {
  console.log("Message reçu du serveur ", event.data);
});

Spécifications

Compatibilité des navigateurs

Voir aussi

• WebSocket : évènement close
• WebSocket : évènement error
• WebSocket : évènement open
• Écrire des applications clientes WebSocket