initbiz / selenium2tests-plugin
使用Selenium 2在OctoberCMS中编写测试
Requires
- php: >=7.0
- composer/installers: ~1.0
This package is auto-updated.
Last update: 2024-09-05 16:05:36 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
目录中的所有文件,除了 /tests/examples
中的文件。
浏览器选项(例如无头模式)
如果您想在无头模式下运行浏览器,可以将该行添加到您的 selenium.php
文件中
define('TEST_SELENIUM_BROWSER_OPTIONS', ['--headless']);