ajax-hooker 1.2.5 → 1.3.0

package/README.md

@@ -295,6 +295,7 @@ The response object received by the response callback contains the following pro
 | `arrayBuffer` | `ArrayBuffer` | Read-only | Fetch only. Response ArrayBuffer |
 | `blob` | `Blob` | Read-only | Fetch only. Response Blob |
 | `formData` | `FormData` | Read-only | Fetch only. Response FormData |
+| `mockError` | `Error \| string` | **Writable** | Fetch only. Rejects the fetch promise after the real request has been sent |
 
 > **Note:** For Fetch responses, `json`, `text`, `arrayBuffer`, `blob`, and `formData` are automatically parsed by the interceptor and available as properties. No need to call `.json()` or similar methods. If parsing fails, the corresponding property is `null`.
 
@@ -319,6 +320,7 @@ interface AjaxResponse {
   arrayBuffer?: ArrayBuffer;
   blob?: Blob;
   formData?: FormData;
+  mockError?: Error | string;
 }
 ```
 
@@ -406,6 +408,21 @@ interceptor.hook((request) => {
 }, 'xhr');
 ```
 
+### Simulate Fetch Network Errors
+
+```typescript
+interceptor.hook((request) => {
+  if (request.url.includes('/api/fail')) {
+    request.response = (response) => {
+      response.mockError = new TypeError('Failed to fetch');
+    };
+  }
+  return request;
+}, 'fetch');
+```
+
+> `mockError` is designed for **Fetch only**. For XHR failure simulation, prefer setting `request.timeout` and using a slow or hanging endpoint to trigger native timeout behavior.
+
 ### Intercept Streaming Responses
 
 ```typescript

package/dist/cjs/index.js

@@ -31,7 +31,7 @@ Object.getOwnPropertyDescriptor.bind(Object);
 
 const getType = Object.prototype.toString.call.bind(Object.prototype.toString);
 
-const resolveUrl = (url = "") => new URL(url, window.location.origin).toString();
+const resolveUrl = (url = "") => new URL(url, window.location.href).toString();
 
 const getProxyValue = (target, prop) => {
     const value = Reflect.get(target, prop);
@@ -52,6 +52,13 @@ class XhrInterceptor {
     nativeXhr=window.XMLHttpRequest;
     nativeXhrPrototype=window.XMLHttpRequest.prototype;
     hooks=[];
+    xhrContructorKeys={
+        UNSENT: this.nativeXhr.UNSENT,
+        OPENED: this.nativeXhr.OPENED,
+        HEADERS_RECEIVED: this.nativeXhr.HEADERS_RECEIVED,
+        LOADING: this.nativeXhr.LOADING,
+        DONE: this.nativeXhr.DONE
+    };
     xhrResponseEvents=[ "readystatechange", "load", "loadend" ];
     xhrInstanceAttr=[ "response", "responseText", "responseXML", "status", "statusText" ];
     xhrInstanceAttrHandler=this.xhrInstanceAttr.reduce((acc, attr) => {
@@ -97,6 +104,7 @@ class XhrInterceptor {
                     console.warn("[AjaxInterceptor] Error in xhr request hooks:", error);
                 }
                 hooker.req = newRequest;
+                if (target.readyState !== self.xhrContructorKeys.OPENED && target.readyState !== self.xhrContructorKeys.UNSENT) return;
                 const needReopen = oldRequest.method !== newRequest.method || oldRequest.url !== newRequest.url;
                 const headersChanged = !self.headersEqual(oldRequest.headers, newRequest.headers);
                 const shouldReopen = needReopen || headersChanged;
@@ -354,7 +362,8 @@ class FetchInterceptor {
         };
     }
     resolveRequest(req, newRequest, sourceMap) {
-        const urlChanged = typeof req === "string" && newRequest.url !== req || req instanceof URL && newRequest.url !== req.href || req instanceof Request && newRequest.url !== req.url;
+        const resolvedOriginalUrl = typeof req === "string" ? resolveUrl(req) : req instanceof URL ? req.href : req.url;
+        const urlChanged = newRequest.url !== resolvedOriginalUrl;
         if (typeof req === "string") return urlChanged ? newRequest.url : req;
         if (req instanceof URL) return urlChanged ? new URL(newRequest.url) : req;
         if (req instanceof Request) {
@@ -404,6 +413,13 @@ class FetchInterceptor {
         if (headers instanceof Headers) return headers;
         return new Headers(headers);
     }
+    resolveFetchError(error) {
+        if (error instanceof Error) return error;
+        return new TypeError(error);
+    }
+    throwIfMockError(mockError) {
+        if (mockError) throw this.resolveFetchError(mockError);
+    }
     isWasmRequest(url) {
         try {
             return new URL(url).pathname.endsWith(".wasm");
@@ -468,6 +484,7 @@ class FetchInterceptor {
                 } catch (error) {
                     console.warn("[AjaxInterceptor] Error in fetch stream response callback:", error);
                 }
+                self.throwIfMockError(hooker.resp.mockError);
                 let chunkIndex = 0;
                 const {readable: readable, writable: writable} = new TransformStream({
                     async transform(chunk, controller) {
@@ -520,6 +537,7 @@ class FetchInterceptor {
                 } catch (error) {
                     console.warn("[AjaxInterceptor] Error in fetch response callback:", error);
                 }
+                self.throwIfMockError(hooker.resp.mockError);
             }
             interceptedResponse[CYCLE_SCHEDULER] = hooker;
             const proxyFh = new Proxy(interceptedResponse, {

package/dist/esm/index.js

@@ -25,7 +25,7 @@ Object.getOwnPropertyDescriptor.bind(Object);
 
 const getType = Object.prototype.toString.call.bind(Object.prototype.toString);
 
-const resolveUrl = (url = "") => new URL(url, window.location.origin).toString();
+const resolveUrl = (url = "") => new URL(url, window.location.href).toString();
 
 const getProxyValue = (target, prop) => {
     const value = Reflect.get(target, prop);
@@ -46,6 +46,13 @@ class XhrInterceptor {
     nativeXhr=window.XMLHttpRequest;
     nativeXhrPrototype=window.XMLHttpRequest.prototype;
     hooks=[];
+    xhrContructorKeys={
+        UNSENT: this.nativeXhr.UNSENT,
+        OPENED: this.nativeXhr.OPENED,
+        HEADERS_RECEIVED: this.nativeXhr.HEADERS_RECEIVED,
+        LOADING: this.nativeXhr.LOADING,
+        DONE: this.nativeXhr.DONE
+    };
     xhrResponseEvents=[ "readystatechange", "load", "loadend" ];
     xhrInstanceAttr=[ "response", "responseText", "responseXML", "status", "statusText" ];
     xhrInstanceAttrHandler=this.xhrInstanceAttr.reduce((acc, attr) => {
@@ -91,6 +98,7 @@ class XhrInterceptor {
                     console.warn("[AjaxInterceptor] Error in xhr request hooks:", error);
                 }
                 hooker.req = newRequest;
+                if (target.readyState !== self.xhrContructorKeys.OPENED && target.readyState !== self.xhrContructorKeys.UNSENT) return;
                 const needReopen = oldRequest.method !== newRequest.method || oldRequest.url !== newRequest.url;
                 const headersChanged = !self.headersEqual(oldRequest.headers, newRequest.headers);
                 const shouldReopen = needReopen || headersChanged;
@@ -348,7 +356,8 @@ class FetchInterceptor {
         };
     }
     resolveRequest(req, newRequest, sourceMap) {
-        const urlChanged = typeof req === "string" && newRequest.url !== req || req instanceof URL && newRequest.url !== req.href || req instanceof Request && newRequest.url !== req.url;
+        const resolvedOriginalUrl = typeof req === "string" ? resolveUrl(req) : req instanceof URL ? req.href : req.url;
+        const urlChanged = newRequest.url !== resolvedOriginalUrl;
         if (typeof req === "string") return urlChanged ? newRequest.url : req;
         if (req instanceof URL) return urlChanged ? new URL(newRequest.url) : req;
         if (req instanceof Request) {
@@ -398,6 +407,13 @@ class FetchInterceptor {
         if (headers instanceof Headers) return headers;
         return new Headers(headers);
     }
+    resolveFetchError(error) {
+        if (error instanceof Error) return error;
+        return new TypeError(error);
+    }
+    throwIfMockError(mockError) {
+        if (mockError) throw this.resolveFetchError(mockError);
+    }
     isWasmRequest(url) {
         try {
             return new URL(url).pathname.endsWith(".wasm");
@@ -462,6 +478,7 @@ class FetchInterceptor {
                 } catch (error) {
                     console.warn("[AjaxInterceptor] Error in fetch stream response callback:", error);
                 }
+                self.throwIfMockError(hooker.resp.mockError);
                 let chunkIndex = 0;
                 const {readable: readable, writable: writable} = new TransformStream({
                     async transform(chunk, controller) {
@@ -514,6 +531,7 @@ class FetchInterceptor {
                 } catch (error) {
                     console.warn("[AjaxInterceptor] Error in fetch response callback:", error);
                 }
+                self.throwIfMockError(hooker.resp.mockError);
             }
             interceptedResponse[CYCLE_SCHEDULER] = hooker;
             const proxyFh = new Proxy(interceptedResponse, {

package/dist/iife/index.js

@@ -22,7 +22,7 @@ var AjaxHooker = function(exports) {
     }
     Object.getOwnPropertyDescriptor.bind(Object);
     const getType = Object.prototype.toString.call.bind(Object.prototype.toString);
-    const resolveUrl = (url = "") => new URL(url, window.location.origin).toString();
+    const resolveUrl = (url = "") => new URL(url, window.location.href).toString();
     const getProxyValue = (target, prop) => {
         const value = Reflect.get(target, prop);
         if (typeof value !== "function") return value;
@@ -40,6 +40,13 @@ var AjaxHooker = function(exports) {
         nativeXhr=window.XMLHttpRequest;
         nativeXhrPrototype=window.XMLHttpRequest.prototype;
         hooks=[];
+        xhrContructorKeys={
+            UNSENT: this.nativeXhr.UNSENT,
+            OPENED: this.nativeXhr.OPENED,
+            HEADERS_RECEIVED: this.nativeXhr.HEADERS_RECEIVED,
+            LOADING: this.nativeXhr.LOADING,
+            DONE: this.nativeXhr.DONE
+        };
         xhrResponseEvents=[ "readystatechange", "load", "loadend" ];
         xhrInstanceAttr=[ "response", "responseText", "responseXML", "status", "statusText" ];
         xhrInstanceAttrHandler=this.xhrInstanceAttr.reduce((acc, attr) => {
@@ -85,6 +92,7 @@ var AjaxHooker = function(exports) {
                         console.warn("[AjaxInterceptor] Error in xhr request hooks:", error);
                     }
                     hooker.req = newRequest;
+                    if (target.readyState !== self.xhrContructorKeys.OPENED && target.readyState !== self.xhrContructorKeys.UNSENT) return;
                     const needReopen = oldRequest.method !== newRequest.method || oldRequest.url !== newRequest.url;
                     const headersChanged = !self.headersEqual(oldRequest.headers, newRequest.headers);
                     const shouldReopen = needReopen || headersChanged;
@@ -339,7 +347,8 @@ var AjaxHooker = function(exports) {
             };
         }
         resolveRequest(req, newRequest, sourceMap) {
-            const urlChanged = typeof req === "string" && newRequest.url !== req || req instanceof URL && newRequest.url !== req.href || req instanceof Request && newRequest.url !== req.url;
+            const resolvedOriginalUrl = typeof req === "string" ? resolveUrl(req) : req instanceof URL ? req.href : req.url;
+            const urlChanged = newRequest.url !== resolvedOriginalUrl;
             if (typeof req === "string") return urlChanged ? newRequest.url : req;
             if (req instanceof URL) return urlChanged ? new URL(newRequest.url) : req;
             if (req instanceof Request) {
@@ -389,6 +398,13 @@ var AjaxHooker = function(exports) {
             if (headers instanceof Headers) return headers;
             return new Headers(headers);
         }
+        resolveFetchError(error) {
+            if (error instanceof Error) return error;
+            return new TypeError(error);
+        }
+        throwIfMockError(mockError) {
+            if (mockError) throw this.resolveFetchError(mockError);
+        }
         isWasmRequest(url) {
             try {
                 return new URL(url).pathname.endsWith(".wasm");
@@ -453,6 +469,7 @@ var AjaxHooker = function(exports) {
                     } catch (error) {
                         console.warn("[AjaxInterceptor] Error in fetch stream response callback:", error);
                     }
+                    self.throwIfMockError(hooker.resp.mockError);
                     let chunkIndex = 0;
                     const {readable: readable, writable: writable} = new TransformStream({
                         async transform(chunk, controller) {
@@ -505,6 +522,7 @@ var AjaxHooker = function(exports) {
                     } catch (error) {
                         console.warn("[AjaxInterceptor] Error in fetch response callback:", error);
                     }
+                    self.throwIfMockError(hooker.resp.mockError);
                 }
                 interceptedResponse[CYCLE_SCHEDULER] = hooker;
                 const proxyFh = new Proxy(interceptedResponse, {

package/dist/types/fetch.d.ts

@@ -15,6 +15,8 @@ export declare class FetchInterceptor {
     private resolveRequest;
     private resolveOptions;
     private resolveHeaders;
+    private resolveFetchError;
+    private throwIfMockError;
     private isWasmRequest;
     private _generateProxyFetch;
 }

package/dist/types/type.d.ts

@@ -13,6 +13,7 @@ export interface FetchResponse extends Pick<Response, 'ok' | 'redirected'> {
     blob: Blob;
     formData: FormData;
     json: any;
+    mockError?: Error | string;
 }
 export interface AjaxResponse extends BaseResponse, Partial<XhrResponse & FetchResponse> {
 }

package/dist/types/xhr.d.ts

@@ -11,6 +11,7 @@ export declare class XhrInterceptor {
     };
     readonly nativeXhrPrototype: XMLHttpRequest;
     hooks: HookFunction[];
+    private readonly xhrContructorKeys;
     private xhrResponseEvents;
     private xhrInstanceAttr;
     private xhrInstanceAttrHandler;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ajax-hooker",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "Browser AJAX interceptor for XMLHttpRequest and fetch with unified hooks, request/response mutation, and streaming response support.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",