全网整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:400-708-3566

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

在 Laravel Dusk 自动化测试中,处理浏览器权限(如剪贴板访问)是常见的挑战。本文将详细介绍如何通过扩展 `DuskTestCase` 类,利用 `ChromeDevToolsDriver` 执行 `Browser.grantPermissions` 命令,从而在测试运行时程序化地授予特定权限。这将使开发者能够更全面地测试依赖于浏览器权限的用户界面功能,确保测试流程的顺畅与完整性。

自动化测试中的浏览器权限挑战

在进行端到端(E2E)测试时,自动化工具如 Laravel Dusk 模拟用户与 Web 应用程序的交互。然而,现代浏览器为了安全和隐私,会对某些敏感操作(例如访问剪贴板、地理位置、摄像头或麦克风)进行权限提示。在无头(headless)模式或自动化测试环境中,这些权限提示会阻断测试流程,导致测试失败。传统的点击授权方式在自动化测试中往往不可行,因此需要一种程序化的方式来预先授予必要的权限。

通过 Chrome DevTools 协议授予权限

Laravel Dusk 基于 Selenium WebDriver,而 Chrome 浏览器提供了一套强大的 DevTools 协议,允许开发者工具或自动化脚本直接与浏览器进行低级别通信。Facebook\WebDriver\Chrome\ChromeDevToolsDriver 类正是连接 WebDriver 与 Chrome DevTools 协议的桥梁。我们可以利用这个类来执行 Browser.grantPermissions 命令,从而在测试开始前或特定测试步骤中授予所需的浏览器权限。

实现权限授予辅助方法

为了方便在多个测试用例中复用权限授予逻辑,建议在 tests/DuskTestCase.php 文件中添加一个辅助方法。

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;
        }
    }
}

代码解释:

  • $browser->driver:获取当前 Dusk 浏览器实例底层的 WebDriver 实例。
  • new ChromeDevToolsDriver($driver):使用 WebDriver 实例初始化 ChromeDevToolsDriver,这是与 Chrome DevTools 协议通信的关键。
  • $devtools->execute('Browser.grantPermissions', [...]):调用 DevTools 协议中的 Browser.grantPermissions 命令。
  • "permissions":这是一个字符串数组,包含了需要授予的具体权限标识符。例如,clipboardReadWrite 和 clipboardSanitizedWrite 用于读写剪贴板。其他常见的权限还包括 geolocation (地理位置)、camera (摄像头) 和 microphone (麦克风) 等。
  • "origin":这是一个可选参数,用于指定权限生效的源。在大多数 Dusk 测试场景中,由于测试通常在当前页面进行,因此可以省略或让其默认。

在测试用例中使用权限授予方法

一旦 grantPermission 方法被添加到 DuskTestCase 中,你就可以在任何继承自 DuskTestCase 的 Dusk 测试用例中调用它。

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');
            // 进一步的断言,例如检查地图是否正确显示或位置信息是否被获取
        });
    }
}

注意事项与最佳实践

  • 浏览器兼容性: ChromeDevToolsDriver 和 Browser.grantPermissions 命令是 Chrome/Chromium 浏览器特有的。如果你的 Dusk 测试需要支持其他浏览器(如 Firefox),你需要寻找对应浏览器的权限管理机制或替代方案。
  • 权限列表: 不同的权限有不同的字符串标识符。请查阅 Chrome DevTools 协议文档 以获取完整的权限列表和其对应的字符串。
  • 测试隔离: 每次测试完成后,浏览器环境通常会重置,包括权限状态。但在某些复杂场景下,为了确保测试之间的完全隔离,你可能需要考虑在测试结束后显式地撤销权限(尽管 Browser.grantPermissions 协议中没有直接的 revokePermissions 命令,但通常每次测试运行都是一个新的浏览器上下文)。
  • 错误处理: 在 grantPermission 方法中加入异常捕获和日志记录,可以帮助你调试权限授予失败的情况。

总结

通过利用 Laravel Dusk 的底层能力和 Chrome DevTools 协议,我们可以有效地在自动化测试中管理浏览器权限。这种方法不仅解决了因权限提示导致的测试中断问题,还使得对依赖敏感浏览器功能的应用程序进行端到端测试成为可能,从而提高了测试的覆盖率和可靠性。掌握这一技巧,将使你的 Laravel Dusk 测试套件更加健壮和全面。


# php  # javascript  # laravel  # java  # js  # 浏览器  # app  # facebook  # 工具  # ai  # firefox  # chrome  # chrome devtools  # 标识符  # 字符串  # 继承  # 自动化  # 而在  # 这是一个  # 测试中  # 可选  # 通常会  # 应用程序  # 端到  # 都是  # 是一个  # 这是 


相关文章: 如何获取PHP WAP自助建站系统源码?  高端网站建设与定制开发一站式解决方案 中企动力  建站DNS解析失败?如何正确配置域名服务器?  如何通过二级域名建站提升品牌影响力?  制作充值网站的软件,做人力招聘为什么要自己交端口钱?  婚礼视频制作网站,学习*后期制作的网站有哪些?  高端企业智能建站程序:SEO优化与响应式模板定制开发  沈阳个人网站制作公司,哪个网站能考到沈阳事业编招聘的信息?  购物网站制作费用多少,开办网上购物网站,需要办理哪些手续?  娃派WAP自助建站:免费模板+移动优化,快速打造专业网站  如何选择建站程序?包含哪些必备功能与类型?  php json中文编码为null的解决办法  广州网站制作的公司,现在专门做网站的公司有没有哪几家是比较好的,性价比高,模板也多的?  如何制作算命网站,怎么注册算命网站?  高性能网站服务器部署指南:稳定运行与安全配置优化方案  如何解决VPS建站LNMP环境配置常见问题?  建站之星安装失败:服务器环境不兼容?  javascript中的try catch异常捕获机制用法分析  零基础网站服务器架设实战:轻量应用与域名解析配置指南  电视网站制作tvbox接口,云海电视怎样自定义添加电视源?  导航网站建站方案与优化指南:一站式高效搭建技巧解析  建站主机服务器选购指南:轻量应用与VPS配置解析  Android使用GridView实现日历的简单功能  如何快速生成可下载的建站源码工具?  建站之星北京办公室:智能建站系统与小程序生成方案解析  建站之星如何快速生成多端适配网站?  如何正确选择百度移动适配建站域名?  ,网页ppt怎么弄成自己的ppt?  ,购物网站怎么盈利呢?  C#怎么使用委托和事件 C# delegate与event编程方法  简单实现Android文件上传  如何快速搭建个人网站并优化SEO?  logo在线制作免费网站在线制作好吗,DW网页制作时,如何在网页标题前加上logo?  实现点击下箭头变上箭头来回切换的两种方法【推荐】  html制作网站的步骤有哪些,iapp如何添加网页?  Swift中swift中的switch 语句  建站一年半SEO优化实战指南:核心词挖掘与长尾流量提升策略  杭州银行网站设计制作流程,杭州银行怎么开通认证方式?  php8.4新语法match怎么用_php8.4match表达式替代switch【方法】  如何快速启动建站代理加盟业务?  网站制作哪家好,cc、.co、.cm哪个域名更适合做网站?  深圳网站制作平台,深圳市做网站好的公司有哪些?  制作宣传网站的软件,小红书可以宣传网站吗?  制作网站的公司有哪些,做一个公司网站要多少钱?  建站之星3.0如何解决常见操作问题?  怎么用手机制作网站链接,dw怎么把手机适应页面变成网页?  已有域名建站全流程解析:网站搭建步骤与建站工具选择  ,石家庄四十八中学官网?  ,柠檬视频怎样兑换vip?  网站制作专业公司有哪些,如何制作一个企业网站,建设网站的基本步骤有哪些? 

您的项目需求

*请认真填写需求信息,我们会在24小时内与您取得联系。