前端 Vuer，为自己的项目搭建一个 Playwright 测试环境吧，给自己多一点安全感！

头像
OpenTiny社区
     广东
    阅读 6 分钟
    头图

    本文由体验技术团队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 ）

    前端javascriptvue.js
    OpenTiny社区
    63 声望10 粉丝

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

    « 上一篇
    有奖问卷调研|OpenTiny给你送天命人好礼啦！
    下一篇 »
    茶思屋直播|TinyEngine+AI：聚焦主航道，在实践中探索低代码技术黑土地

    引用和评论

    推荐阅读
    头像
    优化永不止步：TinyVue v3.20.0 正式发布，更美观的官网UI，更友好的文档搜索，更强大的主题配置能力~

    OpenTiny社区阅读 77

    头像
    腾讯新闻中心首页改版啦

    小蚊酱赞 11阅读 9.9k评论 7

    头像
    网页设计的垂直居中

    寒青赞 41阅读 5.2k评论 3

    头像
    CSS团队协作规范

    寒青赞 38阅读 7.4k

    头像
    前端如何入门 Go 语言

    robin赞 28阅读 8.3k评论 9

    头像
    100个React最佳实践小技巧

    夕水赞 25阅读 6.5k评论 4

    头像
    前端开发工具

    寒青赞 19阅读 5.2k

    0 条评论
    得票最新