Protractor

 

官网地址：http://www.protractortest.org/

1. 预备环境

protractor 是一个 Node.js 程序，为了运行 protractor ，你首先需要 Node 环境。你还应该检查一下 Node 的版本，它应该在 v0.10.0 以上。

node --version

 

Node 中附带了 npm 包管理工具，通过 npm 可以下载和安装 protractor。

默认情况下，protractor 使用 Jasmine 作为测试框架。下面的内容将使用 Jasmine 进行， Jasmine 的当前版本是 2.3，我们将使用这个版本。

我们还将使用本地的独立 Selenium 服务器来控制浏览器，你需要安装 Java Development Kit (JDK) 来运行它，通过执行下面的命令来检查 java 是否正确安装。

java -version

 

 

2. 安装 protractor

使用 NPM 进行全局安装。

npm install -g protractor

这将会安装两个工具：protractor 和 webdriver-manager， 先运行一下 protractor --version 确认可以正常工作。

webdriver-manager 用来帮助我们获取  Selenium Server，但是， 你可能会遇到网络错误。 

webdriver-manager update

我这里执行的结果是这样的。

PS C:\study\demo> webdriver-manager update
Updating selenium standalone
downloading https://selenium-release.storage.googleapis.com/2.45/selenium-server-standalone-2.45.0.jar...
Updating chromedriver
downloading https://chromedriver.storage.googleapis.com/2.15/chromedriver_win32.zip...
Error: Got error Error: connect ETIMEDOUT 74.125.23.128:443 from https://selenium-release.storage.googleapis.com/2.45/selenium-server-standalone-2.45.0.jar
Error: Got error Error: connect ETIMEDOUT 74.125.23.128:443 from https://chromedriver.storage.googleapis.com/2.15/chrome
driver_win32.zip

可以看到，实际上需要下载两个文件：selenium-server-standalone-2.45.0.jar 和 chromedriver_win32.zip ，这两个文件分别是 selenium 独立服务器和 chrome 的驱动。

淘宝提供了镜像地址，我们可以修改一下 webdriver-manager，通过淘宝来下载。

http://npm.taobao.org/mirrors/selenium/

https://npm.taobao.org/mirrors/chromedriver/2.2/

首先找到你的 webdriver-manager 文件，它应该在 C:\Users\your_account\AppData\Roaming\npm\node_modules\protractor\bin 中，找到第 34 行，修改为淘宝的 selenium 地址。

    cdn: 'http://npm.taobao.org/mirrors/selenium/',
    // cdn: 'https://selenium-release.storage.googleapis.com/',

 

再找到第 46 行，修改为

    cdn: 'https://npm.taobao.org/mirrors/chromedriver/',
    // cdn: 'https://chromedriver.storage.googleapis.com/',

 

重新执行 webdriver-manager update 就可以下载了。

下载之后，保存到哪里呢？直接执行一下 webdriver-manager，可以看到如下的输出。

PS C:\study\demo> webdriver-manager
Usage: webdriver-manager <command>
Commands:
  update: install or update selected binaries
  start: start up the selenium server
  status: list the current available drivers

Options:
  --out_dir        Location to output/expect                         [default: "C:\\Users\\xxx\\AppData\\Roaming\\npm\\node_modules\\protractor\\selenium"]
  --seleniumPort   Optional port for the selenium standalone server
  --ignore_ssl     Ignore SSL certificates                           [default: false]
  --proxy          Proxy to use for the install or update command
  --alternate_cdn  Alternate CDN to the binaries
  --standalone     Install or update selenium standalone             [default: true]
  --chrome         Install or update chromedriver                    [default: true]
  --ie             Install or update IEDriver                        [default: false]

Please specify one command

这里给出了默认的保存地址。

成功下载之后，启动服务器检查一下。

webdriver-manager start

 

这将会启动 Selenium 服务器，控制台也会输出一些日志信息.

PS C:\study\demo> webdriver-manager start
seleniumProcess.pid: 4856
15:16:07.179 INFO - Launching a standalone server
Setting system property webdriver.chrome.driver to C:\Users\Whao\AppData\Roaming\npm\node_modules\protractor\selenium\chromedriver.exe
15:16:07.238 INFO - Java: Oracle Corporation 23.6-b04
15:16:07.238 INFO - OS: Windows 7 6.1 amd64
15:16:07.245 INFO - v2.45.0, with Core v2.45.0. Built from revision 5017cb8
15:16:07.317 INFO - RemoteWebDriver instances should connect to: http://127.0.0.1:4444/wd/hub
15:16:07.318 INFO - Version Jetty/5.1.x
15:16:07.318 INFO - Started HttpContext[/selenium-server/driver,/selenium-server/driver]
15:16:07.319 INFO - Started HttpContext[/selenium-server,/selenium-server]
15:16:07.319 INFO - Started HttpContext[/,/]
15:16:07.364 INFO - Started org.openqa.jetty.jetty.servlet.ServletHandler@601edf33
15:16:07.364 INFO - Started HttpContext[/wd,/wd]
15:16:07.367 INFO - Started SocketListener on 0.0.0.0:4444
15:16:07.367 INFO - Started org.openqa.jetty.jetty.Server@792bf755

 

我们的 Protractor 测试将会把测试请求发送到这个服务器，通过它来控制本地的浏览器进行测试，在我们的整个教程中，保持这个服务器的运行，在下面的地址，你可以看到关于服务器状态的信息。

http://localhost:4444/wd/hub

 

3. 演练

Step 0 write a test

保持上面的命令行窗口运行，重新打开另外一个命令行窗口，创建一个用于测试的干净文件夹。

Protractor 需要两个文件来运行测试，一个测试规范文件，一个配置文件。

让我们从示例的 AngularJS 应用开始写一个简单的测试，我们使用位于 http://juliemr.github.io/protractor-demo/ 的超级计算器应用，测试将检查页面的 title 是否符合我们的预期。

复制下面的代码到 spec.js 文件中。

// spec.js
describe('Protractor Demo App', function() {
  it('should have a title', function() {
    browser.get('http://juliemr.github.io/protractor-demo/');

    expect(browser.getTitle()).toEqual('Super Calculator');
  });
});

 

describe 和 it 是 Jasmine 测试框架的语法格式。browser 是通过 protractor 创建的全局变量。它用于浏览器范围的命令控制，比如通过 browser.get 进行导航。

现在，我们创建配置文件，复制一下代码到 conf.js 中。

// conf.js
exports.config = {
  framework: 'jasmine2',
  seleniumAddress: 'http://localhost:4444/wd/hub',
  specs: ['spec.js']
}

 

配置文件中描述了到何处定位测试规范文件 (specs )，Selenium 服务器的地址 (seleniumAddress)， 还说明了我们将会使用 Jasmine 版本 2 作为测试框架。其它配置这里使用默认的配置，Chrome 是默认的浏览器。

现在执行测试。

protractor conf.js

 

你应该看到自动打开了一个 chrome 浏览器，然后导航到超级计算器应用地址，然后，浏览器自动关闭 (这应该非常快 )。测试的输出应该是

 

祝贺你，我们已经运行了第一个 protractor 测试。

Setp 1 - interacting with elements

这一次，我们修改一下测试来与页面中的元素进行交互，将 spec.js 修改为如下内容。

// spec.js
describe('Protractor Demo App', function() {
  it('should add one and two', function() {
    browser.get('http://juliemr.github.io/protractor-demo/');
    element(by.model('first')).sendKeys(1);
    element(by.model('second')).sendKeys(2);

    element(by.id('gobutton')).click();

    expect(element(by.binding('latest')).getText()).
        toEqual('5'); // This is wrong!
  });
});

 

这里，我们使用全局的 element 函数和 by 对象，它们也是 protractor 创建的函数，element 函数用来在页面中定位 HTML 元素，函数返回一个 ElementFinder 对象。可以通过这个对象与页面元素进行交互或者获取信息。在这个测试中，我们使用了 sendKeys 在 input 元素中输入内容，click 函数来模拟点击按钮，getText 获取元素的内容。

element 需要一个参数，一个选择器参数，用来描述如何找到元素，by 对象用来创建选择器，这里我们使用了三种类型的选择器。

• by.model('first') 通过 ng-model='first' 来定位元素。如果你查看 Calculator 页面的源码，你会看到 <input type=text ng-model="first">.
• by.id('gobutton') 通过指定的 id 来定位元素，比如 <button id="gobutton"> .
• by.binding('latest') 定位绑定的变量 latest，比如这里的 {{latest}}

执行这个测试。

protractor conf.js

 

你应该看到页面中输入了两个数字，等待结果显示出来。由于结果是 3 ，而不是 5，我们的测试失败。修复这个测试，然后重新运行它。

Step 2 - writeing multiple scenarios

我们将两个测试放在一起，如下修改 spec.js

// spec.js
describe('Protractor Demo App', function() {
  var firstNumber = element(by.model('first'));
  var secondNumber = element(by.model('second'));
  var goButton = element(by.id('gobutton'));
  var latestResult = element(by.binding('latest'));

  beforeEach(function() {
    browser.get('http://juliemr.github.io/protractor-demo/');
  });

  it('should have a title', function() {
    expect(browser.getTitle()).toEqual('Super Calculator');
  });

  it('should add one and two', function() {
    firstNumber.sendKeys(1);
    secondNumber.sendKeys(2);

    goButton.click();

    expect(latestResult.getText()).toEqual('3');
  });

  it('should add four and six', function() {
    // Fill this in.
    expect(latestResult.getText()).toEqual('10');
  });
});

 

这里，我们把导航移到了 beforeEach 中，这个函数会在每一个 it 块之前执行。我们还把 ElementFinder 保存在变量中进行共享使用。

Step 3 - changing the configuration

我们已经写了一些测试，现在来看看配置文件。在配置文件中，我们可以配置使用什么浏览器，如何连接到 Selenium 服务器等等，先改变一下我们使用的服务器。

// conf.js
exports.config = {
  framework: 'jasmine2',
  seleniumAddress: 'http://localhost:4444/wd/hub',
  specs: ['spec.js'],
  capabilities: {
    browserName: 'firefox'
  }
}

 

重新运行测试，你会看到测试运行在 firefox 中而不是原来的 chrome。capabilities 对象描述了测试使用的浏览器。各种配置参数，参见：the reference config file.

还可以同时在多个浏览器上运行测试，例如。

// conf.js
exports.config = {
  framework: 'jasmine2',
  seleniumAddress: 'http://localhost:4444/wd/hub',
  specs: ['spec.js'],
  multiCapabilities: [{
    browserName: 'firefox'
  }, {
    browserName: 'chrome'
  }]
}

 

重新运行，你会看到测试运行在 chrome 和 firefox 浏览器中。

Step 4 - lists of elements

我们回到测试，把配置文件也调整为仅使用一个浏览器。

有的时候，我们需要处理一组元素 ，可以使用 element.all，它会返回 ElementArrayFinder。在 Calculator 中，任何操作都被记录在 log 中。这是使用 ng-repeat 生成的表格实现的。

我们先进行一系列操作，然后测试它们出现在 log 历史记录中，修改 spec.js 如下。

// spec.js
describe('Protractor Demo App', function() {
  var firstNumber = element(by.model('first'));
  var secondNumber = element(by.model('second'));
  var goButton = element(by.id('gobutton'));
  var latestResult = element(by.binding('latest'));
  var history = element.all(by.repeater('result in memory'));

  function add(a, b) {
    firstNumber.sendKeys(a);
    secondNumber.sendKeys(b);
    goButton.click();
  }

  beforeEach(function() {
    browser.get('http://juliemr.github.io/protractor-demo/');
  });

  it('should have a history', function() {
    add(1, 2);
    add(3, 4);

    expect(history.count()).toEqual(2);

    add(5, 6);

    expect(history.count()).toEqual(0); // This is wrong!
  });
});

 

我们做了许多事，首先，创建了一个 helper 函数 add。还有一个变量 history。我们通过 by.repeater 使用 element.all 来得到 ElementArrayFinder。在我们的测试中，我们使用 count 方法来断言期望的长度。修改测试以便通过第二个测试。

除了 count 之外，ElementArrayFinder 还提供了许多方法，让我们使用 last 来获得最后一个元素的 ElementFinder ，修改测试。

it('should have a history', function() {
    add(1, 2);
    add(3, 4);

    expect(history.last().getText()).toContain('1 + 2');
    expect(history.first().getText()).toContain('foo'); // This is wrong!
  });

 

由于 Calculator 在最后报告最早的结果，最早的计算 (1 + 2) 会出现在最后。我们使用 Jasmine 的 toContain 断言来检查 "1 + 2" ，元素的文本内容中还包含了时间戳和计算结果。

修复这个测试，正确地期望在第一个历史记录中包含了 "3 + 4"。

ElementArrayFinder 还提供了方法 each, map, filter 和 reduce 等等模拟 JavaScript 的数组方法，详见： Read the API for more details.

 

4. 参考资料

原文地址：http://www.protractortest.org/#/tutorial