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

<?php  namespace Tests;  use FacebookWebDriverChromeChromeDevToolsDriver; use LaravelDuskBrowser; use FacebookWebDriverRemoteRemoteWebDriver; // 引入 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 TestsBrowser;  use LaravelDuskBrowser; use TestsDuskTestCase; // 确保引用了你的 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');         });     } }