测试

AdonisJS 内置了对编写测试的支持。你无需安装额外的包或配置应用程序即可进行测试——所有繁重的工作都已完成。

你可以使用以下 ace 命令运行应用程序测试。

node ace test

测试存储在 tests 目录中，我们进一步按类型组织测试。例如，功能测试存储在 tests/functional 目录中，单元测试存储在 tests/unit 目录中。

功能测试是指从外部进行的测试，你将对应用程序发出实际的 HTTP 请求，以测试给定流程或端点的功能。例如，你可能有一组用于创建用户的功能测试。

一些社区可能会将功能测试称为功能测试或端到端测试。AdonisJS 对这些术语的使用很灵活。我们决定使用 功能测试 这一术语。

配置测试运行器

AdonisJS 使用 Japa 编写和运行测试。因此，我们建议你阅读 Japa 文档，以更好地了解其 API 和配置选项。

测试套件

测试套件在 adonisrc.ts 文件中定义。默认情况下，我们注册了 functional 和 unit 测试套件。如有需要，你可以删除现有的套件并从头开始。

{
  tests: {
    suites: [
      {
        name: 'functional',
        files: ['tests/functional/**/*.spec.(js|ts)']
      },
      {
        name: 'unit',
        files: ['tests/unit/**/*.spec.(js|ts)']
      }
    ]
  }
}

套件结合了套件的唯一名称和文件的 glob 模式。
当你为特定套件运行测试时，只会导入与该套件相关的文件。

你可以使用 tests/bootstrap.ts 文件中定义的 configureSuite 钩子在运行时配置套件。例如，在运行功能测试时，你可以注册套件级钩子以启动 HTTP 服务器。

export const configureSuite: Config['configureSuite'] = (suite) => {
  if (['browser', 'functional', 'e2e'].includes(suite.name)) {
    return suite.setup(() => testUtils.httpServer().start())
  }
}

运行器钩子

运行器钩子是在所有测试之前和之后运行的全局操作。钩子在 tests/boostrap.ts 文件中使用 runnerHooks 属性定义。

export const runnerHooks: Required<Pick<Config, 'setup' | 'teardown'>> = {
  setup: [
    () => {
      console.log('running before all the tests')
    }
  ],
  teardown: [
    () => {
      console.log('running after all the tests')
    }
  ],
}

插件

Japa 有一个插件系统，你可以使用它来扩展其功能。插件在 tests/bootstrap.ts 文件中注册。

另请参阅：创建 Japa 插件

export const plugins: Config['plugins'] = [
  assert(),
  pluginAdonisJS(app)
]

报告器

报告器用于在测试运行时报告/显示测试进度。报告器在 tests/bootstrap.ts 文件中注册。

另请参阅：创建 Japa 报告器

export const reporters: Config['reporters'] = {
  activated: ['spec']
}

创建测试

你可以使用 make:test 命令创建一个新测试。该命令需要套件的名称来创建测试文件。

另请参阅：Make test command

node ace make:test posts/create --suite=functional

文件将在使用 files glob 属性配置的目录中创建。

编写测试

测试使用从 @japa/runner 包导入的 test 方法定义。测试接受一个标题作为第一个参数，实现回调作为第二个参数。

在以下示例中，我们创建一个新用户帐户，并使用 assert 对象确保密码已正确散列。

import { test } from '@japa/runner'

import User from '#models/User'
import hash from '@adonisjs/core/services/hash'

test('hashes user password when creating a new user', async ({ assert }) => {
  const user = new User()
  user.password = 'secret'
  
  await user.save()
  
  assert.isTrue(hash.isValidHash(user.password))
  assert.isTrue(await hash.verify(user.password, 'secret'))
})

使用测试组

测试组使用 test.group 方法创建。组为测试添加结构，并允许你在测试周围运行生命周期钩子。

继续前面的示例，我们将密码散列测试移到组中。

import { test } from '@japa/runner'

import User from '#models/User'
import hash from '@adonisjs/core/services/hash'

test.group('creating user', () => {
  test('hashes user password', async ({ assert }) => {
    const user = new User()
    user.password = 'secret'
    
    await user.save()
    
    assert.isTrue(hash.isValidHash(user.password))
    assert.isTrue(await hash.verify(user.password, 'secret'))
  })
})

如果你已经注意到，我们从测试标题中移除了 "when creating a new user" 片段。这是因为组标题已明确说明该组下的所有测试都适用于 创建新用户。

生命周期钩子

生命周期钩子用于在测试周围执行操作。你可以使用 group 对象定义钩子。

另请参阅 - Japa 文档中的生命周期钩子

test.group('creating user', (group) => {
  group.each.setup(async () => {
    console.log('runs before every test')
  })

  group.each.teardown(async () => {
    console.log('runs after every test')
  })

  group.setup(async () => {
    console.log('runs once before all the tests')
  })

  group.teardown(async () => {
    console.log('runs once after all the tests')
  })

  test('hashes user password', async ({ assert }) => {
    const user = new User()
    user.password = 'secret'
    
    await user.save()
    
    assert.isTrue(hash.isValidHash(user.password))
    assert.isTrue(await hash.verify(user.password, 'secret'))
  })
})

后续步骤

现在你已经了解了创建和编写测试的基础知识。我们建议你探索 Japa 文档中的以下主题。

运行测试

你可以使用 test 命令运行测试。默认情况下，将执行所有套件的测试。但是，你可以通过传递名称来运行特定套件的测试。

node ace test

node ace test functional
node ace test unit

监视文件更改并重新运行测试

你可以使用 --watch 命令监视文件系统并重新运行测试。如果测试文件发生更改，则仅运行更改文件中的测试。否则，将重新运行所有测试。

node ace test --watch

过滤测试

运行测试时，可以使用命令行标志应用过滤器。以下是可用选项的列表。

另请参阅：Japa 过滤测试指南

使用 VSCode？ 使用 Japa 扩展，通过键盘快捷键或活动侧边栏在代码编辑器中运行所选测试。

标志	描述
`--tests`	通过测试标题过滤测试。此过滤器与确切的测试标题匹配。
`--files`	通过测试文件名的子集过滤测试。匹配是在文件名末尾（不包括 `.spec.ts`）进行的。你可以使用通配符表达式运行整个文件夹的测试。例如，`folder/*`
`--groups`	通过组名过滤测试。此过滤器与确切的组名匹配。
`--tags`	通过标签过滤测试。可以在标签名前加上波浪号 `~` 来忽略具有给定标签的测试
`--matchAll`	默认情况下，Japa 将运行与任何提及标签匹配的测试。如果你希望所有标签都匹配，请使用 `--matchAll` 标志

强制退出测试

Japa 在完成所有测试后等待进程优雅地关闭。优雅关闭进程意味着退出所有长连接并清空 Node.js 事件循环。

如有需要，你可以使用 --force-exit 标志强制 Japa 退出进程，而不是等待优雅关闭。

node ace test --force-exit

重试测试

你可以使用 --retries 标志多次重试失败的测试。该标志将应用于所有没有明确在测试级别定义重试次数的测试。

# 重试失败的测试 2 次
node ace test --retries=2

运行上次运行失败的测试

你可以使用 --failed 命令行标志重新运行上次运行失败的测试。

node ace test --failed

切换报告器

Japa 允许你在配置文件中注册多个测试报告器，但默认情况下不会激活它们。你可以在配置文件中激活报告器，或者使用 --reporter 命令行标志激活报告器。

# 激活 spec 报告器
node ace test --reporter=spec

# 激活 spec 和 json 报告器
node ace test --reporter=spec,json

你也可以在配置文件中激活报告器。

export const reporters: Config['reporters'] = {
  activated: ['spec', 'json']
}

将选项传递给 Node.js 命令行

test 命令以子进程形式运行测试 (bin/test.ts file)。如果你想将 node arguments 传递给子进程，可以在命令名称之前定义它们。

node ace --no-warnings --trace-exit test

环境变量

你可以使用 .env.test 文件定义测试期间所需的环境变量。.env.test 文件中的值优先于 .env 文件中的值。

测试期间的 SESSION_DRIVER 必须设置为 memory。

.env.test

SESSION_DRIVER=memory

视图&模板

Inertia

测试

HTTP 测试

测试