Represent the screens of your web app as a series of objects. This ember-cli addon ease the construction of these objects on your acceptance tests.
An excerpt from the Selenium Wiki
Within your web app's UI there are areas that your tests interact with. A Page Object simply models these as objects within the test code. This reduces the amount of duplicated code and means that if the UI changes, the fix need only be applied in one place.
The pattern was first introduced by the Selenium
You can find more information about this design pattern here:
Install the npm package on your ember-cli project
npm install --save-dev ember-cli-page-objectthen import the page-object helper
import PO from '../page-object';The previous example assumes that your test file is one level deep under
tests/ folder. i.e. tests/acceptance/my-acceptance-test.js.
Then you can start building your page objects as follows:
var login = PO.build({
visit: PO.visitable('/login'),
userName: PO.fillable('#username'),
password: PO.fillable('#password'),
submit: PO.clickable('#login'),
errorMessage: PO.text('.message')
});
test('Invalid log in', function(assert) {
login
.visit()
.userName('[email protected]')
.password('secret')
.submit();
andThen(function() {
assert.equal(login.errorMessage(), 'Invalid credentials!');
});
});Built-in support for defining tables and collections:
<table id="users">
<tr>
<td>Jane</td>
<td>Doe</td>
</tr>
<tr>
<td>John</td>
<td>Doe</td>
</tr>
</table>var page = PO.build({
visit: PO.visitable('/users'),
users: PO.collection({
itemScope: '#users tr',
item: {
firstName: PO.text('td:nth-of-type(1)'),
lastName: PO.text('td:nth-of-type(2)')
}
})
});
test('show all users', function(assert) {
page.visit();
andThen(function() {
assert.equal(page.users().count(), 2);
assert.equal(page.users(1).firstName(), 'Jane');
assert.equal(page.users(1).lastName(), 'Doe');
assert.equal(page.users(2).firstName(), 'John');
assert.equal(page.users(2).lastName(), 'Doe');
});
});You can use ES6 destructuring to declutter even more your page definition:
var { visitable, collection, text } = PO;
var page = PO.build({
visit: visitable('/users'),
users: collection({
itemScope: '#users tr',
item: {
firstName: text('td:nth-of-type(1)'),
lastName: text('td:nth-of-type(2)')
}
})
});Check the full DOCUMENTATION for more information.
The addon includes the following blueprints
| Name | Description |
|---|---|
page-object |
Creates a new page object under tests/pages folder |
page-object-component |
Creates a new a component object to be used on a page object under tests/pages/components folder. |
page-object-helper |
Creates a new a helper object to be used on a page object under tests/pages/helpers folder. |
You can create a new page object called users using the generate command
$ ember generate page-object users
installing
create tests/pages/users.jsA new file will be generated under tests/pages folder and can be included on
an acceptance test like follows
import Ember from 'ember';
import { module, test } from 'qunit';
import startApp from '../helpers/start-app';
import page from '../pages/users';
var application;
module('Acceptance: UserList', {
beforeEach: function() {
application = startApp();
},
afterEach: function() {
Ember.run(application, 'destroy');
}
});
test('visiting /users', function(assert) {
page.visit();
andThen(function() {
assert.equal(currentPath(), 'users');
});
});git clonethis repositorynpm installbower install
ember server- Visit your app at http://localhost:4200.
ember testember test --server
ember build
ember-cli-page-object is licensed under the MIT license.
See LICENSE for the full license text.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent