@depup/mswjs__interceptors 0.41.3-depup.0

package/src/utils/resolveWebSocketUrl.ts

@@ -0,0 +1,45 @@
+/**
+ * Resolve potentially relative WebSocket URLs the same way
+ * the browser does (replace the protocol, use the origin, etc).
+ *
+ * @see https://websockets.spec.whatwg.org//#dom-websocket-websocket
+ */
+export function resolveWebSocketUrl(url: string | URL): string {
+  if (typeof url === 'string') {
+    /**
+     * @note Cast the string to a URL first so the parsing errors
+     * are thrown as a part of the WebSocket constructor, not consumers.
+     */
+    const urlRecord = new URL(
+      url,
+      typeof location !== 'undefined' ? location.href : undefined
+    )
+
+    return resolveWebSocketUrl(urlRecord)
+  }
+
+  if (url.protocol === 'http:') {
+    url.protocol = 'ws:'
+  } else if (url.protocol === 'https:') {
+    url.protocol = 'wss:'
+  }
+
+  if (url.protocol !== 'ws:' && url.protocol !== 'wss:') {
+    /**
+     * @note These errors are modeled after the browser errors.
+     * The exact error messages aren't provided in the specification.
+     * Node.js uses more obscure error messages that I don't wish to replicate.
+     */
+    throw new SyntaxError(
+      `Failed to construct 'WebSocket': The URL's scheme must be either 'http', 'https', 'ws', or 'wss'. '${url.protocol}' is not allowed.`
+    )
+  }
+
+  if (url.hash !== '') {
+    throw new SyntaxError(
+      `Failed to construct 'WebSocket': The URL contains a fragment identifier ('${url.hash}'). Fragment identifiers are not allowed in WebSocket URLs.`
+    )
+  }
+
+  return url.href
+}

package/src/utils/responseUtils.ts

@@ -0,0 +1,59 @@
+import { isObject } from './isObject'
+import { isPropertyAccessible } from './isPropertyAccessible'
+
+/**
+ * Creates a generic 500 Unhandled Exception response.
+ */
+export function createServerErrorResponse(body: unknown): Response {
+  return new Response(
+    JSON.stringify(
+      body instanceof Error
+        ? {
+            name: body.name,
+            message: body.message,
+            stack: body.stack,
+          }
+        : body
+    ),
+    {
+      status: 500,
+      statusText: 'Unhandled Exception',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+    }
+  )
+}
+
+export type ResponseError = Response & { type: 'error' }
+
+/**
+ * Check if the given response is a `Response.error()`.
+ *
+ * @note Some environments, like Miniflare (Cloudflare) do not
+ * implement the "Response.type" property and throw on its access.
+ * Safely check if we can access "type" on "Response" before continuing.
+ * @see https://github.com/mswjs/msw/issues/1834
+ */
+export function isResponseError(response: unknown): response is ResponseError {
+  return (
+    response != null &&
+    response instanceof Response &&
+    isPropertyAccessible(response, 'type') &&
+    response.type === 'error'
+  )
+}
+
+/**
+ * Check if the given value is a `Response` or a Response-like object.
+ * This is different from `value instanceof Response` because it supports
+ * custom `Response` constructors, like the one when using Undici directly.
+ */
+export function isResponseLike(value: unknown): value is Response {
+  return (
+    isObject<Record<string, any>>(value, true) &&
+    isPropertyAccessible(value, 'status') &&
+    isPropertyAccessible(value, 'statusText') &&
+    isPropertyAccessible(value, 'bodyUsed')
+  )
+}