ajax-hooker 1.2.6 → 1.3.1

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

@@ -52,7 +52,15 @@ 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" ];
+    xhrAssignedMethodOverrides=new WeakMap;
     xhrInstanceAttr=[ "response", "responseText", "responseXML", "status", "statusText" ];
     xhrInstanceAttrHandler=this.xhrInstanceAttr.reduce((acc, attr) => {
         acc[attr] = function(target) {
@@ -97,7 +105,7 @@ class XhrInterceptor {
                     console.warn("[AjaxInterceptor] Error in xhr request hooks:", error);
                 }
                 hooker.req = newRequest;
-                if (target.readyState !== XMLHttpRequest.OPENED) return;
+                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;
@@ -217,11 +225,24 @@ class XhrInterceptor {
         };
         return toSortedString(a) === toSortedString(b);
     }
+    getAssignedMethodOverride(target, attr) {
+        return this.xhrAssignedMethodOverrides.get(target)?.[attr];
+    }
+    setAssignedMethodOverride(target, attr, value) {
+        let targetOverrides = this.xhrAssignedMethodOverrides.get(target);
+        if (!targetOverrides) {
+            targetOverrides = {};
+            this.xhrAssignedMethodOverrides.set(target, targetOverrides);
+        }
+        targetOverrides[attr] = value;
+    }
     getCaptureOption(options) {
         if (typeof options === "boolean") return options;
         return !!options?.capture;
     }
     getAttrHandler(target, attr, receiver) {
+        const assignedMethodOverride = this.getAssignedMethodOverride(target, attr);
+        if (assignedMethodOverride !== void 0) return assignedMethodOverride;
         if (this.xhrInstanceAttr.includes(attr)) return this.xhrInstanceAttrHandler[attr](target);
         if (this.xhrMethodsHandler[attr]) return this.xhrMethodsHandler[attr](this, target, receiver);
         return null;
@@ -236,6 +257,7 @@ class XhrInterceptor {
                     return self.getAttrHandler(target, prop, receiver) ?? getProxyValue(target, prop);
                 },
                 set(target, prop, value, receiver) {
+                    if (self.xhrMethodsHandler[prop]) self.setAssignedMethodOverride(target, prop, value);
                     if (typeof value === "function" && prop.startsWith("on")) {
                         const isResponseEvent = self.xhrResponseEvents.includes(prop.replace(/^on/, ""));
                         const fn = async function(...args) {
@@ -406,6 +428,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");
@@ -470,6 +499,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) {
@@ -522,6 +552,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

@@ -46,7 +46,15 @@ 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" ];
+    xhrAssignedMethodOverrides=new WeakMap;
     xhrInstanceAttr=[ "response", "responseText", "responseXML", "status", "statusText" ];
     xhrInstanceAttrHandler=this.xhrInstanceAttr.reduce((acc, attr) => {
         acc[attr] = function(target) {
@@ -91,7 +99,7 @@ class XhrInterceptor {
                     console.warn("[AjaxInterceptor] Error in xhr request hooks:", error);
                 }
                 hooker.req = newRequest;
-                if (target.readyState !== XMLHttpRequest.OPENED) return;
+                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;
@@ -211,11 +219,24 @@ class XhrInterceptor {
         };
         return toSortedString(a) === toSortedString(b);
     }
+    getAssignedMethodOverride(target, attr) {
+        return this.xhrAssignedMethodOverrides.get(target)?.[attr];
+    }
+    setAssignedMethodOverride(target, attr, value) {
+        let targetOverrides = this.xhrAssignedMethodOverrides.get(target);
+        if (!targetOverrides) {
+            targetOverrides = {};
+            this.xhrAssignedMethodOverrides.set(target, targetOverrides);
+        }
+        targetOverrides[attr] = value;
+    }
     getCaptureOption(options) {
         if (typeof options === "boolean") return options;
         return !!options?.capture;
     }
     getAttrHandler(target, attr, receiver) {
+        const assignedMethodOverride = this.getAssignedMethodOverride(target, attr);
+        if (assignedMethodOverride !== void 0) return assignedMethodOverride;
         if (this.xhrInstanceAttr.includes(attr)) return this.xhrInstanceAttrHandler[attr](target);
         if (this.xhrMethodsHandler[attr]) return this.xhrMethodsHandler[attr](this, target, receiver);
         return null;
@@ -230,6 +251,7 @@ class XhrInterceptor {
                     return self.getAttrHandler(target, prop, receiver) ?? getProxyValue(target, prop);
                 },
                 set(target, prop, value, receiver) {
+                    if (self.xhrMethodsHandler[prop]) self.setAssignedMethodOverride(target, prop, value);
                     if (typeof value === "function" && prop.startsWith("on")) {
                         const isResponseEvent = self.xhrResponseEvents.includes(prop.replace(/^on/, ""));
                         const fn = async function(...args) {
@@ -400,6 +422,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");
@@ -464,6 +493,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) {
@@ -516,6 +546,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

@@ -40,7 +40,15 @@ 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" ];
+        xhrAssignedMethodOverrides=new WeakMap;
         xhrInstanceAttr=[ "response", "responseText", "responseXML", "status", "statusText" ];
         xhrInstanceAttrHandler=this.xhrInstanceAttr.reduce((acc, attr) => {
             acc[attr] = function(target) {
@@ -85,7 +93,7 @@ var AjaxHooker = function(exports) {
                         console.warn("[AjaxInterceptor] Error in xhr request hooks:", error);
                     }
                     hooker.req = newRequest;
-                    if (target.readyState !== XMLHttpRequest.OPENED) return;
+                    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;
@@ -205,11 +213,24 @@ var AjaxHooker = function(exports) {
             };
             return toSortedString(a) === toSortedString(b);
         }
+        getAssignedMethodOverride(target, attr) {
+            return this.xhrAssignedMethodOverrides.get(target)?.[attr];
+        }
+        setAssignedMethodOverride(target, attr, value) {
+            let targetOverrides = this.xhrAssignedMethodOverrides.get(target);
+            if (!targetOverrides) {
+                targetOverrides = {};
+                this.xhrAssignedMethodOverrides.set(target, targetOverrides);
+            }
+            targetOverrides[attr] = value;
+        }
         getCaptureOption(options) {
             if (typeof options === "boolean") return options;
             return !!options?.capture;
         }
         getAttrHandler(target, attr, receiver) {
+            const assignedMethodOverride = this.getAssignedMethodOverride(target, attr);
+            if (assignedMethodOverride !== void 0) return assignedMethodOverride;
             if (this.xhrInstanceAttr.includes(attr)) return this.xhrInstanceAttrHandler[attr](target);
             if (this.xhrMethodsHandler[attr]) return this.xhrMethodsHandler[attr](this, target, receiver);
             return null;
@@ -224,6 +245,7 @@ var AjaxHooker = function(exports) {
                         return self.getAttrHandler(target, prop, receiver) ?? getProxyValue(target, prop);
                     },
                     set(target, prop, value, receiver) {
+                        if (self.xhrMethodsHandler[prop]) self.setAssignedMethodOverride(target, prop, value);
                         if (typeof value === "function" && prop.startsWith("on")) {
                             const isResponseEvent = self.xhrResponseEvents.includes(prop.replace(/^on/, ""));
                             const fn = async function(...args) {
@@ -391,6 +413,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");
@@ -455,6 +484,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) {
@@ -507,6 +537,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,7 +11,9 @@ export declare class XhrInterceptor {
     };
     readonly nativeXhrPrototype: XMLHttpRequest;
     hooks: HookFunction[];
+    private readonly xhrContructorKeys;
     private xhrResponseEvents;
+    private xhrAssignedMethodOverrides;
     private xhrInstanceAttr;
     private xhrInstanceAttrHandler;
     private xhrMethodsHandler;
@@ -21,6 +23,8 @@ export declare class XhrInterceptor {
     private parseHeaders;
     private responseProcessor;
     private headersEqual;
+    private getAssignedMethodOverride;
+    private setAssignedMethodOverride;
     private getCaptureOption;
     private getAttrHandler;
     private _generateProxyXMLHttpRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ajax-hooker",
-  "version": "1.2.6",
+  "version": "1.3.1",
   "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",