在Laravel Dusk测试中授予浏览器权限的实践指南

<?php

namespace Tests;

use Facebook\WebDriver\Chrome\ChromeDevToolsDriver;
use Laravel\Dusk\Browser;
use Facebook\WebDriver\Remote\RemoteWebDriver; // 引入RemoteWebDriver

abstract class DuskTestCase extends BaseTestCase
{
    // ... 其他DuskTestCase内容 ...

    /**
     * 授予浏览器特定权限。
     *
     * @param Browser $browser 当前的Dusk浏览器实例。
     * @param array $permissions 要授予的权限数组，例如 ["clipboardReadWrite", "geolocation"]。
     * @param string|null $origin 权限作用域的源URL，如果为null则默认为当前页面源。
     * @return array|null CDP命令执行结果，或在失败时返回null。
     */
    protected function grantPermission(Browser $browser, array $permissions, ?string $origin = null): ?array
    {
        try {
            /** @var RemoteWebDriver $driver */
            $driver = $browser->driver;
            $devtools = new ChromeDevToolsDriver($driver);

            // 如果未指定origin，尝试获取当前URL作为origin
            if ($origin === null) {
                try {
                    $currentUrl = $driver->getCurrentURL();
                    $parsedUrl = parse_url($currentUrl);
                    if (isset($parsedUrl['scheme']) && isset($parsedUrl['host'])) {
                        $origin = $parsedUrl['scheme'] . '://' . $parsedUrl['host'];
                        if (isset($parsedUrl['port'])) {
                            $origin .= ':' . $parsedUrl['port'];
                        }
                    } else {
                        // 如果无法解析当前URL，则不设置origin参数，让CDP使用默认行为
                        $origin = ''; // 设置为空字符串，表示不明确指定origin，CDP会根据上下文处理
                    }
                } catch (\Exception $e) {
                    // 捕获获取当前URL时的异常，例如页面未加载
                    error_log("Failed to get current URL for origin: " . $e->getMessage());
                    $origin = '';
                }
            }

            $params = [
                "permissions" => $permissions,
            ];

            // 只有当origin有效时才添加到参数中
            if (!empty($origin)) {
                $params["origin"] = $origin;
            }

            // 执行Browser.grantPermissions命令
            $result = $devtools->execute('Browser.grantPermissions', $params);

            return $result;
        } catch (\Exception $e) {
            // 捕获异常，例如权限名称错误、DevTools协议通信失败或WebDriver错误
            error_log("Failed to grant permissions: " . $e->getMessage());
            return null;
        }
    }
}

<?php

namespace Tests\Browser;

use Laravel\Dusk\Browser;
use Tests\DuskTestCase; // 确保引用了你的DuskTestCase

class ClipboardTest extends DuskTestCase
{
    /**
     * 测试Web应用中的剪贴板复制功能。
     *
     * @return void
     */
    public function testClipboardCopyFunctionality()
    {
        $this->browse(function (Browser $browser) {
            // 1. 在执行需要剪贴板权限的操作之前，授予剪贴板读写权限。
            // 我们可以同时授予多个权限，例如：
            $this->grantPermission($browser, ["clipboardReadWrite", "clipboardSanitizedWrite"]);

            // 2. 导航到包含复制按钮的页面。
            $browser->visit('/copy-feature')
                    ->waitForText('Copy Link Feature'); // 等待页面加载完成

            // 3. 点击复制按钮。假设页面上有一个带有data-dusk="copy-button"的按钮。
            $browser->click('@copy-button');

            // 4. 验证剪贴板内容。
            // 直接从浏览器会话读取剪贴板内容通常需要更复杂的DevTools命令或JavaScript注入。
            // 一种常见的做法是，如果前端JS在复制后将内容存储在一个隐藏的输入框或某个可访问的JS变量中，
            // 我们可以尝试通过Dusk的script方法来获取。
            // 假设你的前端JS在复制成功后，会将内容设置到一个id为"clipboard-output"的隐藏input中：
            $clipboardContent = $browser->script('return document.getElementById("clipboard-output").value;')[0];

            $this->assertEquals('https://example.com/some-link-to-copy', $clipboardContent);

            // 5. 也可以验证UI上的反馈，例如显示“已复制”提示。
            $browser->assertSee('Link copied to clipboard!');
        });
    }

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

            $browser->visit('/map-feature')
                    ->waitForText('Your Location');

            // 模拟用户点击允许地理位置，或者等待地理位置API自动获取
            // 进一步的断言取决于你的应用如何处理地理位置数据
            $browser->assertSee('Displaying map based on your location');
        });
    }
}