msw 2.3.0-ws.rc-1 → 2.3.0-ws.rc-3

package/lib/iife/index.js

@@ -32,6 +32,7 @@ var MockServiceWorker = (() => {
     SET_TIMEOUT_MAX_ALLOWED_INT: () => SET_TIMEOUT_MAX_ALLOWED_INT,
     SetupApi: () => SetupApi,
     SetupWorkerApi: () => SetupWorkerApi,
+    WebSocketHandler: () => WebSocketHandler,
     bypass: () => bypass,
     cleanUrl: () => cleanUrl,
     delay: () => delay,
@@ -626,9 +627,13 @@ var MockServiceWorker = (() => {
   }
 
   // src/core/utils/logging/getTimestamp.ts
-  function getTimestamp() {
+  function getTimestamp(options) {
     const now = /* @__PURE__ */ new Date();
-    return [now.getHours(), now.getMinutes(), now.getSeconds()].map(String).map((chunk) => chunk.slice(0, 2)).map((chunk) => chunk.padStart(2, "0")).join(":");
+    const timestamp = `${now.getHours().toString().padStart(2, "0")}:${now.getMinutes().toString().padStart(2, "0")}:${now.getSeconds().toString().padStart(2, "0")}`;
+    if (options?.milliseconds) {
+      return `${timestamp}.${now.getMilliseconds().toString().padStart(3, "0")}`;
+    }
+    return timestamp;
   }
 
   // src/core/utils/logging/serializeRequest.ts
@@ -1065,7 +1070,7 @@ var MockServiceWorker = (() => {
     if (options === void 0) {
       options = {};
     }
-    var _a2 = options.strict, strict = _a2 === void 0 ? false : _a2, _b2 = options.start, start = _b2 === void 0 ? true : _b2, _c = options.end, end = _c === void 0 ? true : _c, _d = options.encode, encode = _d === void 0 ? function(x) {
+    var _a2 = options.strict, strict = _a2 === void 0 ? false : _a2, _b2 = options.start, start = _b2 === void 0 ? true : _b2, _c2 = options.end, end = _c2 === void 0 ? true : _c2, _d = options.encode, encode = _d === void 0 ? function(x) {
       return x;
     } : _d, _e = options.delimiter, delimiter = _e === void 0 ? "/#?" : _e, _f = options.endsWith, endsWith = _f === void 0 ? "" : _f;
     var endsWithRe = "[".concat(escapeString(endsWith), "]|$");
@@ -1124,7 +1129,7 @@ var MockServiceWorker = (() => {
     return stringToRegexp(path, keys, options);
   }
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/chunk-UJZOJSMP.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/chunk-UJZOJSMP.mjs
   var encoder = new TextEncoder();
   function encodeBuffer(text) {
     return encoder.encode(text);
@@ -1150,7 +1155,7 @@ var MockServiceWorker = (() => {
     return RESPONSE_STATUS_CODES_WITHOUT_BODY.has(status);
   }
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/chunk-HAGW22AN.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/chunk-HAGW22AN.mjs
   var IS_PATCHED_MODULE = Symbol("isPatchedModule");
 
   // node_modules/.pnpm/is-node-process@1.2.0/node_modules/is-node-process/lib/index.mjs
@@ -1440,7 +1445,8 @@ var MockServiceWorker = (() => {
     return message3.toString();
   }
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/chunk-SGO3INLV.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/chunk-QED3Q6Z2.mjs
+  var INTERNAL_REQUEST_ID_HEADER_NAME = "x-interceptors-internal-request-id";
   function getGlobalSymbol(symbol) {
     return (
       // @ts-ignore https://github.com/Microsoft/TypeScript/issues/24587
@@ -1583,8 +1589,11 @@ var MockServiceWorker = (() => {
       this.logger.info("cleared global instance!", this.symbol.description);
     }
   };
+  function createRequestId() {
+    return Math.random().toString(16).slice(2);
+  }
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/index.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/index.mjs
   var BatchInterceptor = class extends Interceptor {
     constructor(options) {
       BatchInterceptor.symbol = Symbol(options.name);
@@ -2291,7 +2300,7 @@ Invalid value has been removed from localStorage to prevent subsequent failed pa
         queryParams.push(paramName);
       });
       devUtils.warn(
-        `Found a redundant usage of query parameters in the request handler URL for "${method} ${path}". Please match against a path instead and access query parameters in the response resolver function using "req.url.searchParams".`
+        `Found a redundant usage of query parameters in the request handler URL for "${method} ${path}". Please match against a path instead and access query parameters using "new URL(request.url).searchParams" instead. Learn more: https://mswjs.io/docs/recipes/query-parameters`
       );
     }
     async parse(args) {
@@ -4824,7 +4833,7 @@ spurious results.`);
     }
   }
 
-  // node_modules/.pnpm/headers-polyfill@4.0.2/node_modules/headers-polyfill/lib/index.mjs
+  // node_modules/.pnpm/headers-polyfill@4.0.3/node_modules/headers-polyfill/lib/index.mjs
   var __create4 = Object.create;
   var __defProp6 = Object.defineProperty;
   var __getOwnPropDesc5 = Object.getOwnPropertyDescriptor;
@@ -5100,10 +5109,12 @@ spurious results.`);
   var HEADER_VALUE_DELIMITER = ", ";
   var _a;
   var _b;
+  var _c;
   var Headers2 = class _Headers {
     constructor(init) {
       this[_a] = {};
       this[_b] = /* @__PURE__ */ new Map();
+      this[_c] = "Headers";
       if (["Headers", "HeadersPolyfill"].includes(init?.constructor.name) || init instanceof _Headers || typeof globalThis.Headers !== "undefined" && init instanceof globalThis.Headers) {
         const initialHeaders = init;
         initialHeaders.forEach((value, name) => {
@@ -5126,7 +5137,7 @@ spurious results.`);
         });
       }
     }
-    [(_a = NORMALIZED_HEADERS, _b = RAW_HEADER_NAMES, Symbol.iterator)]() {
+    [(_a = NORMALIZED_HEADERS, _b = RAW_HEADER_NAMES, _c = Symbol.toStringTag, Symbol.iterator)]() {
       return this.entries();
     }
     *keys() {
@@ -5618,12 +5629,14 @@ Consider naming this operation or using "graphql.operation()" request handler to
   // src/core/handlers/WebSocketHandler.ts
   var kEmitter = Symbol("kEmitter");
   var kDispatchEvent = Symbol("kDispatchEvent");
-  var kDefaultPrevented = Symbol("kDefaultPrevented");
+  var kSender = Symbol("kSender");
   var WebSocketHandler = class {
     constructor(url) {
       this.url = url;
       this[kEmitter] = new Emitter();
+      this.callFrame = getCallFrame(new Error());
     }
+    callFrame;
     [kEmitter];
     parse(args) {
       const connection = args.event.data;
@@ -5637,19 +5650,13 @@ Consider naming this operation or using "graphql.operation()" request handler to
     }
     async [kDispatchEvent](event) {
       const parsedResult = this.parse({ event });
-      const shouldIntercept = this.predicate({ event, parsedResult });
-      if (!shouldIntercept) {
-        return;
-      }
-      if (!Reflect.get(event, kDefaultPrevented)) {
-        Reflect.set(event, kDefaultPrevented, true);
-      }
       const connection = event.data;
-      this[kEmitter].emit("connection", {
+      const resolvedConnection = {
         client: connection.client,
         server: connection.server,
         params: parsedResult.match.params || {}
-      });
+      };
+      this[kEmitter].emit("connection", resolvedConnection);
     }
   };
 
@@ -5752,13 +5759,13 @@ Consider naming this operation or using "graphql.operation()" request handler to
     }
   };
 
-  // src/core/ws/ws.ts
+  // src/core/ws.ts
   var wsBroadcastChannel = new BroadcastChannel("msw:ws-client-manager");
   function createWebSocketLinkHandler(url) {
     invariant(url, "Expected a WebSocket server URL but got undefined");
     invariant(
       isPath(url),
-      "Expected a WebSocket server URL but got %s",
+      "Expected a WebSocket server URL to be a valid path but got %s",
       typeof url
     );
     const clientManager = new WebSocketClientManager(wsBroadcastChannel);
@@ -5772,28 +5779,9 @@ Consider naming this operation or using "graphql.operation()" request handler to
         handler[kEmitter].on(event, listener);
         return handler;
       },
-      /**
-       * Broadcasts the given data to all WebSocket clients.
-       *
-       * @example
-       * const service = ws.link('wss://example.com')
-       * service.on('connection', () => {
-       *   service.broadcast('hello, everyone!')
-       * })
-       */
       broadcast(data) {
         this.broadcastExcept([], data);
       },
-      /**
-       * Broadcasts the given data to all WebSocket clients
-       * except the ones provided in the `clients` argument.
-       *
-       * @example
-       * const service = ws.link('wss://example.com')
-       * service.on('connection', ({ client }) => {
-       *   service.broadcastExcept(client, 'hi, the rest of you!')
-       * })
-       */
       broadcastExcept(clients, data) {
         const ignoreClients = Array.prototype.concat(clients).map((client) => client.id);
         clientManager.clients.forEach((otherClient) => {
@@ -5959,16 +5947,11 @@ Read more: https://mswjs.io/docs/getting-started/mocks`;
     return transformedResponse;
   }
 
-  // src/core/utils/internal/randomId.ts
-  function randomId() {
-    return Math.random().toString(16).slice(2);
-  }
-
   // src/core/getResponse.ts
   var getResponse = async (handlers, request) => {
     const result = await executeHandlers({
       request,
-      requestId: randomId(),
+      requestId: createRequestId(),
       handlers
     });
     return result?.response;
@@ -5996,7 +5979,9 @@ Read more: https://mswjs.io/docs/getting-started/mocks`;
       });
     }
     if (typeof document !== "undefined") {
-      const responseCookies = init.headers.get("Set-Cookie")?.split(",") || [];
+      const responseCookies = Headers2.prototype.getSetCookie.call(
+        init.headers
+      );
       for (const cookieString of responseCookies) {
         document.cookie = cookieString;
       }
@@ -6141,7 +6126,12 @@ Read more: https://mswjs.io/docs/getting-started/mocks`;
 
   // src/core/bypass.ts
   function bypass(input, init) {
-    const request = input instanceof Request ? input : new Request(input, init);
+    const request = new Request(
+      // If given a Request instance, clone it not to exhaust
+      // the original request's body.
+      input instanceof Request ? input.clone() : input,
+      init
+    );
     invariant(
       !request.bodyUsed,
       'Failed to create a bypassed request to "%s %s": given request instance already has its body read. Make sure to clone the intercepted request if you wish to read its body before bypassing it.',
@@ -6343,7 +6333,7 @@ Learn more about creating the Service Worker script: https://mswjs.io/docs/cli/i
           context.emitter,
           {
             onPassthroughResponse() {
-              messageChannel.postMessage("NOT_FOUND");
+              messageChannel.postMessage("PASSTHROUGH");
             },
             async onMockedResponse(response, { handler, parsedResult }) {
               const responseClone = response.clone();
@@ -6407,18 +6397,21 @@ This exception has been gracefully handled as a 500 response, however, it's stro
     };
   };
 
-  // src/browser/utils/requestIntegrityCheck.ts
-  async function requestIntegrityCheck(context, serviceWorker) {
+  // src/browser/utils/checkWorkerIntegrity.ts
+  async function checkWorkerIntegrity(context) {
     context.workerChannel.send("INTEGRITY_CHECK_REQUEST");
-    const { payload: actualChecksum } = await context.events.once(
-      "INTEGRITY_CHECK_RESPONSE"
-    );
-    if (actualChecksum !== "223d191a56023cd36aa88c802961b911") {
-      throw new Error(
-        `Currently active Service Worker (${actualChecksum}) is behind the latest published one (${"223d191a56023cd36aa88c802961b911"}).`
+    const { payload } = await context.events.once("INTEGRITY_CHECK_RESPONSE");
+    if (payload.checksum !== "26357c79639bfa20d64c0efca2a87423") {
+      devUtils.warn(
+        `The currently registered Service Worker has been generated by a different version of MSW (${payload.packageVersion}) and may not be fully compatible with the installed version.
+
+It's recommended you update your worker script by running this command:
+
+  \u2022 npx msw init <PUBLIC_DIR>
+
+You can also automate this process and make the worker script update automatically upon the library installations. Read more: https://mswjs.io/docs/cli/init.`
       );
     }
-    return serviceWorker;
   }
 
   // src/browser/setupWorker/start/createResponseListener.ts
@@ -6514,19 +6507,12 @@ Please consider using a custom "serviceWorker.url" option to point to the actual
           }
           window.clearInterval(context.keepAliveInterval);
         });
-        const integrityCheckResult = await until(
-          () => requestIntegrityCheck(context, worker)
-        );
-        if (integrityCheckResult.error) {
-          devUtils.error(`Detected outdated Service Worker: ${integrityCheckResult.error.message}
-
-The mocking is still enabled, but it's highly recommended that you update your Service Worker by running:
-
-$ npx msw init <PUBLIC_DIR>
-
-This is necessary to ensure that the Service Worker is in sync with the library to guarantee its stability.
-If this message still persists after updating, please report an issue: https://github.com/open-draft/msw/issues      `);
-        }
+        await checkWorkerIntegrity(context).catch((error3) => {
+          devUtils.error(
+            "Error while checking the worker script integrity. Please report this on GitHub (https://github.com/mswjs/msw/issues), including the original error below."
+          );
+          console.error(error3);
+        });
         context.keepAliveInterval = window.setInterval(
           () => context.workerChannel.send("KEEPALIVE_REQUEST"),
           5e3
@@ -6590,19 +6576,22 @@ If this message still persists after updating, please report an issue: https://g
 
   // src/core/utils/internal/mergeRight.ts
   function mergeRight(left, right) {
-    return Object.entries(right).reduce((result, [key, rightValue]) => {
-      const leftValue = result[key];
-      if (Array.isArray(leftValue) && Array.isArray(rightValue)) {
-        result[key] = leftValue.concat(rightValue);
+    return Object.entries(right).reduce(
+      (result, [key, rightValue]) => {
+        const leftValue = result[key];
+        if (Array.isArray(leftValue) && Array.isArray(rightValue)) {
+          result[key] = leftValue.concat(rightValue);
+          return result;
+        }
+        if (isObject(leftValue) && isObject(rightValue)) {
+          result[key] = mergeRight(leftValue, rightValue);
+          return result;
+        }
+        result[key] = rightValue;
         return result;
-      }
-      if (isObject(leftValue) && isObject(rightValue)) {
-        result[key] = mergeRight(leftValue, rightValue);
-        return result;
-      }
-      result[key] = rightValue;
-      return result;
-    }, Object.assign({}, left));
+      },
+      Object.assign({}, left)
+    );
   }
 
   // src/browser/setupWorker/start/utils/prepareStartHandler.ts
@@ -6685,7 +6674,7 @@ If this message still persists after updating, please report an issue: https://g
     }
   };
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/chunk-OUWBQF3Z.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/chunk-OUWBQF3Z.mjs
   var RequestController = class {
     constructor(request) {
       this.request = request;
@@ -6723,16 +6712,7 @@ If this message still persists after updating, please report an issue: https://g
     }
   }
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/chunk-CEKC26XE.mjs
-  function uuidv4() {
-    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
-      const r = Math.random() * 16 | 0;
-      const v = c == "x" ? r : r & 3 | 8;
-      return v.toString(16);
-    });
-  }
-
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/chunk-65OQZE6W.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/chunk-3FNUI33J.mjs
   function isPropertyAccessible2(obj, key) {
     try {
       obj[key];
@@ -6756,7 +6736,7 @@ If this message still persists after updating, please report an issue: https://g
     checkEnvironment() {
       return typeof globalThis !== "undefined" && typeof globalThis.fetch !== "undefined";
     }
-    setup() {
+    async setup() {
       const pureFetch = globalThis.fetch;
       invariant(
         !pureFetch[IS_PATCHED_MODULE],
@@ -6764,7 +6744,7 @@ If this message still persists after updating, please report an issue: https://g
       );
       globalThis.fetch = async (input, init) => {
         var _a2;
-        const requestId = uuidv4();
+        const requestId = createRequestId();
         const resolvedInput = typeof input === "string" && typeof location !== "undefined" && !canParseUrl(input) ? new URL(input, location.origin) : input;
         const request = new Request(resolvedInput, init);
         this.logger.info("[%s] %s", request.method, request.url);
@@ -6879,7 +6859,7 @@ If this message still persists after updating, please report an issue: https://g
     });
   }
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/chunk-6ZIL5FW4.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/chunk-VYFS2IF2.mjs
   function concatArrayBuffer(left, right) {
     const result = new Uint8Array(left.byteLength + right.byteLength);
     result.set(left, 0);
@@ -7073,7 +7053,7 @@ If this message still persists after updating, please report an issue: https://g
       this.method = "GET";
       this.url = null;
       this.events = /* @__PURE__ */ new Map();
-      this.requestId = uuidv4();
+      this.requestId = createRequestId();
       this.requestHeaders = new Headers();
       this.responseBuffer = new Uint8Array();
       this.request = createProxy(initialRequest, {
@@ -7155,7 +7135,10 @@ If this message still persists after updating, please report an issue: https://g
                     this.request.readyState
                   );
                   if (IS_NODE2) {
-                    this.request.setRequestHeader("X-Request-Id", this.requestId);
+                    this.request.setRequestHeader(
+                      INTERNAL_REQUEST_ID_HEADER_NAME,
+                      this.requestId
+                    );
                   }
                   return invoke();
                 }
@@ -7701,32 +7684,39 @@ If this message still persists after updating, please report an issue: https://g
     }
   }
 
-  // node_modules/.pnpm/@mswjs+interceptors@0.26.8/node_modules/@mswjs/interceptors/lib/browser/interceptors/WebSocket/index.mjs
+  // node_modules/.pnpm/@mswjs+interceptors@0.26.15/node_modules/@mswjs/interceptors/lib/browser/interceptors/WebSocket/index.mjs
   function bindEvent(target, event) {
-    Object.defineProperty(event, "target", {
-      enumerable: true,
-      writable: true,
-      value: target
+    Object.defineProperties(event, {
+      target: {
+        value: target,
+        enumerable: true,
+        writable: true
+      },
+      currentTarget: {
+        value: target,
+        enumerable: true,
+        writable: true
+      }
     });
     return event;
   }
   var kCancelable = Symbol("kCancelable");
-  var kDefaultPrevented2 = Symbol("kDefaultPrevented");
+  var kDefaultPrevented = Symbol("kDefaultPrevented");
   var CancelableMessageEvent = class extends MessageEvent {
     constructor(type, init) {
       super(type, init);
       this[kCancelable] = !!init.cancelable;
-      this[kDefaultPrevented2] = false;
+      this[kDefaultPrevented] = false;
     }
     get cancelable() {
       return this[kCancelable];
     }
     get defaultPrevented() {
-      return this[kDefaultPrevented2];
+      return this[kDefaultPrevented];
     }
     preventDefault() {
-      if (this.cancelable && !this[kDefaultPrevented2]) {
-        this[kDefaultPrevented2] = true;
+      if (this.cancelable && !this[kDefaultPrevented]) {
+        this[kDefaultPrevented] = true;
       }
     }
   };
@@ -7743,7 +7733,7 @@ If this message still persists after updating, please report an issue: https://g
     constructor(socket, transport) {
       this.socket = socket;
       this.transport = transport;
-      this.id = uuidv4();
+      this.id = createRequestId();
       this.url = new URL(socket.url);
       this[kEmitter2] = new EventTarget();
       this.transport.onOutgoing = (data) => {
@@ -7760,8 +7750,8 @@ If this message still persists after updating, please report an issue: https://g
     /**
      * Listen for the outgoing events from the connected WebSocket client.
      */
-    addEventListener(event, listener, options) {
-      this[kEmitter2].addEventListener(event, listener, options);
+    addEventListener(type, listener, options) {
+      this[kEmitter2].addEventListener(type, listener, options);
     }
     /**
      * Removes the listener for the given event.
@@ -7788,129 +7778,6 @@ If this message still persists after updating, please report an issue: https://g
       this.transport.close(code, reason);
     }
   };
-  var kEmitter22 = Symbol("kEmitter");
-  var WebSocketServerConnection = class {
-    constructor(socket, transport, createConnection) {
-      this.socket = socket;
-      this.transport = transport;
-      this.createConnection = createConnection;
-      this[kEmitter22] = new EventTarget();
-      this.transport.onIncoming = (event) => {
-        const messageEvent = bindEvent(
-          this.realWebSocket,
-          new CancelableMessageEvent("message", {
-            data: event.data,
-            origin: event.origin,
-            cancelable: true
-          })
-        );
-        this[kEmitter22].dispatchEvent(messageEvent);
-        if (!messageEvent.defaultPrevented) {
-          this.socket.dispatchEvent(
-            bindEvent(
-              /**
-               * @note Bind the forwarded original server events
-               * to the mock WebSocket instance so it would
-               * dispatch them straight away.
-               */
-              this.socket,
-              // Clone the message event again to prevent
-              // the "already being dispatched" exception.
-              new MessageEvent("message", {
-                data: event.data,
-                origin: event.origin
-              })
-            )
-          );
-        }
-      };
-    }
-    /**
-     * Server ready state.
-     * Proxies the ready state of the original WebSocket instance,
-     * if set. If the original connection hasn't been established,
-     * defaults to `-1`.
-     */
-    get readyState() {
-      if (this.realWebSocket) {
-        return this.realWebSocket.readyState;
-      }
-      return -1;
-    }
-    /**
-     * Open connection to the original WebSocket server.
-     */
-    connect() {
-      invariant(
-        this.readyState === -1,
-        'Failed to call "connect()" on the original WebSocket instance: the connection already open'
-      );
-      const ws2 = this.createConnection();
-      ws2.binaryType = this.socket.binaryType;
-      this.socket.addEventListener(
-        "close",
-        (event) => {
-          ws2.close(event.code, event.reason);
-        },
-        { once: true }
-      );
-      ws2.addEventListener("message", (event) => {
-        this.transport.onIncoming(event);
-      });
-      ws2.addEventListener("error", () => {
-        this.socket.dispatchEvent(bindEvent(this.socket, new Event("error")));
-      });
-      this.realWebSocket = ws2;
-    }
-    /**
-     * Listen for the incoming events from the original WebSocket server.
-     */
-    addEventListener(event, listener, options) {
-      this[kEmitter22].addEventListener(
-        event,
-        listener.bind(this.realWebSocket),
-        options
-      );
-    }
-    /**
-     * Removes the listener for the given event.
-     */
-    removeEventListener(event, listener, options) {
-      this[kEmitter22].removeEventListener(
-        event,
-        listener,
-        options
-      );
-    }
-    /**
-     * Send data to the original WebSocket server.
-     * @example
-     * server.send('hello')
-     * server.send(new Blob(['hello']))
-     * server.send(new TextEncoder().encode('hello'))
-     */
-    send(data) {
-      const { realWebSocket } = this;
-      invariant(
-        realWebSocket,
-        'Failed to call "server.send()" for "%s": the connection is not open. Did you forget to call "await server.connect()"?',
-        this.socket.url
-      );
-      if (realWebSocket.readyState === realWebSocket.CONNECTING) {
-        realWebSocket.addEventListener(
-          "open",
-          () => {
-            realWebSocket.send(data);
-          },
-          { once: true }
-        );
-        return;
-      }
-      realWebSocket.send(data);
-    }
-  };
-  var WebSocketTransport = class {
-  };
   var WEBSOCKET_CLOSE_CODE_RANGE_ERROR = "InvalidAccessError: close code out of user configurable range";
   var kOnSend = Symbol("kOnSend");
   var kClose = Symbol("kClose");
@@ -8057,6 +7924,176 @@ If this message still persists after updating, please report an issue: https://g
     }
     return data.byteLength;
   }
+  var kEmitter22 = Symbol("kEmitter");
+  var WebSocketServerConnection = class {
+    constructor(socket, transport, createConnection) {
+      this.socket = socket;
+      this.transport = transport;
+      this.createConnection = createConnection;
+      this[kEmitter22] = new EventTarget();
+      this.mockCloseController = new AbortController();
+      this.transport.onIncoming = (event) => {
+        const messageEvent = bindEvent(
+          this.realWebSocket,
+          new CancelableMessageEvent("message", {
+            data: event.data,
+            origin: event.origin,
+            cancelable: true
+          })
+        );
+        this[kEmitter22].dispatchEvent(messageEvent);
+        if (!messageEvent.defaultPrevented) {
+          this.socket.dispatchEvent(
+            bindEvent(
+              /**
+               * @note Bind the forwarded original server events
+               * to the mock WebSocket instance so it would
+               * dispatch them straight away.
+               */
+              this.socket,
+              // Clone the message event again to prevent
+              // the "already being dispatched" exception.
+              new MessageEvent("message", {
+                data: event.data,
+                origin: event.origin
+              })
+            )
+          );
+        }
+      };
+    }
+    /**
+     * Server ready state.
+     * Proxies the ready state of the original WebSocket instance,
+     * if set. If the original connection hasn't been established,
+     * defaults to `-1`.
+     */
+    get readyState() {
+      if (this.realWebSocket) {
+        return this.realWebSocket.readyState;
+      }
+      return -1;
+    }
+    /**
+     * Open connection to the original WebSocket server.
+     */
+    connect() {
+      invariant(
+        !this.realWebSocket || this.realWebSocket.readyState !== WebSocket.OPEN,
+        'Failed to call "connect()" on the original WebSocket instance: the connection already open'
+      );
+      const realWebSocket = this.createConnection();
+      realWebSocket.binaryType = this.socket.binaryType;
+      realWebSocket.addEventListener(
+        "open",
+        (event) => {
+          this[kEmitter22].dispatchEvent(
+            bindEvent(this.realWebSocket, new Event("open", event))
+          );
+        },
+        { once: true }
+      );
+      realWebSocket.addEventListener("message", (event) => {
+        this.transport.onIncoming(event);
+      });
+      this.socket.addEventListener("close", this.handleMockClose.bind(this), {
+        signal: this.mockCloseController.signal
+      });
+      realWebSocket.addEventListener("close", this.handleRealClose.bind(this));
+      realWebSocket.addEventListener("error", () => {
+        this.socket.dispatchEvent(bindEvent(this.socket, new Event("error")));
+      });
+      this.realWebSocket = realWebSocket;
+    }
+    /**
+     * Listen for the incoming events from the original WebSocket server.
+     */
+    addEventListener(event, listener, options) {
+      this[kEmitter22].addEventListener(
+        event,
+        listener.bind(this.realWebSocket),
+        options
+      );
+    }
+    /**
+     * Remove the listener for the given event.
+     */
+    removeEventListener(event, listener, options) {
+      this[kEmitter22].removeEventListener(
+        event,
+        listener,
+        options
+      );
+    }
+    /**
+     * Send data to the original WebSocket server.
+     * @example
+     * server.send('hello')
+     * server.send(new Blob(['hello']))
+     * server.send(new TextEncoder().encode('hello'))
+     */
+    send(data) {
+      const { realWebSocket } = this;
+      invariant(
+        realWebSocket,
+        'Failed to call "server.send()" for "%s": the connection is not open. Did you forget to call "server.connect()"?',
+        this.socket.url
+      );
+      if (realWebSocket.readyState === WebSocket.CLOSING || realWebSocket.readyState === WebSocket.CLOSED) {
+        return;
+      }
+      if (realWebSocket.readyState === WebSocket.CONNECTING) {
+        realWebSocket.addEventListener(
+          "open",
+          () => {
+            realWebSocket.send(data);
+          },
+          { once: true }
+        );
+        return;
+      }
+      realWebSocket.send(data);
+    }
+    /**
+     * Close the actual server connection.
+     */
+    close() {
+      const { realWebSocket } = this;
+      invariant(
+        realWebSocket,
+        'Failed to close server connection for "%s": the connection is not open. Did you forget to call "server.connect()"?',
+        this.socket.url
+      );
+      realWebSocket.removeEventListener("close", this.handleRealClose);
+      if (realWebSocket.readyState === WebSocket.CLOSING || realWebSocket.readyState === WebSocket.CLOSED) {
+        return;
+      }
+      realWebSocket.close();
+      queueMicrotask(() => {
+        this[kEmitter22].dispatchEvent(
+          bindEvent(this.realWebSocket, new CloseEvent("close"))
+        );
+      });
+    }
+    handleMockClose(_event) {
+      if (this.realWebSocket) {
+        this.realWebSocket.close();
+      }
+    }
+    handleRealClose(event) {
+      this.mockCloseController.abort();
+      const closeEvent = bindEvent(
+        this.realWebSocket,
+        new CloseEvent("close", event)
+      );
+      this[kEmitter22].dispatchEvent(closeEvent);
+      if (!closeEvent.defaultPrevented) {
+        this.socket[kClose](event.code, event.reason);
+      }
+    }
+  };
+  var WebSocketTransport = class {
+  };
   var WebSocketClassTransport = class extends WebSocketTransport {
     constructor(socket) {
       super();
@@ -8138,30 +8175,33 @@ If this message still persists after updating, please report an issue: https://g
   // src/core/ws/webSocketInterceptor.ts
   var webSocketInterceptor = new WebSocketInterceptor();
 
-  // src/core/utils/handleWebSocketEvent.ts
-  function handleWebSocketEvent(getCurrentHandlers) {
+  // src/core/ws/handleWebSocketEvent.ts
+  function handleWebSocketEvent(options) {
     webSocketInterceptor.on("connection", (connection) => {
-      const handlers = getCurrentHandlers();
+      const handlers = options.getHandlers();
       const connectionEvent = new MessageEvent("connection", {
         data: connection
-        /**
-         * @note This message event should be marked as "cancelable"
-         * to have its default prevented using "event.preventDefault()".
-         * There's a bug in Node.js that breaks the "cancelable" flag.
-         * @see https://github.com/nodejs/node/issues/51767
-         */
-      });
-      Object.defineProperty(connectionEvent, kDefaultPrevented, {
-        enumerable: false,
-        writable: true,
-        value: false
       });
-      for (const handler of handlers) {
-        if (handler instanceof WebSocketHandler) {
+      const matchingHandlers = handlers.filter(
+        (handler) => {
+          if (handler instanceof WebSocketHandler) {
+            return handler.predicate({
+              event: connectionEvent,
+              parsedResult: handler.parse({
+                event: connectionEvent
+              })
+            });
+          }
+          return false;
+        }
+      );
+      if (matchingHandlers.length > 0) {
+        options?.onMockedConnection(connection);
+        for (const handler of matchingHandlers) {
           handler[kDispatchEvent](connectionEvent);
         }
-      }
-      if (!Reflect.get(connectionEvent, kDefaultPrevented)) {
+      } else {
+        options?.onPassthroughConnection(connection);
         connection.server.connect();
         connection.client.addEventListener("message", (event) => {
           connection.server.send(event.data);
@@ -8170,6 +8210,217 @@ If this message still persists after updating, please report an issue: https://g
     });
   }
 
+  // src/core/ws/utils/getMessageLength.ts
+  function getMessageLength(data) {
+    if (data instanceof Blob) {
+      return data.size;
+    }
+    if (data instanceof ArrayBuffer) {
+      return data.byteLength;
+    }
+    return new Blob([data]).size;
+  }
+
+  // src/core/ws/utils/truncateMessage.ts
+  var MAX_LENGTH = 24;
+  function truncateMessage(message3) {
+    if (message3.length <= MAX_LENGTH) {
+      return message3;
+    }
+    return `${message3.slice(0, MAX_LENGTH)}\u2026`;
+  }
+
+  // src/core/ws/utils/getPublicData.ts
+  async function getPublicData(data) {
+    if (data instanceof Blob) {
+      const text = await data.text();
+      return `Blob(${truncateMessage(text)})`;
+    }
+    if (typeof data === "object" && "byteLength" in data) {
+      const text = new TextDecoder().decode(data);
+      return `ArrayBuffer(${truncateMessage(text)})`;
+    }
+    return truncateMessage(data);
+  }
+
+  // src/core/ws/utils/attachWebSocketLogger.ts
+  function attachWebSocketLogger(connection) {
+    const { client, server } = connection;
+    logConnectionOpen(client);
+    client.addEventListener("message", (event) => {
+      logOutgoingClientMessage(event);
+    });
+    client.addEventListener("close", (event) => {
+      logConnectionClose(event);
+    });
+    client.socket.addEventListener("message", (event) => {
+      logIncomingClientMessage(event);
+    });
+    client.socket.addEventListener("error", (event) => {
+      logClientError(event);
+    });
+    client.send = new Proxy(client.send, {
+      apply(target, thisArg, args) {
+        const [data] = args;
+        const messageEvent = new MessageEvent("message", { data });
+        Object.defineProperties(messageEvent, {
+          currentTarget: {
+            enumerable: true,
+            writable: false,
+            value: client.socket
+          },
+          target: {
+            enumerable: true,
+            writable: false,
+            value: client.socket
+          }
+        });
+        logIncomingMockedClientMessage(messageEvent);
+        return Reflect.apply(target, thisArg, args);
+      }
+    });
+    server.addEventListener(
+      "open",
+      () => {
+        server.addEventListener("message", (event) => {
+          logIncomingServerMessage(event);
+        });
+      },
+      { once: true }
+    );
+    server.send = new Proxy(server.send, {
+      apply(target, thisArg, args) {
+        const [data] = args;
+        const messageEvent = new MessageEvent("message", { data });
+        Object.defineProperties(messageEvent, {
+          currentTarget: {
+            enumerable: true,
+            writable: false,
+            value: server["realWebSocket"]
+          },
+          target: {
+            enumerable: true,
+            writable: false,
+            value: server["realWebSocket"]
+          }
+        });
+        logOutgoingMockedClientMessage(messageEvent);
+        return Reflect.apply(target, thisArg, args);
+      }
+    });
+  }
+  function logConnectionOpen(client) {
+    const publicUrl = toPublicUrl(client.url);
+    console.groupCollapsed(
+      devUtils.formatMessage(`${getTimestamp()} %c\u25B8%c ${publicUrl}`),
+      "color:blue",
+      "color:inherit"
+    );
+    console.log("Client:", client.socket);
+    console.groupEnd();
+  }
+  async function logOutgoingClientMessage(event) {
+    const byteLength = getMessageLength(event.data);
+    const publicData = await getPublicData(event.data);
+    console.groupCollapsed(
+      devUtils.formatMessage(
+        `${getTimestamp({ milliseconds: true })} %c\u2191%c ${publicData} %c${byteLength}%c`
+      ),
+      "color:green",
+      "color:inherit",
+      "color:gray;font-weight:normal",
+      "color:inherit;font-weight:inherit"
+    );
+    console.log(event);
+    console.groupEnd();
+  }
+  async function logOutgoingMockedClientMessage(event) {
+    const byteLength = getMessageLength(event.data);
+    const publicData = await getPublicData(event.data);
+    console.groupCollapsed(
+      devUtils.formatMessage(
+        `${getTimestamp({ milliseconds: true })} %c\u21E1%c ${publicData} %c${byteLength}%c`
+      ),
+      "color:orangered",
+      "color:inherit",
+      "color:gray;font-weight:normal",
+      "color:inherit;font-weight:inherit"
+    );
+    console.log(event);
+    console.groupEnd();
+  }
+  async function logIncomingClientMessage(event) {
+    const byteLength = getMessageLength(event.data);
+    const publicData = await getPublicData(event.data);
+    console.groupCollapsed(
+      devUtils.formatMessage(
+        `${getTimestamp({ milliseconds: true })} %c\u2193%c ${publicData} %c${byteLength}%c`
+      ),
+      "color:red",
+      "color:inherit",
+      "color:gray;font-weight:normal",
+      "color:inherit;font-weight:inherit"
+    );
+    console.log(event);
+    console.groupEnd();
+  }
+  async function logIncomingMockedClientMessage(event) {
+    const byteLength = getMessageLength(event.data);
+    const publicData = await getPublicData(event.data);
+    console.groupCollapsed(
+      devUtils.formatMessage(
+        `${getTimestamp({ milliseconds: true })} %c\u21E3%c ${publicData} %c${byteLength}%c`
+      ),
+      "color:orangered",
+      "color:inherit",
+      "color:gray;font-weight:normal",
+      "color:inherit;font-weight:inherit"
+    );
+    console.log(event);
+    console.groupEnd();
+  }
+  function logConnectionClose(event) {
+    const target = event.target;
+    const publicUrl = toPublicUrl(target.url);
+    console.groupCollapsed(
+      devUtils.formatMessage(
+        `${getTimestamp({ milliseconds: true })} %c\u25A0%c ${publicUrl}`
+      ),
+      "color:blue",
+      "color:inherit"
+    );
+    console.log(event);
+    console.groupEnd();
+  }
+  async function logIncomingServerMessage(event) {
+    const byteLength = getMessageLength(event.data);
+    const publicData = await getPublicData(event.data);
+    console.groupCollapsed(
+      devUtils.formatMessage(
+        `${getTimestamp({ milliseconds: true })} %c\u21E3%c ${publicData} %c${byteLength}%c`
+      ),
+      "color:orangered",
+      "color:inherit",
+      "color:gray;font-weight:normal",
+      "color:inherit;font-weight:inherit"
+    );
+    console.log(event);
+    console.groupEnd();
+  }
+  function logClientError(event) {
+    const socket = event.target;
+    const publicUrl = toPublicUrl(socket.url);
+    console.groupCollapsed(
+      devUtils.formatMessage(
+        `${getTimestamp({ milliseconds: true })} %c\xD7%c ${publicUrl}`
+      ),
+      "color:red",
+      "color:inherit"
+    );
+    console.log(event);
+    console.groupEnd();
+  }
+
   // src/browser/setupWorker/setupWorker.ts
   var SetupWorkerApi = class extends SetupApi {
     context;
@@ -8286,8 +8537,17 @@ If this message still persists after updating, please report an issue: https://g
         DEFAULT_START_OPTIONS,
         options
       );
-      handleWebSocketEvent(() => {
-        return this.handlersController.currentHandlers();
+      handleWebSocketEvent({
+        getHandlers: () => {
+          return this.handlersController.currentHandlers();
+        },
+        onMockedConnection: (connection) => {
+          if (!this.context.startOptions.quiet) {
+            attachWebSocketLogger(connection);
+          }
+        },
+        onPassthroughConnection() {
+        }
       });
       webSocketInterceptor.apply();
       this.subscriptions.push(() => {