Laravel Dusk：通过 DevTools 协议管理浏览器权限

<?php

namespace Tests;

use Facebook\WebDriver\Chrome\ChromeDevToolsDriver;
use Laravel\Dusk\Browser;
use Laravel\Dusk\TestCase as BaseTestCase;

abstract class DuskTestCase extends BaseTestCase
{
    use CreatesApplication;

    /**
     * 授予浏览器特定权限。
     *
     * @param Browser $browser 当前的 Dusk 浏览器实例。
     * @param array $permissions 要授予的权限数组，例如 ["clipboardReadWrite", "clipboardSanitizedWrite"]。
     * @return mixed DevTools 命令的执行结果，或 null（如果发生异常）。
     */
    protected function grantPermission(Browser $browser, array $permissions)
    {
        try {
            $driver = $browser->driver;
            // 创建 ChromeDevToolsDriver 实例，用于执行 DevTools 命令
            $devtools = new ChromeDevToolsDriver($driver);

            // 执行 Browser.grantPermissions 命令
            // "permissions" 参数是一个字符串数组，指定要授予的权限类型
            // 更多权限类型请参考 Chrome DevTools 协议文档
            $result = $devtools->execute('Browser.grantPermissions', [
                "permissions" => $permissions,
                // "origin" 参数可选，指定权限作用的源，
                // 如果不指定，通常会作用于当前页面或默认源。
                // 在多数 Dusk 测试场景中，通常无需显式指定。
            ]);

            return $result;
        } catch (\Exception $e) {
            // 捕获异常，例如 DevTools 命令执行失败
            // 可以在此处记录日志或根据需要处理错误
            error_log("Failed to grant permissions: " . $e->getMessage());
            return null;
        }
    }
}

<?php

namespace Tests\Browser;

use Laravel\Dusk\Browser;
use Tests\DuskTestCase;

class ExampleTest extends DuskTestCase
{
    /**
     * 测试剪贴板复制功能。
     *
     * @return void
     */
    public function testClipboardFunctionality()
    {
        $this->browse(function (Browser $browser) {
            // 在执行需要剪贴板权限的操作之前，授予权限
            $this->grantPermission($browser, ["clipboardReadWrite", "clipboardSanitizedWrite"]);

            // 模拟用户操作，例如点击复制按钮
            $browser->visit('/some-page-with-copy-button')
                    ->click('#copy-button');

            // 验证剪贴板内容（可能需要额外的 JavaScript 来获取剪贴板内容并断言）
            // 例如：
            // $clipboardContent = $browser->script('return navigator.clipboard.readText()')[0];
            // $this->assertEquals('Expected content', $clipboardContent);

            // 注意：直接从浏览器获取剪贴板内容可能需要进一步的实现，
            // 因为 Dusk 默认的 `script` 方法在某些情况下可能无法直接访问到
            // 浏览器上下文的 `navigator.clipboard`。
            // 更可靠的方法可能是让你的应用在复制后将内容存储在某个可访问的 DOM 元素或 JS 变量中。
        });
    }

    /**
     * 测试需要地理位置权限的功能。
     *
     * @return void
     */
    public function testGeolocationFeature()
    {
        $this->browse(function (Browser $browser) {
            // 授予地理位置权限
            $this->grantPermission($browser, ["geolocation"]);

            // 模拟访问需要地理位置的页面
            $browser->visit('/map-page')
                    ->assertSee('Your current location');
            // 进一步的断言，例如检查地图是否正确显示或位置信息是否被获取
        });
    }
}