npm - @mswjs/interceptors - Versions diffs - 0.26.4 → 0.26.5 - Mend

@mswjs/interceptors 0.26.4 → 0.26.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/lib/browser/interceptors/WebSocket/index.d.ts CHANGED Viewed

@@ -2,26 +2,31 @@ import { I as Interceptor } from '../../Interceptor-b7c08a9f.js';
 import '@open-draft/logger';
 import 'strict-event-emitter';
-type WebSocketRawData = string | ArrayBufferLike | Blob | ArrayBufferView;
-type WebSocketTransportOnIncomingCallback = (event: MessageEvent<WebSocketRawData>) => void;
-type WebSocketTransportOnOutgoingCallback = (data: WebSocketRawData) => void;
+type WebSocketData = string | ArrayBufferLike | Blob | ArrayBufferView;
+type WebSocketTransportOnIncomingCallback = (event: MessageEvent<WebSocketData>) => void;
+type WebSocketTransportOnOutgoingCallback = (data: WebSocketData) => void;
 type WebSocketTransportOnCloseCallback = (event: CloseEvent) => void;
 declare abstract class WebSocketTransport {
     /**
-     * Listener for the incoming server events.
-     * This is called when the client receives the
-     * event from the original server connection.
-     *
-     * This way, we can trigger the "message" event
-     * on the mocked connection to let the user know.
+     * A callback for the incoming server events.
+     * This is called when the WebSocket client receives
+     * a message from the server.
      */
     abstract onIncoming: WebSocketTransportOnIncomingCallback;
+    /**
+     * A callback for outgoing client events.
+     * This is called when the WebSocket client sends data.
+     */
     abstract onOutgoing: WebSocketTransportOnOutgoingCallback;
+    /**
+     * A callback for the close client event.
+     * This is called when the WebSocket client is closed.
+     */
     abstract onClose: WebSocketTransportOnCloseCallback;
     /**
      * Send the data from the server to this client.
      */
-    abstract send(data: WebSocketRawData): void;
+    abstract send(data: WebSocketData): void;
     /**
      * Close the client connection.
      */
@@ -77,7 +82,7 @@ declare class WebSocketOverride extends EventTarget implements WebSocket {
     /**
      * @see https://websockets.spec.whatwg.org/#ref-for-dom-websocket-send%E2%91%A0
      */
-    send(data: WebSocketRawData): void;
+    send(data: WebSocketData): void;
     close(code?: number, reason?: string): void;
     private [kClose];
     addEventListener<K extends keyof WebSocketEventMap>(type: K, listener: (this: WebSocket, event: WebSocketEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
@@ -94,18 +99,24 @@ declare class WebSocketOverride extends EventTarget implements WebSocket {
  */
 declare const kEmitter$1: unique symbol;
+interface WebSocketClientConnectionProtocol {
+    id: string;
+    url: URL;
+    send(data: WebSocketData): void;
+    close(code?: number, reason?: string): void;
+}
 /**
  * The WebSocket client instance represents an incoming
  * client connection. The user can control the connection,
  * send and receive events.
  */
-declare class WebSocketClientConnection {
-    protected readonly ws: WebSocket;
-    protected readonly transport: WebSocketTransport;
+declare class WebSocketClientConnection implements WebSocketClientConnectionProtocol {
+    private readonly socket;
+    private readonly transport;
     readonly id: string;
     readonly url: URL;
-    protected [kEmitter$1]: EventTarget;
-    constructor(ws: WebSocket, transport: WebSocketTransport);
+    private [kEmitter$1];
+    constructor(socket: WebSocket, transport: WebSocketTransport);
     /**
      * Listen for the outgoing events from the connected WebSocket client.
      */
@@ -117,7 +128,7 @@ declare class WebSocketClientConnection {
     /**
      * Send data to the connected client.
      */
-    send(data: WebSocketRawData): void;
+    send(data: WebSocketData): void;
     /**
      * Close the WebSocket connection.
      * @param {number} code A status code (see https://www.rfc-editor.org/rfc/rfc6455#section-7.4.1).
@@ -126,13 +137,17 @@ declare class WebSocketClientConnection {
     close(code?: number, reason?: string): void;
 }
+/**
+ * Abstraction over the given mock `WebSocket` instance that allows
+ * for controlling that instance (e.g. sending and receiving messages).
+ */
 declare class WebSocketClassTransport extends WebSocketTransport {
-    protected readonly ws: WebSocketOverride;
+    protected readonly socket: WebSocketOverride;
     onOutgoing: WebSocketTransportOnOutgoingCallback;
     onIncoming: WebSocketTransportOnIncomingCallback;
     onClose: WebSocketTransportOnCloseCallback;
-    constructor(ws: WebSocketOverride);
-    send(data: WebSocketRawData): void;
+    constructor(socket: WebSocketOverride);
+    send(data: WebSocketData): void;
     close(code: number, reason?: string): void;
 }
@@ -143,15 +158,15 @@ declare const kEmitter: unique symbol;
  * establish it by calling `server.connect()`.
  */
 declare class WebSocketServerConnection {
-    private readonly mockWebSocket;
-    private readonly createConnection;
+    private readonly socket;
     private readonly transport;
+    private readonly createConnection;
     /**
      * A WebSocket instance connected to the original server.
      */
     private realWebSocket?;
     private [kEmitter];
-    constructor(mockWebSocket: WebSocketOverride, createConnection: () => WebSocket, transport: WebSocketClassTransport);
+    constructor(socket: WebSocketOverride, transport: WebSocketClassTransport, createConnection: () => WebSocket);
     /**
      * Server ready state.
      * Proxies the ready state of the original WebSocket instance,
@@ -178,7 +193,7 @@ declare class WebSocketServerConnection {
      * server.send(new Blob(['hello']))
      * server.send(new TextEncoder().encode('hello'))
      */
-    send(data: WebSocketRawData): void;
+    send(data: WebSocketData): void;
 }
 type WebSocketEventMap$1 = {
@@ -206,4 +221,4 @@ declare class WebSocketInterceptor extends Interceptor<WebSocketEventMap$1> {
     protected setup(): void;
 }
-export { WebSocketClientConnection, WebSocketEventMap$1 as WebSocketEventMap, WebSocketInterceptor, WebSocketRawData, WebSocketServerConnection };
+export { WebSocketClientConnection, WebSocketClientConnectionProtocol, WebSocketData, WebSocketEventMap$1 as WebSocketEventMap, WebSocketInterceptor, WebSocketServerConnection, WebSocketTransport };

package/lib/browser/interceptors/WebSocket/index.js CHANGED Viewed

@@ -49,20 +49,20 @@ var CloseEvent = class extends Event {
 // src/interceptors/WebSocket/WebSocketClientConnection.ts
 var kEmitter = Symbol("kEmitter");
 var WebSocketClientConnection = class {
-  constructor(ws, transport) {
-    this.ws = ws;
+  constructor(socket, transport) {
+    this.socket = socket;
     this.transport = transport;
     this.id = _chunkLQSFVQBOjs.uuidv4.call(void 0, );
-    this.url = new URL(ws.url);
+    this.url = new URL(socket.url);
     this[kEmitter] = new EventTarget();
     this.transport.onOutgoing = (data) => {
       this[kEmitter].dispatchEvent(
-        bindEvent(this.ws, new MessageEvent("message", { data }))
+        bindEvent(this.socket, new MessageEvent("message", { data }))
       );
     };
     this.transport.onClose = (event) => {
       this[kEmitter].dispatchEvent(
-        bindEvent(this.ws, new CloseEvent("close", event))
+        bindEvent(this.socket, new CloseEvent("close", event))
       );
     };
   }
@@ -103,10 +103,10 @@ kEmitter;
 var _outvariant = require('outvariant');
 var kEmitter2 = Symbol("kEmitter");
 var WebSocketServerConnection = class {
-  constructor(mockWebSocket, createConnection, transport) {
-    this.mockWebSocket = mockWebSocket;
-    this.createConnection = createConnection;
+  constructor(socket, transport, createConnection) {
+    this.socket = socket;
     this.transport = transport;
+    this.createConnection = createConnection;
     this[kEmitter2] = new EventTarget();
     this.transport.onIncoming = (event) => {
       const messageEvent = bindEvent(
@@ -119,14 +119,14 @@ var WebSocketServerConnection = class {
       );
       this[kEmitter2].dispatchEvent(messageEvent);
       if (!messageEvent.defaultPrevented) {
-        this.mockWebSocket.dispatchEvent(
+        this.socket.dispatchEvent(
           bindEvent(
             /**
              * @note Bind the forwarded original server events
              * to the mock WebSocket instance so it would
              * dispatch them straight away.
              */
-            this.mockWebSocket,
+            this.socket,
             // Clone the message event again to prevent
             // the "already being dispatched" exception.
             new MessageEvent("message", {
@@ -159,7 +159,7 @@ var WebSocketServerConnection = class {
       'Failed to call "connect()" on the original WebSocket instance: the connection already open'
     );
     const ws = this.createConnection();
-    this.mockWebSocket.addEventListener(
+    this.socket.addEventListener(
       "close",
       (event) => {
         ws.close(event.code, event.reason);
@@ -170,9 +170,7 @@ var WebSocketServerConnection = class {
       this.transport.onIncoming(event);
     });
     ws.addEventListener("error", () => {
-      this.mockWebSocket.dispatchEvent(
-        bindEvent(this.mockWebSocket, new Event("error"))
-      );
+      this.socket.dispatchEvent(bindEvent(this.socket, new Event("error")));
     });
     this.realWebSocket = ws;
   }
@@ -208,7 +206,7 @@ var WebSocketServerConnection = class {
     _outvariant.invariant.call(void 0,
       realWebSocket,
       'Failed to call "server.send()" for "%s": the connection is not open. Did you forget to call "await server.connect()"?',
-      this.mockWebSocket.url
+      this.socket.url
     );
     if (realWebSocket.readyState === realWebSocket.CONNECTING) {
       realWebSocket.addEventListener(
@@ -380,19 +378,19 @@ function getDataSize(data) {
 // src/interceptors/WebSocket/WebSocketClassTransport.ts
 var WebSocketClassTransport = class extends WebSocketTransport {
-  constructor(ws) {
+  constructor(socket) {
     super();
-    this.ws = ws;
+    this.socket = socket;
     this.onOutgoing = () => {
     };
     this.onIncoming = () => {
     };
     this.onClose = () => {
     };
-    this.ws.addEventListener("close", (event) => this.onClose(event), {
+    this.socket.addEventListener("close", (event) => this.onClose(event), {
       once: true
     });
-    this.ws[kOnSend] = (...args) => this.onOutgoing(...args);
+    this.socket[kOnSend] = (...args) => this.onOutgoing(...args);
   }
   send(data) {
     queueMicrotask(() => {
@@ -405,17 +403,17 @@ var WebSocketClassTransport = class extends WebSocketTransport {
          * mocked message events like the one below
          * (must be dispatched on the client instance).
          */
-        this.ws,
+        this.socket,
         new MessageEvent("message", {
           data,
-          origin: this.ws.url
+          origin: this.socket.url
         })
       );
-      this.ws.dispatchEvent(message);
+      this.socket.dispatchEvent(message);
     });
   }
   close(code, reason) {
-    this.ws[kClose](code, reason);
+    this.socket[kClose](code, reason);
   }
 };
@@ -434,17 +432,17 @@ var _WebSocketInterceptor = class extends _chunkEM6NYHQVjs.Interceptor {
         const createConnection = () => {
           return Reflect.construct(target, args, newTarget);
         };
-        const mockWs = new WebSocketOverride(url, protocols);
-        const transport = new WebSocketClassTransport(mockWs);
+        const socket = new WebSocketOverride(url, protocols);
+        const transport = new WebSocketClassTransport(socket);
         this.emitter.emit("connection", {
-          client: new WebSocketClientConnection(mockWs, transport),
+          client: new WebSocketClientConnection(socket, transport),
           server: new WebSocketServerConnection(
-            mockWs,
-            createConnection,
-            transport
+            socket,
+            transport,
+            createConnection
           )
         });
-        return mockWs;
+        return socket;
       }
     });
     globalThis.WebSocket = webSocketProxy.proxy;
@@ -459,5 +457,6 @@ WebSocketInterceptor.symbol = Symbol("websocket");
-exports.WebSocketClientConnection = WebSocketClientConnection; exports.WebSocketInterceptor = WebSocketInterceptor; exports.WebSocketServerConnection = WebSocketServerConnection;
+exports.WebSocketClientConnection = WebSocketClientConnection; exports.WebSocketInterceptor = WebSocketInterceptor; exports.WebSocketServerConnection = WebSocketServerConnection; exports.WebSocketTransport = WebSocketTransport;
 //# sourceMappingURL=index.js.map

package/lib/browser/interceptors/WebSocket/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../../src/interceptors/WebSocket/utils/bindEvent.ts","../../../../src/interceptors/WebSocket/utils/events.ts","../../../../src/interceptors/WebSocket/WebSocketClientConnection.ts","../../../../src/interceptors/WebSocket/WebSocketServerConnection.ts","../../../../src/interceptors/WebSocket/WebSocketTransport.ts","../../../../src/interceptors/WebSocket/WebSocketOverride.ts","../../../../src/interceptors/WebSocket/WebSocketClassTransport.ts","../../../../src/interceptors/WebSocket/index.ts"],"names":["kEmitter","invariant"],"mappings":"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","sourcesContent":["type EventWithTarget<E extends Event, T> = E & { target: T }\n\nexport function bindEvent<E extends Event, T>(\n target: T,\n event: E\n): EventWithTarget<E, T> {\n Object.defineProperty(event, 'target', {\n enumerable: true,\n writable: true,\n value: target,\n })\n return event as EventWithTarget<E, T>\n}\n","const kCancelable = Symbol('kCancelable')\nconst kDefaultPrevented = Symbol('kDefaultPrevented')\n\n/*\n A `MessageEvent` superset that supports event cancellation\n * in Node.js. It's rather non-intrusive so it can be safely\n * used in the browser as well.\n \n @see https://github.com/nodejs/node/issues/51767\n /\nexport class CancelableMessageEvent<T = any> extends MessageEvent<T> {\n [kCancelable]: boolean;\n [kDefaultPrevented]: boolean\n\n constructor(type: string, init: MessageEventInit<T>) {\n super(type, init)\n this[kCancelable] = !!init.cancelable\n this[kDefaultPrevented] = false\n }\n\n get cancelable() {\n return this[kCancelable]\n }\n\n get defaultPrevented() {\n return this[kDefaultPrevented]\n }\n\n public preventDefault(): void {\n if (this.cancelable && !this[kDefaultPrevented]) {\n this[kDefaultPrevented] = true\n }\n }\n}\n\ninterface CloseEventInit extends EventInit {\n code?: number\n reason?: string\n wasClean?: boolean\n}\n\nexport class CloseEvent extends Event {\n public code: number\n public reason: string\n public wasClean: boolean\n\n constructor(type: string, init: CloseEventInit = {}) {\n super(type, init)\n this.code = init.code === undefined ? 0 : init.code\n this.reason = init.reason === undefined ? '' : init.reason\n this.wasClean = init.wasClean === undefined ? false : init.wasClean\n }\n}\n","/\n WebSocket client class.\n * This represents an incoming WebSocket client connection.\n * @note Keep this class implementation-agnostic because it's\n * meant to be used over any WebSocket implementation\n * (not all of them follow the one from WHATWG).\n /\nimport type { WebSocketRawData, WebSocketTransport } from './WebSocketTransport'\nimport { WebSocketMessageListener } from './WebSocketOverride'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\nimport { uuidv4 } from '../../utils/uuid'\n\nconst kEmitter = Symbol('kEmitter')\n\n/\n The WebSocket client instance represents an incoming\n * client connection. The user can control the connection,\n * send and receive events.\n /\nexport class WebSocketClientConnection {\n public readonly id: string\n public readonly url: URL\n\n protected [kEmitter]: EventTarget\n\n constructor(\n protected readonly ws: WebSocket,\n protected readonly transport: WebSocketTransport\n ) {\n this.id = uuidv4()\n this.url = new URL(ws.url)\n this[kEmitter] = new EventTarget()\n\n // Emit outgoing client data (\"ws.send()\") as \"message\"\n // events on the client connection.\n this.transport.onOutgoing = (data) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.ws, new MessageEvent('message', { data }))\n )\n }\n\n this.transport.onClose = (event) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.ws, new CloseEvent('close', event))\n )\n }\n }\n\n /\n Listen for the outgoing events from the connected WebSocket client.\n /\n public addEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(event, listener as EventListener, options)\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the connected client.\n /\n public send(data: WebSocketRawData): void {\n this.transport.send(data)\n }\n\n /\n Close the WebSocket connection.\n * @param {number} code A status code (see https://www.rfc-editor.org/rfc/rfc6455#section-7.4.1).\n * @param {string} reason A custom connection close reason.\n /\n public close(code?: number, reason?: string): void {\n this.transport.close(code, reason)\n }\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketOverride } from './WebSocketOverride'\nimport type { WebSocketRawData } from './WebSocketTransport'\nimport type { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CancelableMessageEvent } from './utils/events'\n\nconst kEmitter = Symbol('kEmitter')\n\n/\n The WebSocket server instance represents the actual production\n * WebSocket server connection. It's idle by default but you can\n * establish it by calling `server.connect()`.\n /\nexport class WebSocketServerConnection {\n /\n A WebSocket instance connected to the original server.\n /\n private realWebSocket?: WebSocket\n private [kEmitter]: EventTarget\n\n constructor(\n private readonly mockWebSocket: WebSocketOverride,\n private readonly createConnection: () => WebSocket,\n private readonly transport: WebSocketClassTransport\n ) {\n this[kEmitter] = new EventTarget()\n\n // Handle incoming events from the actual server.\n // The (mock) WebSocket instance will call this\n // whenever a \"message\" event from the actual server\n // is dispatched on it (the dispatch will be skipped).\n this.transport.onIncoming = (event) => {\n // Clone the event to dispatch it on this class\n // once again and prevent the \"already being dispatched\"\n // exception. Clone it here so we can observe this event\n // being prevented in the \"server.on()\" listeners.\n const messageEvent = bindEvent(\n this.realWebSocket!,\n new CancelableMessageEvent('message', {\n data: event.data,\n origin: event.origin,\n cancelable: true,\n })\n )\n\n /\n @note Emit \"message\" event on the WebSocketClassServer\n * instance to let the interceptor know about these\n * incoming events from the original server. In that listener,\n * the interceptor can modify or skip the event forwarding\n * to the mock WebSocket instance.\n /\n this[kEmitter].dispatchEvent(messageEvent)\n\n /\n @note Forward the incoming server events to the client.\n * Preventing the default on the message event stops this.\n /\n if (!messageEvent.defaultPrevented) {\n this.mockWebSocket.dispatchEvent(\n bindEvent(\n /\n @note Bind the forwarded original server events\n * to the mock WebSocket instance so it would\n * dispatch them straight away.\n /\n this.mockWebSocket,\n // Clone the message event again to prevent\n // the \"already being dispatched\" exception.\n new MessageEvent('message', {\n data: event.data,\n origin: event.origin,\n })\n )\n )\n }\n }\n }\n\n /\n Server ready state.\n * Proxies the ready state of the original WebSocket instance,\n * if set. If the original connection hasn't been established,\n * defaults to `-1`.\n /\n public get readyState(): number {\n if (this.realWebSocket) {\n return this.realWebSocket.readyState\n }\n\n return -1\n }\n\n /\n Open connection to the original WebSocket server.\n /\n public connect(): void {\n invariant(\n this.readyState === -1,\n 'Failed to call \"connect()\" on the original WebSocket instance: the connection already open'\n )\n\n const ws = this.createConnection()\n\n // Close the original connection when the (mock)\n // client closes, regardless of the reason.\n this.mockWebSocket.addEventListener(\n 'close',\n (event) => {\n ws.close(event.code, event.reason)\n },\n { once: true }\n )\n\n ws.addEventListener('message', (event) => {\n this.transport.onIncoming(event)\n })\n\n // Forward server errors to the WebSocket client as-is.\n // We may consider exposing them to the interceptor in the future.\n ws.addEventListener('error', () => {\n this.mockWebSocket.dispatchEvent(\n bindEvent(this.mockWebSocket, new Event('error'))\n )\n })\n\n this.realWebSocket = ws\n }\n\n /\n Listen for the incoming events from the original WebSocket server.\n /\n public addEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(\n event,\n listener.bind(this.realWebSocket!) as EventListener,\n options\n )\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the original WebSocket server.\n * @example\n * server.send('hello')\n * server.send(new Blob(['hello']))\n * server.send(new TextEncoder().encode('hello'))\n /\n public send(data: WebSocketRawData): void {\n const { realWebSocket } = this\n invariant(\n realWebSocket,\n 'Failed to call \"server.send()\" for \"%s\": the connection is not open. Did you forget to call \"await server.connect()\"?',\n this.mockWebSocket.url\n )\n\n // Delegate the send to when the original connection is open.\n // Unlike the mock, connecting to the original server may take time\n // so we cannot call this on the next tick.\n if (realWebSocket.readyState === realWebSocket.CONNECTING) {\n realWebSocket.addEventListener(\n 'open',\n () => {\n realWebSocket.send(data)\n },\n { once: true }\n )\n return\n }\n\n // Send the data to the original WebSocket server.\n realWebSocket.send(data)\n }\n}\n","export type WebSocketRawData = string \| ArrayBufferLike \| Blob \| ArrayBufferView\n\nexport type WebSocketTransportOnIncomingCallback = (\n event: MessageEvent<WebSocketRawData>\n) => void\n\nexport type WebSocketTransportOnOutgoingCallback = (\n data: WebSocketRawData\n) => void\n\nexport type WebSocketTransportOnCloseCallback = (event: CloseEvent) => void\n\nexport abstract class WebSocketTransport {\n /\n Listener for the incoming server events.\n * This is called when the client receives the\n * event from the original server connection.\n \n This way, we can trigger the \"message\" event\n * on the mocked connection to let the user know.\n /\n abstract onIncoming: WebSocketTransportOnIncomingCallback\n abstract onOutgoing: WebSocketTransportOnOutgoingCallback\n abstract onClose: WebSocketTransportOnCloseCallback\n\n /\n Send the data from the server to this client.\n /\n abstract send(data: WebSocketRawData): void\n\n /\n Close the client connection.\n /\n abstract close(code?: number, reason?: string): void\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketRawData } from './WebSocketTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\n\ntype WebSocketEventListener = (this: WebSocket, event: Event) => void\n\nexport type WebSocketMessageListener = (\n this: WebSocket,\n event: MessageEvent\n) => void\n\ntype WebSocketCloseListener = (this: WebSocket, event: CloseEvent) => void\n\nconst WEBSOCKET_CLOSE_CODE_RANGE_ERROR =\n 'InvalidAccessError: close code out of user configurable range'\n\nexport const kOnSend = Symbol('kOnSend')\nexport const kClose = Symbol('kClose')\n\nexport class WebSocketOverride extends EventTarget implements WebSocket {\n static readonly CONNECTING = WebSocket.CONNECTING\n static readonly OPEN = WebSocket.OPEN\n static readonly CLOSING = WebSocket.CLOSING\n static readonly CLOSED = WebSocket.CLOSED\n readonly CONNECTING = WebSocket.CONNECTING\n readonly OPEN = WebSocket.OPEN\n readonly CLOSING = WebSocket.CLOSING\n readonly CLOSED = WebSocket.CLOSED\n\n public url: string\n public protocol: string\n public extensions: string\n public binaryType: BinaryType\n public readyState: number\n public bufferedAmount: number\n\n private _onopen: WebSocketEventListener \| null = null\n private _onmessage: WebSocketMessageListener \| null = null\n private _onerror: WebSocketEventListener \| null = null\n private _onclose: WebSocketCloseListener \| null = null\n\n private [kOnSend]?: (data: WebSocketRawData) => void\n\n constructor(url: string \| URL, protocols?: string \| Array<string>) {\n super()\n this.url = url.toString()\n this.protocol = ''\n this.extensions = ''\n this.binaryType = 'blob'\n this.readyState = this.CONNECTING\n this.bufferedAmount = 0\n\n Reflect.set(this, 'readyState', this.CONNECTING)\n queueMicrotask(() => {\n Reflect.set(this, 'readyState', this.OPEN)\n this.protocol = protocols ? protocols[0] : 'ws'\n\n this.dispatchEvent(bindEvent(this, new Event('open')))\n })\n }\n\n set onopen(listener: WebSocketEventListener \| null) {\n this.removeEventListener('open', this._onopen)\n this._onopen = listener\n if (listener !== null) {\n this.addEventListener('open', listener)\n }\n }\n get onopen(): WebSocketEventListener \| null {\n return this._onopen\n }\n\n set onmessage(listener: WebSocketMessageListener \| null) {\n this.removeEventListener(\n 'message',\n this._onmessage as WebSocketEventListener\n )\n this._onmessage = listener\n if (listener !== null) {\n this.addEventListener('message', listener)\n }\n }\n get onmessage(): WebSocketMessageListener \| null {\n return this._onmessage\n }\n\n set onerror(listener: WebSocketEventListener \| null) {\n this.removeEventListener('error', this._onerror)\n this._onerror = listener\n if (listener !== null) {\n this.addEventListener('error', listener)\n }\n }\n get onerror(): WebSocketEventListener \| null {\n return this._onerror\n }\n\n set onclose(listener: WebSocketCloseListener \| null) {\n this.removeEventListener('close', this._onclose as WebSocketEventListener)\n this._onclose = listener\n if (listener !== null) {\n this.addEventListener('close', listener)\n }\n }\n get onclose(): WebSocketCloseListener \| null {\n return this._onclose\n }\n\n /\n @see https://websockets.spec.whatwg.org/#ref-for-dom-websocket-send%E2%91%A0\n /\n public send(data: WebSocketRawData): void {\n if (this.readyState === this.CONNECTING) {\n this.close()\n throw new DOMException('InvalidStateError')\n }\n\n // Sending when the socket is about to close\n // discards the sent data.\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n // Buffer the data to send in this even loop\n // but send it in the next.\n this.bufferedAmount += getDataSize(data)\n\n queueMicrotask(() => {\n // This is a bit optimistic but since no actual data transfer\n // is involved, all the data will be \"sent\" on the next tick.\n this.bufferedAmount = 0\n\n /\n @note Notify the parent about outgoing data.\n * This notifies the transport and the connection\n * listens to the outgoing data to emit the \"message\" event.\n /\n this[kOnSend]?.(data)\n })\n }\n\n public close(code: number = 1000, reason?: string): void {\n invariant(code, WEBSOCKET_CLOSE_CODE_RANGE_ERROR)\n invariant(\n code === 1000 \|\| (code >= 3000 && code <= 4999),\n WEBSOCKET_CLOSE_CODE_RANGE_ERROR\n )\n\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n this[kClose](code, reason)\n }\n\n private [kClose](code: number = 1000, reason?: string): void {\n this.readyState = this.CLOSING\n\n queueMicrotask(() => {\n this.readyState = this.CLOSED\n\n // Non-user-configurable close status codes\n // represent connection termination and must\n // emit the \"error\" event before closing.\n if (code > 1000 && code <= 1015) {\n this.dispatchEvent(bindEvent(this, new Event('error')))\n }\n\n this.dispatchEvent(\n bindEvent(\n this,\n new CloseEvent('close', {\n code,\n reason,\n wasClean: code === 1000,\n })\n )\n )\n\n // Remove all event listeners once the socket is closed.\n this._onopen = null\n this._onmessage = null\n this._onerror = null\n this._onclose = null\n })\n }\n\n public addEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: string,\n listener: EventListenerOrEventListenerObject,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: unknown,\n listener: unknown,\n options?: unknown\n ): void {\n return super.addEventListener(\n type as string,\n listener as EventListener,\n options as AddEventListenerOptions\n )\n }\n\n removeEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n callback: EventListenerOrEventListenerObject \| null,\n options?: boolean \| EventListenerOptions\n ): void {\n return super.removeEventListener(type, callback, options)\n }\n}\n\nfunction getDataSize(data: WebSocketRawData): number {\n if (typeof data === 'string') {\n return data.length\n }\n\n if (data instanceof Blob) {\n return data.size\n }\n\n return data.byteLength\n}\n","import { bindEvent } from './utils/bindEvent'\nimport {\n WebSocketRawData,\n WebSocketTransport,\n WebSocketTransportOnCloseCallback,\n WebSocketTransportOnIncomingCallback,\n WebSocketTransportOnOutgoingCallback,\n} from './WebSocketTransport'\nimport { kOnSend, kClose, WebSocketOverride } from './WebSocketOverride'\n\nexport class WebSocketClassTransport extends WebSocketTransport {\n public onOutgoing: WebSocketTransportOnOutgoingCallback = () => {}\n public onIncoming: WebSocketTransportOnIncomingCallback = () => {}\n public onClose: WebSocketTransportOnCloseCallback = () => {}\n\n constructor(protected readonly ws: WebSocketOverride) {\n super()\n\n this.ws.addEventListener('close', (event) => this.onClose(event), {\n once: true,\n })\n this.ws[kOnSend] = (...args) => this.onOutgoing(...args)\n }\n\n public send(data: WebSocketRawData): void {\n queueMicrotask(() => {\n const message = bindEvent(\n /\n @note Setting this event's \"target\" to the\n * WebSocket override instance is important.\n * This way it can tell apart original incoming events\n * (must be forwarded to the transport) from the\n * mocked message events like the one below\n * (must be dispatched on the client instance).\n /\n this.ws,\n new MessageEvent('message', {\n data,\n origin: this.ws.url,\n })\n )\n\n this.ws.dispatchEvent(message)\n })\n }\n\n public close(code: number, reason?: string): void {\n /\n @note Call the internal close method directly\n * to allow closing the connection with the status codes\n * that are non-configurable by the user (> 1000 <= 1015).\n /\n this.ws[kClose](code, reason)\n }\n}\n","import { Interceptor } from '../../Interceptor'\nimport { WebSocketClientConnection } from './WebSocketClientConnection'\nimport { WebSocketServerConnection } from './WebSocketServerConnection'\nimport { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { WebSocketOverride } from './WebSocketOverride'\n\nexport type { WebSocketRawData } from './WebSocketTransport'\nexport { WebSocketClientConnection, WebSocketServerConnection }\n\nexport type WebSocketEventMap = {\n connection: [\n args: {\n /\n The incoming WebSocket client connection.\n /\n client: WebSocketClientConnection\n\n /\n The original WebSocket server connection.\n /\n server: WebSocketServerConnection\n }\n ]\n}\n\n/\n Intercept the outgoing WebSocket connections created using\n * the global `WebSocket` class.\n */\nexport class WebSocketInterceptor extends Interceptor<WebSocketEventMap> {\n static symbol = Symbol('websocket')\n\n constructor() {\n super(WebSocketInterceptor.symbol)\n }\n\n protected checkEnvironment(): boolean {\n // Enable this interceptor in any environment\n // that has a global WebSocket API.\n return typeof globalThis.WebSocket !== 'undefined'\n }\n\n protected setup(): void {\n const webSocketProxy = Proxy.revocable(globalThis.WebSocket, {\n construct: (\n target,\n args: ConstructorParameters<typeof globalThis.WebSocket>,\n newTarget\n ) => {\n const [url, protocols] = args\n\n const createConnection = (): WebSocket => {\n return Reflect.construct(target, args, newTarget)\n }\n\n // All WebSocket instances are mocked and don't forward\n // any events to the original server (no connection established).\n // To forward the events, the user must use the \"server.send()\" API.\n const mockWs = new WebSocketOverride(url, protocols)\n const transport = new WebSocketClassTransport(mockWs)\n\n // The \"globalThis.WebSocket\" class stands for\n // the client-side connection. Assume it's established\n // as soon as the WebSocket instance is constructed.\n this.emitter.emit('connection', {\n client: new WebSocketClientConnection(mockWs, transport),\n server: new WebSocketServerConnection(\n mockWs,\n createConnection,\n transport\n ),\n })\n\n return mockWs\n },\n })\n\n globalThis.WebSocket = webSocketProxy.proxy\n\n this.subscriptions.push(() => {\n webSocketProxy.revoke()\n })\n }\n}\n"]}
1	+ {"version":3,"sources":["../../../../src/interceptors/WebSocket/utils/bindEvent.ts","../../../../src/interceptors/WebSocket/utils/events.ts","../../../../src/interceptors/WebSocket/WebSocketClientConnection.ts","../../../../src/interceptors/WebSocket/WebSocketServerConnection.ts","../../../../src/interceptors/WebSocket/WebSocketTransport.ts","../../../../src/interceptors/WebSocket/WebSocketOverride.ts","../../../../src/interceptors/WebSocket/WebSocketClassTransport.ts","../../../../src/interceptors/WebSocket/index.ts"],"names":["kEmitter","invariant"],"mappings":"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","sourcesContent":["type EventWithTarget<E extends Event, T> = E & { target: T }\n\nexport function bindEvent<E extends Event, T>(\n target: T,\n event: E\n): EventWithTarget<E, T> {\n Object.defineProperty(event, 'target', {\n enumerable: true,\n writable: true,\n value: target,\n })\n return event as EventWithTarget<E, T>\n}\n","const kCancelable = Symbol('kCancelable')\nconst kDefaultPrevented = Symbol('kDefaultPrevented')\n\n/*\n A `MessageEvent` superset that supports event cancellation\n * in Node.js. It's rather non-intrusive so it can be safely\n * used in the browser as well.\n \n @see https://github.com/nodejs/node/issues/51767\n /\nexport class CancelableMessageEvent<T = any> extends MessageEvent<T> {\n [kCancelable]: boolean;\n [kDefaultPrevented]: boolean\n\n constructor(type: string, init: MessageEventInit<T>) {\n super(type, init)\n this[kCancelable] = !!init.cancelable\n this[kDefaultPrevented] = false\n }\n\n get cancelable() {\n return this[kCancelable]\n }\n\n get defaultPrevented() {\n return this[kDefaultPrevented]\n }\n\n public preventDefault(): void {\n if (this.cancelable && !this[kDefaultPrevented]) {\n this[kDefaultPrevented] = true\n }\n }\n}\n\ninterface CloseEventInit extends EventInit {\n code?: number\n reason?: string\n wasClean?: boolean\n}\n\nexport class CloseEvent extends Event {\n public code: number\n public reason: string\n public wasClean: boolean\n\n constructor(type: string, init: CloseEventInit = {}) {\n super(type, init)\n this.code = init.code === undefined ? 0 : init.code\n this.reason = init.reason === undefined ? '' : init.reason\n this.wasClean = init.wasClean === undefined ? false : init.wasClean\n }\n}\n","/\n WebSocket client class.\n * This represents an incoming WebSocket client connection.\n * @note Keep this class implementation-agnostic because it's\n * meant to be used over any WebSocket implementation\n * (not all of them follow the one from WHATWG).\n /\nimport type { WebSocketData, WebSocketTransport } from './WebSocketTransport'\nimport { WebSocketMessageListener } from './WebSocketOverride'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\nimport { uuidv4 } from '../../utils/uuid'\n\nconst kEmitter = Symbol('kEmitter')\n\nexport interface WebSocketClientConnectionProtocol {\n id: string\n url: URL\n send(data: WebSocketData): void\n close(code?: number, reason?: string): void\n}\n\n/\n The WebSocket client instance represents an incoming\n * client connection. The user can control the connection,\n * send and receive events.\n /\nexport class WebSocketClientConnection\n implements WebSocketClientConnectionProtocol\n{\n public readonly id: string\n public readonly url: URL\n\n private [kEmitter]: EventTarget\n\n constructor(\n private readonly socket: WebSocket,\n private readonly transport: WebSocketTransport\n ) {\n this.id = uuidv4()\n this.url = new URL(socket.url)\n this[kEmitter] = new EventTarget()\n\n // Emit outgoing client data (\"ws.send()\") as \"message\"\n // events on the client connection.\n this.transport.onOutgoing = (data) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.socket, new MessageEvent('message', { data }))\n )\n }\n\n this.transport.onClose = (event) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.socket, new CloseEvent('close', event))\n )\n }\n }\n\n /\n Listen for the outgoing events from the connected WebSocket client.\n /\n public addEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(event, listener as EventListener, options)\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the connected client.\n /\n public send(data: WebSocketData): void {\n this.transport.send(data)\n }\n\n /\n Close the WebSocket connection.\n * @param {number} code A status code (see https://www.rfc-editor.org/rfc/rfc6455#section-7.4.1).\n * @param {string} reason A custom connection close reason.\n /\n public close(code?: number, reason?: string): void {\n this.transport.close(code, reason)\n }\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketOverride } from './WebSocketOverride'\nimport type { WebSocketData } from './WebSocketTransport'\nimport type { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CancelableMessageEvent } from './utils/events'\n\nconst kEmitter = Symbol('kEmitter')\n\n/\n The WebSocket server instance represents the actual production\n * WebSocket server connection. It's idle by default but you can\n * establish it by calling `server.connect()`.\n /\nexport class WebSocketServerConnection {\n /\n A WebSocket instance connected to the original server.\n /\n private realWebSocket?: WebSocket\n private [kEmitter]: EventTarget\n\n constructor(\n private readonly socket: WebSocketOverride,\n private readonly transport: WebSocketClassTransport,\n private readonly createConnection: () => WebSocket\n ) {\n this[kEmitter] = new EventTarget()\n\n // Handle incoming events from the actual server.\n // The (mock) WebSocket instance will call this\n // whenever a \"message\" event from the actual server\n // is dispatched on it (the dispatch will be skipped).\n this.transport.onIncoming = (event) => {\n // Clone the event to dispatch it on this class\n // once again and prevent the \"already being dispatched\"\n // exception. Clone it here so we can observe this event\n // being prevented in the \"server.on()\" listeners.\n const messageEvent = bindEvent(\n this.realWebSocket!,\n new CancelableMessageEvent('message', {\n data: event.data,\n origin: event.origin,\n cancelable: true,\n })\n )\n\n /\n @note Emit \"message\" event on the WebSocketClassServer\n * instance to let the interceptor know about these\n * incoming events from the original server. In that listener,\n * the interceptor can modify or skip the event forwarding\n * to the mock WebSocket instance.\n /\n this[kEmitter].dispatchEvent(messageEvent)\n\n /\n @note Forward the incoming server events to the client.\n * Preventing the default on the message event stops this.\n /\n if (!messageEvent.defaultPrevented) {\n this.socket.dispatchEvent(\n bindEvent(\n /\n @note Bind the forwarded original server events\n * to the mock WebSocket instance so it would\n * dispatch them straight away.\n /\n this.socket,\n // Clone the message event again to prevent\n // the \"already being dispatched\" exception.\n new MessageEvent('message', {\n data: event.data,\n origin: event.origin,\n })\n )\n )\n }\n }\n }\n\n /\n Server ready state.\n * Proxies the ready state of the original WebSocket instance,\n * if set. If the original connection hasn't been established,\n * defaults to `-1`.\n /\n public get readyState(): number {\n if (this.realWebSocket) {\n return this.realWebSocket.readyState\n }\n\n return -1\n }\n\n /\n Open connection to the original WebSocket server.\n /\n public connect(): void {\n invariant(\n this.readyState === -1,\n 'Failed to call \"connect()\" on the original WebSocket instance: the connection already open'\n )\n\n const ws = this.createConnection()\n\n // Close the original connection when the (mock)\n // client closes, regardless of the reason.\n this.socket.addEventListener(\n 'close',\n (event) => {\n ws.close(event.code, event.reason)\n },\n { once: true }\n )\n\n ws.addEventListener('message', (event) => {\n this.transport.onIncoming(event)\n })\n\n // Forward server errors to the WebSocket client as-is.\n // We may consider exposing them to the interceptor in the future.\n ws.addEventListener('error', () => {\n this.socket.dispatchEvent(bindEvent(this.socket, new Event('error')))\n })\n\n this.realWebSocket = ws\n }\n\n /\n Listen for the incoming events from the original WebSocket server.\n /\n public addEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(\n event,\n listener.bind(this.realWebSocket!) as EventListener,\n options\n )\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the original WebSocket server.\n * @example\n * server.send('hello')\n * server.send(new Blob(['hello']))\n * server.send(new TextEncoder().encode('hello'))\n /\n public send(data: WebSocketData): void {\n const { realWebSocket } = this\n invariant(\n realWebSocket,\n 'Failed to call \"server.send()\" for \"%s\": the connection is not open. Did you forget to call \"await server.connect()\"?',\n this.socket.url\n )\n\n // Delegate the send to when the original connection is open.\n // Unlike the mock, connecting to the original server may take time\n // so we cannot call this on the next tick.\n if (realWebSocket.readyState === realWebSocket.CONNECTING) {\n realWebSocket.addEventListener(\n 'open',\n () => {\n realWebSocket.send(data)\n },\n { once: true }\n )\n return\n }\n\n // Send the data to the original WebSocket server.\n realWebSocket.send(data)\n }\n}\n","export type WebSocketData = string \| ArrayBufferLike \| Blob \| ArrayBufferView\n\nexport type WebSocketTransportOnIncomingCallback = (\n event: MessageEvent<WebSocketData>\n) => void\n\nexport type WebSocketTransportOnOutgoingCallback = (data: WebSocketData) => void\n\nexport type WebSocketTransportOnCloseCallback = (event: CloseEvent) => void\n\nexport abstract class WebSocketTransport {\n /\n A callback for the incoming server events.\n * This is called when the WebSocket client receives\n * a message from the server.\n /\n abstract onIncoming: WebSocketTransportOnIncomingCallback\n\n /\n A callback for outgoing client events.\n * This is called when the WebSocket client sends data.\n /\n abstract onOutgoing: WebSocketTransportOnOutgoingCallback\n\n /\n A callback for the close client event.\n * This is called when the WebSocket client is closed.\n /\n abstract onClose: WebSocketTransportOnCloseCallback\n\n /\n Send the data from the server to this client.\n /\n abstract send(data: WebSocketData): void\n\n /\n Close the client connection.\n /\n abstract close(code?: number, reason?: string): void\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketData } from './WebSocketTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\n\ntype WebSocketEventListener = (this: WebSocket, event: Event) => void\n\nexport type WebSocketMessageListener = (\n this: WebSocket,\n event: MessageEvent\n) => void\n\ntype WebSocketCloseListener = (this: WebSocket, event: CloseEvent) => void\n\nconst WEBSOCKET_CLOSE_CODE_RANGE_ERROR =\n 'InvalidAccessError: close code out of user configurable range'\n\nexport const kOnSend = Symbol('kOnSend')\nexport const kClose = Symbol('kClose')\n\nexport class WebSocketOverride extends EventTarget implements WebSocket {\n static readonly CONNECTING = WebSocket.CONNECTING\n static readonly OPEN = WebSocket.OPEN\n static readonly CLOSING = WebSocket.CLOSING\n static readonly CLOSED = WebSocket.CLOSED\n readonly CONNECTING = WebSocket.CONNECTING\n readonly OPEN = WebSocket.OPEN\n readonly CLOSING = WebSocket.CLOSING\n readonly CLOSED = WebSocket.CLOSED\n\n public url: string\n public protocol: string\n public extensions: string\n public binaryType: BinaryType\n public readyState: number\n public bufferedAmount: number\n\n private _onopen: WebSocketEventListener \| null = null\n private _onmessage: WebSocketMessageListener \| null = null\n private _onerror: WebSocketEventListener \| null = null\n private _onclose: WebSocketCloseListener \| null = null\n\n private [kOnSend]?: (data: WebSocketData) => void\n\n constructor(url: string \| URL, protocols?: string \| Array<string>) {\n super()\n this.url = url.toString()\n this.protocol = ''\n this.extensions = ''\n this.binaryType = 'blob'\n this.readyState = this.CONNECTING\n this.bufferedAmount = 0\n\n Reflect.set(this, 'readyState', this.CONNECTING)\n queueMicrotask(() => {\n Reflect.set(this, 'readyState', this.OPEN)\n this.protocol = protocols ? protocols[0] : 'ws'\n\n this.dispatchEvent(bindEvent(this, new Event('open')))\n })\n }\n\n set onopen(listener: WebSocketEventListener \| null) {\n this.removeEventListener('open', this._onopen)\n this._onopen = listener\n if (listener !== null) {\n this.addEventListener('open', listener)\n }\n }\n get onopen(): WebSocketEventListener \| null {\n return this._onopen\n }\n\n set onmessage(listener: WebSocketMessageListener \| null) {\n this.removeEventListener(\n 'message',\n this._onmessage as WebSocketEventListener\n )\n this._onmessage = listener\n if (listener !== null) {\n this.addEventListener('message', listener)\n }\n }\n get onmessage(): WebSocketMessageListener \| null {\n return this._onmessage\n }\n\n set onerror(listener: WebSocketEventListener \| null) {\n this.removeEventListener('error', this._onerror)\n this._onerror = listener\n if (listener !== null) {\n this.addEventListener('error', listener)\n }\n }\n get onerror(): WebSocketEventListener \| null {\n return this._onerror\n }\n\n set onclose(listener: WebSocketCloseListener \| null) {\n this.removeEventListener('close', this._onclose as WebSocketEventListener)\n this._onclose = listener\n if (listener !== null) {\n this.addEventListener('close', listener)\n }\n }\n get onclose(): WebSocketCloseListener \| null {\n return this._onclose\n }\n\n /\n @see https://websockets.spec.whatwg.org/#ref-for-dom-websocket-send%E2%91%A0\n /\n public send(data: WebSocketData): void {\n if (this.readyState === this.CONNECTING) {\n this.close()\n throw new DOMException('InvalidStateError')\n }\n\n // Sending when the socket is about to close\n // discards the sent data.\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n // Buffer the data to send in this even loop\n // but send it in the next.\n this.bufferedAmount += getDataSize(data)\n\n queueMicrotask(() => {\n // This is a bit optimistic but since no actual data transfer\n // is involved, all the data will be \"sent\" on the next tick.\n this.bufferedAmount = 0\n\n /\n @note Notify the parent about outgoing data.\n * This notifies the transport and the connection\n * listens to the outgoing data to emit the \"message\" event.\n /\n this[kOnSend]?.(data)\n })\n }\n\n public close(code: number = 1000, reason?: string): void {\n invariant(code, WEBSOCKET_CLOSE_CODE_RANGE_ERROR)\n invariant(\n code === 1000 \|\| (code >= 3000 && code <= 4999),\n WEBSOCKET_CLOSE_CODE_RANGE_ERROR\n )\n\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n this[kClose](code, reason)\n }\n\n private [kClose](code: number = 1000, reason?: string): void {\n this.readyState = this.CLOSING\n\n queueMicrotask(() => {\n this.readyState = this.CLOSED\n\n // Non-user-configurable close status codes\n // represent connection termination and must\n // emit the \"error\" event before closing.\n if (code > 1000 && code <= 1015) {\n this.dispatchEvent(bindEvent(this, new Event('error')))\n }\n\n this.dispatchEvent(\n bindEvent(\n this,\n new CloseEvent('close', {\n code,\n reason,\n wasClean: code === 1000,\n })\n )\n )\n\n // Remove all event listeners once the socket is closed.\n this._onopen = null\n this._onmessage = null\n this._onerror = null\n this._onclose = null\n })\n }\n\n public addEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: string,\n listener: EventListenerOrEventListenerObject,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: unknown,\n listener: unknown,\n options?: unknown\n ): void {\n return super.addEventListener(\n type as string,\n listener as EventListener,\n options as AddEventListenerOptions\n )\n }\n\n removeEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n callback: EventListenerOrEventListenerObject \| null,\n options?: boolean \| EventListenerOptions\n ): void {\n return super.removeEventListener(type, callback, options)\n }\n}\n\nfunction getDataSize(data: WebSocketData): number {\n if (typeof data === 'string') {\n return data.length\n }\n\n if (data instanceof Blob) {\n return data.size\n }\n\n return data.byteLength\n}\n","import { bindEvent } from './utils/bindEvent'\nimport {\n WebSocketData,\n WebSocketTransport,\n WebSocketTransportOnCloseCallback,\n WebSocketTransportOnIncomingCallback,\n WebSocketTransportOnOutgoingCallback,\n} from './WebSocketTransport'\nimport { kOnSend, kClose, WebSocketOverride } from './WebSocketOverride'\n\n/\n Abstraction over the given mock `WebSocket` instance that allows\n * for controlling that instance (e.g. sending and receiving messages).\n /\nexport class WebSocketClassTransport extends WebSocketTransport {\n public onOutgoing: WebSocketTransportOnOutgoingCallback = () => {}\n public onIncoming: WebSocketTransportOnIncomingCallback = () => {}\n public onClose: WebSocketTransportOnCloseCallback = () => {}\n\n constructor(protected readonly socket: WebSocketOverride) {\n super()\n\n this.socket.addEventListener('close', (event) => this.onClose(event), {\n once: true,\n })\n this.socket[kOnSend] = (...args) => this.onOutgoing(...args)\n }\n\n public send(data: WebSocketData): void {\n queueMicrotask(() => {\n const message = bindEvent(\n /\n @note Setting this event's \"target\" to the\n * WebSocket override instance is important.\n * This way it can tell apart original incoming events\n * (must be forwarded to the transport) from the\n * mocked message events like the one below\n * (must be dispatched on the client instance).\n /\n this.socket,\n new MessageEvent('message', {\n data,\n origin: this.socket.url,\n })\n )\n\n this.socket.dispatchEvent(message)\n })\n }\n\n public close(code: number, reason?: string): void {\n /\n @note Call the internal close method directly\n * to allow closing the connection with the status codes\n * that are non-configurable by the user (> 1000 <= 1015).\n /\n this.socket[kClose](code, reason)\n }\n}\n","import { Interceptor } from '../../Interceptor'\nimport {\n type WebSocketClientConnectionProtocol,\n WebSocketClientConnection,\n} from './WebSocketClientConnection'\nimport { WebSocketServerConnection } from './WebSocketServerConnection'\nimport { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { WebSocketOverride } from './WebSocketOverride'\n\nexport { type WebSocketData, WebSocketTransport } from './WebSocketTransport'\nexport {\n WebSocketClientConnection,\n WebSocketClientConnectionProtocol,\n WebSocketServerConnection,\n}\n\nexport type WebSocketEventMap = {\n connection: [\n args: {\n /\n The incoming WebSocket client connection.\n /\n client: WebSocketClientConnection\n\n /\n The original WebSocket server connection.\n /\n server: WebSocketServerConnection\n },\n ]\n}\n\n/\n Intercept the outgoing WebSocket connections created using\n * the global `WebSocket` class.\n */\nexport class WebSocketInterceptor extends Interceptor<WebSocketEventMap> {\n static symbol = Symbol('websocket')\n\n constructor() {\n super(WebSocketInterceptor.symbol)\n }\n\n protected checkEnvironment(): boolean {\n // Enable this interceptor in any environment\n // that has a global WebSocket API.\n return typeof globalThis.WebSocket !== 'undefined'\n }\n\n protected setup(): void {\n const webSocketProxy = Proxy.revocable(globalThis.WebSocket, {\n construct: (\n target,\n args: ConstructorParameters<typeof globalThis.WebSocket>,\n newTarget\n ) => {\n const [url, protocols] = args\n\n const createConnection = (): WebSocket => {\n return Reflect.construct(target, args, newTarget)\n }\n\n // All WebSocket instances are mocked and don't forward\n // any events to the original server (no connection established).\n // To forward the events, the user must use the \"server.send()\" API.\n const socket = new WebSocketOverride(url, protocols)\n const transport = new WebSocketClassTransport(socket)\n\n // The \"globalThis.WebSocket\" class stands for\n // the client-side connection. Assume it's established\n // as soon as the WebSocket instance is constructed.\n this.emitter.emit('connection', {\n client: new WebSocketClientConnection(socket, transport),\n server: new WebSocketServerConnection(\n socket,\n transport,\n createConnection\n ),\n })\n\n return socket\n },\n })\n\n globalThis.WebSocket = webSocketProxy.proxy\n\n this.subscriptions.push(() => {\n webSocketProxy.revoke()\n })\n }\n}\n"]}

package/lib/browser/interceptors/WebSocket/index.mjs CHANGED Viewed

@@ -49,20 +49,20 @@ var CloseEvent = class extends Event {
 // src/interceptors/WebSocket/WebSocketClientConnection.ts
 var kEmitter = Symbol("kEmitter");
 var WebSocketClientConnection = class {
-  constructor(ws, transport) {
-    this.ws = ws;
+  constructor(socket, transport) {
+    this.socket = socket;
     this.transport = transport;
     this.id = uuidv4();
-    this.url = new URL(ws.url);
+    this.url = new URL(socket.url);
     this[kEmitter] = new EventTarget();
     this.transport.onOutgoing = (data) => {
       this[kEmitter].dispatchEvent(
-        bindEvent(this.ws, new MessageEvent("message", { data }))
+        bindEvent(this.socket, new MessageEvent("message", { data }))
       );
     };
     this.transport.onClose = (event) => {
       this[kEmitter].dispatchEvent(
-        bindEvent(this.ws, new CloseEvent("close", event))
+        bindEvent(this.socket, new CloseEvent("close", event))
       );
     };
   }
@@ -103,10 +103,10 @@ kEmitter;
 import { invariant } from "outvariant";
 var kEmitter2 = Symbol("kEmitter");
 var WebSocketServerConnection = class {
-  constructor(mockWebSocket, createConnection, transport) {
-    this.mockWebSocket = mockWebSocket;
-    this.createConnection = createConnection;
+  constructor(socket, transport, createConnection) {
+    this.socket = socket;
     this.transport = transport;
+    this.createConnection = createConnection;
     this[kEmitter2] = new EventTarget();
     this.transport.onIncoming = (event) => {
       const messageEvent = bindEvent(
@@ -119,14 +119,14 @@ var WebSocketServerConnection = class {
       );
       this[kEmitter2].dispatchEvent(messageEvent);
       if (!messageEvent.defaultPrevented) {
-        this.mockWebSocket.dispatchEvent(
+        this.socket.dispatchEvent(
           bindEvent(
             /**
              * @note Bind the forwarded original server events
              * to the mock WebSocket instance so it would
              * dispatch them straight away.
              */
-            this.mockWebSocket,
+            this.socket,
             // Clone the message event again to prevent
             // the "already being dispatched" exception.
             new MessageEvent("message", {
@@ -159,7 +159,7 @@ var WebSocketServerConnection = class {
       'Failed to call "connect()" on the original WebSocket instance: the connection already open'
     );
     const ws = this.createConnection();
-    this.mockWebSocket.addEventListener(
+    this.socket.addEventListener(
       "close",
       (event) => {
         ws.close(event.code, event.reason);
@@ -170,9 +170,7 @@ var WebSocketServerConnection = class {
       this.transport.onIncoming(event);
     });
     ws.addEventListener("error", () => {
-      this.mockWebSocket.dispatchEvent(
-        bindEvent(this.mockWebSocket, new Event("error"))
-      );
+      this.socket.dispatchEvent(bindEvent(this.socket, new Event("error")));
     });
     this.realWebSocket = ws;
   }
@@ -208,7 +206,7 @@ var WebSocketServerConnection = class {
     invariant(
       realWebSocket,
       'Failed to call "server.send()" for "%s": the connection is not open. Did you forget to call "await server.connect()"?',
-      this.mockWebSocket.url
+      this.socket.url
     );
     if (realWebSocket.readyState === realWebSocket.CONNECTING) {
       realWebSocket.addEventListener(
@@ -380,19 +378,19 @@ function getDataSize(data) {
 // src/interceptors/WebSocket/WebSocketClassTransport.ts
 var WebSocketClassTransport = class extends WebSocketTransport {
-  constructor(ws) {
+  constructor(socket) {
     super();
-    this.ws = ws;
+    this.socket = socket;
     this.onOutgoing = () => {
     };
     this.onIncoming = () => {
     };
     this.onClose = () => {
     };
-    this.ws.addEventListener("close", (event) => this.onClose(event), {
+    this.socket.addEventListener("close", (event) => this.onClose(event), {
       once: true
     });
-    this.ws[kOnSend] = (...args) => this.onOutgoing(...args);
+    this.socket[kOnSend] = (...args) => this.onOutgoing(...args);
   }
   send(data) {
     queueMicrotask(() => {
@@ -405,17 +403,17 @@ var WebSocketClassTransport = class extends WebSocketTransport {
          * mocked message events like the one below
          * (must be dispatched on the client instance).
          */
-        this.ws,
+        this.socket,
         new MessageEvent("message", {
           data,
-          origin: this.ws.url
+          origin: this.socket.url
         })
       );
-      this.ws.dispatchEvent(message);
+      this.socket.dispatchEvent(message);
     });
   }
   close(code, reason) {
-    this.ws[kClose](code, reason);
+    this.socket[kClose](code, reason);
   }
 };
@@ -434,17 +432,17 @@ var _WebSocketInterceptor = class extends Interceptor {
         const createConnection = () => {
           return Reflect.construct(target, args, newTarget);
         };
-        const mockWs = new WebSocketOverride(url, protocols);
-        const transport = new WebSocketClassTransport(mockWs);
+        const socket = new WebSocketOverride(url, protocols);
+        const transport = new WebSocketClassTransport(socket);
         this.emitter.emit("connection", {
-          client: new WebSocketClientConnection(mockWs, transport),
+          client: new WebSocketClientConnection(socket, transport),
           server: new WebSocketServerConnection(
-            mockWs,
-            createConnection,
-            transport
+            socket,
+            transport,
+            createConnection
           )
         });
-        return mockWs;
+        return socket;
       }
     });
     globalThis.WebSocket = webSocketProxy.proxy;
@@ -458,6 +456,7 @@ WebSocketInterceptor.symbol = Symbol("websocket");
 export {
   WebSocketClientConnection,
   WebSocketInterceptor,
-  WebSocketServerConnection
+  WebSocketServerConnection,
+  WebSocketTransport
 };
 //# sourceMappingURL=index.mjs.map

package/lib/browser/interceptors/WebSocket/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../../src/interceptors/WebSocket/utils/bindEvent.ts","../../../../src/interceptors/WebSocket/utils/events.ts","../../../../src/interceptors/WebSocket/WebSocketClientConnection.ts","../../../../src/interceptors/WebSocket/WebSocketServerConnection.ts","../../../../src/interceptors/WebSocket/WebSocketTransport.ts","../../../../src/interceptors/WebSocket/WebSocketOverride.ts","../../../../src/interceptors/WebSocket/WebSocketClassTransport.ts","../../../../src/interceptors/WebSocket/index.ts"],"sourcesContent":["type EventWithTarget<E extends Event, T> = E & { target: T }\n\nexport function bindEvent<E extends Event, T>(\n target: T,\n event: E\n): EventWithTarget<E, T> {\n Object.defineProperty(event, 'target', {\n enumerable: true,\n writable: true,\n value: target,\n })\n return event as EventWithTarget<E, T>\n}\n","const kCancelable = Symbol('kCancelable')\nconst kDefaultPrevented = Symbol('kDefaultPrevented')\n\n/*\n A `MessageEvent` superset that supports event cancellation\n * in Node.js. It's rather non-intrusive so it can be safely\n * used in the browser as well.\n \n @see https://github.com/nodejs/node/issues/51767\n /\nexport class CancelableMessageEvent<T = any> extends MessageEvent<T> {\n [kCancelable]: boolean;\n [kDefaultPrevented]: boolean\n\n constructor(type: string, init: MessageEventInit<T>) {\n super(type, init)\n this[kCancelable] = !!init.cancelable\n this[kDefaultPrevented] = false\n }\n\n get cancelable() {\n return this[kCancelable]\n }\n\n get defaultPrevented() {\n return this[kDefaultPrevented]\n }\n\n public preventDefault(): void {\n if (this.cancelable && !this[kDefaultPrevented]) {\n this[kDefaultPrevented] = true\n }\n }\n}\n\ninterface CloseEventInit extends EventInit {\n code?: number\n reason?: string\n wasClean?: boolean\n}\n\nexport class CloseEvent extends Event {\n public code: number\n public reason: string\n public wasClean: boolean\n\n constructor(type: string, init: CloseEventInit = {}) {\n super(type, init)\n this.code = init.code === undefined ? 0 : init.code\n this.reason = init.reason === undefined ? '' : init.reason\n this.wasClean = init.wasClean === undefined ? false : init.wasClean\n }\n}\n","/\n WebSocket client class.\n * This represents an incoming WebSocket client connection.\n * @note Keep this class implementation-agnostic because it's\n * meant to be used over any WebSocket implementation\n * (not all of them follow the one from WHATWG).\n /\nimport type { WebSocketRawData, WebSocketTransport } from './WebSocketTransport'\nimport { WebSocketMessageListener } from './WebSocketOverride'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\nimport { uuidv4 } from '../../utils/uuid'\n\nconst kEmitter = Symbol('kEmitter')\n\n/\n The WebSocket client instance represents an incoming\n * client connection. The user can control the connection,\n * send and receive events.\n /\nexport class WebSocketClientConnection {\n public readonly id: string\n public readonly url: URL\n\n protected [kEmitter]: EventTarget\n\n constructor(\n protected readonly ws: WebSocket,\n protected readonly transport: WebSocketTransport\n ) {\n this.id = uuidv4()\n this.url = new URL(ws.url)\n this[kEmitter] = new EventTarget()\n\n // Emit outgoing client data (\"ws.send()\") as \"message\"\n // events on the client connection.\n this.transport.onOutgoing = (data) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.ws, new MessageEvent('message', { data }))\n )\n }\n\n this.transport.onClose = (event) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.ws, new CloseEvent('close', event))\n )\n }\n }\n\n /\n Listen for the outgoing events from the connected WebSocket client.\n /\n public addEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(event, listener as EventListener, options)\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the connected client.\n /\n public send(data: WebSocketRawData): void {\n this.transport.send(data)\n }\n\n /\n Close the WebSocket connection.\n * @param {number} code A status code (see https://www.rfc-editor.org/rfc/rfc6455#section-7.4.1).\n * @param {string} reason A custom connection close reason.\n /\n public close(code?: number, reason?: string): void {\n this.transport.close(code, reason)\n }\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketOverride } from './WebSocketOverride'\nimport type { WebSocketRawData } from './WebSocketTransport'\nimport type { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CancelableMessageEvent } from './utils/events'\n\nconst kEmitter = Symbol('kEmitter')\n\n/\n The WebSocket server instance represents the actual production\n * WebSocket server connection. It's idle by default but you can\n * establish it by calling `server.connect()`.\n /\nexport class WebSocketServerConnection {\n /\n A WebSocket instance connected to the original server.\n /\n private realWebSocket?: WebSocket\n private [kEmitter]: EventTarget\n\n constructor(\n private readonly mockWebSocket: WebSocketOverride,\n private readonly createConnection: () => WebSocket,\n private readonly transport: WebSocketClassTransport\n ) {\n this[kEmitter] = new EventTarget()\n\n // Handle incoming events from the actual server.\n // The (mock) WebSocket instance will call this\n // whenever a \"message\" event from the actual server\n // is dispatched on it (the dispatch will be skipped).\n this.transport.onIncoming = (event) => {\n // Clone the event to dispatch it on this class\n // once again and prevent the \"already being dispatched\"\n // exception. Clone it here so we can observe this event\n // being prevented in the \"server.on()\" listeners.\n const messageEvent = bindEvent(\n this.realWebSocket!,\n new CancelableMessageEvent('message', {\n data: event.data,\n origin: event.origin,\n cancelable: true,\n })\n )\n\n /\n @note Emit \"message\" event on the WebSocketClassServer\n * instance to let the interceptor know about these\n * incoming events from the original server. In that listener,\n * the interceptor can modify or skip the event forwarding\n * to the mock WebSocket instance.\n /\n this[kEmitter].dispatchEvent(messageEvent)\n\n /\n @note Forward the incoming server events to the client.\n * Preventing the default on the message event stops this.\n /\n if (!messageEvent.defaultPrevented) {\n this.mockWebSocket.dispatchEvent(\n bindEvent(\n /\n @note Bind the forwarded original server events\n * to the mock WebSocket instance so it would\n * dispatch them straight away.\n /\n this.mockWebSocket,\n // Clone the message event again to prevent\n // the \"already being dispatched\" exception.\n new MessageEvent('message', {\n data: event.data,\n origin: event.origin,\n })\n )\n )\n }\n }\n }\n\n /\n Server ready state.\n * Proxies the ready state of the original WebSocket instance,\n * if set. If the original connection hasn't been established,\n * defaults to `-1`.\n /\n public get readyState(): number {\n if (this.realWebSocket) {\n return this.realWebSocket.readyState\n }\n\n return -1\n }\n\n /\n Open connection to the original WebSocket server.\n /\n public connect(): void {\n invariant(\n this.readyState === -1,\n 'Failed to call \"connect()\" on the original WebSocket instance: the connection already open'\n )\n\n const ws = this.createConnection()\n\n // Close the original connection when the (mock)\n // client closes, regardless of the reason.\n this.mockWebSocket.addEventListener(\n 'close',\n (event) => {\n ws.close(event.code, event.reason)\n },\n { once: true }\n )\n\n ws.addEventListener('message', (event) => {\n this.transport.onIncoming(event)\n })\n\n // Forward server errors to the WebSocket client as-is.\n // We may consider exposing them to the interceptor in the future.\n ws.addEventListener('error', () => {\n this.mockWebSocket.dispatchEvent(\n bindEvent(this.mockWebSocket, new Event('error'))\n )\n })\n\n this.realWebSocket = ws\n }\n\n /\n Listen for the incoming events from the original WebSocket server.\n /\n public addEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(\n event,\n listener.bind(this.realWebSocket!) as EventListener,\n options\n )\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the original WebSocket server.\n * @example\n * server.send('hello')\n * server.send(new Blob(['hello']))\n * server.send(new TextEncoder().encode('hello'))\n /\n public send(data: WebSocketRawData): void {\n const { realWebSocket } = this\n invariant(\n realWebSocket,\n 'Failed to call \"server.send()\" for \"%s\": the connection is not open. Did you forget to call \"await server.connect()\"?',\n this.mockWebSocket.url\n )\n\n // Delegate the send to when the original connection is open.\n // Unlike the mock, connecting to the original server may take time\n // so we cannot call this on the next tick.\n if (realWebSocket.readyState === realWebSocket.CONNECTING) {\n realWebSocket.addEventListener(\n 'open',\n () => {\n realWebSocket.send(data)\n },\n { once: true }\n )\n return\n }\n\n // Send the data to the original WebSocket server.\n realWebSocket.send(data)\n }\n}\n","export type WebSocketRawData = string \| ArrayBufferLike \| Blob \| ArrayBufferView\n\nexport type WebSocketTransportOnIncomingCallback = (\n event: MessageEvent<WebSocketRawData>\n) => void\n\nexport type WebSocketTransportOnOutgoingCallback = (\n data: WebSocketRawData\n) => void\n\nexport type WebSocketTransportOnCloseCallback = (event: CloseEvent) => void\n\nexport abstract class WebSocketTransport {\n /\n Listener for the incoming server events.\n * This is called when the client receives the\n * event from the original server connection.\n \n This way, we can trigger the \"message\" event\n * on the mocked connection to let the user know.\n /\n abstract onIncoming: WebSocketTransportOnIncomingCallback\n abstract onOutgoing: WebSocketTransportOnOutgoingCallback\n abstract onClose: WebSocketTransportOnCloseCallback\n\n /\n Send the data from the server to this client.\n /\n abstract send(data: WebSocketRawData): void\n\n /\n Close the client connection.\n /\n abstract close(code?: number, reason?: string): void\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketRawData } from './WebSocketTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\n\ntype WebSocketEventListener = (this: WebSocket, event: Event) => void\n\nexport type WebSocketMessageListener = (\n this: WebSocket,\n event: MessageEvent\n) => void\n\ntype WebSocketCloseListener = (this: WebSocket, event: CloseEvent) => void\n\nconst WEBSOCKET_CLOSE_CODE_RANGE_ERROR =\n 'InvalidAccessError: close code out of user configurable range'\n\nexport const kOnSend = Symbol('kOnSend')\nexport const kClose = Symbol('kClose')\n\nexport class WebSocketOverride extends EventTarget implements WebSocket {\n static readonly CONNECTING = WebSocket.CONNECTING\n static readonly OPEN = WebSocket.OPEN\n static readonly CLOSING = WebSocket.CLOSING\n static readonly CLOSED = WebSocket.CLOSED\n readonly CONNECTING = WebSocket.CONNECTING\n readonly OPEN = WebSocket.OPEN\n readonly CLOSING = WebSocket.CLOSING\n readonly CLOSED = WebSocket.CLOSED\n\n public url: string\n public protocol: string\n public extensions: string\n public binaryType: BinaryType\n public readyState: number\n public bufferedAmount: number\n\n private _onopen: WebSocketEventListener \| null = null\n private _onmessage: WebSocketMessageListener \| null = null\n private _onerror: WebSocketEventListener \| null = null\n private _onclose: WebSocketCloseListener \| null = null\n\n private [kOnSend]?: (data: WebSocketRawData) => void\n\n constructor(url: string \| URL, protocols?: string \| Array<string>) {\n super()\n this.url = url.toString()\n this.protocol = ''\n this.extensions = ''\n this.binaryType = 'blob'\n this.readyState = this.CONNECTING\n this.bufferedAmount = 0\n\n Reflect.set(this, 'readyState', this.CONNECTING)\n queueMicrotask(() => {\n Reflect.set(this, 'readyState', this.OPEN)\n this.protocol = protocols ? protocols[0] : 'ws'\n\n this.dispatchEvent(bindEvent(this, new Event('open')))\n })\n }\n\n set onopen(listener: WebSocketEventListener \| null) {\n this.removeEventListener('open', this._onopen)\n this._onopen = listener\n if (listener !== null) {\n this.addEventListener('open', listener)\n }\n }\n get onopen(): WebSocketEventListener \| null {\n return this._onopen\n }\n\n set onmessage(listener: WebSocketMessageListener \| null) {\n this.removeEventListener(\n 'message',\n this._onmessage as WebSocketEventListener\n )\n this._onmessage = listener\n if (listener !== null) {\n this.addEventListener('message', listener)\n }\n }\n get onmessage(): WebSocketMessageListener \| null {\n return this._onmessage\n }\n\n set onerror(listener: WebSocketEventListener \| null) {\n this.removeEventListener('error', this._onerror)\n this._onerror = listener\n if (listener !== null) {\n this.addEventListener('error', listener)\n }\n }\n get onerror(): WebSocketEventListener \| null {\n return this._onerror\n }\n\n set onclose(listener: WebSocketCloseListener \| null) {\n this.removeEventListener('close', this._onclose as WebSocketEventListener)\n this._onclose = listener\n if (listener !== null) {\n this.addEventListener('close', listener)\n }\n }\n get onclose(): WebSocketCloseListener \| null {\n return this._onclose\n }\n\n /\n @see https://websockets.spec.whatwg.org/#ref-for-dom-websocket-send%E2%91%A0\n /\n public send(data: WebSocketRawData): void {\n if (this.readyState === this.CONNECTING) {\n this.close()\n throw new DOMException('InvalidStateError')\n }\n\n // Sending when the socket is about to close\n // discards the sent data.\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n // Buffer the data to send in this even loop\n // but send it in the next.\n this.bufferedAmount += getDataSize(data)\n\n queueMicrotask(() => {\n // This is a bit optimistic but since no actual data transfer\n // is involved, all the data will be \"sent\" on the next tick.\n this.bufferedAmount = 0\n\n /\n @note Notify the parent about outgoing data.\n * This notifies the transport and the connection\n * listens to the outgoing data to emit the \"message\" event.\n /\n this[kOnSend]?.(data)\n })\n }\n\n public close(code: number = 1000, reason?: string): void {\n invariant(code, WEBSOCKET_CLOSE_CODE_RANGE_ERROR)\n invariant(\n code === 1000 \|\| (code >= 3000 && code <= 4999),\n WEBSOCKET_CLOSE_CODE_RANGE_ERROR\n )\n\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n this[kClose](code, reason)\n }\n\n private [kClose](code: number = 1000, reason?: string): void {\n this.readyState = this.CLOSING\n\n queueMicrotask(() => {\n this.readyState = this.CLOSED\n\n // Non-user-configurable close status codes\n // represent connection termination and must\n // emit the \"error\" event before closing.\n if (code > 1000 && code <= 1015) {\n this.dispatchEvent(bindEvent(this, new Event('error')))\n }\n\n this.dispatchEvent(\n bindEvent(\n this,\n new CloseEvent('close', {\n code,\n reason,\n wasClean: code === 1000,\n })\n )\n )\n\n // Remove all event listeners once the socket is closed.\n this._onopen = null\n this._onmessage = null\n this._onerror = null\n this._onclose = null\n })\n }\n\n public addEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: string,\n listener: EventListenerOrEventListenerObject,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: unknown,\n listener: unknown,\n options?: unknown\n ): void {\n return super.addEventListener(\n type as string,\n listener as EventListener,\n options as AddEventListenerOptions\n )\n }\n\n removeEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n callback: EventListenerOrEventListenerObject \| null,\n options?: boolean \| EventListenerOptions\n ): void {\n return super.removeEventListener(type, callback, options)\n }\n}\n\nfunction getDataSize(data: WebSocketRawData): number {\n if (typeof data === 'string') {\n return data.length\n }\n\n if (data instanceof Blob) {\n return data.size\n }\n\n return data.byteLength\n}\n","import { bindEvent } from './utils/bindEvent'\nimport {\n WebSocketRawData,\n WebSocketTransport,\n WebSocketTransportOnCloseCallback,\n WebSocketTransportOnIncomingCallback,\n WebSocketTransportOnOutgoingCallback,\n} from './WebSocketTransport'\nimport { kOnSend, kClose, WebSocketOverride } from './WebSocketOverride'\n\nexport class WebSocketClassTransport extends WebSocketTransport {\n public onOutgoing: WebSocketTransportOnOutgoingCallback = () => {}\n public onIncoming: WebSocketTransportOnIncomingCallback = () => {}\n public onClose: WebSocketTransportOnCloseCallback = () => {}\n\n constructor(protected readonly ws: WebSocketOverride) {\n super()\n\n this.ws.addEventListener('close', (event) => this.onClose(event), {\n once: true,\n })\n this.ws[kOnSend] = (...args) => this.onOutgoing(...args)\n }\n\n public send(data: WebSocketRawData): void {\n queueMicrotask(() => {\n const message = bindEvent(\n /\n @note Setting this event's \"target\" to the\n * WebSocket override instance is important.\n * This way it can tell apart original incoming events\n * (must be forwarded to the transport) from the\n * mocked message events like the one below\n * (must be dispatched on the client instance).\n /\n this.ws,\n new MessageEvent('message', {\n data,\n origin: this.ws.url,\n })\n )\n\n this.ws.dispatchEvent(message)\n })\n }\n\n public close(code: number, reason?: string): void {\n /\n @note Call the internal close method directly\n * to allow closing the connection with the status codes\n * that are non-configurable by the user (> 1000 <= 1015).\n /\n this.ws[kClose](code, reason)\n }\n}\n","import { Interceptor } from '../../Interceptor'\nimport { WebSocketClientConnection } from './WebSocketClientConnection'\nimport { WebSocketServerConnection } from './WebSocketServerConnection'\nimport { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { WebSocketOverride } from './WebSocketOverride'\n\nexport type { WebSocketRawData } from './WebSocketTransport'\nexport { WebSocketClientConnection, WebSocketServerConnection }\n\nexport type WebSocketEventMap = {\n connection: [\n args: {\n /\n The incoming WebSocket client connection.\n /\n client: WebSocketClientConnection\n\n /\n The original WebSocket server connection.\n /\n server: WebSocketServerConnection\n }\n ]\n}\n\n/\n Intercept the outgoing WebSocket connections created using\n * the global `WebSocket` class.\n */\nexport class WebSocketInterceptor extends Interceptor<WebSocketEventMap> {\n static symbol = Symbol('websocket')\n\n constructor() {\n super(WebSocketInterceptor.symbol)\n }\n\n protected checkEnvironment(): boolean {\n // Enable this interceptor in any environment\n // that has a global WebSocket API.\n return typeof globalThis.WebSocket !== 'undefined'\n }\n\n protected setup(): void {\n const webSocketProxy = Proxy.revocable(globalThis.WebSocket, {\n construct: (\n target,\n args: ConstructorParameters<typeof globalThis.WebSocket>,\n newTarget\n ) => {\n const [url, protocols] = args\n\n const createConnection = (): WebSocket => {\n return Reflect.construct(target, args, newTarget)\n }\n\n // All WebSocket instances are mocked and don't forward\n // any events to the original server (no connection established).\n // To forward the events, the user must use the \"server.send()\" API.\n const mockWs = new WebSocketOverride(url, protocols)\n const transport = new WebSocketClassTransport(mockWs)\n\n // The \"globalThis.WebSocket\" class stands for\n // the client-side connection. Assume it's established\n // as soon as the WebSocket instance is constructed.\n this.emitter.emit('connection', {\n client: new WebSocketClientConnection(mockWs, transport),\n server: new WebSocketServerConnection(\n mockWs,\n createConnection,\n transport\n ),\n })\n\n return mockWs\n },\n })\n\n globalThis.WebSocket = webSocketProxy.proxy\n\n this.subscriptions.push(() => {\n webSocketProxy.revoke()\n })\n }\n}\n"],"mappings":"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","names":["kEmitter","invariant","invariant"]}
1	+ {"version":3,"sources":["../../../../src/interceptors/WebSocket/utils/bindEvent.ts","../../../../src/interceptors/WebSocket/utils/events.ts","../../../../src/interceptors/WebSocket/WebSocketClientConnection.ts","../../../../src/interceptors/WebSocket/WebSocketServerConnection.ts","../../../../src/interceptors/WebSocket/WebSocketTransport.ts","../../../../src/interceptors/WebSocket/WebSocketOverride.ts","../../../../src/interceptors/WebSocket/WebSocketClassTransport.ts","../../../../src/interceptors/WebSocket/index.ts"],"sourcesContent":["type EventWithTarget<E extends Event, T> = E & { target: T }\n\nexport function bindEvent<E extends Event, T>(\n target: T,\n event: E\n): EventWithTarget<E, T> {\n Object.defineProperty(event, 'target', {\n enumerable: true,\n writable: true,\n value: target,\n })\n return event as EventWithTarget<E, T>\n}\n","const kCancelable = Symbol('kCancelable')\nconst kDefaultPrevented = Symbol('kDefaultPrevented')\n\n/*\n A `MessageEvent` superset that supports event cancellation\n * in Node.js. It's rather non-intrusive so it can be safely\n * used in the browser as well.\n \n @see https://github.com/nodejs/node/issues/51767\n /\nexport class CancelableMessageEvent<T = any> extends MessageEvent<T> {\n [kCancelable]: boolean;\n [kDefaultPrevented]: boolean\n\n constructor(type: string, init: MessageEventInit<T>) {\n super(type, init)\n this[kCancelable] = !!init.cancelable\n this[kDefaultPrevented] = false\n }\n\n get cancelable() {\n return this[kCancelable]\n }\n\n get defaultPrevented() {\n return this[kDefaultPrevented]\n }\n\n public preventDefault(): void {\n if (this.cancelable && !this[kDefaultPrevented]) {\n this[kDefaultPrevented] = true\n }\n }\n}\n\ninterface CloseEventInit extends EventInit {\n code?: number\n reason?: string\n wasClean?: boolean\n}\n\nexport class CloseEvent extends Event {\n public code: number\n public reason: string\n public wasClean: boolean\n\n constructor(type: string, init: CloseEventInit = {}) {\n super(type, init)\n this.code = init.code === undefined ? 0 : init.code\n this.reason = init.reason === undefined ? '' : init.reason\n this.wasClean = init.wasClean === undefined ? false : init.wasClean\n }\n}\n","/\n WebSocket client class.\n * This represents an incoming WebSocket client connection.\n * @note Keep this class implementation-agnostic because it's\n * meant to be used over any WebSocket implementation\n * (not all of them follow the one from WHATWG).\n /\nimport type { WebSocketData, WebSocketTransport } from './WebSocketTransport'\nimport { WebSocketMessageListener } from './WebSocketOverride'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\nimport { uuidv4 } from '../../utils/uuid'\n\nconst kEmitter = Symbol('kEmitter')\n\nexport interface WebSocketClientConnectionProtocol {\n id: string\n url: URL\n send(data: WebSocketData): void\n close(code?: number, reason?: string): void\n}\n\n/\n The WebSocket client instance represents an incoming\n * client connection. The user can control the connection,\n * send and receive events.\n /\nexport class WebSocketClientConnection\n implements WebSocketClientConnectionProtocol\n{\n public readonly id: string\n public readonly url: URL\n\n private [kEmitter]: EventTarget\n\n constructor(\n private readonly socket: WebSocket,\n private readonly transport: WebSocketTransport\n ) {\n this.id = uuidv4()\n this.url = new URL(socket.url)\n this[kEmitter] = new EventTarget()\n\n // Emit outgoing client data (\"ws.send()\") as \"message\"\n // events on the client connection.\n this.transport.onOutgoing = (data) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.socket, new MessageEvent('message', { data }))\n )\n }\n\n this.transport.onClose = (event) => {\n this[kEmitter].dispatchEvent(\n bindEvent(this.socket, new CloseEvent('close', event))\n )\n }\n }\n\n /\n Listen for the outgoing events from the connected WebSocket client.\n /\n public addEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(event, listener as EventListener, options)\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener(\n event: string,\n listener: WebSocketMessageListener,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the connected client.\n /\n public send(data: WebSocketData): void {\n this.transport.send(data)\n }\n\n /\n Close the WebSocket connection.\n * @param {number} code A status code (see https://www.rfc-editor.org/rfc/rfc6455#section-7.4.1).\n * @param {string} reason A custom connection close reason.\n /\n public close(code?: number, reason?: string): void {\n this.transport.close(code, reason)\n }\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketOverride } from './WebSocketOverride'\nimport type { WebSocketData } from './WebSocketTransport'\nimport type { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CancelableMessageEvent } from './utils/events'\n\nconst kEmitter = Symbol('kEmitter')\n\n/\n The WebSocket server instance represents the actual production\n * WebSocket server connection. It's idle by default but you can\n * establish it by calling `server.connect()`.\n /\nexport class WebSocketServerConnection {\n /\n A WebSocket instance connected to the original server.\n /\n private realWebSocket?: WebSocket\n private [kEmitter]: EventTarget\n\n constructor(\n private readonly socket: WebSocketOverride,\n private readonly transport: WebSocketClassTransport,\n private readonly createConnection: () => WebSocket\n ) {\n this[kEmitter] = new EventTarget()\n\n // Handle incoming events from the actual server.\n // The (mock) WebSocket instance will call this\n // whenever a \"message\" event from the actual server\n // is dispatched on it (the dispatch will be skipped).\n this.transport.onIncoming = (event) => {\n // Clone the event to dispatch it on this class\n // once again and prevent the \"already being dispatched\"\n // exception. Clone it here so we can observe this event\n // being prevented in the \"server.on()\" listeners.\n const messageEvent = bindEvent(\n this.realWebSocket!,\n new CancelableMessageEvent('message', {\n data: event.data,\n origin: event.origin,\n cancelable: true,\n })\n )\n\n /\n @note Emit \"message\" event on the WebSocketClassServer\n * instance to let the interceptor know about these\n * incoming events from the original server. In that listener,\n * the interceptor can modify or skip the event forwarding\n * to the mock WebSocket instance.\n /\n this[kEmitter].dispatchEvent(messageEvent)\n\n /\n @note Forward the incoming server events to the client.\n * Preventing the default on the message event stops this.\n /\n if (!messageEvent.defaultPrevented) {\n this.socket.dispatchEvent(\n bindEvent(\n /\n @note Bind the forwarded original server events\n * to the mock WebSocket instance so it would\n * dispatch them straight away.\n /\n this.socket,\n // Clone the message event again to prevent\n // the \"already being dispatched\" exception.\n new MessageEvent('message', {\n data: event.data,\n origin: event.origin,\n })\n )\n )\n }\n }\n }\n\n /\n Server ready state.\n * Proxies the ready state of the original WebSocket instance,\n * if set. If the original connection hasn't been established,\n * defaults to `-1`.\n /\n public get readyState(): number {\n if (this.realWebSocket) {\n return this.realWebSocket.readyState\n }\n\n return -1\n }\n\n /\n Open connection to the original WebSocket server.\n /\n public connect(): void {\n invariant(\n this.readyState === -1,\n 'Failed to call \"connect()\" on the original WebSocket instance: the connection already open'\n )\n\n const ws = this.createConnection()\n\n // Close the original connection when the (mock)\n // client closes, regardless of the reason.\n this.socket.addEventListener(\n 'close',\n (event) => {\n ws.close(event.code, event.reason)\n },\n { once: true }\n )\n\n ws.addEventListener('message', (event) => {\n this.transport.onIncoming(event)\n })\n\n // Forward server errors to the WebSocket client as-is.\n // We may consider exposing them to the interceptor in the future.\n ws.addEventListener('error', () => {\n this.socket.dispatchEvent(bindEvent(this.socket, new Event('error')))\n })\n\n this.realWebSocket = ws\n }\n\n /\n Listen for the incoming events from the original WebSocket server.\n /\n public addEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: AddEventListenerOptions \| boolean\n ): void {\n this[kEmitter].addEventListener(\n event,\n listener.bind(this.realWebSocket!) as EventListener,\n options\n )\n }\n\n /\n Removes the listener for the given event.\n /\n public removeEventListener<K extends keyof WebSocketEventMap>(\n event: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: EventListenerOptions \| boolean\n ): void {\n this[kEmitter].removeEventListener(\n event,\n listener as EventListener,\n options\n )\n }\n\n /\n Send data to the original WebSocket server.\n * @example\n * server.send('hello')\n * server.send(new Blob(['hello']))\n * server.send(new TextEncoder().encode('hello'))\n /\n public send(data: WebSocketData): void {\n const { realWebSocket } = this\n invariant(\n realWebSocket,\n 'Failed to call \"server.send()\" for \"%s\": the connection is not open. Did you forget to call \"await server.connect()\"?',\n this.socket.url\n )\n\n // Delegate the send to when the original connection is open.\n // Unlike the mock, connecting to the original server may take time\n // so we cannot call this on the next tick.\n if (realWebSocket.readyState === realWebSocket.CONNECTING) {\n realWebSocket.addEventListener(\n 'open',\n () => {\n realWebSocket.send(data)\n },\n { once: true }\n )\n return\n }\n\n // Send the data to the original WebSocket server.\n realWebSocket.send(data)\n }\n}\n","export type WebSocketData = string \| ArrayBufferLike \| Blob \| ArrayBufferView\n\nexport type WebSocketTransportOnIncomingCallback = (\n event: MessageEvent<WebSocketData>\n) => void\n\nexport type WebSocketTransportOnOutgoingCallback = (data: WebSocketData) => void\n\nexport type WebSocketTransportOnCloseCallback = (event: CloseEvent) => void\n\nexport abstract class WebSocketTransport {\n /\n A callback for the incoming server events.\n * This is called when the WebSocket client receives\n * a message from the server.\n /\n abstract onIncoming: WebSocketTransportOnIncomingCallback\n\n /\n A callback for outgoing client events.\n * This is called when the WebSocket client sends data.\n /\n abstract onOutgoing: WebSocketTransportOnOutgoingCallback\n\n /\n A callback for the close client event.\n * This is called when the WebSocket client is closed.\n /\n abstract onClose: WebSocketTransportOnCloseCallback\n\n /\n Send the data from the server to this client.\n /\n abstract send(data: WebSocketData): void\n\n /\n Close the client connection.\n /\n abstract close(code?: number, reason?: string): void\n}\n","import { invariant } from 'outvariant'\nimport type { WebSocketData } from './WebSocketTransport'\nimport { bindEvent } from './utils/bindEvent'\nimport { CloseEvent } from './utils/events'\n\ntype WebSocketEventListener = (this: WebSocket, event: Event) => void\n\nexport type WebSocketMessageListener = (\n this: WebSocket,\n event: MessageEvent\n) => void\n\ntype WebSocketCloseListener = (this: WebSocket, event: CloseEvent) => void\n\nconst WEBSOCKET_CLOSE_CODE_RANGE_ERROR =\n 'InvalidAccessError: close code out of user configurable range'\n\nexport const kOnSend = Symbol('kOnSend')\nexport const kClose = Symbol('kClose')\n\nexport class WebSocketOverride extends EventTarget implements WebSocket {\n static readonly CONNECTING = WebSocket.CONNECTING\n static readonly OPEN = WebSocket.OPEN\n static readonly CLOSING = WebSocket.CLOSING\n static readonly CLOSED = WebSocket.CLOSED\n readonly CONNECTING = WebSocket.CONNECTING\n readonly OPEN = WebSocket.OPEN\n readonly CLOSING = WebSocket.CLOSING\n readonly CLOSED = WebSocket.CLOSED\n\n public url: string\n public protocol: string\n public extensions: string\n public binaryType: BinaryType\n public readyState: number\n public bufferedAmount: number\n\n private _onopen: WebSocketEventListener \| null = null\n private _onmessage: WebSocketMessageListener \| null = null\n private _onerror: WebSocketEventListener \| null = null\n private _onclose: WebSocketCloseListener \| null = null\n\n private [kOnSend]?: (data: WebSocketData) => void\n\n constructor(url: string \| URL, protocols?: string \| Array<string>) {\n super()\n this.url = url.toString()\n this.protocol = ''\n this.extensions = ''\n this.binaryType = 'blob'\n this.readyState = this.CONNECTING\n this.bufferedAmount = 0\n\n Reflect.set(this, 'readyState', this.CONNECTING)\n queueMicrotask(() => {\n Reflect.set(this, 'readyState', this.OPEN)\n this.protocol = protocols ? protocols[0] : 'ws'\n\n this.dispatchEvent(bindEvent(this, new Event('open')))\n })\n }\n\n set onopen(listener: WebSocketEventListener \| null) {\n this.removeEventListener('open', this._onopen)\n this._onopen = listener\n if (listener !== null) {\n this.addEventListener('open', listener)\n }\n }\n get onopen(): WebSocketEventListener \| null {\n return this._onopen\n }\n\n set onmessage(listener: WebSocketMessageListener \| null) {\n this.removeEventListener(\n 'message',\n this._onmessage as WebSocketEventListener\n )\n this._onmessage = listener\n if (listener !== null) {\n this.addEventListener('message', listener)\n }\n }\n get onmessage(): WebSocketMessageListener \| null {\n return this._onmessage\n }\n\n set onerror(listener: WebSocketEventListener \| null) {\n this.removeEventListener('error', this._onerror)\n this._onerror = listener\n if (listener !== null) {\n this.addEventListener('error', listener)\n }\n }\n get onerror(): WebSocketEventListener \| null {\n return this._onerror\n }\n\n set onclose(listener: WebSocketCloseListener \| null) {\n this.removeEventListener('close', this._onclose as WebSocketEventListener)\n this._onclose = listener\n if (listener !== null) {\n this.addEventListener('close', listener)\n }\n }\n get onclose(): WebSocketCloseListener \| null {\n return this._onclose\n }\n\n /\n @see https://websockets.spec.whatwg.org/#ref-for-dom-websocket-send%E2%91%A0\n /\n public send(data: WebSocketData): void {\n if (this.readyState === this.CONNECTING) {\n this.close()\n throw new DOMException('InvalidStateError')\n }\n\n // Sending when the socket is about to close\n // discards the sent data.\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n // Buffer the data to send in this even loop\n // but send it in the next.\n this.bufferedAmount += getDataSize(data)\n\n queueMicrotask(() => {\n // This is a bit optimistic but since no actual data transfer\n // is involved, all the data will be \"sent\" on the next tick.\n this.bufferedAmount = 0\n\n /\n @note Notify the parent about outgoing data.\n * This notifies the transport and the connection\n * listens to the outgoing data to emit the \"message\" event.\n /\n this[kOnSend]?.(data)\n })\n }\n\n public close(code: number = 1000, reason?: string): void {\n invariant(code, WEBSOCKET_CLOSE_CODE_RANGE_ERROR)\n invariant(\n code === 1000 \|\| (code >= 3000 && code <= 4999),\n WEBSOCKET_CLOSE_CODE_RANGE_ERROR\n )\n\n if (this.readyState === this.CLOSING \|\| this.readyState === this.CLOSED) {\n return\n }\n\n this[kClose](code, reason)\n }\n\n private [kClose](code: number = 1000, reason?: string): void {\n this.readyState = this.CLOSING\n\n queueMicrotask(() => {\n this.readyState = this.CLOSED\n\n // Non-user-configurable close status codes\n // represent connection termination and must\n // emit the \"error\" event before closing.\n if (code > 1000 && code <= 1015) {\n this.dispatchEvent(bindEvent(this, new Event('error')))\n }\n\n this.dispatchEvent(\n bindEvent(\n this,\n new CloseEvent('close', {\n code,\n reason,\n wasClean: code === 1000,\n })\n )\n )\n\n // Remove all event listeners once the socket is closed.\n this._onopen = null\n this._onmessage = null\n this._onerror = null\n this._onclose = null\n })\n }\n\n public addEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n listener: (this: WebSocket, event: WebSocketEventMap[K]) => void,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: string,\n listener: EventListenerOrEventListenerObject,\n options?: boolean \| AddEventListenerOptions\n ): void\n public addEventListener(\n type: unknown,\n listener: unknown,\n options?: unknown\n ): void {\n return super.addEventListener(\n type as string,\n listener as EventListener,\n options as AddEventListenerOptions\n )\n }\n\n removeEventListener<K extends keyof WebSocketEventMap>(\n type: K,\n callback: EventListenerOrEventListenerObject \| null,\n options?: boolean \| EventListenerOptions\n ): void {\n return super.removeEventListener(type, callback, options)\n }\n}\n\nfunction getDataSize(data: WebSocketData): number {\n if (typeof data === 'string') {\n return data.length\n }\n\n if (data instanceof Blob) {\n return data.size\n }\n\n return data.byteLength\n}\n","import { bindEvent } from './utils/bindEvent'\nimport {\n WebSocketData,\n WebSocketTransport,\n WebSocketTransportOnCloseCallback,\n WebSocketTransportOnIncomingCallback,\n WebSocketTransportOnOutgoingCallback,\n} from './WebSocketTransport'\nimport { kOnSend, kClose, WebSocketOverride } from './WebSocketOverride'\n\n/\n Abstraction over the given mock `WebSocket` instance that allows\n * for controlling that instance (e.g. sending and receiving messages).\n /\nexport class WebSocketClassTransport extends WebSocketTransport {\n public onOutgoing: WebSocketTransportOnOutgoingCallback = () => {}\n public onIncoming: WebSocketTransportOnIncomingCallback = () => {}\n public onClose: WebSocketTransportOnCloseCallback = () => {}\n\n constructor(protected readonly socket: WebSocketOverride) {\n super()\n\n this.socket.addEventListener('close', (event) => this.onClose(event), {\n once: true,\n })\n this.socket[kOnSend] = (...args) => this.onOutgoing(...args)\n }\n\n public send(data: WebSocketData): void {\n queueMicrotask(() => {\n const message = bindEvent(\n /\n @note Setting this event's \"target\" to the\n * WebSocket override instance is important.\n * This way it can tell apart original incoming events\n * (must be forwarded to the transport) from the\n * mocked message events like the one below\n * (must be dispatched on the client instance).\n /\n this.socket,\n new MessageEvent('message', {\n data,\n origin: this.socket.url,\n })\n )\n\n this.socket.dispatchEvent(message)\n })\n }\n\n public close(code: number, reason?: string): void {\n /\n @note Call the internal close method directly\n * to allow closing the connection with the status codes\n * that are non-configurable by the user (> 1000 <= 1015).\n /\n this.socket[kClose](code, reason)\n }\n}\n","import { Interceptor } from '../../Interceptor'\nimport {\n type WebSocketClientConnectionProtocol,\n WebSocketClientConnection,\n} from './WebSocketClientConnection'\nimport { WebSocketServerConnection } from './WebSocketServerConnection'\nimport { WebSocketClassTransport } from './WebSocketClassTransport'\nimport { WebSocketOverride } from './WebSocketOverride'\n\nexport { type WebSocketData, WebSocketTransport } from './WebSocketTransport'\nexport {\n WebSocketClientConnection,\n WebSocketClientConnectionProtocol,\n WebSocketServerConnection,\n}\n\nexport type WebSocketEventMap = {\n connection: [\n args: {\n /\n The incoming WebSocket client connection.\n /\n client: WebSocketClientConnection\n\n /\n The original WebSocket server connection.\n /\n server: WebSocketServerConnection\n },\n ]\n}\n\n/\n Intercept the outgoing WebSocket connections created using\n * the global `WebSocket` class.\n */\nexport class WebSocketInterceptor extends Interceptor<WebSocketEventMap> {\n static symbol = Symbol('websocket')\n\n constructor() {\n super(WebSocketInterceptor.symbol)\n }\n\n protected checkEnvironment(): boolean {\n // Enable this interceptor in any environment\n // that has a global WebSocket API.\n return typeof globalThis.WebSocket !== 'undefined'\n }\n\n protected setup(): void {\n const webSocketProxy = Proxy.revocable(globalThis.WebSocket, {\n construct: (\n target,\n args: ConstructorParameters<typeof globalThis.WebSocket>,\n newTarget\n ) => {\n const [url, protocols] = args\n\n const createConnection = (): WebSocket => {\n return Reflect.construct(target, args, newTarget)\n }\n\n // All WebSocket instances are mocked and don't forward\n // any events to the original server (no connection established).\n // To forward the events, the user must use the \"server.send()\" API.\n const socket = new WebSocketOverride(url, protocols)\n const transport = new WebSocketClassTransport(socket)\n\n // The \"globalThis.WebSocket\" class stands for\n // the client-side connection. Assume it's established\n // as soon as the WebSocket instance is constructed.\n this.emitter.emit('connection', {\n client: new WebSocketClientConnection(socket, transport),\n server: new WebSocketServerConnection(\n socket,\n transport,\n createConnection\n ),\n })\n\n return socket\n },\n })\n\n globalThis.WebSocket = webSocketProxy.proxy\n\n this.subscriptions.push(() => {\n webSocketProxy.revoke()\n })\n }\n}\n"],"mappings":"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","names":["kEmitter","invariant","invariant"]}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@mswjs/interceptors",
   "description": "Low-level HTTP/HTTPS/XHR/fetch request interception library.",
-  "version": "0.26.4",
+  "version": "0.26.5",
   "main": "./lib/node/index.js",
   "module": "./lib/node/index.mjs",
   "types": "./lib/node/index.d.ts",

package/src/interceptors/WebSocket/WebSocketClassTransport.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { bindEvent } from './utils/bindEvent'
 import {
-  WebSocketRawData,
+  WebSocketData,
   WebSocketTransport,
   WebSocketTransportOnCloseCallback,
   WebSocketTransportOnIncomingCallback,
@@ -8,21 +8,25 @@ import {
 } from './WebSocketTransport'
 import { kOnSend, kClose, WebSocketOverride } from './WebSocketOverride'
+/**
+ * Abstraction over the given mock `WebSocket` instance that allows
+ * for controlling that instance (e.g. sending and receiving messages).
+ */
 export class WebSocketClassTransport extends WebSocketTransport {
   public onOutgoing: WebSocketTransportOnOutgoingCallback = () => {}
   public onIncoming: WebSocketTransportOnIncomingCallback = () => {}
   public onClose: WebSocketTransportOnCloseCallback = () => {}
-  constructor(protected readonly ws: WebSocketOverride) {
+  constructor(protected readonly socket: WebSocketOverride) {
     super()
-    this.ws.addEventListener('close', (event) => this.onClose(event), {
+    this.socket.addEventListener('close', (event) => this.onClose(event), {
       once: true,
     })
-    this.ws[kOnSend] = (...args) => this.onOutgoing(...args)
+    this.socket[kOnSend] = (...args) => this.onOutgoing(...args)
   }
-  public send(data: WebSocketRawData): void {
+  public send(data: WebSocketData): void {
     queueMicrotask(() => {
       const message = bindEvent(
         /**
@@ -33,14 +37,14 @@ export class WebSocketClassTransport extends WebSocketTransport {
          * mocked message events like the one below
          * (must be dispatched on the client instance).
          */
-        this.ws,
+        this.socket,
         new MessageEvent('message', {
           data,
-          origin: this.ws.url,
+          origin: this.socket.url,
         })
       )
-      this.ws.dispatchEvent(message)
+      this.socket.dispatchEvent(message)
     })
   }
@@ -50,6 +54,6 @@ export class WebSocketClassTransport extends WebSocketTransport {
      * to allow closing the connection with the status codes
      * that are non-configurable by the user (> 1000 <= 1015).
      */
-    this.ws[kClose](code, reason)
+    this.socket[kClose](code, reason)
   }
 }

package/src/interceptors/WebSocket/WebSocketClientConnection.ts CHANGED Viewed

@@ -5,7 +5,7 @@
  * meant to be used over any WebSocket implementation
  * (not all of them follow the one from WHATWG).
  */
-import type { WebSocketRawData, WebSocketTransport } from './WebSocketTransport'
+import type { WebSocketData, WebSocketTransport } from './WebSocketTransport'
 import { WebSocketMessageListener } from './WebSocketOverride'
 import { bindEvent } from './utils/bindEvent'
 import { CloseEvent } from './utils/events'
@@ -13,36 +13,45 @@ import { uuidv4 } from '../../utils/uuid'
 const kEmitter = Symbol('kEmitter')
+export interface WebSocketClientConnectionProtocol {
+  id: string
+  url: URL
+  send(data: WebSocketData): void
+  close(code?: number, reason?: string): void
+}
 /**
  * The WebSocket client instance represents an incoming
  * client connection. The user can control the connection,
  * send and receive events.
  */
-export class WebSocketClientConnection {
+export class WebSocketClientConnection
+  implements WebSocketClientConnectionProtocol
+{
   public readonly id: string
   public readonly url: URL
-  protected [kEmitter]: EventTarget
+  private [kEmitter]: EventTarget
   constructor(
-    protected readonly ws: WebSocket,
-    protected readonly transport: WebSocketTransport
+    private readonly socket: WebSocket,
+    private readonly transport: WebSocketTransport
   ) {
     this.id = uuidv4()
-    this.url = new URL(ws.url)
+    this.url = new URL(socket.url)
     this[kEmitter] = new EventTarget()
     // Emit outgoing client data ("ws.send()") as "message"
     // events on the client connection.
     this.transport.onOutgoing = (data) => {
       this[kEmitter].dispatchEvent(
-        bindEvent(this.ws, new MessageEvent('message', { data }))
+        bindEvent(this.socket, new MessageEvent('message', { data }))
       )
     }
     this.transport.onClose = (event) => {
       this[kEmitter].dispatchEvent(
-        bindEvent(this.ws, new CloseEvent('close', event))
+        bindEvent(this.socket, new CloseEvent('close', event))
       )
     }
   }
@@ -76,7 +85,7 @@ export class WebSocketClientConnection {
   /**
    * Send data to the connected client.
    */
-  public send(data: WebSocketRawData): void {
+  public send(data: WebSocketData): void {
     this.transport.send(data)
   }

package/src/interceptors/WebSocket/WebSocketOverride.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import { invariant } from 'outvariant'
-import type { WebSocketRawData } from './WebSocketTransport'
+import type { WebSocketData } from './WebSocketTransport'
 import { bindEvent } from './utils/bindEvent'
 import { CloseEvent } from './utils/events'
@@ -40,7 +40,7 @@ export class WebSocketOverride extends EventTarget implements WebSocket {
   private _onerror: WebSocketEventListener | null = null
   private _onclose: WebSocketCloseListener | null = null
-  private [kOnSend]?: (data: WebSocketRawData) => void
+  private [kOnSend]?: (data: WebSocketData) => void
   constructor(url: string | URL, protocols?: string | Array<string>) {
     super()
@@ -110,7 +110,7 @@ export class WebSocketOverride extends EventTarget implements WebSocket {
   /**
    * @see https://websockets.spec.whatwg.org/#ref-for-dom-websocket-send%E2%91%A0
    */
-  public send(data: WebSocketRawData): void {
+  public send(data: WebSocketData): void {
     if (this.readyState === this.CONNECTING) {
       this.close()
       throw new DOMException('InvalidStateError')
@@ -217,7 +217,7 @@ export class WebSocketOverride extends EventTarget implements WebSocket {
   }
 }
-function getDataSize(data: WebSocketRawData): number {
+function getDataSize(data: WebSocketData): number {
   if (typeof data === 'string') {
     return data.length
   }

package/src/interceptors/WebSocket/WebSocketServerConnection.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { invariant } from 'outvariant'
 import type { WebSocketOverride } from './WebSocketOverride'
-import type { WebSocketRawData } from './WebSocketTransport'
+import type { WebSocketData } from './WebSocketTransport'
 import type { WebSocketClassTransport } from './WebSocketClassTransport'
 import { bindEvent } from './utils/bindEvent'
 import { CancelableMessageEvent } from './utils/events'
@@ -20,9 +20,9 @@ export class WebSocketServerConnection {
   private [kEmitter]: EventTarget
   constructor(
-    private readonly mockWebSocket: WebSocketOverride,
-    private readonly createConnection: () => WebSocket,
-    private readonly transport: WebSocketClassTransport
+    private readonly socket: WebSocketOverride,
+    private readonly transport: WebSocketClassTransport,
+    private readonly createConnection: () => WebSocket
   ) {
     this[kEmitter] = new EventTarget()
@@ -58,14 +58,14 @@ export class WebSocketServerConnection {
        * Preventing the default on the message event stops this.
        */
       if (!messageEvent.defaultPrevented) {
-        this.mockWebSocket.dispatchEvent(
+        this.socket.dispatchEvent(
           bindEvent(
             /**
              * @note Bind the forwarded original server events
              * to the mock WebSocket instance so it would
              * dispatch them straight away.
              */
-            this.mockWebSocket,
+            this.socket,
             // Clone the message event again to prevent
             // the "already being dispatched" exception.
             new MessageEvent('message', {
@@ -105,7 +105,7 @@ export class WebSocketServerConnection {
     // Close the original connection when the (mock)
     // client closes, regardless of the reason.
-    this.mockWebSocket.addEventListener(
+    this.socket.addEventListener(
       'close',
       (event) => {
         ws.close(event.code, event.reason)
@@ -120,9 +120,7 @@ export class WebSocketServerConnection {
     // Forward server errors to the WebSocket client as-is.
     // We may consider exposing them to the interceptor in the future.
     ws.addEventListener('error', () => {
-      this.mockWebSocket.dispatchEvent(
-        bindEvent(this.mockWebSocket, new Event('error'))
-      )
+      this.socket.dispatchEvent(bindEvent(this.socket, new Event('error')))
     })
     this.realWebSocket = ws
@@ -165,12 +163,12 @@ export class WebSocketServerConnection {
    * server.send(new Blob(['hello']))
    * server.send(new TextEncoder().encode('hello'))
    */
-  public send(data: WebSocketRawData): void {
+  public send(data: WebSocketData): void {
     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.mockWebSocket.url
+      this.socket.url
     )
     // Delegate the send to when the original connection is open.

package/src/interceptors/WebSocket/WebSocketTransport.ts CHANGED Viewed

@@ -1,32 +1,37 @@
-export type WebSocketRawData = string | ArrayBufferLike | Blob | ArrayBufferView
+export type WebSocketData = string | ArrayBufferLike | Blob | ArrayBufferView
 export type WebSocketTransportOnIncomingCallback = (
-  event: MessageEvent<WebSocketRawData>
+  event: MessageEvent<WebSocketData>
 ) => void
-export type WebSocketTransportOnOutgoingCallback = (
-  data: WebSocketRawData
-) => void
+export type WebSocketTransportOnOutgoingCallback = (data: WebSocketData) => void
 export type WebSocketTransportOnCloseCallback = (event: CloseEvent) => void
 export abstract class WebSocketTransport {
   /**
-   * Listener for the incoming server events.
-   * This is called when the client receives the
-   * event from the original server connection.
-   *
-   * This way, we can trigger the "message" event
-   * on the mocked connection to let the user know.
+   * A callback for the incoming server events.
+   * This is called when the WebSocket client receives
+   * a message from the server.
    */
   abstract onIncoming: WebSocketTransportOnIncomingCallback
+  /**
+   * A callback for outgoing client events.
+   * This is called when the WebSocket client sends data.
+   */
   abstract onOutgoing: WebSocketTransportOnOutgoingCallback
+  /**
+   * A callback for the close client event.
+   * This is called when the WebSocket client is closed.
+   */
   abstract onClose: WebSocketTransportOnCloseCallback
   /**
    * Send the data from the server to this client.
    */
-  abstract send(data: WebSocketRawData): void
+  abstract send(data: WebSocketData): void
   /**
    * Close the client connection.

package/src/interceptors/WebSocket/index.ts CHANGED Viewed

@@ -1,11 +1,18 @@
 import { Interceptor } from '../../Interceptor'
-import { WebSocketClientConnection } from './WebSocketClientConnection'
+import {
+  type WebSocketClientConnectionProtocol,
+  WebSocketClientConnection,
+} from './WebSocketClientConnection'
 import { WebSocketServerConnection } from './WebSocketServerConnection'
 import { WebSocketClassTransport } from './WebSocketClassTransport'
 import { WebSocketOverride } from './WebSocketOverride'
-export type { WebSocketRawData } from './WebSocketTransport'
-export { WebSocketClientConnection, WebSocketServerConnection }
+export { type WebSocketData, WebSocketTransport } from './WebSocketTransport'
+export {
+  WebSocketClientConnection,
+  WebSocketClientConnectionProtocol,
+  WebSocketServerConnection,
+}
 export type WebSocketEventMap = {
   connection: [
@@ -19,7 +26,7 @@ export type WebSocketEventMap = {
        * The original WebSocket server connection.
        */
       server: WebSocketServerConnection
-    }
+    },
   ]
 }
@@ -56,22 +63,22 @@ export class WebSocketInterceptor extends Interceptor<WebSocketEventMap> {
         // All WebSocket instances are mocked and don't forward
         // any events to the original server (no connection established).
         // To forward the events, the user must use the "server.send()" API.
-        const mockWs = new WebSocketOverride(url, protocols)
-        const transport = new WebSocketClassTransport(mockWs)
+        const socket = new WebSocketOverride(url, protocols)
+        const transport = new WebSocketClassTransport(socket)
         // The "globalThis.WebSocket" class stands for
         // the client-side connection. Assume it's established
         // as soon as the WebSocket instance is constructed.
         this.emitter.emit('connection', {
-          client: new WebSocketClientConnection(mockWs, transport),
+          client: new WebSocketClientConnection(socket, transport),
           server: new WebSocketServerConnection(
-            mockWs,
-            createConnection,
-            transport
+            socket,
+            transport,
+            createConnection
           ),
         })
-        return mockWs
+        return socket
       },
     })