ajax-hooker 1.2.6 → 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

@@ -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,7 +104,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;
@@ -406,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");
@@ -470,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) {
@@ -522,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

@@ -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,7 +98,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;
@@ -400,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");
@@ -464,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) {
@@ -516,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

@@ -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,7 +92,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;
@@ -391,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");
@@ -455,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) {
@@ -507,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.6",
+  "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",