Workers - WebSockets が Close フレームに自動で応答するようになりました

公開日：2026-04-07

Workers ランタイムは、ピアから Close フレームを受信したときに相互の Close フレームを自動的に送信するようになりました。readyState は close イベントが発火する前に CLOSED に遷移します。この動作は WebSocket specification と標準ブラウザの挙動に一致します。

この変更は、互換性日付が 2026-04-07 以降の Workers（web_socket_auto_reply_to_close 互換フラグ経由）でデフォルトで有効になります。

• 既存のコードで close イベントハンドラ内から明示的に close() を呼び出している場合でも動作は継続します。WebSocket が既に閉じているときの呼び出しは静かに無視されます。

動作の例

サーバ側が相手の Close を受け取ったとき、readyState はすでに CLOSED になっています。サンプル：

const [client, server] = Object.values(new WebSocketPair());
server.accept();
server.addEventListener("close", (event) => {
    // readyState はすでに CLOSED — server.close() を呼ぶ必要はありません。
    console.log(server.readyState); // WebSocket.CLOSED
    console.log(event.code); // 1000
    console.log(event.wasClean); // true
});

WebSocket プロキシ（Half-open）モード

自動 Close の動作は、Worker がクライアントとバックエンドの間に入り、両側の Close を独立して調整する必要がある WebSocket プロキシングと干渉することがあります。このユースケースをサポートするために、accept() に { allowHalfOpen: true } を渡してください。

サンプル：

const [client, server] = Object.values(new WebSocketPair());
server.accept({ allowHalfOpen: true });
server.addEventListener("close", (event) => {
    // ここでは readyState はまだ CLOSING のままなので、
    // 他側の Close を調整する時間があります。
    console.log(server.readyState); // WebSocket.CLOSING

    // 準備ができたら手動で閉じる。
    server.close(event.code, "done");
});

補足

• この変更は WebSocket の仕様に準拠したものであり、ブラウザの標準的な挙動と一致します。
• 追加情報は「WebSockets Close behavior」を参照してください。

---

リソース: API、Cloudflare ドキュメント、ヘルプセンター。