指南
配置
插件
API
教程
社区
指南
配置
插件
API
教程
社区
简体中文

Cypress

Cypress 是一个用于 E2E 测试和组件测试的框架。

在 Modern.js 中使用 Cypress 需要先安装依赖，可以执行以下命令：

npm
yarn
pnpm
npm install -D cypress

接下来，创建 cypress.config.ts 文件，并添加以下内容：

import { defineConfig } from 'cypress'
 
export default defineConfig({
  e2e: {
    setupNodeEvents(on, config) {},
  },
})

编写测试用例

现在，使用 Cypress 来编写一个 E2E 用例，首先创建两张 Modern.js 的页面。

routes/page.tsx
import { Link } from '@modern-js/runtime/router';

const Index = () => (
  <div>
    <h1>Home</h1>
    <Link to="/about">About</Link>
  </div>
);

export default Index;
routes/about/page.tsx
import { Link } from '@modern-js/runtime/router';

const Index = () => (
  <div>
    <h1>About</h1>
    <Link to="/">Home</Link>
  </div>
);

export default Index;

接下来，创建测试用例文件：

cypress/e2e/app.cy.ts
describe('Navigation', () => {
  it('should navigate to the about page', () => {
    // Start from the index page
    cy.visit('http://localhost:8080/')
 
    // Find a link with an href attribute containing "about" and click it
    cy.get('a[href*="about"]').click()
 
    // The new url should include "/about"
    cy.url().should('include', '/about')
 
    // The new page should contain an h1 with "About"
    cy.get('h1').contains('About')
  })
})

测试文件可能会缺少 API 的类型，你可以参考 Cypress - Typescript 文档解决。

你可以将命令添加到 package.json 中：

package.json
{
  "scripts": {
    "test": "cypress open"
  }
}

运行测试用例

执行上述 test 命令，运行测试用例：

DevTools listening on ws://127.0.0.1:55203/devtools/browser/xxxxx

Cypress 会打开一个无头浏览器，按照提示你可以找到对应的测试文件，并自动运行 E2E 测试：

cypress