@serenity-js/webdriverio 3.10.0 → 3.10.2

package/CHANGELOG.md

@@ -3,6 +3,29 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.10.2](https://github.com/serenity-js/serenity-js/compare/v3.10.1...v3.10.2) (2023-09-10)
+
+
+### Bug Fixes
+
+* **core:** updated installation instruction in the README ([ec3f277](https://github.com/serenity-js/serenity-js/commit/ec3f2778334abbd7324497ceaa2df9f0560a103e)), closes [#1915](https://github.com/serenity-js/serenity-js/issues/1915)
+
+
+
+
+
+## [3.10.1](https://github.com/serenity-js/serenity-js/compare/v3.10.0...v3.10.1) (2023-09-01)
+
+
+### Bug Fixes
+
+* **core:** use module: es2020 instead of Node16 to avoid issue nrwl/nx[#18801](https://github.com/serenity-js/serenity-js/issues/18801) ([935e655](https://github.com/serenity-js/serenity-js/commit/935e655a9a707ed8c97797e8b1bfab4e806c984c))
+* **webdriverio:** use Node16 module loader ([105be09](https://github.com/serenity-js/serenity-js/commit/105be094af2050e6ec3ae4dbb9768b8d372a5cef))
+
+
+
+
+
 # [3.10.0](https://github.com/serenity-js/serenity-js/compare/v3.9.1...v3.10.0) (2023-08-23)
 
 

package/README.md

@@ -9,9 +9,10 @@
 of complex software systems faster, more collaborative and easier to scale.
 
 ⭐️ Get started with Serenity/JS!
-- [Serenity/JS Handbook](https://serenity-js.org/handbook) and [tutorial](https://serenity-js.org/handbook/web-testing/your-first-web-scenario),
-- [API documentation](https://serenity-js.org/api/core), 
-- [Serenity/JS project templates on GitHub](https://serenity-js.org/handbook/getting-started#serenityjs-project-templates).
+- [Serenity/JS web testing tutorial](https://serenity-js.org/handbook/web-testing/your-first-web-scenario)
+- [Serenity/JS Handbook](https://serenity-js.org/handbook) and [Getting Started guides](https://serenity-js.org/handbook/getting-started/)
+- [API documentation](https://serenity-js.org/api/core)
+- [Serenity/JS Project Templates on GitHub](https://serenity-js.org/handbook/getting-started#serenityjs-project-templates)
 
 👋 Join the Serenity/JS Community!
 - Meet other Serenity/JS developers and maintainers on the [Serenity/JS Community chat channel](https://matrix.to/#/#serenity-js:gitter.im),
@@ -26,13 +27,19 @@ for [WebdriverIO](https://webdriver.io/) that will help you with testing Web and
 
 ### Installation
 
-To install this module, run the following command in your [WebdriverIO project directory](https://webdriver.io/docs/gettingstarted/):
+To install this module, use an [existing WebdriverIO project](https://webdriver.io/docs/gettingstarted/) or generate a new one by running:
 
-```bash
-npm install --save-dev @serenity-js/{assertions,console-reporter,core,serenity-bdd,web,webdriverio}
+```sh
+npm init wdio .
 ```
 
-Next, install a [Serenity/JS test runner adapter](https://serenity-js.org/handbook/test-runners/) appropriate for your preferred test runner.
+Install the below Serenity/JS modules in your WebdriverIO project directory:
+
+```sh
+npm install --save-dev @serenity-js/assertions @serenity-js/console-reporter @serenity-js/core @serenity-js/serenity-bdd @serenity-js/web @serenity-js/webdriverio
+```
+
+To learn more about Serenity/JS and how to use it on your project, follow the [Serenity/JS Getting Started guide fpr WebdriverIO](https://serenity-js.org/handbook/getting-started/serenity-js-with-webdriverio/).
 
 #### Usage with Cucumber.js
 
@@ -123,7 +130,7 @@ export const config: WebdriverIOConfig = {
     // ],
 
     // ... other WebdriverIO-specific configuration   
-};
+}
 ```
 
 Learn more about:
@@ -144,10 +151,10 @@ with a custom [`Cast`](https://serenity-js.org/api/core/class/Cast), like this o
 
 ```typescript title="serenity/Actors.ts"
 // serenity/Actors.ts
-import { Actor, Cast, TakeNotes } from '@serenity-js/core';
-import { CallAnApi } from '@serenity-js/rest';
-import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio';
-import type { Browser } from 'webdriverio';
+import { Actor, Cast, TakeNotes } from '@serenity-js/core'
+import { CallAnApi } from '@serenity-js/rest'
+import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio'
+import type { Browser } from 'webdriverio'
 
 export class Actors implements Cast {
 
@@ -162,13 +169,13 @@ export class Actors implements Cast {
             case 'Apisitt':
                 return actor.whoCan(
                     CallAnApi.at(this.apiUrl)
-                );
+                )
                 
             default:
                 return actor.whoCan(
                     BrowseTheWebWithWebdriverIO.using(browser), // global WDIO browser
                     TakeNotes.usingAnEmptyNotepad(),
-                );
+                )
         }
 
     }
@@ -179,16 +186,16 @@ export class Actors implements Cast {
 
 ```typescript title="specs/example.spec.ts"
 // specs/example.spec.ts
-import { actorCalled } from '@serenity-js/core';
-import { Ensure, equals } from '@serenity-js/assertions';
-import { By, Navigate, PageElement, Text } from '@serenity-js/web';
-import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio';
+import { actorCalled } from '@serenity-js/core'
+import { Ensure, equals } from '@serenity-js/assertions'
+import { By, Navigate, PageElement, Text } from '@serenity-js/web'
+import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio'
 
 // example Lean Page Object describing a widget we interact with in the test
 class SerenityJSWebsite {
     static header = () =>
         PageElement.located(By.css('h1'))   // selector to identify the interactable element
-            .describedAs('header');         // description to be used in reports
+            .describedAs('header')          // description to be used in reports
 }
 
 describe('Serenity/JS', () => {
@@ -204,8 +211,8 @@ describe('Serenity/JS', () => {
                     equals('Enable collaborative test automation at any scale!')
                 ),
             )
-    });
-});
+    })
+})
 ```
 
 To learn more, check out the [example projects](https://github.com/serenity-js/serenity-js/tree/main/examples).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/webdriverio",
-  "version": "3.10.0",
+  "version": "3.10.2",
   "description": "Serenity/JS reporter and Screenplay Pattern library for WebdriverIO",
   "author": {
     "name": "Jan Molak",
@@ -64,9 +64,9 @@
     "node": "^16.13 || ^18.12 || ^20"
   },
   "dependencies": {
-    "@serenity-js/core": "3.10.0",
-    "@serenity-js/web": "3.10.0",
-    "@wdio/reporter": "8.15.6",
+    "@serenity-js/core": "3.10.2",
+    "@serenity-js/web": "3.10.2",
+    "@wdio/reporter": "8.15.10",
     "deepmerge": "^4.3.1",
     "tiny-types": "^1.20.0"
   },
@@ -74,8 +74,8 @@
     "@serenity-js/cucumber": "^3.0.0",
     "@serenity-js/jasmine": "^3.0.0",
     "@serenity-js/mocha": "^3.0.0",
-    "@wdio/cli": "^8.15.6",
-    "webdriverio": "^8.15.6"
+    "@wdio/cli": "^8.15.10",
+    "webdriverio": "^8.15.10"
   },
   "peerDependenciesMeta": {
     "@serenity-js/cucumber": {
@@ -91,13 +91,13 @@
   "devDependencies": {
     "@integration/testing-tools": "3.0.0",
     "@types/mocha": "^10.0.1",
-    "@wdio/cli": "8.15.6",
-    "@wdio/devtools-service": "8.15.6",
-    "@wdio/dot-reporter": "8.15.6",
-    "@wdio/local-runner": "8.15.6",
-    "@wdio/spec-reporter": "8.15.6",
-    "@wdio/types": "8.15.0",
-    "axios": "^1.4.0",
+    "@wdio/cli": "8.15.10",
+    "@wdio/devtools-service": "8.15.10",
+    "@wdio/dot-reporter": "8.15.10",
+    "@wdio/local-runner": "8.15.10",
+    "@wdio/spec-reporter": "8.15.10",
+    "@wdio/types": "8.15.10",
+    "axios": "^1.5.0",
     "c8": "8.0.1",
     "cross-env": "^7.0.3",
     "mocha": "^10.2.0",
@@ -105,7 +105,7 @@
     "mocha-testdata": "^1.2.0",
     "puppeteer-core": "^20.9.0",
     "start-server-and-test": "^2.0.0",
-    "webdriverio": "8.15.6"
+    "webdriverio": "8.15.10"
   },
-  "gitHead": "06ae5d8a702be0be2890e989c120715c32f6578a"
+  "gitHead": "6834827fffe5dd8dd3d2f39d2fea2c4039ab1d3d"
 }