# @ch4nn0n/email-forward-parser 中文文档

规范地址：https://npmcn.com/package/%40ch4nn0n/email-forward-parser/

版本：1\.4\.2
npm 元数据更新时间：2023-07-18T07:26:40.573Z
中文译文更新时间：2026-11-09T09:15:37.149Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ch4nn0n/email-forward-parser
原文对照：https://npmcn.com/package/%40ch4nn0n/email-forward-parser/?lang=original
项目主页：https://github.com/crisp-oss/email-forward-parser
源码仓库：https://github.com/crisp-oss/email-forward-parser

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

- 包体积（解压后）：57.3 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2023-07-18T07:26:40.065Z
- 最新版本发布：2023-07-18T07:26:40.293Z
- 近 30 天下载量：10273（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

解析转发邮件和提取内容

## 安装

```sh
npm install @ch4nn0n/email-forward-parser
```

也可以使用：`pnpm add @ch4nn0n/email-forward-parser`、`yarn add @ch4nn0n/email-forward-parser`、`bun add @ch4nn0n/email-forward-parser`

## README

# 电子邮件前导解析器

[![Test and Build](https://github.com/ch4nn0n/email-forward-parser/workflows/Test%20and%20Build/badge.svg?branch=master)](https://github.com/ch4nn0n/email-forward-parser/actions?query=workflow%3A%22Test+and+Build%22) [![Build and Release](https://github.com/ch4nn0n/email-forward-parser/workflows/Build%20and%20Release/badge.svg)](https://github.com/ch4nn0n/email-forward-parser/actions?query=workflow%3A%22Build+and+Release%22) [![NPM](https://img.shields.io/npm/v/@ch4nn0n/email-forward-parser.svg)](https://www.npmjs.com/package/@channon/email-forward-parser) [![Downloads](https://img.shields.io/npm/dt/@channon/email-forward-parser.svg)](https://www.npmjs.com/package/@channon/email-forward-parser)

解析转发电子邮件并提取原始内容 .

这个库支持大多数常见的电子邮件客户端和地盘.

## 动机

最初的项目来自 [冰冻](https://crisp.chat/) [电子邮件复制解析器](https://github.com/crisp-oss/email-forward-parser) 依赖 [可再生能源2](https://www.npmjs.com/package/re2) 库,并非所有平台,即一些无服务器和浏览器环境都可以使用。 这个叉子是同一个库的纯粹的javascript执行.

## 特征

-   支持客户端:苹果邮件,Gmail,Outlook Live / 365,Outlook 2013,Outlook 2019,New Outlook 2019,Yahoo Mail,雷鸟,Missive,HubSpot,IONOS by 1 & 1
-   支助的当地人:克罗地亚、捷克、丹麦、荷兰、英语、法语、芬兰语、德语、匈牙利语、意大利语、日语、挪威语、波兰语、葡萄牙语(巴西)、葡萄牙语、罗马尼亚语、俄语、斯洛伐克语、西班牙语、瑞典语、土耳其语、乌克兰语

## 使用量

```js
const EmailForwardParser = require("email-forward-parser");

const result = new EmailForwardParser().read(MY_EMAIL_STRING);

console.log(result.forwarded);
// true
```

## API 密码

### 分析转发的电子邮件

`read(body, subject)` 检查电子邮件是否转发,并描述其原始内容(从、向、Cc、主题、日期和正文):

-   `body` 必须是代表电子邮件正文的字符串( 由 [邮箱](https://github.com/nodemailer/mailparser)(例如)
-   `subject` 必须是代表电子邮件主题的字符串。 此参数是可选的,但建议改进对一些电子邮件客户端的检测(特别是"2019年新展望")

```js
const EmailForwardParser = require("email-forward-parser");

const result = new EmailForwardParser().read(MY_EMAIL_STRING, MY_SUBJECT_STRING);

console.log(result);
// {
//   forwarded: true,
//
//   message: "Praesent suscipit egestas hendrerit.",
//
//   email: {
//     body: "Aenean quis diam urna.",
//
//     from: {
//       address: "john.doe@acme.com",
//       name: "John Doe"
//     },
//     to: [{
//       address: "bessie.berry@acme.com",
//       name: "Bessie Berry"
//     }],
//     cc: [{
//       address: "walter.sheltan@acme.com",
//       name: "Walter Sheltan"
//     }],
//
//     subject: "Integer consequat non purus",
//     date: "25 October 2021 at 11:17:21 EEST"
//   }
// }
```

## 怎么会这样?

电子邮件转发(即您通过点击您的电子邮件客户端中的"Forward"按钮手动转发电子邮件副本时)不被任何 RFC 规范. 意思是电子邮件客户端可以随意格式化转发的电子邮件 .

没有神奇的子弹可以处理这种差距。 唯一可行的办法是依靠 **正则表达式** (a lot!),以说明每个电子邮件客户端的特殊性:

| 客户端 | 通过主体可探测 | 通过分隔器可探测 | 主题本地化 | 本地分隔符 | 所有原始资料 | 本地化原始资料 | 其他特殊性 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 苹果邮件 | 对 | 对 | 对 | 对 | 对 | 对 | \- 说吧 |
| 邮件 | 对 | 对 | 没有 | 没有 | 对 | 仅部分 | \- 说吧 |
| 展望实况 365 | 对 | 对 | 对 | 没有 | 对 | 没有 | \- 说吧 |
| 2013年展望 | 对 | 没有 | ? 吗? | \- 说吧 | ? 吗? | ? 吗? | \- 说吧 |
| 2019年展望 | 对 | 对 | 没有 | 对 | 没有 | 对 | 从和日期部分(只有原始信息)嵌入到分隔符中,而不是正体本身 |
| 2019年新展望 | 对 | 没有 | 对 | \- 说吧 | 对 | 对 | \- 说吧 |
| 雅虎邮件 | 对 | 对 | 没有 | 对 | 对 | 对 | 原始信息都粘在一起,没有换行 |
| 雷鸟 | 对 | 对 | 没有 | 对 | 对 | 对 | \- 说吧 |
| 错过 | 对 | 对 | 没有 | 没有 | 对 | 没有 | \- 说吧 |
| 枢纽点 | 对 | 对 | 对 | 对 | 对 | 对 | \- 说吧 |
| IONOS by 1 & 1 | ? 吗? | 对 | ? 吗? | ? 吗? | 对 | ? 吗? | \- 说吧 |

## 捐款

随意将这个项目叉出并提交修正. 我们可以调整你的代码 以适应代码库.

您可以使用 :

```
npm test
```

## 许可证

以麻省理工学院的许可发布电子邮件前置parser。 详情见捆绑的LICENSE文件.

## 常见问题

### @ch4nn0n/email-forward-parser 是什么？

解析转发邮件和提取内容

### 如何安装 @ch4nn0n/email-forward-parser？

在项目目录运行 npm install @ch4nn0n/email-forward-parser，或使用 pnpm add / yarn add / bun add。

### @ch4nn0n/email-forward-parser 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ch4nn0n\_\_email-forward-parser 是否存在。

### @ch4nn0n/email-forward-parser 支持 ESM 还是 CommonJS？

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

### @ch4nn0n/email-forward-parser 可以商用吗？

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

### @ch4nn0n/email-forward-parser 的下载量有多少？

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

### @ch4nn0n/email-forward-parser 还在维护吗？

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