如何使用Laravel Dusk进行浏览器自动化测试? (页面交互与断言)

浅杰吖_9705

浅杰吖_9705

2026-01-11

773人浏览

原创

Laravel Dusk 本质是封装 Facebook WebDriver 的 PHP 客户端,后台启动真实浏览器进行端到端测试,需处理加载延迟、元素可见性等真实环境问题;启动失败主因是 ChromeDriver 与 Chrome 版本不匹配或缺少 GUI 环境,CI 中须启用 headless 模式;visit() 后应使用 waitFor() 等显式等待而非直接 see();动态交互需注意 select/attach 限制,优先用 script() 调用 JS;测试间会话共享,需 tearDown 时清理 cookies 或 quit 浏览器。

如何使用laravel dusk进行浏览器自动化测试? (页面交互与断言)

直接说结论:Laravel Dusk 本质是封装了 Facebook WebDriver 的 PHP 客户端,它不运行在浏览器里,而是在后台启动 Chrome 或 Firefox 实例,通过 HTTP 协议控制真实浏览器完成交互和断言——这意味着你写的测试代码必须考虑页面加载延迟、元素可见性、路由跳转时机等真实环境问题,而不是像单元测试那样“秒执行”。

如何正确启动 Dusk 并避免 Facebook\WebDriver\Exception\SessionNotCreatedException

Dusk 启动失败最常见的原因是 ChromeDriver 版本与系统 Chrome 不匹配,或未配置好 DISPLAY(Linux/macOS)或缺少 GUI 环境(CI 场景)。

  • 本地开发:确保 chromedriver 在 $PATH 中,且版本与 Chrome 一致(可通过 chrome --version 和 chromedriver --version 核对)
  • CI 环境(如 GitHub Actions):必须显式安装匹配的 Chrome + ChromeDriver,并启用 headless 模式。Dusk 默认会尝试启动 GUI 浏览器,CI 上会失败
  • 在 tests/DuskTestCase.php 中修改 driver() 方法,强制使用 headless 模式:
protected function driver()
{
    $options = (new ChromeOptions)->addArguments([
        '--disable-gpu',
        '--headless',
        '--no-sandbox',
        '--window-size=1920,1080',
    ]);

    return RemoteWebDriver::create(
        'http://localhost:9515',
        DesiredCapabilities::chrome()->setCapability(
            ChromeOptions::CAPABILITY, $options
        )
    );
}

注意:http://localhost:9515 是 ChromeDriver 默认监听地址;若用 php artisan dusk:install 下载的驱动未自动启动,需手动运行 chromedriver --port=9515。

visit() 后为什么 see() 总失败?

visit() 只触发导航,不等待页面 DOM 加载完成或 Vue/React 渲染完毕。常见现象是页面已跳转,但元素还没出现,导致 see()、assertSee() 报错 “Element not found”。

  • 不要依赖 see() 判断文字是否在页面上——它只检查 DOM 文本节点,不处理 CSS display: none 或 Vue v-if 动态隐藏
  • 优先用 waitForText() 或 waitFor() 显式等待关键元素出现:
$browser->visit('/login')
    ->type('email', 'test@example.com')
    ->type('password', 'secret')
    ->press('Login')
    ->waitFor('#dashboard', 10) // 等待 ID 为 dashboard 的元素在 10 秒内出现
    ->assertSee('Welcome back');

如果页面由 JS 渲染(如 Inertia / Livewire),还要加 ->pause(500) 或 ->waitUntilMissing('.loading') 避免竞态。

Capture and search AI coding sessions alongside Git history with Entire CLI
Capture and search AI coding sessions alongside Git history with Entire CLI

在提交旁边记录AI编码会话,以便代理程序可以恢复代码更改的原因、从检查点恢复以及干净地交接工作。

下载

如何对动态表单、下拉选择、文件上传做可靠交互?

Dusk 提供的 select()、attach()、check() 等方法底层靠 CSS 选择器定位,一旦 HTML 结构变化(比如加了 class="form-control" 或用了 Shadow DOM),就会失效。

  • select() 要求 元素必须是原生标签,不能是第三方组件(如 Select2、Vue Multiselect)包裹后的伪下拉
  • 文件上传必须用绝对路径:$browser->attach('avatar', '/absolute/path/to/image.jpg'); —— 相对路径会报 File not found
  • 对 JS 组件交互,绕过 Dusk 封装,直接执行 JS 获取状态或触发事件:
$browser->script("document.querySelector('[data-testid=\"submit-btn\"]').click();");
// 或读取 Vue 实例数据(假设挂载在 window.app)
$browser->script("return window.app.$data.form.email"); // 返回当前邮箱值

注意:script() 返回值会被序列化为 JSON,复杂对象可能丢失方法或原型链。

最常被忽略的一点:Dusk 测试默认共享同一个浏览器会话(Session),多个 Browser 实例之间 cookie 和 localStorage 是互通的。如果你在某个测试里登录了用户,下一个测试没显式退出或清理,就可能因缓存状态导致断言误判。务必在 tearDown() 或 afterEach() 中调用 $this->browse(function (Browser $browser) { $browser->driver->manage()->deleteAllCookies(); });,或更彻底地用 $browser->quit() 销毁实例。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

897

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

875

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2528

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

5101

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

7530

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

4936

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

9249

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1536

29

Laravel 框架安装指南
Laravel 框架安装指南

本指南详解 Laravel 框架安装全流程,涵盖 PHP 8.1+ 环境配置、Composer 依赖管理工具安装及国内镜像源优化。重点演示使用 composer create-project 命令创建 Laravel 10/11 项目,解决常见安装错误与依赖冲突。从环境搭建到项目初始化,助您快速完成 Laravel 开发环境部署,为后续 Web 应用开发奠定基础。适合 PHP 初学者与框架迁移开发者参考。

2026.04.09

235

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习