初步了解Angular 2端到端的测试

[[176204]]

有许多原因使我过去不愿对自己的应用添加自动化测试。原因之一是不知道其中的效益成本比率，另一个原因是考虑到集成到现有生产环境的应用可能比较难。测试应用而不用从头重构代码，仅仅只是引入测试要怎么做呢?

首先我们先从简单区分测试的类型开始。应用测试有很多类型，但最为常见的是单元测试及端对端测试(亦称为集成测试)。单元测试是测试代码自身行为的一种测试。在用户看来什么也没有做，但可以确保其方法能达到期望的目的。集成测试是模仿用户行为的一种测试。比如说，登陆系统，创建帖子，退出系统等这些操作都可以自动化，并且你可以用眼睛看到其过程是怎么发生的。

 

这两种类型的测试，它们通常彼此结合使用。对于新的开发来说，这将是理想的。如果时间有限制，或继承于现有项目的情况下，端对端测试或许比单元测试更加合适。因为我们并不需要过多了解先前的代码库，同样可以覆盖更多场景，这将比单元测试更快，因为单元测试并不测试单个单元而是整个场景。

单元测试依然重要，但如果你必须要在开始的时候选择一个，我认为端对端测试会是更好的选择。在这篇文章中，我将测试一个现有的Angular 2的待办事项的项目。我将使用集成测试，并覆盖一系列的场景。

如果你需要熟悉Angular 2的入门，请看这篇文章 Angular 2 article from Jscrambler。

 

被测试的场景

• 当应用初始化加载时，有3件待处理的事情
• 需要加载新待办事项
• 点击一个待办事项，然后跳到待办事项的详细页
• 删除一个待办事项
• 编辑一个待办事项标题，然后保存后，可以在首页的待办事项列表中看到新标题
• 不允许保存一个空的待办事项，在点了禁用的保存按钮后，待办事项的列表依然还是原来的总数
• 起初加载首页时，添加新待办事项的按钮应处于禁用状态
• 保存待办事项的按钮仅应在输入待办事项标题后处于编辑状体

Todo 应用程序概述

让我们简单的描述一下TODO应用程序。应用程序将首先在主页上列出待办事项清单。有三个待办事项会详细列出。

这写数据不会由服务端提供，而是从设备文件硬编码中加载。

在首页上，我们可以添加新的待办事项。我们可以通过点击代办事项的标题来访问其详细信息页面。在此页面上，我们可以编辑代办事项标题或删除待办事项。

克隆并设置Todo 应用程序

1、首先克隆我已经推送到存储库这里但未经测试的应用程序，确保你是在主分支克隆的。接下来，你需要安装几个工具以便能进行下面的操作，在本教程中，使用Candidate已经发布的Angular 2，版本为2。

2、确保您已安装NodeJS的版本是Node 4.x.x或更高版本。

3、使用以下命令安装节点依赖项：

npm install 

当然是在克隆的存储库中操作

4.使用Angular-CLI进行开发。安装Angular-CLI 全局使用下面命令：

npm install -g angular-cli@latest 

5.Angular 2 端到端测试使用被称为 protractor的工具来运行，安装protractor 全局使用下面命令：

npm install -g protractor 

6.安装所有依赖项后，使用以下命令启动开发服务器：

ng serve 

然后导航到浏览器地址：http://localhost:4200，您将看到三个待办事项列表。

如果您在启动服务器时遇到问题，您可以参考stackoverflow issue来解决问题。

 

Angular 2测试相关的重要概念

端对端测试的文件夹在e2e。 其中有一个已预备好的案列文件，文件名为es2/app.e2e-spec.ts。

其中的测试文件是用 jasmine 框架开发的。有很多方式模块化、组织Angular 2端对端测试，但这里为了方便，这篇文章都将在一个文件中进行。

我们这个应用仅有一个功能那就是待办事项。为了满足大家的好奇心或有人在想比上述更复杂的情况，试想一个需要测试订单、用户配置等功能更复杂的应用的场景。对此测试的场景，我将在e2e文件夹中分别为每个待测试功能创建一个文件夹，并将各自测试文件放置其中。

这种情况下，我们将有两个文件夹分别命名为e2e/orders 和 e2e/userProfile。每个文件夹中仅会有一个测试文件，或者为了满足更多待测试功能的需要而创建多个测试文件。需要注意的一点是每个测试文件都以word e2e-spec.ts结尾，这样Protractor测试工具才可以加载到。

Ok，还是回到我们简单的单个测试文件。如果你略有查看此文件，你会发现文件的头部有个导入声明(import statement)。导入是声明若干测试文件中所用的普通函数是源于哪里。然而这篇文章，我们不会使用这个，而将这个视为函数库。

 

在引入声明(import statement)之后，我们有一个描述性的代码块，它的两个函数调用即 beforeEach 和它里面的回调。

在描述代码块内，每个回调传递给 beforeEach 都需要测试。

每个测试再把里面的回调函数传递给它。

让我们用命令运行当前的测试

protractor 

如果你在运行 protractor 两个命令中的一个时有问题，请参考这里。

./node_modules/protractor/bin/webdriver-manager update 

或者

webdriver-manager update 

要是当前的测试失败，可能会在首页看到“app works”这样的文本提示。这并不是因为我们修改了首页的内容就出现这种情况。

在我们开始编写我们的测试之前，让我们理解一些重要的通用函数，然后使用 Angular 2 的端到端测试。

 

导航到页面

在测试文件中，有一个browser全局变量。它使用import语句引入

import { browser, element, by } from 'protractor/globals'; 

你现在可以添加上。

例如，我们使用下面语句导航到你的应用程序中可用的任何页面

browser.get('/'); 

到你的主页，和

browser.get('/users'); 

到users页面。请注意，这些网址是相对的URL，我们也可以使用绝对URL，但是我建议使用相对URL，因为如果你的域名改变，这更易于维护。

选择元素

通常的做法是在当前页面上选择元素。你可以通过一个叫做element的全局变量选择元素。它接受可以使用全局by创建的定位器。

使用选择具有green类的p标签例子如下

let greenParagraph = element(by.css('p.green')); 

选择多个元素，有些轻微的变化

let greenParagraphs = element.all(by.css('p.green')); 

这将给出一个数组，而不是一个单一的元素。

抓取元素文本

要得到一个元素的文本，你必须先选择它，然后调用getText方法，想下面这样。

 

let greenParagraph = element(by.css('p.green'));  
let text = greenParagraph.getText(); 

点击元素

点击元素可以使用下面的语法完成

 

let submitButton = element(by("form .submit-button"));  
submitButton.click(); 

统计元素

我们也可以使用下面的语法来统计元素个数。

 

let blueParagraphsList = elements.all(by("p.blue"));  
let count = blueParagraphsList.count(); 

 

Test Scenarios测试方案

对于那些不太寻常的概念，我们列出了上面覆盖的场景。

确认要做的首要三件事

当应用程序初次被加载的时候，我们有将要做三件事。

在测试文件 e2e/app.e2e-spec.ts 的内部， beforeEach 代码块的下面，删除调用它的函数，并在下面添加

 

it("should show three todos when we first load the todo app", () => {  
browser.get("/");  
let todos = element.all(by.css(".todos .todo"));  
expect(todos.count()).toEqual(3);  
}) 

不要忘记在这个文件的顶部添加这个导入声明

import { browser, element, by } from 'protractor/globals'; 

现在，当你运行 protractor 命令，另一个浏览器将会被打开且迅速关闭，在你的控制台上你能看到通过测试的时候显示为绿色。

好的!我们刚刚已经写完了我们第一个通过 Angular 2 的端到端测试。

 

添加一个新的待办事项

现在进行下一个，我们可以添加一个待办事项。让我们用下面的代码添加一个测试块

 

it("should be able to add a new todo", () => {  
browser.get("/");  
let newTodoInput = element(by.css(".add-todo input[type=text]"));  
newTodoInput.sendKeys("Todo 4");  
let newTodoSubmitButton = element(by.css(".add-todo input[type=submit]"));  
newTodoSubmitButton.click();  
let todos = element.all(by.css(".todos .todo"));  
expect(todos.count()).toEqual(4);  
}) 

我们在这里要做的是在待办事项输入框中输入文本并提交表单。然后我们检查是否有四个待办事项。 如果是的话，测试通过。

我们刚刚介绍了另一个函数sendKeys，它可以访问一个选中的元素，常用于输入文本到输入框这类元素中。

查看待办事项的详情页

我们应该能单击一个待办事项转到该待办事项的详情页，让我们用下面的测试实现它吧。

 

it("should be able to click on a todo on the homepage and get to the details page", () => {  
browser.get("/");  
let firstTodo = element.all(by.css(".todos .todo")).first();  
let firstTodoText = firstTodo.getText();  
firstTodo.click();  
let inputFieldText = element(by.css("todo input[type=text]")).getAttribute("value");  
expect(inputFieldText).toEqual(firstTodoText);  
}) 

删除一个待办事项

我们应该能删除一个待办事项。现在让我们试着删除一个待办事项看看能不能成功。

我们将转到待办事项页并单击删除链接，当我们返回主页时，我们能看到减少了一个待办事项。

 

it("should be able to delete a todo", () => {  
browser.get("/");  
let firstTodo = element.all(by.css(".todos .todo")).first();  
firstTodo.click();  
let deleteLink = element(by.cssContainingText("span", "Delete"));  
deleteLink.click();  
let todosList = element.all(by.css(".todos .todo"));  
expect(todosList.count()).toEqual(2);  
}) 

编辑一个待办事项的标题

我们能编辑待办事项的标题，保存后能在主页的待办事项列表中显示新标题。

 

it("should be able to edit a todo title", () => {  
browser.get("/");  
let firstTodo = element.all(by.css(".todos .todo")).first();  
firstTodo.click();  
let todoInputField = element(by.css("todo input[type=text]"));  
todoInputField.clear();  
todoInputField.sendKeys("Editted Todo1 Title");  
let saveButton = element(by.css("todo button[type=submit]"));  
saveButton.click();  
firstTodo = element.all(by.css(".todos .todo")).first();  
let firstTodoText = firstTodo.getText();  
expect(firstTodoText).toEqual("Editted Todo1 Title");  
}) 

不能保存空的待办事项

当我们想保存一个空的待办事项时，我们无法进行操作，并且单击禁用按钮时，待办事项列表依然保持同样的长度。

 

it("should not be able to save an empty todo", () => {  
browser.get("/");  
let newTodoInput = element(by.css(".add-todo input[type=text]"));  
let newTodoSubmitButton = element(by.css(".add-todo input[type=submit]"));  
newTodoSubmitButton.click();  
let todos = element.all(by.css(".todos .todo"));  
expect(todos.count()).toEqual(3);  
}) 

保存按钮在初始化时禁用

初始化时添加待办事项按钮被禁用，所以我们添加下列代码

it("should have add todo button be disabled initially", () => {  
browser.get("/");  
let newTodoSubmitButton = element(by.css(".add-todo input[type=submit]"));  
expect(newTodoSubmitButton.isEnabled()).toEqual(false);  
}) 

当我们开始输入时启用保存按钮

只用当我们开始输入待办事项标题时，待办事项保存按钮才被启用。

 

it("should only enable save todo button when we start typing a new todo title", () => {  
browser.get("/");  
let newTodoSubmitButton = element(by.css(".add-todo input[type=submit]"));  
let newTodoInputField = element(by.css(".add-todo input[type=text]"));  
newTodoInputField.sendKeys("New Todo 4");  
expect(newTodoSubmitButton.isEnabled()).toEqual(true); 
}) 

 

结论

现在，我们来总结一下 Angular2 的“端对端”测试。即使您没有任何的编程基础，也可以快速上手编写“端对端”测试。对于那些被引入代码库而又可能存在漏洞的部分，“端对端”测试是一个高效便捷的方法来捕获问题所在。

我们在概念部分中介绍了一些其他方法。您可以点击这里来浏览这些 Protractor API。并且可以在 GitHub repository 上找到这个应用的完整版和测试版。

我希望您看完这个介绍之后，在您修改任何一行代码之前都能兴奋的开始您的前端应用测试。如果您高兴，和我们交流一些您在日常测试中的高见。或者是您关于 Javascript 框架及 Angular2 的想法。感谢您的阅读。