# @alex\_neo/jest-expect-message 中文文档

规范地址：https://npmcn.com/package/%40alex_neo/jest-expect-message/

版本：1\.0\.5
npm 元数据更新时间：2022-04-04T12:38:39.483Z
中文译文更新时间：2026-11-05T18:36:54.749Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40alex_neo/jest-expect-message
原文对照：https://npmcn.com/package/%40alex_neo/jest-expect-message/?lang=original
项目主页：https://github.com/mattphillips/jest-expect-message#readme
源码仓库：https://github.com/mattphillips/jest-expect-message

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

- 包体积（解压后）：25 kB，19 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2021-06-22T06:55:48.750Z
- 最新版本发布：2021-06-22T06:58:09.410Z
- 近 30 天下载量：62013（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

将自定义信件添加到 Jest 期望中

## 安装

```sh
npm install @alex_neo/jest-expect-message
```

也可以使用：`pnpm add @alex_neo/jest-expect-message`、`yarn add @alex_neo/jest-expect-message`、`bun add @alex_neo/jest-expect-message`

## README

# 短消息( 短消息 )

🃏🗯

将自定义信件添加到 Jest 期望中

* * *

[![Build Status](https://img.shields.io/travis/mattphillips/jest-expect-message.svg?style=flat-square)](https://travis-ci.org/mattphillips/jest-expect-message) [![Code Coverage](https://img.shields.io/codecov/c/github/mattphillips/jest-expect-message.svg?style=flat-square)](https://codecov.io/github/mattphillips/jest-expect-message) [![version](https://img.shields.io/npm/v/jest-expect-message.svg?style=flat-square)](https://www.npmjs.com/package/jest-expect-message) [![downloads](https://img.shields.io/npm/dm/jest-expect-message.svg?style=flat-square)](http://npm-stat.com/charts.html?package=jest-expect-message&from=2017-09-14) [![MIT License](https://img.shields.io/npm/l/jest-expect-message.svg?style=flat-square)](https://github.com/mattphillips/jest-expect-message/blob/master/LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com/) [![Roadmap](https://img.shields.io/badge/%F0%9F%93%94-roadmap-CD9523.svg?style=flat-square)](https://github.com/mattphillips/jest-expect-message/blob/master/docs/ROADMAP.md) [![Examples](https://img.shields.io/badge/%F0%9F%92%A1-examples-ff615b.svg?style=flat-square)](https://github.com/mattphillips/jest-expect-message/blob/master/docs/EXAMPLES.md)

## 问题

在许多测试库中,可以为给定期望提供自定义消息,但目前不是 也许在杰斯特.

例如:

```js
test('returns 2 when adding 1 and 1', () => {
  expect(1 + 1, 'Woah this should be 2!').toBe(3);
});
```

这将在 Jest 中抛出以下错误 :

```sh
Expect takes at most one argument.
```

## 解决方案

`jest-expect-message` 允许您拨打 `expect` 提出第二个论点: `String` 留言.

例如,上述测试相同:

```js
test('returns 2 when adding 1 and 1', () => {
  expect(1 + 1, 'Woah this should be 2!').toBe(3);
});
```

与 `jest-expect-message` 这将以自定义错误消息失败 :

```sh
  ● returns 2 when adding 1 and 1

    Custom message:
      Woah this should be 2!

    expect(received).toBe(expected) // Object.is equality

    Expected: 3
    Received: 2
```

## 安装

以 npm 为单位 :

```sh
npm install --save-dev jest-expect-message
```

用纱线:

```sh
yarn add -D jest-expect-message
```

## 设置

添加 `jest-expect-message` 敬你的欢乐 `setupFilesAfterEnv` 配置 . [请求帮助](https://jestjs.io/docs/en/next/configuration#setupfilesafterenv-array)

### 游戏 v24+

```json
"jest": {
  "setupFilesAfterEnv": ["jest-expect-message"]
}
```

### 贾斯特v23 -

```json
"jest": {
  "setupTestFrameworkScriptFile": "jest-expect-message"
}
```

## 使用量

-   `expect(actual, message)`
    -   `actual`: 通常会传递到 `expect` 和一个配对者对抗.
    -   `message`:字符串,如果 `expect` 失败.

```js
test('returns 2 when adding 1 and 1', () => {
  expect(1 + 1, 'Woah this should be 2!').toBe(3);
});
```

## 贡献者

| [![](https://avatars0.githubusercontent.com/u/5610087?v=4)  
**马特·菲利普斯**](http://mattphillips.io/)  
[💻](https://github.com/mattphillips/jest-expect-message/commits?author=mattphillips "Code") [📖](https://github.com/mattphillips/jest-expect-message/commits?author=mattphillips "Documentation") [💡](https://npmcn.com/package/%40alex_neo/jest-expect-message/#readme-example-mattphillips "Examples") [🤔](https://npmcn.com/package/%40alex_neo/jest-expect-message/#readme-ideas-mattphillips "Ideas, Planning, & Feedback") [🚇](https://npmcn.com/package/%40alex_neo/jest-expect-message/#readme-infra-mattphillips "Infrastructure (Hosting, Build-Tools, etc)") [⚠️](https://github.com/mattphillips/jest-expect-message/commits?author=mattphillips "Tests") [🔧](https://npmcn.com/package/%40alex_neo/jest-expect-message/#readme-tool-mattphillips "Tools") | [![](https://avatars.githubusercontent.com/u/11705902?v=4)  
**亚历克斯·尼欧**](https://github.com/alexneo2003)  
[💻](https://github.com/mattphillips/jest-expect-message/commits?author=alexneo2003 "Code") |
| :-: | :-: |
|  |  |

## 自由主义

[麻省理工学院](https://npmcn.com/LICENSE)

## 常见问题

### @alex\_neo/jest-expect-message 是什么？

将自定义信件添加到 Jest 期望中

### 如何安装 @alex\_neo/jest-expect-message？

在项目目录运行 npm install @alex\_neo/jest-expect-message，或使用 pnpm add / yarn add / bun add。

### @alex\_neo/jest-expect-message 支持 TypeScript 吗？

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

### @alex\_neo/jest-expect-message 支持 ESM 还是 CommonJS？

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

### @alex\_neo/jest-expect-message 可以商用吗？

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

### @alex\_neo/jest-expect-message 的下载量有多少？

根据 npm 官方下载统计，@alex\_neo/jest-expect-message 在 2026/10/06 – 2026/11/04 这 30 天内被下载 62,013 次，日均约 2,067 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @alex\_neo/jest-expect-message 还在维护吗？

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