gulp-protractor-qa
Keeping end-to-end tests up-to-date can be really painful. Gulp Protractor QA warns you on the fly whether all element() selectors could be found or not within your application view files.
Because code changes should not break your tests!
How it works?
Screencast
TL;DR: a couple of new features and fixes have been added since this screencast publication.
Install
npm install --save-dev gulp-protractor-qa
Example
var gulp = ;var protractorQA = ;
Registering the task
gulp;
Running it
gulp;
See final gulpfile.js example.
API
protractorQA(options)
options
runOnce
Type: Boolean
Default: false
Optional: Set to true
when you want to control yourself when to run task.
In other words, it won't watch files changes.
testSrc
Type: String
or Array
Default: ""
Where the plugin should watch the changes in order to map all element()
indexes.
viewSrc
Type: String
or Array
Default: ""
Where your AngularJS view files are located. Protractor QA will watch the changes in those files to verify if all element()
selectors could be found.
Watched selectors by gulp-protractor-qa
Gulp-protractor-qa is currently watching the following element()
locators:
by.binding()
;by.model()
;by.repeater()
;by.css()
;by.id()
;by.className()
;by.name()
;
Note: currently it can't find by.css()
selectors with :nth-child()
.
Changelog
-
0.2.0 api completely rewritten, including:
- Introducing
runOnce
feature; - Ignoring commented out element selectors;
- Handle any form of denormalized directives - except
ng:*
due tocheerio
limitation; - Fix a couple of bugs related to
by.css
old regex; - Add suport for more protractor locators:
by.id()
,by.className()
andby.name()
.
- Introducing
-
0.1.19 improve
by.css
regex; -
0.1.18 bug fix: adding support for
data-*
attributes; -
0.1.14 showing "
<number>
out of<total>
element selectors are been watched" in the log; -
0.1.12 bug fix related to
gaze
version; -
0.1.10
testSrc
andviewSrc
now receivestring
orarray
value; -
0.1.07
- Improved the error log showing in which file each wrong selector came from;
- Improved the regex that find selectors by:
by.css('[attr-name="attr-value"]')
;
-
0.1.05
- Mapping more
element()
selectors:by.css('[attr-name="attr-value"]')
andby.binding()
; - Improve regex rules to support both:
protractor.By
andby.
; - Other code improvements;
- Mapping more
-
0.1.0 Mapping just two
element()
selectors:by.model()
andby.repeater()
.