README

WPSelenium是一个库，允许您快速使用selenium和phpunit进行网站测试。

WPSelenium是一个库，当您想要使用selenium和phpunit测试您的网站时，可以快速启动。它是通过安装和配置phpunit、selenium服务器、php客户端webdriver（由Facebook提供）以及您要测试的浏览器的正确驱动程序来实现的。一旦安装，您只需关注编写selenium php测试。

WPSelenium还包括对WordPress插件和主题测试的支持。它是通过提供您可以使用的WordPress特定钩子和配置端点来实现的。

使用说明

Operand browser is required

Usage: vendor/bin/wpselenium <browser>  [options] 
Example: vendor/bin/wpselenium chrome --type wordpress

Operands:
  <browser>  Brower you want to test on. Chrome and Firefox supported by default. See documenation if you want to add
             others.

Options:
  --type <arg>      The type of site you are testing. e.g --type wordpress
  --loglevel <arg>  Console loglevel - info, warn, error, debug.
  -?, --help        Show this help and quit.

入门指南

要求

为了运行WPSelenium，您需要安装以下内容

Java（并确保它在您的系统路径中。在终端或命令行窗口中输入java以进行检查）
Php >= 7.2
Composer
Chrome 或 Firefox 或您想要测试的任何其他浏览器（假设您有驱动程序）

1. 安装

要开始使用WPselenium，请使用以下命令使用composer进行安装：

composer require --dev devchid/wpselenium

注意：此命令假定您运行它的工作目录是一个composer项目。如果不是，您可以通过运行composer init或添加一个composer.json文件来轻松地将它变成一个项目。

注意：WPSelnenium当前下载的是76.0.3809.126 chrome驱动程序和0.24 firefox gecko驱动程序。如果您的浏览器需要较新或较旧的驱动程序版本（如果不确定，您将收到建议使用此版本的错误），请在wpselenium.xml配置文件中指定驱动程序的更新下载URL。有关更多详细信息，请参阅文档网站。

2. 配置

安装wpselenium后，您需要创建一个wpselenium.xml配置文件。此文件应位于与您的composer.json文件相同的目录中。以下是一个基本的示例配置，以帮助您开始。

<wpselenium>
    <siteUrl>https://:3000</siteUrl>
    <phpunit bootstrap="vendor/autoload.php">
          <testsuites>
              <testsuite name="WPSelenium Sample Tests">
                  <file>vendor/devchid/wpselenium/src/Sample/SampleTest.php</file>
              </testsuite>
          </testsuites>
    </phpunit>
</wpselenium>

您需要将siteUrl替换为您要测试的自己的网站。

注意：WPSelenium.xml可以嵌入phpunit配置，使用phpunit端点（如上所述）。然后将在使用phpunit测试项目时加载指定的配置。但是，如果您想创建自己的phpunit配置文件（phpunit.xml），您也可以这样做（并且不包含在这里）。有关更多详细信息，请参阅文档网站。

3. 运行测试

完成此步骤后，您基本上就完成了。您可以从与您的composer.json文件相同的目录中运行以下命令（其中browser_driver可以是chrome或firefox）

/vendor/bin/wpselenium [浏览器驱动]

如果一切配置正确，你应该会看到一个浏览器窗口打开到你的网站的首页（以下为示例）。此窗口将在大约10秒后关闭。

注意：

首次运行时，WPSelenium将下载所需的文件并适当配置。这意味着你的第一次运行将需要一点时间来开始测试你的网站。

WPSelenium目前仅支持Chrome和Firefox。但是，如果你需要测试其他浏览器，可以在wpselenium配置中指定浏览器驱动的链接。从那里，你可以使用指定的驱动名称重新运行上述命令（例如，/vendor/bin/wpselenium opera）。有关详细信息，请参阅配置部分。

如果你能看到像上述示例那样的网站首页，那么一切设置正确。你现在可以继续编写测试。

WordPress支持

WPSelenium内置了对WordPress站点的支持。这对于构建可能需要UI测试的定制插件或主题特别有用。有关详细信息，请参阅文档网站。

文档

WPSelenium库在https://wpselenium.centridsol.tech/进行了全面文档化。如果你认为还有其他应该文档化的内容，请告知。

贡献

WPSelenium是一个开源项目，并且重视贡献。

如果你正在贡献一个错误修复，请创建一个包含以下详细信息的pull request：

你正在解决的问题/错误
修复适用于的WPSelenium版本
你是如何测试修复的

如果是新功能，请将其作为带有增强标签的问题添加，详细说明新功能和为什么你认为它需要。我们将在那里讨论它，一旦达成一致，你可以创建一个包含上述详细信息的pull request。

作者

Chido Warambwa - 初始工作 - chidow@centridsol.tech

许可证

本项目受MIT许可证的许可 - 请参阅LICENSE文件以获取详细信息

devchid / wpselenium

维护者

详细信息