# @haverstack/axios-fetch-adapter 中文文档

规范地址：https://npmcn.com/package/%40haverstack/axios-fetch-adapter/

版本：0\.12\.0
npm 元数据更新时间：2023-12-23T16:09:55.535Z
中文译文更新时间：2026-11-17T11:50:02.125Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40haverstack/axios-fetch-adapter
原文对照：https://npmcn.com/package/%40haverstack/axios-fetch-adapter/?lang=original
项目主页：https://github.com/haverstack/axios-fetch-adapter#readme
源码仓库：https://github.com/haverstack/axios-fetch-adapter

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：39.3 kB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：axios ^0\.21\.1
- 首次发布：2022-11-28T03:38:35.091Z
- 最新版本发布：2023-12-23T16:09:55.331Z
- 近 30 天下载量：35435（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 0 个）

## 中文简介

使用本地取取或自定义取取取函数的 Axios 适配器 。 对云浮工人和服务工人环境有用.

## 安装

```sh
npm install @haverstack/axios-fetch-adapter
```

也可以使用：`pnpm add @haverstack/axios-fetch-adapter`、`yarn add @haverstack/axios-fetch-adapter`、`bun add @haverstack/axios-fetch-adapter`

## README

# axios-fetch-适应器

[![npm badge](https://img.shields.io/npm/v/@haverstack/axios-fetch-adapter)](https://www.npmjs.com/package/@haverstack/axios-fetch-adapter) [![checks badge](https://img.shields.io/github/checks-status/haverstack/axios-fetch-adapter/main)](https://github.com/haverstack/axios-fetch-adapter/actions) [![codecov badge](https://codecov.io/gh/haverstack/axios-fetch-adapter/branch/main/graph/badge.svg?token=J2J0ANDB3F)](https://codecov.io/gh/haverstack/axios-fetch-adapter) [![license badge](https://img.shields.io/github/license/haverstack/axios-fetch-adapter)](https://npmcn.com/package/%40haverstack/axios-fetch-adapter/LICENSE)

Axios 适应器,使用本地 `fetch` 或习惯 `fetch` 函数。 对云浮工人和服务工人环境有用.

> **说明:** 这个适配器是针对版本设计的 `0.21.1` axios,它仍然用于突出的电子商务 SDKs.

## 安装

```sh
npm install @haverstack/axios-fetch-adapter
```

## 使用

此库的默认使用大小写是 :

```javascript
import axios from "axios";
import fetchAdapter from "@haverstack/axios-fetch-adapter";

const client = axios.create({
  adapter: fetchAdapter
});
```

### 使用自定义 `fetch` 函数

如果您的应用程序没有使用全球通用的 `fetch`,您可以指定自己的习惯 `fetch` 函数代替:

```javascript
import axios from "axios";
import { createFetchAdapter } from "@haverstack/axios-fetch-adapter";
import myCustomFetch from "my-custom-fetch";

const myCustomFetchAdapter = createFetchAdapter({ fetch: myCustomFetch });
const client = axios.create({
  adapter: myCustomFetchAdapter
});
```

如果您的应用程序允许使用不完全合格的URL,例如. `/foo`,使用 `disableRequest` 选项将 URL 直接传递到您的自定义 `fetch` 函数不创建 `Request` 对象 :

```javascript
import axios from "axios";
import { createFetchAdapter } from "@haverstack/axios-fetch-adapter";
import myCustomFetch from "my-custom-fetch";

const customAdapter = createFetchAdapter({
  fetch: myCustomFetch,
  disableRequest: true
});
const client = axios.create({
  adapter: myCustomFetchAdapter
});
```

**说明:** 其副作用为 `disableRequest` 选项是: `AxiosResponse` 对象只会在其 `request` 属性而不是 `Request` 对象。 这意味着,例如,获取, `response.request.url` 将投出一个错误.

### 与 Square 节点使用 SDK

使用此库 [`square`](https://www.npmjs.com/package/square) 用于管理您的软件包 [平方边](https://squareup.com/) 资源:

```javascript
import { Client, Environment } from "square";
import fetchAdapter from "@haverstack/axios-fetch-adapter";

const client = new Client({
  accessToken,
  environment,
  unstable_httpClientOptions: { adapter: fetchAdapter }
});
```

## 发展

```sh
# Run tests
npm run test

# Check tests, linting, and formatting
npm run check

# Fix linting and formatting
npm run fix
```

A 类 [迷你灯](https://miniflare.dev/) 测试环境用于模拟Cloudflare工人或服务工人。 这种测试环境也是有用的,因为节点没有本地执行 `fetch`。 。 。 .

## 鸣谢

此 repo 中的代码大量取自以下项目:

-   [vespaiach/xios-fetch-适应器](https://github.com/vespaiach/axios-fetch-adapter): 此repo中的大部分初始代码是从这里复制的. 授权麻省理工学院.
-   [轴/轴](https://github.com/axios/axios)编号: `buildFullPath` 函数从 `axios` 已被复制并修改为更灵活。 授权麻省理工学院.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40haverstack/axios-fetch-adapter/LICENSE)

## 常见问题

### @haverstack/axios-fetch-adapter 是什么？

使用本地取取或自定义取取取函数的 Axios 适配器 。 对云浮工人和服务工人环境有用\.

### 如何安装 @haverstack/axios-fetch-adapter？

在项目目录运行 npm install @haverstack/axios-fetch-adapter，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：axios（^0\.21\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @haverstack/axios-fetch-adapter 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @haverstack/axios-fetch-adapter 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @haverstack/axios-fetch-adapter 可以商用吗？

@haverstack/axios-fetch-adapter 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @haverstack/axios-fetch-adapter 的下载量有多少？

根据 npm 官方下载统计，@haverstack/axios-fetch-adapter 在 2026/10/18 – 2026/11/16 这 30 天内被下载 35,435 次，日均约 1,181 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @haverstack/axios-fetch-adapter 还在维护吗？

最新版本 0\.12\.0 发布于 2023/12/24（2 年前）；至今共发布 14 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/11/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

