@guren/testing

中文文档
1.15.1发布于 2026/11/14MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 9148

测试 Guren 应用程序的效用: TestApp 带有 HTTP 和 Inertia 的断言, 加上 auth, 邮件, 队列和事件假冒的 bun: test .

中文使用文档
文档目录5 节
  1. 测试控制器
  2. 虚假
  3. 子路径导出
  4. 文档
  5. 许可证

@ guren/ 测试

测试公用事业 格伦 应用程序 : TestApp 与HTTP和Inertia的断言, 加上假的认证,邮件,队列,事件,和AI代理. 运行在 bun test。 。 。 .

bun add -d @guren/testing

脚手架应用已经依赖于它.

测试控制器

import { describe, test, beforeAll } from 'bun:test'
import { TestApp } from '@guren/testing'

describe('PostController', () => {
  let app: TestApp

  beforeAll(async () => {
    app = await TestApp.create()
  })

  test('lists posts', async () => {
    await app.get('/posts').assertOk()
  })

  test('creates a post', async () => {
    await app
      .post('/posts', { title: 'Hello', content: 'World' })
      .assertStatus(201)
      .assertJsonPath('post.title', 'Hello')
  })

  test('returns 404 for a missing post', async () => {
    await app.get('/posts/999').assertNotFound()
  })
})

TestApp.create() 从您通过的部分组装一个应用程序, 它适合一个孤立的切片, 但可以从服务器实际运行的地方漂移。 要进行真正的配置, 请将您的项目导出 :

import app from '../src/app.js'

const http = await TestApp.fromApp(app)
await http.get('/').assertOk()

虚假

每个人将一个子系统换成一个可检查的双倍,所以测试时都坚持应用试图做的而不是副作用. fakeEvent(), (中文(简体) ), fakeMail() 财务报告和审定财务报表 fakeQueue() 在应用程序上绑有 app.container.fake(),在需要它们的测试中,每个捆绑都想要子系统解决的形状: 测试指南 给出每个的精确表单, 以及一个假的绑定值为一等的错误 .

假话启动
fakeMail()本应发送的邮件
fakeQueue()本来会派去的工作
fakeEvent()本来会发出的事件

还有两种方法 TestApp因为它们改变了请求本身的提出方式:

await app.actingAs(user).get('/dashboard').assertOk()   // authenticated request
using ai = app.fakeAi()                                  // script an in-process AI agent

子路径导出

导入目录
@guren/testing/vitest在 Vitest 下运行的 React 组件测试的相同助手

文档

这个 测试指南 包括控制器、模型、事件、工作、邮件和通知测试.

许可证

麻省理工学院

版本与发布记录

@guren/testing 共发布 51 个版本,首次发布于 2025/11/02;过去 12 个月发布了 43 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.15.1latest2026/11/142 天前
1.15.02026/11/134 天前
1.14.42026/11/0511 天前
1.14.32026/11/0214 天前
1.14.22026/10/2225 天前
1.14.12026/09/261 个月前

其他发布通道:alpha → 0.1.1-alpha.0,rc → 1.0.0-rc.26。

关于 @guren/testing 的常见问题

@guren/testing 是什么?

测试 Guren 应用程序的效用: TestApp 带有 HTTP 和 Inertia 的断言, 加上 auth, 邮件, 队列和事件假冒的 bun: test .

如何安装 @guren/testing?

在项目目录运行 npm install @guren/testing,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:hono(^4.13.16)、@guren/server(>=2.36.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@guren/testing 支持 TypeScript 吗?

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

@guren/testing 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@guren/testing 可以商用吗?

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

@guren/testing 的下载量有多少?

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

@guren/testing 还在维护吗?

最新版本 1.15.1 发布于 2026/11/14(2 天前);至今共发布 51 个版本,其中过去 12 个月发布了 43 个;首次发布于 2025/11/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。