WebSocket : propriété binaryType - Les API Web | MDN

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 : propriété binaryType

Baseline Large disponibilité

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.

>

Note : Cette fonctionnalité est disponible via les Web Workers.

La propriété binaryType de l'interface WebSocket contrôle le type de données binaires reçues via la connexion WebSocket.

Valeur

Une chaîne de caractères :

"blob"

Utilise des objets Blob pour les données binaires. Il s'agit de la valeur par défaut.

"arraybuffer"

Utilise des objets ArrayBuffer pour les données binaires.

Exemples

js
// On crée une connexion WebSocket connection.
const socket = new WebSocket("ws://localhost:8080");

// On change le type de données binaires de "blob" à "arraybuffer"
socket.binaryType = "arraybuffer";

// On écoute les différents messages
socket.addEventListener("message", (event) => {
  if (event.data instanceof ArrayBuffer) {
    // Frame de données binaires
    const view = new DataView(event.data);
    console.log(view.getInt32(0));
  } else {
    // Frame textuelle
    console.log(event.data);
  }
});

Spécifications

Spécification
WebSockets>
# ref-for-dom-websocket-binarytype①>

Compatibilité des navigateurs