initbiz / oc-selenium2tests-plugin
使用 Selenium 2 在 OctoberCMS 中编写测试
Requires
- php: >=7.0
- composer/installers: ~1.0
This package is auto-updated.
Last update: 2024-02-05 14:43:51 UTC
README
这是一个由 InIT.biz 创建的 OctoberCMS 插件仓库。
如何使用
系统要求
- Java 8 已安装在你的平台默认位置(例如 Linux 的 /usr/bin/java)
- 用于测试的浏览器的驱动程序(例如 ChromeDriver)
Linux 用户注意事项
从你的包管理器安装 Chromium 应该会为你安装 ChromeDriver
Mac 用户注意事项
你可能需要按照以下链接描述将较新版本的 Java 链接到默认路径:这里
安装
- 你可以使用三种方法来安装此插件
- 从 OctoberCMS 市场place,
- 从 GitHub 克隆代码到 /plugins/initbiz/selenium2tests目录或
- 使用 Composer 安装 composer require --dev initbiz/oc-selenium2tests-plugin
- 将 "laravel/dusk": "^2.0"添加到composer.json文件的require-dev部分
- 转到 /plugins/initbiz/selenium2tests
- 将 selenium.php.example复制到selenium.php并配置你的环境
你还可以在你的根目录中创建 selenium.php 文件,它将在插件目录中的文件不存在时被读取
测试 OctoberCMS 基础
不要将测试和开发目的使用相同的数据库是一个好习惯。
为了配置用于测试目的的不同数据库,请在 config 目录中创建 testing 目录并将 database.php 复制到新创建的目录中。然后按需更改默认连接。
之后,如果你在 .env 文件中使用 APP_ENV=testing,则将从 testing 目录使用配置。
在 Selenium 2 中编写测试
在 tests/example 目录中有使用 Ui2TestCase 类的示例测试。
运行测试
首先,你必须运行包含在包中的 Selenium 2 独立服务器。为了启动 Selenium 2 服务器,请转到 <project_root>/plugins/initbiz/selenium2tests 并运行 java -jar selenium.jar。
现在你可以使用 OctoberCMS 的 vendor/bin/phpunit 运行测试了。
你可以将测试文件放在任何位置,但插件的 .gitignore 将排除除 /tests/examples 之外的所有 /tests 目录下的文件。
浏览器选项(例如无头模式)
如果您想例如以无头模式运行浏览器,可以将该行添加到您的 selenium.php 文件中
define('TEST_SELENIUM_BROWSER_OPTIONS', ['--headless']);
