本教程将详细介绍如何在 laravel dusk 自动化测试中管理浏览器权限，特别是处理如剪贴板访问等需要用户授权的场景。通过利用 chrome devtools driver 的 `browser.grantpermissions` 命令，开发者可以编程化地授予测试所需的权限，从而确保测试流程顺畅进行，避免因权限弹窗而中断测试。
在进行 Web 应用程序的自动化测试时，经常会遇到浏览器权限相关的挑战。许多现代 Web 功能，如访问剪贴板、获取地理位置、发送桌面通知或使用摄像头/麦克风，都需要用户显式授权。在手动测试中，用户可以轻松点击弹窗进行授权，但在自动化测试框架（如 Laravel Dusk）中，这些交互式弹窗会中断测试流程，导致测试失败。
Laravel Dusk 基于 Selenium WebDriver，默认情况下无法直接与这些权限弹窗进行交互。为了解决这一问题，我们需要一种编程方式来预先授予或拒绝这些权限，从而确保测试能够无缝执行。
对于基于 Chrome 浏览器的 Dusk 测试，我们可以利用 Chrome DevTools Protocol (CDP) 来直接控制浏览器行为，包括管理权限。Facebook\WebDriver\Chrome\ChromeDevToolsDriver 类提供了与 CDP 交互的接口，允许我们执行各种低级浏览器命令。
其中，Browser.grantPermissions 命令是专门用于授予特定权限的。通过这个命令，我们可以模拟用户授权行为，让浏览器在测试开始前就拥有所需的权限，从而避免权限弹窗的出现。
为了方便在测试用例中复用，建议在 DuskTestCase 类中添加一个辅助方法来封装权限授予逻辑。
首先，确保你的 DuskTestCase 类中导入了 ChromeDevToolsDriver：
<?php
namespace Tests;
use Facebook\WebDriver\Chrome\ChromeDevToolsDriver; // 导入此命名空间
use Laravel\Dusk\Browser;
use Laravel\Dusk\TestCase as BaseTestCase;
abstract class DuskTestCase extends BaseTestCase
{
// ... 其他方法
/**
* 授予浏览器特定权限。
*
* @param Browser $browser 当前的 Dusk 浏览器实例
* @param array $permissions 要授予的权限数组，例如 ["clipboardReadWrite", "geolocation"]
* @param string|null $origin 权限作用的源（URL），如果为 null 则默认为当前页面
* @return mixed DevTools 命令的执行结果，或 null（如果发生异常）
*/
protected function grantPermission(Browser $browser, array $permissions, ?string $origin = null)
{
try {
// 获取底层的 WebDriver 实例
$driver = $browser->driver;
// 创建 ChromeDevToolsDriver 实例，用于与 CDP 交互
$devtools = new ChromeDevToolsDriver($driver);
// 构建 DevTools 命令参数
$params = [
"permissions" => $permissions,
];
// 如果指定了 origin，则添加到参数中
if ($origin !== null) {
$params["origin"] = $origin;
}
// 执行 Browser.grantPermissions DevTools 命令
$result = $devtools->execute('Browser.grantPermissions', $params);
return $result;
} catch (\Exception $e) {
// 捕获异常，例如驱动不支持 DevTools 命令或参数错误
echo "Error granting permissions: " . $e->getMessage() . "\n";
return null;
}
}
// ... 其他方法
}
代码解析：
一旦 grantPermission 方法被添加到 DuskTestCase 类中，你就可以在任何 Dusk 测试用例中调用它来授予所需的权限。
以下是一个测试剪贴板功能的示例：
<?php
namespace Tests\Browser;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Laravel\Dusk\Browser;
use Tests\DuskTestCase;
class ClipboardTest extends DuskTestCase
{
use DatabaseMigrations;
/**
* 测试复制链接功能是否正常，并处理剪贴板权限。
*
* @return void
*/
public function testClipboardFunctionality()
{
$this->browse(function (Browser $browser) {
// 在执行需要剪贴板访问的操作之前，授予剪贴板读写权限
$this->grantPermission($browser, ["clipboardReadWrite", "clipboardSanitizedWrite"]);
// 导航到需要测试的页面
$browser->visit('/some-page-with-copy-button')
->assertSee('复制链接');
// 模拟点击复制按钮
$browser->click('#copy-link-button');
// 验证剪贴板内容（这通常需要JavaScript来读取）
// 例如，你可以执行JS来读取剪贴板内容并进行断言
$clipboardContent = $browser->script('return navigator.clipboard.readText();')[0];
$this->assertEquals('期望的链接内容', $clipboardContent);
// 或者，如果你的应用有UI反馈，可以断言UI变化
$browser->assertSee('链接已复制！');
});
}
}
在这个示例中，$this->grantPermission($browser, ["clipboardReadWrite", "clipboardSanitizedWrite"]); 会在测试导航到页面并尝试点击复制按钮之前，确保浏览器已经拥有了访问剪贴板的权限，从而避免了权限弹窗的干扰。
除了剪贴板访问，Browser.grantPermissions 命令还可以用于管理其他多种权限。以下是一些常见的权限类型：
你可以在 Chrome DevTools Protocol 文档中查找更详细的权限列表和相关命令。
通过利用 Laravel Dusk 与 ChromeDevToolsDriver 的结合，开发者能够有效地管理自动化测试中遇到的浏览器权限问题。Browser.grantPermissions 命令提供了一个强大且灵活的机制，允许我们编程化地控制浏览器行为，从而确保测试流程的顺畅和可靠性。掌握这一技术，将大大提升 Laravel Dusk 在测试复杂 Web 应用时的能力和效率。
以上就是Laravel Dusk 测试中管理浏览器权限：以剪贴板访问为例的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
714
收藏
