Laravel Dusk 是基于 ChromeDriver 的浏览器测试工具，用于模拟用户操作如点击、输入等。通过 composer require --dev laravel/dusk 安装并注册 DuskServiceProvider，运行 php artisan dusk:install 初始化。使用 php artisan dusk:make 创建测试文件，在 testUserCanLogin 方法中调用 visit、type、press 等方法实现登录流程测试，并用 assertPathIs 断言路径。Dusk 支持 waitFor 处理异步加载，失败时自动截图，可设置 headless 模式用于 CI/CD。建议结合数据库事务保证测试独立性。
Laravel Dusk 是 Laravel 官方提供的浏览器自动化测试工具，基于 ChromeDriver 和 Facebook WebDriver 构建，可以模拟真实用户在浏览器中的操作，比如点击、输入、提交表单等。它不需要安装 JDK 或 Selenium，使用简单，适合进行功能测试和 UI 测试。
安装与配置 Laravel Dusk
在 Laravel 项目根目录下运行以下命令来安装 Dusk：
composer require --dev laravel/dusk安装完成后，注册 Dusk 的服务提供者。在 app/Providers/AppServiceProvider.php 中的 register() 方法添加如下代码（仅在开发环境注册）：
use Laravel\Dusk\DuskServiceProvider;
public function register()
{
if ($this->app->environment('local', 'testing')) {
$this->app->register(DuskServiceProvider::class);
}
}
接着运行 Dusk 的安装命令：
php artisan dusk:install该命令会创建 tests/Browser 目录，并生成一个示例测试文件。
创建并运行第一个浏览器测试
使用 Artisan 命令创建一个新的浏览器测试：
php artisan dusk:make LoginTest这将在 tests/Browser 下生成 LoginTest.php 文件。编辑该文件，例如测试登录功能：
public function testUserCanLogin()
{
$user = \App\Models\User::factory()->create([
'email' => 'test@example.com',
'password' => bcrypt('password'),
]);
$this->browse(function ($browser) use ($user) {
$browser->visit('/login')
->type('email', $user->email)
->type('password', 'password')
->press('Login')
->assertPathIs('/dashboard');
});
}
运行测试：
php artisan duskDusk 会自动启动 Chrome 浏览器并执行操作。如果 Chrome 无法启动，确保系统已安装 Chrome 浏览器或 Chromium。
常用浏览器操作方法
Dusk 提供了丰富的 API 来模拟用户行为：
- visit('/url')：访问指定页面
- type('field', 'value')：在输入框中输入内容
- click('selector') 或 press('button text')：点击按钮或链接
- check('checkbox') / uncheck('checkbox')：勾选或取消勾选复选框
- select('dropdown', 'option')：选择下拉选项
- attach('file_input', '/path/to/file')：上传文件
- assertSee('text')：断言页面包含指定文本
- assertPathIs('/expected/path')：断言当前 URL 路径
- assertInputValue('field', 'value')：断言输入框的值
- waitFor('.selector')：等待某个元素出现
这些方法链式调用，写法直观，接近自然语言。
处理异步加载和等待元素
现代 Web 应用常有 AJAX 加载内容，Dusk 支持等待机制：
$browser->waitFor('.dynamic-content')
->assertSee('加载成功');
也可以设置最大等待时间：
$browser->waitFor('.modal', 5); // 最多等待5秒
使用 pause(1000) 可暂停执行（单位毫秒），便于调试。
截图与调试
测试失败时，Dusk 会自动截屏保存在 tests/Browser/screenshots 目录中。你也可以手动截图用于调试：
$browser->screenshot('login_page');
若想在无头模式下运行（不显示浏览器），可修改 tests/DuskTestCase.php 中的启动选项：
->disableGPU() ->setHeadless()
这样可以在 CI/CD 环境中运行测试。
基本上就这些。Laravel Dusk 让浏览器自动化变得简单高效，特别适合测试关键业务流程，如登录、注册、支付等。只要掌握基本语法，就能快速写出稳定可靠的 UI 测试。不复杂但容易忽略的是保持测试数据独立和清理状态，建议在测试前后使用数据库事务或刷新迁移。
