头图

本文由体验技术团队Kagol 原创

亲爱的朋友:

  • 你是否担心修改完一个 bug,引发了多个 bug?
  • 是否因为担心重构代码之后,影响到现有功能,从而一直不敢对现有代码进行优化,只能不断用 if/else 叠加功能?
  • 你是否担心增加的新特性影响到其他模块的功能,从而花大量时间反复进行手工测试,确保万无一失,却依然在上线前,胆战心惊、如履薄冰?

如果你有以上困扰,推荐大家使用一款 E2E 测试神器:Playwright,新手友好,即使是初学者也能轻松学会!

Playwright 是由微软开发的一款强大的自动化测试工具,旨在为现代Web应用程序提供全面的端到端(E2E)测试解决方案。它支持主流浏览器,包括 Google Chrome、Microsoft Edge、Mozilla Firefox 和 Apple Safari,并且能够在 Windows、macOS 和 Linux 平台上运行。

除了执行测试用例,Playwright 还支持录制测试用例并生成对应的代码,能大大降低编写测试用例的成本,这也是我选择 Playwright 的重要原因之一。

接下来我就带大家一起上手 Playwright,从搭建 Playwright 测试环境,到编写测试用例,再到通过命令和 VSCode 插件执行测试,为你在自己的项目集成 Playwright 测试提供指导。

1 搭建 Playwright 测试环境

假如你已经有了一个 Vite + Vue 的项目。

在根目录执行命令:npm init playwright@latest,即可搭建 Playwright 测试环境。

而且创建了两个测试用的测试用例:tests/example.spec.ts / tests-examples/demo-todo-app.spec.ts

$ npm init playwright@latest
Getting started with writing end-to-end tests with Playwright:
Initializing project in '.'
✔ Where to put your end-to-end tests? · tests
✔ Add a GitHub Actions workflow? (y/N) · true
✔ Install Playwright browsers (can be done manually via 'npx playwright install')? (Y/n) · true

Installing Playwright Test (npm install --save-dev @playwright/test)…
added 4 packages in 4s
Installing Types (npm install --save-dev @types/node)…
added 2 packages in 2s

Writing playwright.config.ts.
Writing .github/workflows/playwright.yml.
Writing tests/example.spec.ts.
Writing tests-examples/demo-todo-app.spec.ts.
Writing package.json.
Downloading browsers (npx playwright install)…
✔ Success! Created a Playwright Test project at /playwright-demo

Inside that directory, you can run several commands:

  npx playwright test
    Runs the end-to-end tests.

  npx playwright test --ui
    Starts the interactive UI mode.

  npx playwright test --project=chromium
    Runs the tests only on Desktop Chrome.

  npx playwright test example
    Runs the tests in a specific file.

  npx playwright test --debug
    Runs the tests in debug mode.

  npx playwright codegen
    Auto generate tests with Codegen.

We suggest that you begin by typing:

    npx playwright test

And check out the following files:
  - ./tests/example.spec.ts - Example end-to-end test
  - ./tests-examples/demo-todo-app.spec.ts - Demo Todo App end-to-end tests
  - ./playwright.config.ts - Playwright Test configuration

Visit https://playwright.dev/docs/intro for more information. ✨

Happy hacking! 🎭

初始化好 Playwright 环境,还提示我们执行命令:npx playwright test,跑一下测试用的测试用例。

并列出了一些常用命令:

  •  npx playwright test:执行全量测试用例
  • npx playwright test --ui:以可视化界面方式手动运行测试用例
  •  npx playwright test --project=chromium:只在 Chrome 浏览器执行
  •  npx playwright test example:执行部分测试用例
  •  npx playwright test --debug:启动调试模式
  •  npx playwright codegen:自动生成测试代码

2 命令方式执行测试用例

2.1 执行全量测试用例:npx playwright test

执行命令:npx playwright test,即可执行所有测试用例。

$ npx playwright test

Running 2 tests using 2 workers
  2 passed (4.0s)

To open last HTML report run:

  npx playwright show-report

可以看到2个测试用例都已通过。

2.2 执行部分测试用例:npx playwright test tests-examples

这是执行全量测试用例,还可以执行部分用例:npx playwright test tests-examples,只执行 tests-examples 目录下的测试用例。

- tests
  - example.spec.ts
- tests-examples
  - demo-todo-app.spec.ts

2.3 只在部分浏览器执行:npx playwright test --project=chromium

在 playwright.config.js 配置文件中,有一个 projects 配置项,用来配置执行的浏览器,默认会在配置的所有浏览器执行,这样速度会比较慢,可以只在部分浏览器执行,比如只在 Chrome 执行:npx playwright test --project=chromium

projects: [
  {
    name: 'chromium',
    use: { ...devices['Desktop Chrome'] },
  },

  {
    name: 'firefox',
    use: { ...devices['Desktop Firefox'] },
  },
  
  ...
}

2.4 可视化方式执行:npx playwright test --ui

还可以通过可视化界面方式手动执行测试用例,执行命令:npx playwright test --ui

执行完会弹出以下界面

image.png

左边会列出所有的测试用例,可以点击播放按钮进行执行。

2.5 查看测试报告:npx playwright show-report

也可以执行命令:npx playwright show-report,查看测试报告。

image.png

3 录制测试用例,并自动生成代码

这个功能可太有用了!必须好好安利下!

执行命令:npx playwright codegen,可启动用例录制和代码生成界面。

image.png

可以看到启动了两个界面,左边那个是用来录制用例的浏览器和界面,右边是实时生成的代码。

生成的代码是可以直接使用的,这大大降低了手动编写测试用例的成本。

只是 codegen 生成的测试用例代码是不带断言的,需要自己手动加一些断言。

import { test, expect } from '@playwright/test';

test('@mention', async ({ page }) => {
  await page.goto('http://localhost:5174/');

  const editor = page.locator('.ql-editor')

  await page.locator('#editor div').click();
  await page.locator('#editor div').fill('Hello @');

  // 输入”@“符号之后,应该断言人名列表存在,并且有三个人名
  const list = page.locator('.ql-mention-list')
  await expect(list).toBeVisible()
  await expect(await list.locator('li.ql-mention-item').count()).toBe(3)

  await page.locator('li').filter({ hasText: '卡哥 156粉丝' }).click();

  // 选择“卡哥”之后,需要断言@的人名是正确的
  const mentionId = editor.locator('[data-mention-id=kagol]')
  await expect(mentionId).toBeVisible()
  await expect((await mentionId.innerText()).trim()).toEqual('@卡哥')

  await page.locator('#editor div').fill('Hello  @卡哥 It's time to code');
  await page.getByRole('button', { name: '发布' }).click();
});

测试代码生成的功能,对于初学者是非常友好的,几乎没有学习成本,一旦你熟悉了 Playwright 测试用例的编写语法,慢慢地你就可以摆脱这个工具,自己手写测试用例。

4 使用 VSCode 插件

在 VSCode 扩展中搜索关键字:Playwright,找到 Playwright Test for VSCode 插件,并安装。

image.png

安装完之后,VSCode 左侧会多出来一个测试的面板,可以看到当前项目所有的测试用例,点击播放按钮就可以执行测试用例,这个和 --ui 那个可视化界面有点类似。

image.png

当 VSCode 插件的功能更强一些,可以直接跳转到测试用例所在的文件。

image.png

测试用例文件左边会多出来一个播放按钮,可以直接执行当前用例。

image.png

下面还有一些配置项的设置,比如设置浏览器,还可以录制新用例。

image.png

推荐使用 Playwright 的 VSCode 插件,很实用。

更多使用方式请参考 Playwright 官网:https://playwright.dev/

5贡献者招募:欢迎来 Fluent Editor 开源富文本练练手

Fluent Editor 是一个基于 Quill 2.0 的富文本编辑器,在 Quill 基础上扩展了丰富的模块和格式,功能强大、开箱即用。

我们正在招募志同道合的共建者🤝

目前 Fluent Editor 已经实现了基本的格式化功能,以及图片和文件上传、代码块高亮、表格、@提醒、插入表情等增强功能,并且集成了 Playwright 测试环境,还需要完善现有功能的 E2E 测试用例,这是一个很好的检验我们 Playwright 学习成果的机会,欢迎一起参与共建!

如果你想为 Fluent Editor 增加新特性,可以从以下规划的任务中进行领取:

https://github.com/opentiny/fluent-editor/discussions/20

源码:https://github.com/opentiny/fluent-editor(欢迎 Star ⭐ 支持)

往期文章推荐:

6关于OpenTiny

OpenTiny官网:https://opentiny.design\
TinyVue 源码:https://github.com/opentiny/tiny-vue (欢迎 Star ⭐)\
TinyEngine 源码:https://github.com/opentiny/tiny-engine (欢迎 Star ⭐)\
B站:https://space.bilibili.com/15284299\
欢迎加入 OpenTiny 开源社区。添加微信小助手 opentiny-official 一起参与交流前端技术~

(温馨提示:OpenTiny CCF开源创新大赛也在持续报名中,欢迎大家一起报名参赛,赢取10W奖金:https://www.gitlink.org.cn/competitions/track1_openTiny


OpenTiny社区
53 声望10 粉丝

OpenTiny官网:[链接] 源码:[链接] (欢迎star)我们是华为云体验技术团队~欢迎关注共同交流~