@serenity-js/web 3.0.0-rc.42 → 3.0.0-rc.44

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.0.0-rc.44](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.43...v3.0.0-rc.44) (2023-03-19)
+
+
+### Bug Fixes
+
+* **core:** support for NPM 9 ([0493474](https://github.com/serenity-js/serenity-js/commit/0493474a1e28b86b1b60f69ec0d591c1a3265425))
+* **deps:** update dependency tiny-types to ^1.19.1 ([ce335eb](https://github.com/serenity-js/serenity-js/commit/ce335ebca434d1fd0e6e809a65a0882fd10a311a))
+
+
+
+
+
+# [3.0.0-rc.43](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.42...v3.0.0-rc.43) (2023-03-10)
+
+**Note:** Version bump only for package @serenity-js/web
+
+
+
+
+
 # [3.0.0-rc.42](https://github.com/serenity-js/serenity-js/compare/v3.0.0-rc.41...v3.0.0-rc.42) (2023-02-12)
 
 **Note:** Version bump only for package @serenity-js/web

package/README.md

@@ -1,5 +1,10 @@
 # Serenity/JS
 
+[![Follow Serenity/JS on LinkedIn](https://img.shields.io/badge/Follow-Serenity%2FJS%20-0077B5?logo=linkedin)](https://www.linkedin.com/company/serenity-js)
+[![Watch Serenity/JS on YouTube](https://img.shields.io/badge/Watch-@serenity--js-E62117?logo=youtube)](https://www.youtube.com/@serenity-js)
+[![Join Serenity/JS Community Chat](https://img.shields.io/badge/Chat-Serenity%2FJS%20Community-FBD30B?logo=matrix)](https://matrix.to/#/#serenity-js:gitter.im)
+[![Support Serenity/JS on GitHub](https://img.shields.io/badge/Support-@serenity--js-703EC8?logo=github)](https://matrix.to/#/#serenity-js:gitter.im)
+
 [Serenity/JS](https://serenity-js.org) is a framework designed to make acceptance and regression testing
 of modern full-stack applications faster, more collaborative and easier to scale.
 
@@ -10,7 +15,7 @@ and [API docs](https://serenity-js.org/modules/), and follow [@SerenityJS](https
 
 To learn more about Serenity/JS, check out the video below, read the [tutorial](https://serenity-js.org/handbook/thinking-in-serenity-js/index.html), review the [examples](https://github.com/serenity-js/serenity-js/tree/main/examples), and create your own test suite with [Serenity/JS template projects](https://github.com/serenity-js).
 
-If you have any questions, join us on [Serenity/JS Community Chat](https://gitter.im/serenity-js/Lobby).
+If you have any questions, join us on the [Serenity/JS Community Chat](https://matrix.to/#/#serenity-js:gitter.im).
 
 [![Full-Stack Acceptance Testing with Serenity/JS and the Screenplay Pattern](https://img.youtube.com/vi/djPMf-n93Rw/0.jpg)](https://www.youtube.com/watch?v=djPMf-n93Rw)
 

package/lib/screenplay/abilities/BrowseTheWeb.d.ts

@@ -16,7 +16,7 @@ import { BrowserCapabilities, BrowsingSession, Page } from '../models';
  * ## Giving the actors an ability to `BrowseTheWeb`
  *
  * To give an {@apilink Actor|actor} an ability to `BrowseTheWeb`, provide the **integration tool-specific implementation**
- * via {@apilink Actor.whoCan} in {@apilink Cast.prepare}, or via {@apilink Cast.whereEveryoneCan}.
+ * via {@apilink Actor.whoCan} in {@apilink Cast.prepare}, or via {@apilink Cast.where}.
  *
  * ```ts
  * import { beforeEach } from 'mocha'
@@ -71,7 +71,7 @@ import { BrowserCapabilities, BrowsingSession, Page } from '../models';
  *
  * - {@apilink Ability}
  * - {@apilink Actor.whoCan}
- * - {@apilink Cast.whereEveryoneCan}
+ * - {@apilink Cast.where}
  * - {@apilink Cast.prepare}
  *
  * @group Abilities

package/lib/screenplay/abilities/BrowseTheWeb.js

@@ -18,7 +18,7 @@ const core_1 = require("@serenity-js/core");
  * ## Giving the actors an ability to `BrowseTheWeb`
  *
  * To give an {@apilink Actor|actor} an ability to `BrowseTheWeb`, provide the **integration tool-specific implementation**
- * via {@apilink Actor.whoCan} in {@apilink Cast.prepare}, or via {@apilink Cast.whereEveryoneCan}.
+ * via {@apilink Actor.whoCan} in {@apilink Cast.prepare}, or via {@apilink Cast.where}.
  *
  * ```ts
  * import { beforeEach } from 'mocha'
@@ -73,7 +73,7 @@ const core_1 = require("@serenity-js/core");
  *
  * - {@apilink Ability}
  * - {@apilink Actor.whoCan}
- * - {@apilink Cast.whereEveryoneCan}
+ * - {@apilink Cast.where}
  * - {@apilink Cast.prepare}
  *
  * @group Abilities

package/lib/screenplay/interactions/Clear.d.ts

@@ -50,7 +50,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink Value}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Clear extends PageElementInteraction {
     private readonly field;

package/lib/screenplay/interactions/Clear.js

@@ -52,7 +52,7 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  * - {@apilink Value}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class Clear extends PageElementInteraction_1.PageElementInteraction {
     /**

package/lib/screenplay/interactions/Click.d.ts

@@ -44,7 +44,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Click extends PageElementInteraction {
     private readonly element;

package/lib/screenplay/interactions/Click.js

@@ -46,7 +46,7 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class Click extends PageElementInteraction_1.PageElementInteraction {
     /**

package/lib/screenplay/interactions/DoubleClick.d.ts

@@ -67,7 +67,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class DoubleClick extends PageElementInteraction {
     private readonly pageElement;

package/lib/screenplay/interactions/DoubleClick.js

@@ -69,7 +69,7 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class DoubleClick extends PageElementInteraction_1.PageElementInteraction {
     /**

package/lib/screenplay/interactions/Enter.d.ts

@@ -41,7 +41,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Enter extends PageElementInteraction {
     private readonly values;

package/lib/screenplay/interactions/Enter.js

@@ -44,7 +44,7 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class Enter extends PageElementInteraction_1.PageElementInteraction {
     /**

package/lib/screenplay/interactions/ExecuteScript.d.ts

@@ -8,7 +8,7 @@ import { Answerable, AnswersQuestions, CollectsArtifacts, Interaction, UsesAbili
  * - {@apilink BrowseTheWeb}
  * - {@apilink LastScriptExecution.result}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class ExecuteScript {
     /**
@@ -179,7 +179,7 @@ export declare class ExecuteScript {
  * ## Learn more
  * -  {@apilink ExecuteScript}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare abstract class ExecuteScriptWithArguments extends Interaction {
     protected readonly script: string | Function;

package/lib/screenplay/interactions/ExecuteScript.js

@@ -14,7 +14,7 @@ const abilities_1 = require("../abilities");
  * - {@apilink BrowseTheWeb}
  * - {@apilink LastScriptExecution.result}
  *
- * @group Interactions
+ * @group Activities
  */
 class ExecuteScript {
     /**
@@ -192,7 +192,7 @@ exports.ExecuteScript = ExecuteScript;
  * ## Learn more
  * -  {@apilink ExecuteScript}
  *
- * @group Interactions
+ * @group Activities
  */
 class ExecuteScriptWithArguments extends core_1.Interaction {
     constructor(description, script, // eslint-disable-line @typescript-eslint/ban-types

package/lib/screenplay/interactions/Hover.d.ts

@@ -48,7 +48,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Hover extends PageElementInteraction {
     private readonly element;

package/lib/screenplay/interactions/Hover.js

@@ -50,7 +50,7 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class Hover extends PageElementInteraction_1.PageElementInteraction {
     /**

package/lib/screenplay/interactions/Navigate.d.ts

@@ -8,7 +8,7 @@ import { Answerable, Interaction } from '@serenity-js/core';
  *
  * - {@apilink BrowseTheWeb}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Navigate {
     /**

package/lib/screenplay/interactions/Navigate.js

@@ -12,7 +12,7 @@ const abilities_1 = require("../abilities");
  *
  * - {@apilink BrowseTheWeb}
  *
- * @group Interactions
+ * @group Activities
  */
 class Navigate {
     /**

package/lib/screenplay/interactions/PageElementInteraction.d.ts

@@ -7,7 +7,7 @@ import { PageElement } from '../models';
  * **Note:** The recommended way to implement custom interactions
  * in your code is to use the {@apilink Interaction.where} factory method.
  *
- * @group Interactions
+ * @group Activities
  */
 export declare abstract class PageElementInteraction extends Interaction {
     protected constructor(description: string, location?: FileSystemLocation);

package/lib/screenplay/interactions/PageElementInteraction.js

@@ -8,7 +8,7 @@ const core_1 = require("@serenity-js/core");
  * **Note:** The recommended way to implement custom interactions
  * in your code is to use the {@apilink Interaction.where} factory method.
  *
- * @group Interactions
+ * @group Activities
  */
 class PageElementInteraction extends core_1.Interaction {
     constructor(description, location = core_1.Interaction.callerLocation(4)) {

package/lib/screenplay/interactions/Press.d.ts

@@ -53,7 +53,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Press extends PageElementInteraction {
     private readonly keys;

package/lib/screenplay/interactions/Press.js

@@ -58,7 +58,7 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class Press extends PageElementInteraction_1.PageElementInteraction {
     /**

package/lib/screenplay/interactions/RightClick.d.ts

@@ -63,7 +63,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class RightClick extends PageElementInteraction {
     private readonly pageElement;

package/lib/screenplay/interactions/RightClick.js

@@ -65,7 +65,7 @@ const PageElementInteraction_1 = require("./PageElementInteraction");
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class RightClick extends PageElementInteraction_1.PageElementInteraction {
     /**

package/lib/screenplay/interactions/Scroll.d.ts

@@ -45,7 +45,7 @@ import { PageElement } from '../models';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Scroll extends Interaction {
     private readonly element;

package/lib/screenplay/interactions/Scroll.js

@@ -47,7 +47,7 @@ const core_1 = require("@serenity-js/core");
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 class Scroll extends core_1.Interaction {
     /**

package/lib/screenplay/interactions/Select.d.ts

@@ -9,7 +9,7 @@ import { PageElement } from '../models';
  * ## Learn more
  * - {@apilink Selected}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Select {
     /**

package/lib/screenplay/interactions/Select.js

@@ -14,7 +14,7 @@ const models_1 = require("../models");
  * ## Learn more
  * - {@apilink Selected}
  *
- * @group Interactions
+ * @group Activities
  */
 class Select {
     /**

package/lib/screenplay/interactions/Switch.d.ts

@@ -96,7 +96,7 @@ import { Switchable } from '../models';
  * - {@apilink Switchable}
  * - {@apilink SwitchableOrigin}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class Switch extends Interaction {
     private readonly switchable;

package/lib/screenplay/interactions/Switch.js

@@ -98,7 +98,7 @@ const core_1 = require("@serenity-js/core");
  * - {@apilink Switchable}
  * - {@apilink SwitchableOrigin}
  *
- * @group Interactions
+ * @group Activities
  */
 class Switch extends core_1.Interaction {
     /**

package/lib/screenplay/interactions/TakeScreenshot.d.ts

@@ -25,7 +25,7 @@ import { Answerable, AnswersQuestions, CollectsArtifacts, Interaction, UsesAbili
  * - {@apilink Artifact}
  * - {@apilink ArtifactArchiver}
  *
- * @group Interactions
+ * @group Activities
  */
 export declare class TakeScreenshot extends Interaction {
     private readonly name;

package/lib/screenplay/interactions/TakeScreenshot.js

@@ -30,7 +30,7 @@ const abilities_1 = require("../abilities");
  * - {@apilink Artifact}
  * - {@apilink ArtifactArchiver}
  *
- * @group Interactions
+ * @group Activities
  */
 class TakeScreenshot extends core_1.Interaction {
     /**

package/lib/scripts/isVisible.js

@@ -31,14 +31,14 @@ function isVisible(domNode) {
     // applicable if element's text is multiline.
     function getOverlappingRects(element, context) {
         context = context || document;
-        const elems = [];
+        const elements = [];
         const rects = element.getClientRects();
         // webdriver clicks on center of the first element's rect (line of text), it might change in future
         const rect = rects[0];
         const x = rect.left + (rect.width / 2);
         const y = rect.top + (rect.height / 2);
-        elems.push(context.elementFromPoint(x, y));
-        return elems;
+        elements.push(context.elementFromPoint(x, y));
+        return elements;
     }
     // get overlapping elements
     function getOverlappingElements(element, context) {

package/lib/scripts/isVisible.js.map

@@ -1 +1 @@
-{"version":3,"file":"isVisible.js","sourceRoot":"","sources":["../../src/scripts/isVisible.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"isVisible.js","sourceRoot":"","sources":["../../src/scripts/isVisible.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/web",
-  "version": "3.0.0-rc.42",
+  "version": "3.0.0-rc.44",
   "description": "Serenity/JS Screenplay Pattern APIs for the Web",
   "author": {
     "name": "Jan Molak",
@@ -27,7 +27,7 @@
     "web"
   ],
   "scripts": {
-    "clean": "rimraf '../../target/coverage/web'",
+    "clean": "rimraf target",
     "test": "nyc mocha --config ../../.mocharc.yml 'spec/**/*.spec.*'",
     "compile": "rimraf lib && tsc --project tsconfig.build.json"
   },
@@ -41,21 +41,22 @@
   },
   "engines": {
     "node": "^14 || ^16 || ^18",
-    "npm": "^6 || ^7 || ^8"
+    "npm": "^6 || ^7 || ^8 || ^9"
   },
   "dependencies": {
-    "@serenity-js/assertions": "3.0.0-rc.42",
-    "@serenity-js/core": "3.0.0-rc.42",
-    "tiny-types": "^1.19.0"
+    "@serenity-js/assertions": "3.0.0-rc.44",
+    "@serenity-js/core": "3.0.0-rc.44",
+    "tiny-types": "^1.19.1"
   },
   "devDependencies": {
     "@integration/testing-tools": "3.0.0",
     "@types/chai": "^4.3.4",
     "@types/mocha": "^10.0.1",
     "mocha": "^10.2.0",
+    "mocha-multi": "^1.1.7",
     "nyc": "15.1.0",
     "ts-node": "^10.9.1",
     "typescript": "^4.9.5"
   },
-  "gitHead": "ebe1ca57bb98f09bc4554f32e87f44a0dbce2c22"
+  "gitHead": "be0c603085f922841e8050f1c50103b7eef7fdc0"
 }

package/src/screenplay/abilities/BrowseTheWeb.ts

@@ -18,7 +18,7 @@ import { BrowserCapabilities, BrowsingSession, Page } from '../models';
  * ## Giving the actors an ability to `BrowseTheWeb`
  *
  * To give an {@apilink Actor|actor} an ability to `BrowseTheWeb`, provide the **integration tool-specific implementation**
- * via {@apilink Actor.whoCan} in {@apilink Cast.prepare}, or via {@apilink Cast.whereEveryoneCan}.
+ * via {@apilink Actor.whoCan} in {@apilink Cast.prepare}, or via {@apilink Cast.where}.
  *
  * ```ts
  * import { beforeEach } from 'mocha'
@@ -73,7 +73,7 @@ import { BrowserCapabilities, BrowsingSession, Page } from '../models';
  *
  * - {@apilink Ability}
  * - {@apilink Actor.whoCan}
- * - {@apilink Cast.whereEveryoneCan}
+ * - {@apilink Cast.where}
  * - {@apilink Cast.prepare}
  *
  * @group Abilities

package/src/screenplay/interactions/Clear.ts

@@ -52,7 +52,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink Value}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Clear extends PageElementInteraction {
 

package/src/screenplay/interactions/Click.ts

@@ -46,7 +46,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Click extends PageElementInteraction {
 

package/src/screenplay/interactions/DoubleClick.ts

@@ -69,7 +69,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class DoubleClick extends PageElementInteraction {
 

package/src/screenplay/interactions/Enter.ts

@@ -44,7 +44,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Enter extends PageElementInteraction {
 

package/src/screenplay/interactions/ExecuteScript.ts

@@ -13,7 +13,7 @@ import { BrowseTheWeb } from '../abilities';
  * - {@apilink BrowseTheWeb}
  * - {@apilink LastScriptExecution.result}
  *
- * @group Interactions
+ * @group Activities
  */
 export class ExecuteScript {
 
@@ -200,7 +200,7 @@ export class ExecuteScript {
  * ## Learn more
  * -  {@apilink ExecuteScript}
  *
- * @group Interactions
+ * @group Activities
  */
 export abstract class ExecuteScriptWithArguments extends Interaction {
 

package/src/screenplay/interactions/Hover.ts

@@ -50,7 +50,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Hover extends PageElementInteraction {
 

package/src/screenplay/interactions/Navigate.ts

@@ -11,7 +11,7 @@ import { BrowseTheWeb } from '../abilities';
  *
  * - {@apilink BrowseTheWeb}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Navigate {
 

package/src/screenplay/interactions/PageElementInteraction.ts

@@ -9,7 +9,7 @@ import { PageElement } from '../models';
  * **Note:** The recommended way to implement custom interactions
  * in your code is to use the {@apilink Interaction.where} factory method.
  *
- * @group Interactions
+ * @group Activities
  */
 export abstract class PageElementInteraction extends Interaction {
 

package/src/screenplay/interactions/Press.ts

@@ -57,7 +57,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Press extends PageElementInteraction {
 

package/src/screenplay/interactions/RightClick.ts

@@ -65,7 +65,7 @@ import { PageElementInteraction } from './PageElementInteraction';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class RightClick extends PageElementInteraction {
     /**

package/src/screenplay/interactions/Scroll.ts

@@ -47,7 +47,7 @@ import { PageElement } from '../models';
  * - {@apilink BrowseTheWeb}
  * - {@apilink PageElement}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Scroll extends Interaction {
 

package/src/screenplay/interactions/Select.ts

@@ -13,7 +13,7 @@ import { PageElement, SelectOption } from '../models';
  * ## Learn more
  * - {@apilink Selected}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Select {
 

package/src/screenplay/interactions/Switch.ts

@@ -98,7 +98,7 @@ import { Switchable } from '../models';
  * - {@apilink Switchable}
  * - {@apilink SwitchableOrigin}
  *
- * @group Interactions
+ * @group Activities
  */
 export class Switch extends Interaction {
 

package/src/screenplay/interactions/TakeScreenshot.ts

@@ -29,7 +29,7 @@ import { BrowseTheWeb } from '../abilities';
  * - {@apilink Artifact}
  * - {@apilink ArtifactArchiver}
  *
- * @group Interactions
+ * @group Activities
  */
 export class TakeScreenshot extends Interaction {
 

package/src/scripts/isVisible.ts

@@ -36,16 +36,16 @@ export function isVisible(domNode: HTMLElement): boolean {
     // applicable if element's text is multiline.
     function getOverlappingRects (element: HTMLElement, context?: Document) {
         context = context || document
-        const elems = []
+        const elements = []
 
         const rects = element.getClientRects()
         // webdriver clicks on center of the first element's rect (line of text), it might change in future
         const rect = rects[0]
         const x = rect.left + (rect.width / 2)
         const y = rect.top + (rect.height / 2)
-        elems.push(context.elementFromPoint(x, y))
+        elements.push(context.elementFromPoint(x, y))
 
-        return elems
+        return elements
     }
 
     // get overlapping elements