# @gcoreplus/axios-logger 中文文档

规范地址：https://npmcn.com/package/%40gcoreplus/axios-logger/

版本：2\.0\.2
npm 元数据更新时间：2024-07-18T03:48:17.524Z
中文译文更新时间：2026-11-16T00:52:19.883Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40gcoreplus/axios-logger
原文对照：https://npmcn.com/package/%40gcoreplus/axios-logger/?lang=original
项目主页：https://rennanboni.com/
源码仓库：https://github.com/gCorePlus/axios-logger

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

- 包体积（解压后）：54.1 kB，39 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2020-12-04T17:42:47.483Z
- 最新版本发布：2024-07-18T03:48:17.340Z
- 近 30 天下载量：13083（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 0 个）

## 中文简介

Axios 标记器

## 安装

```sh
npm install @gcoreplus/axios-logger
```

也可以使用：`pnpm add @gcoreplus/axios-logger`、`yarn add @gcoreplus/axios-logger`、`bun add @gcoreplus/axios-logger`

## README

[![npm version](http://img.shields.io/npm/v/@gcoreplus/axios-logger.svg?style=flat)](https://npmjs.org/package/@gCorePlus/axios-logger "View this project on npm") [![Codecov Coverage](https://codecov.io/gh/gCorePlus/axios-logger/branch/master/graph/badge.svg)](https://codecov.io/gh/gCorePlus/axios-logger) [![ISC license](http://img.shields.io/badge/license-ISC-brightgreen.svg)](http://opensource.org/licenses/ISC)

# 阿克西奥斯·洛格(Axios Logger)

## 关于

`@gcoreplus/axios-logger` 是一个轴截取器,可以在与服务器通信时登录显示必要信息的请求/答复数据.

受到 [轴距](https://www.npmjs.com/package/axios-logger)

## 安装

安装主 lib

```shell
npm install --save @gcoreplus/axios-logger
```

### 使用量

```js
import axios from 'axios';
import * as AxiosLogger from '@gcoreplus/axios-logger';

const instance = axios.create();
instance.interceptors.request.use(AxiosLogger.requestLogger, AxiosLogger.errorLogger);
instance.interceptors.response.use(AxiosLogger.responseLogger, AxiosLogger.errorLogger);
```

### 配置

自定义请求/错误输出日志样本

```js
const instance = axios.create();
instance.interceptors.request.use(
  (request) => AxiosLogger.requestLogger(request, { logger: console.log }),
  (error) => AxiosLogger.errorLogger(error, { logger: console.error })
);
```

自定义输出日志构建器样本

```js
import * as AxiosLogger from '@gcoreplus/axios-logger';

AxiosLogger.setGlobalConfig({
  logger: console.log,
  createLoggerBuilder: config => new ObjectLoggerBuilder(config)
});
```

| 财产 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `method` | 布尔 | `true` | 是否包含 HTTP 方法 . |
| `url` | 布尔 | `true` | 是否包含 URL . |
| `params.apply` | 布尔 | `true` | 是否包含 HTTP 参数 . |
| `params.redact` | 编辑选项 | `undefined` | 是否在打印前过滤限制来自参数对象的数据 . |
| `data.apply` | 布尔 | `true` | 是否包括请求/答复数据. |
| `data.redact` | 编辑选项 | `undefined` | 是否在打印前过滤限制数据对象的数据 . |
| `headers.apply` | 布尔 | `false` | 是否包含 HTTP 信头 . |
| `headers.redact` | 编辑选项 | `undefined` | 是否在打印前过滤来自信头对象的数据 . |
| `status` | 布尔 | `true` | 是否包含响应状态 . |
| `prefixText` | 字符串% 1 `false` | `'Axios'` | `false` 没有前缀, 否则, 定制要的前缀 . |
| `dateFormat` | [日期格式](https://momentjs.com/docs/) | `false` | `new Date().toISOString()` | `false` 没有时间戳,否则,自定义格式 |
| `logger` | 函数 < 字符串, 任何 > | `console.log` | 允许用户自定义要使用的日志函数 。 例如,温斯顿 `logger.info` 可以这样利用: `logger.info.bind(this)` |
| `createLoggerBuilder` | 函数 QQ 调试器 | `new StringLoggerBuilder(config)` | 允许自定义日志输出 。 可能的数值, `new StringLoggerBuilder(config)` 财务报告和审定财务报表 `new ObjectLoggerBuilder(config)` |

#### 以快取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取重取

`@gcoreplus/axios-logger` 使用快速编辑处理限制数据

更多信息见 [快速编辑](https://www.npmjs.com/package/fast-redact) 财务报告和审定财务报表 [编辑文档](https://getpino.io/#/docs/redaction)

编辑配置示例

```js
import * as AxiosLogger from '@gcoreplus/axios-logger';

AxiosLogger.setGlobalConfig({
  headers: {
    apply: true,
    redact: {
      paths: ['["my-token"]', 'cookie'],
      censor: '***'
    }
  }
});
```

## 备份

[![Rennan Stefan Boni](https://avatars0.githubusercontent.com/u/9962013?v=4)](https://github.com/rennanboni)

## 许可证

根据ISC许可证分发。 见 `LICENSE` 更多信息.

## 鸣谢

-   [轴距](https://www.npmjs.com/package/axios-logger)

版权所有 2020 g CorePlus Inc.

## 常见问题

### @gcoreplus/axios-logger 是什么？

Axios 标记器

### 如何安装 @gcoreplus/axios-logger？

在项目目录运行 npm install @gcoreplus/axios-logger，或使用 pnpm add / yarn add / bun add。

### @gcoreplus/axios-logger 支持 TypeScript 吗？

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

### @gcoreplus/axios-logger 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @gcoreplus/axios-logger 可以商用吗？

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

### @gcoreplus/axios-logger 的下载量有多少？

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

### @gcoreplus/axios-logger 还在维护吗？

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

