Merge pull request #3704 from leftstick/master

add ZH-CN translation for using-selenium-and-webdriver
This commit is contained in:
Cheng Zhao 2015-12-09 11:43:26 +08:00
commit 445b4a1834

View file

@ -0,0 +1,119 @@
# 使用Selenium和WebDriver
引自[ChromeDriver - WebDriver for Chrome][chrome-driver]:
> WebDriver是一款开源的支持多浏览器的自动化测试工具。它提供了操作网页、用户输入、JavaScript执行等能力。ChromeDriver是一个实现了WebDriver与Chromium联接协议的独立服务。它也是由开发了Chromium和WebDriver的团队开发的。
为了能够使`chromedriver`和Electron一起正常工作我们需要告诉它Electron在哪并且让它相信Electron就是Chrome浏览器。
## 通过WebDriverJs配置
[WebDriverJs](https://code.google.com/p/selenium/wiki/WebDriverJs) 是一个可以配合WebDriver做测试的node模块我们会用它来做个演示。
### 1. 启动ChromeDriver
首先,你要下载`chromedriver`,然后运行以下命令:
```bash
$ ./chromedriver
Starting ChromeDriver (v2.10.291558) on port 9515
Only local connections are allowed.
```
记住`9515`这个端口号,我们后面会用到
### 2. 安装WebDriverJS
```bash
$ npm install selenium-webdriver
```
### 3. 联接到ChromeDriver
在Electron下使用`selenium-webdriver`和其平时的用法并没有大的差异只是你需要手动设置连接ChromeDriver以及Electron的路径
```javascript
const webdriver = require('selenium-webdriver');
var driver = new webdriver.Builder()
// "9515" 是ChromeDriver使用的端口
.usingServer('http://localhost:9515')
.withCapabilities({
chromeOptions: {
// 这里设置Electron的路径
binary: '/Path-to-Your-App.app/Contents/MacOS/Atom',
}
})
.forBrowser('electron')
.build();
driver.get('http://www.google.com');
driver.findElement(webdriver.By.name('q')).sendKeys('webdriver');
driver.findElement(webdriver.By.name('btnG')).click();
driver.wait(function() {
return driver.getTitle().then(function(title) {
return title === 'webdriver - Google Search';
});
}, 1000);
driver.quit();
```
## 通过WebdriverIO配置
[WebdriverIO](http://webdriver.io/)也是一个配合WebDriver用来测试的node模块
### 1. 启动ChromeDriver
首先,下载`chromedriver`,然后运行以下命令:
```bash
$ chromedriver --url-base=wd/hub --port=9515
Starting ChromeDriver (v2.10.291558) on port 9515
Only local connections are allowed.
```
记住`9515`端口,后面会用到
### 2. 安装WebdriverIO
```bash
$ npm install webdriverio
```
### 3. 连接到ChromeDriver
```javascript
const webdriverio = require('webdriverio');
var options = {
host: "localhost", // 使用localhost作为ChromeDriver服务器
port: 9515, // "9515"是ChromeDriver使用的端口
desiredCapabilities: {
browserName: 'chrome',
chromeOptions: {
binary: '/Path-to-Your-App/electron', // Electron的路径
args: [/* cli arguments */] // 可选参数,类似:'app=' + /path/to/your/app/
}
}
};
var client = webdriverio.remote(options);
client
.init()
.url('http://google.com')
.setValue('#q', 'webdriverio')
.click('#btnG')
.getTitle().then(function(title) {
console.log('Title was: ' + title);
})
.end();
```
## 工作流程
无需重新编译Electron只要把app的源码放到[Electron的资源目录](https://github.com/atom/electron/blob/master/docs/tutorial/application-distribution.md)里就可直接开始测试了。
当然你也可以在运行Electron时传入参数指定你app的所在文件夹。这步可以免去你拷贝粘贴你的app到Electron的资源目录。
[chrome-driver]: https://sites.google.com/a/chromium.org/chromedriver/