Protractor

时间  2019-11-20
标签 protractor 繁體版
原文   原文链接

 

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

1. 预备环境

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

node --version

 

Node 中附带了 npm 包管理工具，经过 npm 能够下载和安装 protractor。node

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

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

java -version

 

 

2. 安装 protractor

使用 NPM 进行全局安装。github

npm install -g protractor

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

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

webdriver-manager update

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

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 的驱动。api

淘宝提供了镜像地址，咱们能够修改一下 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

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程