From 34109fa74171b5f0f3cc76f266485d2c3874f182 Mon Sep 17 00:00:00 2001
From: Cheng Zhao <zcbenz@gmail.com>
Date: Sat, 13 Sep 2014 00:07:21 +0800
Subject: [PATCH] docs: Document how to use chromedriver.

---
 docs/README.md                              |  1 +
 docs/tutorial/use-selenium-and-webdriver.md | 68 +++++++++++++++++++++
 2 files changed, 69 insertions(+)
 create mode 100644 docs/tutorial/use-selenium-and-webdriver.md

diff --git a/docs/README.md b/docs/README.md
index 12300f428d..b834576716 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -5,6 +5,7 @@
 * [Use native node modules](tutorial/use-native-node-modules.md)
 * [Debugging browser process](tutorial/debugging-browser-process.md)
 * [DevTools extension](tutorial/devtools-extension.md)
+* [Use Selenium and WebDriver](tutorial/use-selenium-and-webdriver.md)
 
 ## API references
 
diff --git a/docs/tutorial/use-selenium-and-webdriver.md b/docs/tutorial/use-selenium-and-webdriver.md
new file mode 100644
index 0000000000..5983ca2942
--- /dev/null
+++ b/docs/tutorial/use-selenium-and-webdriver.md
@@ -0,0 +1,68 @@
+# Use Selenium and WebDriver
+
+From [chromedriver - WebDriver for Google Chrome][chrome-driver]:
+
+> WebDriver is an open source tool for automated testing of web apps across many
+> browsers. It provides capabilities for navigating to web pages, user input,
+> JavaScript execution, and more. ChromeDriver is a standalone server which
+> implements WebDriver's wire protocol for Chromium. It is being developed by
+> members of the Chromium and WebDriver teams.
+
+In atom-shell's [releases](https://github.com/atom/atom-shell/releases) page you
+can find archives of `chromedriver`, there is no difference between atom-shell's
+distribution of `chromedriver` and upstream ones, so in order to use
+`chromedriver` together with atom-shell, you will need some special setup.
+
+## Setting up with WebDriverJs
+
+[WebDriverJs](https://code.google.com/p/selenium/wiki/WebDriverJs) provided
+a Node package for testing with web driver, we will use it as an example.
+
+### 1. Start chrome driver
+
+First you need to download the `chromedriver` binary, and run it:
+
+```bash
+$ ./chromedriver
+Starting ChromeDriver (v2.10.291558) on port 9515
+Only local connections are allowed.
+```
+
+Remember the port number `9515`, which will be used later
+
+### 2. Install WebDriverJS
+
+```bash
+$ npm install selenium-webdriver
+```
+
+### 3. Connect to chrome driver
+
+The usage of `selenium-webdriver` with atom-shell is basically the same with
+upstream, except that you have to manually specify how to connect chrome driver
+and where to find atom-shell's binary:
+
+```javascript
+var webdriver = require('selenium-webdriver');
+
+var driver = new webdriver.Builder().
+   // The "9515" is the port opened by chrome driver.
+   usingServer('http://localhost:9515').
+   withCapabilities({chromeOptions: {
+     // Here is the path to your atom-shell binary.
+     binary: '/Path-to-Your-App.app/Contents/MacOS/Atom'}}).
+   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();
+```
+
+[chrome-driver]: https://code.google.com/p/chromedriver/