preparing 0.6.3 release

Author: DavertMik

.gitignore

@@ -7,4 +7,6 @@ site
 docs/build
 test/data/output
 test/acceptance/output
-examples/output
+examples/output
+test/data/app/db
+test/data/sandbox/steps.d.ts

CHANGELOG.md

@@ -1,3 +1,18 @@
+## 0.6.3
+
+* Errors are printed in non-verbose mode. Shows "Selenium not started" and other important errors.
+* Allowed to set custom test options:
+
+```js
+Scenario('My scenario', { build_id: 123, type: 'slow' }, function (I)
+```
+those options can be accessed as `opts` property inside a `test` object. Can be used in custom listeners.
+
+* Added `docs` directory to a package.
+* [WebDriverIO][Protractor][SeleniumWebdriver] Bugfix: cleaning session when `restart: false` by @tfiwm [#519](https://github.com/Codeception/CodeceptJS/pull/519)
+* [WebDriverIO][Protractor][Nightmare] Added second parameter to `saveScreenshot` to allow a full page screenshot. By @HughZurname
+* Added suite object to `suite.before` and `suite.after` events by @implico. [#496](https://github.com/Codeception/CodeceptJS/pull/496)
+
 ## 0.6.2
 
 * Added `config` object to [public API](http://codecept.io/hooks/#api)

docs/hooks.md

@@ -190,6 +190,31 @@ Available events:
 
 For further reference look for [currently available listeners](https://github.com/Codeception/CodeceptJS/tree/master/lib/listener) using event system.
 
+#### Test Object
+
+Test events provide a test object with following fields:
+
+* `title` title of a test
+* `body` test function as a string
+* `opts` additional test options like retries, and others
+* `pending` true if test is scheduled for execution and false if a test has finished
+* `file` path to a file with a test.
+* `steps` array of executed steps (available only in `test.passed` or `test.failed` event)
+
+and others
+
+#### Step Object
+
+Step events provide step objects with following fields:
+
+* `name` name of a step, like 'see', 'click', and others
+* `actor` current actor, in most cases it `I`
+* `helper` current helper instance used to execute this step
+* `helperMethod` corresponding helper method, in most cases is the same as `name`
+* `status` status of a step (passed or failed)
+* `prefix` if a step is executed inside `within` block contain within text, like: 'Within .js-signup-form'.
+* `args` passed arguments
+
 ### Recorder
 
 To inject asynchronous functions in a test or before/after a test you can subscribe to corresponding event and register a function inside a recorder object. [Recorder](https://github.com/Codeception/CodeceptJS/blob/master/lib/recorder.js) represents a global promises chain.

examples/absolutenet_test.js

@@ -1,7 +1,8 @@
 'use strict';
 Feature('Testing Begins');
 
-Scenario('ANI testing', function*(I){
+// test with some demo params
+Scenario('ANI testing', { id: 123, user_id: 1235 }  ,function*(I){
   I.amOnPage('http://www.absolutenet.com/');
   let title = yield I.grabTitle();
   // console.info(title);

lib/listener/helpers.js

@@ -3,7 +3,7 @@
 const event = require('../event');
 const container = require('../container');
 const recorder = require('../recorder');
-const debug = require('../output').debug;
+const error = require('../output').error;
 
 /**
  * Enable Helpers to listen to test events
@@ -38,7 +38,7 @@ module.exports = function () {
 
   event.dispatcher.on(event.test.started, function (test) {
     runHelpersHook('_test', test);
-    recorder.catch((e) => debug(e));
+    recorder.catch((e) => error(e));
   });
 
   event.dispatcher.on(event.test.before, function () {
@@ -48,10 +48,10 @@ module.exports = function () {
   event.dispatcher.on(event.test.failed, function (test) {
     runAsyncHelpersHook('_failed', test, true);
     // should not fail test execution, so errors should be catched
-    recorder.catch((e) => debug(e));
+    recorder.catch((e) => error(e));
   });
 
-  event.dispatcher.on(event.test.after, function (test) {
+  event.dispatcher.on(event.test.after, function () {
     runAsyncHelpersHook('_after', {}, true);
   });
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Modern Era Aceptance Testing Framework for NodeJS",
   "homepage": "http://codecept.io",
   "repository": "Codeception/codeceptjs",
@@ -15,6 +15,7 @@
   },
   "files": [
     "bin",
+    "docs",
     "lib",
     "translations"
   ],