Breaking changes

• Drop support for Node 0.6 to allow updating dependencies.

Minor changes

• Update all dependencies.

Breaking changes

An upgrade guide (with partial automation) is available to help you update your tests through breaking changes.

• Renamed following concepts (#116):
  • Feature to Scenario.
  • Scenario to Steps (inside a feature/scenario)
  • Flow to Verbose.
  • Data to Fixture.
  • Hook to Locator.
  • Widget to Component.

Backward compatibility is kept for this version, but support for previous names is deprecated and will be removed in a later version. Feedback on these names welcome.

Minor changes

• Added compatibility with NPM 3.
• Update documentation generation tool from JSdoc 2 to JSdoc 3.

Installing

npm install --global watai@0.7.0

If you can't npm install, use the archive below.

New features

• ignore config option has been added (#111, thanks @debona).
• SauceLabs view is now available, transmitting test status as pass/fail and outputting a direct link to the job as well as an estimate of how many minutes are left on your account (#87).

Minor changes

• Upgraded obsolete object getters and setters syntax (#107).
• Updated wd to v0.2.6. Some incompatibilities were introduced in v0.2.2. They are in advanced monkeypatching usage, you probably didn't do any with Watai.
• Added an editorconfig file to help contributors (#118, thanks @gillesfabio).
• Added jscs to unify syntax and guide contributors (#119, thanks @gillesfabio).

Bugfixes

• Errors appearing on suite load are now visible (#112, thanks @debona).

Installing

npm install --global watai@0.6.2

Minor changes

• Async configuration entries can now use a promise instead of a callback. This allows for async errors to be detected.
• Improve display of unknown errors.
• Important improvements in development tools.
• Use native Q's long stack traces instead of longjohn module.

Installing

npm install --global watai@0.6.1

If you can't npm install, use the archive below.

New features

• Automatic file upload support: if you set a file field to a local file path, the file will be sent to the Selenium server, making test assets available anywhere automatically.
• Add support for (async) functions in configuration.
• Add bail config key: if set to true, stops a test after the first failing feature.
• Almost all errors now have a proper description (server not reachable, elements not found in state assertions, widget actions failures…).
• Authentication data is now taken from seleniumServerURL, allowing distant services such as SauceLabs to be used.
• Metadata fields name, tags and build are now parsed in config files and sent to the Selenium server.
• There is now a default hook type: css (#92). If you target an element with only a String, it will be considered as a CSS selector.

Breaking changes

An upgrade guide is available to help you update your tests through breaking changes.

• Widgets' elements and actions are now declared in a single hash (#94). Your existing Widgets will need to have their elements key removed.
• Widgets and Features don't need an enclosing curly braces anymore (#91). Your existing Widgets and Features will need to have their enclosing curly braces removed.
• Textual content matches against Strings or RegExps only, not Numbers anymore (reserving for later use) nor any other Object (preventing errors).
• Runner.driverInit event is not fired anymore. API clients should use the Runner.start event instead.
• Runner.restart event is not fired anymore. API clients should use the Runner.start event instead.

Minor changes

• Switch to WD as the underlying library (#89).
• Growl view gives much more details.
• Explicit setters (set<ElementName>) now have precedence over magic setters.
• --installed exits with 1 instead of 3 if Watai is not installed properly.

Bugfixes

• Compatibility with Node 0.10 has improved (#90).

Installing

npm install --global watai@0.6.0

If you can't npm install, use the archive below.

New features

• Config may be set through (a)sync functions.

Minor changes

• Q promises updated to 0.9.6, bringing many new possibilities for API clients.

Installing

npm install --global watai@0.5.2

If you can't npm install, use the archive below.

New features

• Add a --config option to override config at run time.
• Add a --setup option to override setup at run time.
• URLs in config (base, selenium) may be provided as URL objects instead of pure strings, allowing for specific overrides. Compatibility with strings is still offered, and will be maintained.
• Add a browser config shortcut with usual defaults for desiredCapabilities.
• Default view now includes "Instafail".

Minor changes

• Failure reports now give the exact spent time, not the expected timeout.
• Setup options are now loaded from setup files. This is not considered breaking since loading them from config never worked.
• Minor visual improvements to the Flow view.

Bugfixes

• Fix default config values not being loaded in some cases.

Installing

npm install watai@0.5.1

New features

• Add "Flow" view, a more detailed step-by-step view of all actions, non-interactive for compatibility with headless environments.
• Add "PageDump" view: if activated, a failure in the first feature will trigger a page source dump. Useful in headless environments.
• Report failures in real-time.
• Show feature ID for easier identification.
• Warn when no features are found in a suite.
• Add magic for "Option" elements.

Breaking changes

• Only one suite may be loaded at a time, no more CLI varargs.

Minor changes

• Much improved tests speed.
• "test" is now a valid suite name.
• Remove the need for log-level config tweaking.
• Made magic methods much more resilient.
• Correct a minor Dots view summary phrasing inconsistency.
• Improve missing elements tests performance.

Installing

npm install watai@0.5.0

New features

• Add 'Instafail' view.

Minor changes

• Improve CLI animator and view management system.

Installing

npm install watai@0.4.5

Minor changes

• Prevent magically-added shortcuts from being referenced in state assertions by mistake.

Installing

npm install watai@0.4.4