latte-pageobject
v1.0.2
Published
Create your page objects with a fluid, creamy and delicious BDD-like API for browser automation.
Downloads
6
Readme
Latte Page Object
A small library to allow creating your page objects with a fluid, creamy and delicious BDD-like API with the ability to
add crunchy
properties that adds special personal flavour to your page objects for browser automation tests.
Installation
npm install latte-pageobject --save
Usage
Your test could be implemented like the following example:
pageObject.on.childPageObject
.and.on.grandChildPageObject
.given.somePrecondition()
.and.otherPrecondition()
.(*)
.when.userDoesSomething()
.and.doesSomethingElse()
.(*)
.then.itShouldHaveHappenedAThing()
.and.itShouldHaveHappenedAnotherThing()
.(*)
To achieve such API, one can have the following API mold:
var api = {
// The standard ingredients of the Latte PageObject
on: {
grandChildPageObject: grandChildPageObject
},
given: {
somePrecondition: function () {
createPrecondition();
return this;
},
otherPrecondition: function () {
createOtherPrecondition();
return this;
}
},
when: {
userDoesSomething: function () {
createPrecondition();
return this;
},
doesSomethingElse: function () {
createOtherPrecondition();
return this;
}
},
then: {
itShouldHaveHappenedAThing: function () {
createPrecondition();
return this;
},
itShouldHaveHappenedAnotherThing: function () {
createOtherPrecondition();
return this;
}
},
// The `crunchy` parts of the API, where you can add getters, or any other flavour to your Latte. But like any other hot, creamy drink, you should be moderate adding this sprinkles to your drink
getSomeMeaningValueFromMyPageObject: function () {
return something;
}
}
latte.makeIt(api, [parentPageObject, anotherParentPageObject]);
Tests
npm test
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.
Release History
- 1.0.1 Bug fixing
- 1.0.0 Initial release