feat(adapter-xhr): export xhr instance in options.create of adapter (…

…#611)

* feat(adapter-xhr): export xhr instance in `options.create` of adapter

* chore: modify `create` to `onCreate`

.changeset/silent-tips-chew.md

@@ -0,0 +1,5 @@
+---
+'@alova/adapter-xhr': minor
+---
+
+export xhr instance in `options.create` of adapter

packages/adapter-xhr/src/requestAdapter.ts

@@ -10,14 +10,14 @@ import {
   trueValue
 } from '@alova/shared';
 import type { ProgressUpdater } from 'alova';
-import { AlovaXHRAdapter, AlovaXHRResponse } from '~/typings';
+import { AlovaXHRAdapter, AlovaXHRAdapterOptions, AlovaXHRResponse } from '~/typings';
 
 const err = (msg: string) => newInstance(Error, msg);
 const isBodyData = (data: any): data is XMLHttpRequestBodyInit => isString(data) || isSpecialRequestBody(data);
 /**
  * XMLHttpRequest request adapter
  */
-export default function requestAdapter() {
+export default function requestAdapter({ onCreate = noop }: AlovaXHRAdapterOptions = {}) {
   const adapter: AlovaXHRAdapter = ({ type, url, data = null, headers }, method) => {
     const { config } = method;
     const { auth, withCredentials, mimeType, responseType } = config;
@@ -115,6 +115,9 @@ export default function requestAdapter() {
         if (dataSend !== nullValue) {
           dataSend = isBodyData(dataSend) ? dataSend : JSON.stringify(dataSend);
         }
+
+        // export xhr in `onCreate`
+        onCreate(xhr);
         xhr.send(dataSend);
       } catch (error) {
         reject(error);

packages/adapter-xhr/test/requestAdapter.spec.ts

@@ -330,4 +330,21 @@ describe('request adapter', () => {
 
     await expect(Promise.all([Get1, Get2, Get3])).resolves.toStrictEqual(['object', 'object', 'string']);
   });
+
+  test('should respect the type', async () => {
+    const mockFn = vi.fn();
+    const alovaInst = createAlova({
+      baseURL,
+      requestAdapter: xhrRequestAdapter({
+        onCreate(xhr) {
+          mockFn(xhr);
+        }
+      })
+    });
+
+    expect(mockFn).not.toHaveBeenCalled();
+    await alovaInst.Get('/unit-test');
+    expect(mockFn).toHaveBeenCalledTimes(1);
+    expect(mockFn).toHaveBeenCalledWith(expect.any(XMLHttpRequest));
+  });
 });

packages/adapter-xhr/typings/index.d.ts

@@ -63,10 +63,17 @@ export interface AlovaXHRResponse<T = any> {
  */
 export type AlovaXHRAdapter = AlovaRequestAdapter<AlovaXHRRequestConfig, AlovaXHRResponse, AlovaXHRResponseHeaders>;
 
+/**
+ * XMLHttpRequest request adapter options
+ */
+export interface AlovaXHRAdapterOptions {
+  onCreate?: (xhr: XMLHttpRequest) => void;
+}
+
 /**
  * XMLHttpRequest request adapter
  */
-export declare function xhrRequestAdapter(): AlovaXHRAdapter;
+export declare function xhrRequestAdapter(options: AlovaXHRAdapterOptions): AlovaXHRAdapter;
 
 /**
  * Mock response adapter, which is used in @alova/mock to allow xhr response data to be returned in a format compatible with mock requests.