使用 Selenium 和 WebDriver

引自ChromeDriver - WebDriver for Chrome:

WebDriver 是一款开源的支持多浏览器的自动化测试工具。它提供了操作网页、用户输入、JavaScript 执行等能力。ChromeDriver 是一个实现了 WebDriver 与 Chromium 联接协议的独立服务。它也是由开发了 Chromium 和 WebDriver 的团队开发的。

通过 Spectron 配置

Spectron 是 Electron 官方支持的 ChromeDriver 测试框架。 它是建立在 WebdriverIO 的顶层，并且 帮助你在测试中访问 Electron API 和绑定 ChromeDriver。

  1. $ npm install --save-dev spectron
  1. // 一个简单的测试验证一个带标题的可见的窗口
  2. var Application = require('spectron').Application
  3. var assert = require('assert')
  5. var app = new Application({
  6.   path: '/Applications/MyApp.app/Contents/MacOS/MyApp'
  7. })
  9. app.start().then(function () {
  10.   // 检查浏览器窗口是否可见
  11.   return app.browserWindow.isVisible()
  12. }).then(function (isVisible) {
  13.   // 验证浏览器窗口是否可见
  14.   assert.equal(isVisible, true)
  15. }).then(function () {
  16.   // 获得浏览器窗口的标题
  17.   return app.client.getTitle()
  18. }).then(function (title) {
  19.   // 验证浏览器窗口的标题
  20.   assert.equal(title, 'My App')
  21. }).catch(function (error) {
  22.   // 记录任何错误
  23.   console.error('Test failed', error.message)
  24. }).then(function () {
  25.   // 停止应用程序
  26.   return app.stop()
  27. })

通过 WebDriverJs 配置

WebDriverJs 是一个可以配合 WebDriver 做测试的 node 模块，我们会用它来做个演示。

1. 启动 ChromeDriver

首先，你要下载 chromedriver，然后运行以下命令：

  1. $ ./chromedriver
  2. Starting ChromeDriver (v2.10.291558) on port 9515
  3. Only local connections are allowed.

记住 9515 这个端口号，我们后面会用到

2. 安装 WebDriverJS

  1. $ npm install selenium-webdriver

3. 联接到 ChromeDriver

在 Electron 下使用 selenium-webdriver 和其平时的用法并没有大的差异，只是你需要手动设置连接 ChromeDriver，以及 Electron 的路径：

  1. const webdriver = require('selenium-webdriver')
  3. var driver = new webdriver.Builder()
  4.   // "9515" 是ChromeDriver使用的端口
  5.   .usingServer('http://localhost:9515')
  6.   .withCapabilities({
  7.     chromeOptions: {
  8.       // 这里设置Electron的路径
  9.       binary: '/Path-to-Your-App.app/Contents/MacOS/Atom'
  10.     }
  11.   })
  12.   .forBrowser('electron')
  13.   .build()
  15. driver.get('http://www.google.com')
  16. driver.findElement(webdriver.By.name('q')).sendKeys('webdriver')
  17. driver.findElement(webdriver.By.name('btnG')).click()
  18. driver.wait(function () {
  19.   return driver.getTitle().then(function (title) {
  20.     return title === 'webdriver - Google Search'
  21.   })
  22. }, 1000)
  24. driver.quit()

通过 WebdriverIO 配置

WebdriverIO 也是一个配合 WebDriver 用来测试的 node 模块

1. 启动 ChromeDriver

首先，下载 chromedriver，然后运行以下命令：

  1. $ chromedriver --url-base=wd/hub --port=9515
  2. Starting ChromeDriver (v2.10.291558) on port 9515
  3. Only local connections are allowed.

记住 9515 端口，后面会用到

2. 安装 WebdriverIO

  1. $ npm install webdriverio

3. 连接到 ChromeDriver

  1. const webdriverio = require('webdriverio')
  2. const options = {
  3.   host: 'localhost', // 使用localhost作为ChromeDriver服务器
  4.   port: 9515,        // "9515"是ChromeDriver使用的端口
  5.   desiredCapabilities: {
  6.     browserName: 'chrome',
  7.     chromeOptions: {
  8.       binary: '/Path-to-Your-App/electron', // Electron的路径
  9.       args: [/* cli arguments */]           // 可选参数，类似：'app=' + /path/to/your/app/
  10.     }
  11.   }
  12. }
  14. let client = webdriverio.remote(options)
  16. client
  17.     .init()
  18.     .url('http://google.com')
  19.     .setValue('#q', 'webdriverio')
  20.     .click('#btnG')
  21.     .getTitle().then(function (title) {
  22.       console.log('Title was: ' + title)
  23.     })
  24.     .end()

工作流程

无需重新编译 Electron，只要把 app 的源码放到 Electron的资源目录 里就可直接开始测试了。

当然，你也可以在运行 Electron 时传入参数指定你 app 的所在文件夹。这步可以免去你拷贝－粘贴你的 app 到 Electron 的资源目录。