Workers - WebSocket binary messages now delivered as Blob by default

WebSocket バイナリメッセージがデフォルトで Blob として配信されるようになりました

公開日: 2026年4月21日

カテゴリ: Workers

WebSocket で受信したバイナリフレームは、デフォルトでメッセージイベントに Blob オブジェクトとして配信されるようになりました。これは WebSocket 仕様 および標準的なブラウザの動作に合致しています。以前は、バイナリフレームは常に ArrayBuffer として配信されていました。

WebSocket の binaryType プロパティは、WebSocket ごとに配信タイプを制御します。この変更は、websocket_standard_binary_type 互換性フラグを通じて、2026-03-17 以降の互換性日付を持つ Workers で有効になっています。

重要な注意事項

この変更が公開された際にドキュメント化すべきでしたが、できていませんでした。ご迷惑をおかけして申し訳ございません。

Worker がバイナリ WebSocket メッセージを処理し、event.data が ArrayBuffer であると想定している場合、フレームは代わりに Blob として到着します。単純な instanceof ArrayBuffer チェックは、すべてのフレームをサイレントにドロップします。

ArrayBuffer 配信への復帰

accept() を呼び出す前に binaryType を割り当てることで、ArrayBuffer 配信にオプトバックできます。これは互換性フラグに関係なく機能します:

const resp = await fetch("https://example.com", {
  headers: {
    Upgrade: "websocket",
  },
});
const ws = resp.webSocket;

// この WebSocket の ArrayBuffer 配信にオプトバックします。
ws.binaryType = "arraybuffer";
ws.accept();

ws.addEventListener("message", (event) => {
  if (typeof event.data === "string") {
    // テキストフレーム。
  } else {
    // event.data は ArrayBuffer です (上記で binaryType を設定したため)。
  }
});

Wrangler 設定での設定

まだ移行する準備ができておらず、Worker のすべての WebSocket に対してデフォルトとして ArrayBuffer を保持したい場合は、Wrangler 設定ファイルに no_websocket_standard_binary_type フラグを追加してください。

Durable Object への影響

この変更は、Durable Object の hibernatable WebSocket webSocketMessage ハンドラには影響しません。引き続きバイナリデータは ArrayBuffer として受信されます。

詳細情報

詳細については、WebSocket バイナリメッセージ を参照してください。