Laravel Dusk

• 简介
• 安装
  • 管理 ChromeDriver 安装
  • 使用其他浏览器
• 入门指南
  • 生成测试
  • 每次测试后重置数据库
  • 运行测试
  • 环境处理
• 浏览器基础
  • 创建浏览器
  • 导航
  • 调整浏览器窗口大小
  • 浏览器宏
  • 认证
  • Cookies
  • 执行 JavaScript
  • 截图
  • 将控制台输出存储到磁盘
  • 将页面源代码存储到磁盘
• 与元素交互
  • Dusk 选择器
  • 文本、值和属性
  • 与表单交互
  • 附加文件
  • 按下按钮
  • 点击链接
  • 使用键盘
  • 使用鼠标
  • JavaScript 对话框
  • 与内联框架交互
  • 作用域选择器
  • 等待元素
  • 将元素滚动到视图中
• 可用断言
• 页面
  • 生成页面
  • 配置页面
  • 导航到页面
  • 简写选择器
  • 页面方法
• 组件
  • 生成组件
  • 使用组件
• 持续集成
  • Heroku CI
  • Travis CI
  • GitHub Actions
  • Chipper CI

简介

WARNING

Pest 4 现在包含自动化浏览器测试，相比 Laravel Dusk 提供了显著的性能和可用性改进。对于新项目，我们建议使用 Pest 进行浏览器测试。

Laravel Dusk 提供了一个表达性强、易于使用的浏览器自动化和测试 API。默认情况下，Dusk 不需要你在本地计算机上安装 JDK 或 Selenium。相反，Dusk 使用独立的 ChromeDriver 安装。但是，你可以自由使用任何其他你希望的 Selenium 兼容驱动程序。

安装

首先，你应该安装 Google Chrome 并将 laravel/dusk Composer 依赖添加到你的项目中：

composer require laravel/dusk --dev

WARNING

如果你手动注册 Dusk 的服务提供者，你应该永远不要在生产环境中注册它，因为这样做可能导致任意用户能够通过你的应用程序进行认证。

安装 Dusk 包后，执行 dusk:install Artisan 命令。dusk:install 命令将创建 tests/Browser 目录、一个示例 Dusk 测试，并为你的操作系统安装 Chrome Driver 二进制文件：

php artisan dusk:install

接下来，在应用程序的 .env 文件中设置 APP_URL 环境变量。此值应与你在浏览器中访问应用程序的 URL 匹配。

NOTE

如果你使用 Laravel Sail 管理本地开发环境，请同时查看 Sail 文档中关于配置和运行 Dusk 测试的内容。

管理 ChromeDriver 安装

如果你想安装与 Laravel Dusk 通过 dusk:install 命令安装的不同版本的 ChromeDriver，可以使用 dusk:chrome-driver 命令：

# 为你的操作系统安装最新版本的 ChromeDriver...
php artisan dusk:chrome-driver

# 为你的操作系统安装指定版本的 ChromeDriver...
php artisan dusk:chrome-driver 86

# 为所有支持的操作系统安装指定版本的 ChromeDriver...
php artisan dusk:chrome-driver --all

# 安装与你的操作系统检测到的 Chrome / Chromium 版本匹配的 ChromeDriver 版本...
php artisan dusk:chrome-driver --detect