Question

Selenium is a browser automation library. Most often used for testing web-applications, Selenium may be used for any task that requires automating interaction with the browser.

　　Selenium是一个浏览器自动化测试库，大多时候我们用它来测试web应用，Selenium 可以胜任任何在浏览器上自动化测试的任务。

　　众所周知，Selenium可以支持多种编程语言（Java/ruby/python/C#/Go/JavaScipt），这篇博客就来介绍如何通过JavaScipt语言编写Selenium自动化测试脚本。在此之前，需要把环境搭建起来。

　　之前有个问题一直弄不明白，JavaScipt脚本不是只打开浏览器才能执行么？如何运行Selenium呢？难道我要打开一个浏览器执行JavaScipt去驱动另一个浏览器执行？直到我昨天看了一点Node.js的资料，才突然明白。

　　所以，需要先安装Node.js。

　　官方网址：https://nodejs.org/en/

Installation

　　Selenium may be installed via npm with

　　Selenium可以通过npm安装。（npm是随同NodeJS一起安装的包管理工具。）

>npm install selenium-webdriver

　　NOTE: Mozilla's geckodriver is only required for Firefox 47+. Everything you need for Firefox 38-46 is included with this package.

　　Selenium官方在推出了3.0，值得庆祝，万年的2.x终于升级到3.0了，当然，3.0的正式版还没推出。其中带来了一些改变。最大的变化之一是，Firefox浏览器的驱动由原来集成在Selenium安装包里，现在改为独立的一个驱动文件了（gekodriver），但是，它只能驱动Firefox47版本以上（目前最新版本是48.0.2）。

　　经过多年的发展WebDriver已经成为了事实上的标准，现在每种浏览器都有独立的官方驱动文件了。如下表：

Browser	Component
Chrome	chromedriver(.exe)
Internet Explorer	IEDriverServer.exe
Edge	MicrosoftWebDriver.msi
Firefox 47+	geckodriver(.exe)
PhantomJS	phantomjs(.exe)
Opera	operadriver(.exe)
Safari	SafariDriver.safariextz

　　You will need to download additional components to work with each of the major browsers. The drivers for Chrome, Firefox, PhantomJS, Opera, and Microsoft's IE and Edge web browsers are all standalone executables that should be placed on your system PATH. The SafariDriverbrowser extension should be installed in your browser before using Selenium; we recommend disabling the extension when using the browser without Selenium or installing the extension in a profile only used for testing.

　　然后，把这些驱动下载，并存放到一个目录中，例如：D:/driver/ ，然后，把这这个目录添加到系统环境变量PATH下面。

Usage

　　当Selenium-webdriver 被npm下载完成，将到在当前目录下多出一个../node_modules/目录。然后，在与这个目录同级的目录下创建第一个Selenium测试脚本baidu.js。

　　The sample below and others are included in the example directory. You may also find the tests for selenium-webdriver informative.

var webdriver = require('selenium-webdriver'),
    By = webdriver.By,
    until = webdriver.until;var driver = new webdriver.Builder()
    .forBrowser('chrome')
    .build();

driver.get('https://www.baidu.com');
driver.findElement(By.id('kw')).sendKeys('webdriver');
driver.findElement(By.id('su')).click();
driver.wait(until.titleIs('webdriver_百度搜索'), 1000);
driver.quit();

执行姿势，打开cmd执行。

>node baidu.js

chrome mobile emulation

有时候，需要模拟移动端浏览器测试。例子如下：

var webdriver = require('selenium-webdriver'),
    By = webdriver.By,
    until = webdriver.until,
    chrome = require('selenium-webdriver/chrome');var driver = new webdriver.Builder()
    .forBrowser('chrome')
    .setChromeOptions(new chrome.Options()
        .setMobileEmulation({deviceName: 'Google Nexus 5'}))
    .build();

driver.get('https://m.baidu.com');
driver.findElement(By.name('word')).sendKeys('webdriver');
driver.findElement(By.name('word')).submit();
driver.wait(until.titleIs('webdriver - 百度'), 2000);
driver.quit();

Using the Builder API

　　The Builder class is your one-stop shop for configuring new WebDriver instances. Rather than clutter your code with branches for the various browsers, the builder lets you set all options in one flow. When you call Builder#build(), all options irrelevant to the selected browser are dropped:

var webdriver = require('selenium-webdriver'),

    chrome = require('selenium-webdriver/chrome'),

    firefox = require('selenium-webdriver/firefox'); 

var driver = new webdriver.Builder()

    .forBrowser('firefox')

    .setChromeOptions(/* ... */)

    .setFirefoxOptions(/* ... */)

    .build();

　　Why would you want to configure options irrelevant to the target browser? The Builder's API defines your defaultconfiguration. You can change the target browser at runtime through the SELENIUM_BROWSER environment variable. For example, the example/google_search.js script is configured to run against Firefox. You can run the example against other browsers just by changing the runtime environment

# cd node_modules/selenium-webdrivernode example/google_searchSELENIUM_BROWSER=chrome node example/google_searchSELENIUM_BROWSER=safari node example/google_search

The Standalone Selenium Server

　　The standalone Selenium Server acts as a proxy between your script and the browser-specific drivers. The server may be used when running locally, but it's not recommend as it introduces an extra hop for each request and will slow things down. The server is required, however, to use a browser on a remote host (most browser drivers, like the IEDriverServer, do not accept remote connections).

　　To use the Selenium Server, you will need to install the JDK and download the latest server from Selenium. Once downloaded, run the server with

>java -jar selenium-server-standalone-2.45.0.jar

You may configure your tests to run against a remote server through the Builder API:

var webdriver = require('selenium-webdriver'),
By = webdriver.By,
until = webdriver.until;var driver = new webdriver.Builder()
.forBrowser('chrome')
.usingServer('http://localhost:4444/wd/hub')  //注意这里.build();

driver.get('https://www.baidu.com');
driver.findElement(By.id('kw')).sendKeys('webdriver');
driver.findElement(By.id('su')).click();
driver.wait(until.titleIs('webdriver_百度搜索'), 1000);
driver.quit();

Or change the Builder's configuration at runtime with the SELENIUM_REMOTE_URL environment variable:

SELENIUM_REMOTE_URL="http://localhost:4444/wd/hub" node script.js

Documentation

API documentation is available online from the Selenium project. Additional resources include

• the #selenium channel on freenode IRC

• the selenium-users@googlegroups.com list

• SeleniumHQ documentation

===============

官方原文：http://seleniumhq.github.io/selenium/docs/api/javascript/index.html