如何自定义alova的请求适配器

alova是一个轻量级的请求策略库，旨在简化接口的管理和使用。你可以通过简单配置参数，即可实现复杂请求如请求共享、分页请求、表单提交、断点续传等，无需编写大量代码，提高开发效率，应用性能，减轻服务端压力。

在使用 alova 发送网络请求时，我们常常需要在请求头中添加一些信息，比如身份认证的 token、公共参数等。alova 提供了在全局和单个请求两种粒度配置请求头的方式。添加请求头的方法和axios非常类似。

认识请求适配器

还记得如何创建一个 Alova 实例吗？

const alovaInstance = createAlova({
  // ...
  requestAdapter: GlobalFetch()
});

是的，requestAdapter就是请求适配器，内部的请求发送和接收都将依赖请求适配器，GlobalFetch就是通过 fetch api 的方式来管理请求的，在大多数情况下我们可以使用它，但是，当alova运行在 fetch api 不可用的环境时（如 app、小程序），就需要更换一个支持当前环境的请求适配器。

编写一个自己的请求适配器

那应该如何自定义一个请求适配器呢？很简单，它其实是一个函数，在每次发起请求时都会调用此函数，并返回一个对象，这个对象内包含如url、method、data、headers、timeout等请求相关的数据集合，虽然字段较多，但我们只需访问我们需要的数据即可。

请求适配器结构

请求适配器将接收到请求相关的参数，以及当前正在请求的 method 实例，并返回一个响应相关的函数集合。

function CustomRequestAdapter(requestElements, methodInstance) {
  // 发送请求...
  return {
    async response() {
      // ...返回响应数据
    },
    async headers() {
      // 返回响应头的异步函数
    },
    abort() {
      // 中断请求，当外部调用abort时将触发此函数
    },
    onDownload(updateDownloadProgress) {
      // 下载进度信息，内部持续调用updateDownloadProgress来更新下载进度
    },
    onUpload(updateUploadProgress) {
      // 上传进度信息，内部持续调用updateUploadProgress来更新上传进度
    }
  };
}

请求参数详细

requestElements

发送请求的相关元素，包含以下数据。

interface RequestElements {
  // 请求url，get参数已包含其中
  readonly url: string;

  // 请求类型，如GET、POST、PUT等
  readonly type: MethodType;

  // 请求头信息，对象
  readonly headers: Arg;

  // 请求体信息
  readonly data?: RequestBody;
}

methodInstance

当前请求的 method 实例

返回参数详细

response（必填）

一个异步函数，函数返回响应值，它将会传递给全局的响应拦截器（responded）；

headers（必填）

一个异步函数，函数返回的响应头对象将传递给 Method 实例的 transformData 转换钩子函数；

abort（必填）

一个普通函数，它用于中断请求，在 手动中断请求 章节中调用abort函数时，实际上触发中断请求的函数就是这个中断函数；

onDownload（可选）

一个普通函数，它接收一个更新下载进度的回调函数，在此函数内自定义进度更新的频率，在此示例中模拟每隔 100 毫秒更新一次。updateDownloadProgress回调函数接收两个参数，第一个参数是总大小，第二个参数是已下载大小；

onUpload（可选）

一个普通函数，它接收一个更新上传进度的回调函数，在此函数内自定义进度更新的频率，在此示例中模拟每隔 100 毫秒更新一次。updateUploadProgress回调函数接收两个参数，第一个参数是总大小，第二个参数是已上传大小；

（案例）XMLHttpRequest 请求适配器

以下是一个通过 XMLHttpRequest 发送请求的适配器的示例，主要用于演示适配器的写法，代码不完整，不可运行。

function XMLHttpRequestAdapter(requestElements, methodInstance) {
  // 解构出需要用到的数据
  const { url, type, data, headers } = config;

  // 发送请求
  const xhr = new XMLHttpRequest();
  xhr.open(type, url);
  for (const key in headers) {
    xhr.setRequestHeader(key, headers[key]);
  }
  const responsePromise = new Promise((resolve, reject) => {
    xhr.addEventListener('load', event => {
      // 处理响应数据
      resolve(/* ... */);
    });
    xhr.addEventListener('error', event => {
      // 处理请求错误
      reject(/* ... */);
    });
  });

  xhr.send(JSON.stringify(data));

  return {
    // 返回响应数据的异步函数
    response: () => responsePromise,

    // 返回响应头的异步函数
    headers: () => responsePromise.then(() => xhr.getAllResponseHeaders()),
    abort: () => {
      xhr.abort();
    },

    // 下载进度信息，内部持续调用updateDownloadProgress来更新下载进度
    onDownload: updateDownloadProgress => {
      xhr.addEventListener('progress', event => {
        // 数据接收进度
        updateDownloadProgress(event.total, event.loaded);
      });
    },

    // 上传进度信息，内部持续调用updateUploadProgress来更新上传进度
    onUpload: updateUploadProgress => {
      xhr.upload.onprogress = event => {
        updateUploadProgress(event.total, event.loaded);
      };
    }
  };
}

完整的XMLHttpRequest请求适配器代码点此查阅源码。

结尾

以上就是 alova 的自定义请求适配器写法了，可以很灵活地处理不同的请求头设置需求。

有任何使用问题，你可以加入以下群聊咨询，也可以在github 仓库中发布 Discussions，如果遇到问题，也请在github 的 issues中提交，我们会在最快的时间解决。

• 加入在 Discord 社区参与交流
• 加入微信群参与交流

同时也欢迎贡献你的一份力量，请移步贡献指南。

以下为部分章节的教程，想学习更多 alovajs 的用法，欢迎来alova 官网学习。