angular-wdio-builder

Angular builder for running e2e test using webdriver.io runner.

Enables include wdio laucher into angular workspace (angular.json). Replaces protractor as e2e test framework.

Peer dependencies

- _@wdio/cli_

wdio client is not installed. You must install this package by yourself, among other related packages (@wdio/sinc, services, plugins, etc.)

Requirements

- @angular/cli >= @8.0.0

Usage

$3

npm install @migalons/angular-wdio-builder --save-dev

$3

For enabling your e2e test using angular builders, you just need to use this builder for running your e2e test:

``
{
"$schema": "./node_modules/@angular/cli/lib/config/schema.json",
"version": 1,
"newProjectRoot": "projects",
"projects": {
"my-awesome-project": {
...
"architect": {
...
"e2e": {
"builder": "@migalons/angular-wdio-builder:test",
"options": {
"wdioConfig": "e2e/wdio.conf.js",
"devServerTarget": "my-awesome-project:serve"
},
"configurations": {
"production": {
"wdioConfig": "e2e/wdio-prod.conf.js",
"devServerTarget": "my-awesome-project:serve:production"
},
"dev": {
"wdioOptions": {
"port": 4567 // whatever options accepted by wdio cli
}
"devServerTarget": "my-awesome-project:serve:production",
"port": 4201,
"host": "0.0.0.0",
"disableHostCheck: true"
}
}
}
}
}
...
}
``

This builders, accepts three parameters:

- wdioConfig: URL for wdio cli configuration (defaults to "./e2e/wdio.conf.js).
- wdioOptons: Custom options for overriding provided configuration (wdioConfig). See wdio cli options for more information.
- devServerTarget: Project target and configuration to be scheduled before running e2e test (i.e. serve app).
- port: Serve angular application using a custom port
- host: Host to listen on
- disableHostCheck: Don't verify connected clients are part of allowed hosts.

Example

You can find an example of a project with angular application with e2e test implemented using this builder for include wdio test into angular workspace here:

https://github.com/migalons/angular-wdio-builder-demo