@serenity-js/protractor 3.0.0-rc.13 → 3.0.0-rc.16

package/lib/screenplay/abilities/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/screenplay/abilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C"}

package/lib/screenplay/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/screenplay/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAA4B;AAC5B,iDAA+B;AAC/B,2CAAyB;AACzB,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,iDAA+B;AAC/B,2CAAyB;AACzB,8CAA4B"}

package/lib/screenplay/interactions/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/screenplay/interactions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B"}

package/lib/screenplay/models/ProtractorPageElement.d.ts

@@ -1,5 +1,8 @@
 import { PageElement, SwitchableOrigin } from '@serenity-js/web';
 import { ElementFinder } from 'protractor';
+/**
+ * @extends {@serenity-js/web/lib/screenplay/models~PageElement}
+ */
 export declare class ProtractorPageElement extends PageElement<ElementFinder> {
     of(parent: ProtractorPageElement): PageElement<ElementFinder>;
     clearValue(): Promise<void>;
@@ -18,5 +21,16 @@ export declare class ProtractorPageElement extends PageElement<ElementFinder> {
     isEnabled(): Promise<boolean>;
     isPresent(): Promise<boolean>;
     isSelected(): Promise<boolean>;
+    /**
+     * @desc
+     *  Checks if the PageElement:
+     *  - is not hidden, so doesn't have CSS style like `display: none`, `visibility: hidden` or `opacity: 0`
+     *  - is within the browser viewport
+     *  - doesn't have its centre covered by other elements
+     *
+     * @returns {Promise<boolean>}
+     *
+     * @see {@link @serenity-js/web/lib/screenplay/models~PageElement}
+     */
     isVisible(): Promise<boolean>;
 }

package/lib/screenplay/models/ProtractorPageElement.js

@@ -5,15 +5,18 @@ const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
 const protractor_1 = require("protractor");
 const promised_1 = require("../promised");
+/**
+ * @extends {@serenity-js/web/lib/screenplay/models~PageElement}
+ */
 class ProtractorPageElement extends web_1.PageElement {
     of(parent) {
         return new ProtractorPageElement(this.locator.of(parent.locator));
     }
     async clearValue() {
-        function removeCharactersFrom(elf, numberOfCharacters) {
-            return numberOfCharacters === 0
-                ? Promise.resolve(void 0)
-                : elf.sendKeys(protractor_1.protractor.Key.END, ...times(numberOfCharacters, protractor_1.protractor.Key.BACK_SPACE));
+        async function removeCharactersFrom(elf, numberOfCharacters) {
+            if (numberOfCharacters > 0) {
+                await elf.sendKeys(protractor_1.protractor.Key.END, ...times(numberOfCharacters, protractor_1.protractor.Key.BACK_SPACE));
+            }
         }
         // eslint-disable-next-line unicorn/consistent-function-scoping
         function times(length, key) {
@@ -27,7 +30,7 @@ class ProtractorPageElement extends web_1.PageElement {
     }
     async click() {
         const element = await this.nativeElement();
-        return element.click();
+        return (0, promised_1.promised)(element.click());
     }
     async doubleClick() {
         const element = await this.nativeElement();
@@ -39,7 +42,7 @@ class ProtractorPageElement extends web_1.PageElement {
     }
     async enterValue(value) {
         const element = await this.nativeElement();
-        return element.sendKeys([].concat(value).join(''));
+        return (0, promised_1.promised)(element.sendKeys([].concat(value).join('')));
     }
     async scrollIntoView() {
         const element = await this.nativeElement();
@@ -63,11 +66,11 @@ class ProtractorPageElement extends web_1.PageElement {
     }
     async attribute(name) {
         const element = await this.nativeElement();
-        return element.getAttribute(name);
+        return (0, promised_1.promised)(element.getAttribute(name));
     }
     async text() {
         const element = await this.nativeElement();
-        return element.getText();
+        return (0, promised_1.promised)(element.getText());
     }
     async value() {
         const element = await this.nativeElement();
@@ -90,7 +93,7 @@ class ProtractorPageElement extends web_1.PageElement {
                 await browser.switchTo().frame(webElement);
                 return {
                     switchBack: async () => {
-                        await browser.driver.switchToParentFrame();
+                        await (0, promised_1.promised)(browser.driver.switchToParentFrame());
                     },
                 };
             }
@@ -100,7 +103,7 @@ class ProtractorPageElement extends web_1.PageElement {
                 await webElement.getDriver().executeScript(`arguments[0].focus()`, webElement);
                 return {
                     switchBack: async () => {
-                        await webElement.getDriver().executeScript(`arguments[0].focus()`, previouslyFocusedElement);
+                        await (0, promised_1.promised)(webElement.getDriver().executeScript(`arguments[0].focus()`, previouslyFocusedElement));
                     },
                 };
             }
@@ -112,23 +115,34 @@ class ProtractorPageElement extends web_1.PageElement {
     async isActive() {
         const element = await this.nativeElement();
         const webElement = await element.getWebElement();
-        return webElement.getDriver().switchTo().activeElement().then((active) => element.equals(active));
+        return (0, promised_1.promised)(webElement.getDriver().switchTo().activeElement().then((active) => element.equals(active)));
     }
     async isClickable() {
         return this.isEnabled();
     }
     async isEnabled() {
         const element = await this.nativeElement();
-        return element.isEnabled();
+        return (0, promised_1.promised)(element.isEnabled());
     }
     async isPresent() {
         const element = await this.nativeElement();
-        return element.isPresent();
+        return (0, promised_1.promised)(element.isPresent());
     }
     async isSelected() {
         const element = await this.nativeElement();
-        return element.isSelected();
+        return (0, promised_1.promised)(element.isSelected());
     }
+    /**
+     * @desc
+     *  Checks if the PageElement:
+     *  - is not hidden, so doesn't have CSS style like `display: none`, `visibility: hidden` or `opacity: 0`
+     *  - is within the browser viewport
+     *  - doesn't have its centre covered by other elements
+     *
+     * @returns {Promise<boolean>}
+     *
+     * @see {@link @serenity-js/web/lib/screenplay/models~PageElement}
+     */
     async isVisible() {
         const element = await this.nativeElement();
         if (!await element.isDisplayed()) {

package/lib/screenplay/models/ProtractorPageElement.js.map

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

package/lib/screenplay/models/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/screenplay/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAmC;AACnC,0DAAwC;AACxC,mDAAiC;AACjC,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,0DAAwC;AACxC,mDAAiC;AACjC,0DAAwC"}

package/lib/screenplay/models/locators/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/screenplay/models/locators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sDAAoC;AACpC,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,gEAA8C"}

package/lib/screenplay/questions/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/screenplay/questions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/protractor",
-  "version": "3.0.0-rc.13",
+  "version": "3.0.0-rc.16",
   "description": "Test your web apps with Serenity/JS",
   "author": {
     "name": "Jan Molak",
@@ -51,19 +51,19 @@
     "npm": "^6 || ^7 || ^8"
   },
   "dependencies": {
-    "@serenity-js/assertions": "3.0.0-rc.13",
-    "@serenity-js/core": "3.0.0-rc.13",
+    "@serenity-js/assertions": "3.0.0-rc.16",
+    "@serenity-js/core": "3.0.0-rc.16",
     "deepmerge": "^4.2.2",
     "is-plain-object": "^5.0.0",
     "query-selector-shadow-dom": "^1.0.0",
+    "selenium-webdriver": "^3.6.0",
     "tiny-types": "^1.17.0"
   },
   "peerDependencies": {
     "@serenity-js/cucumber": "^3.0.0-rc",
     "@serenity-js/jasmine": "^3.0.0-rc",
     "@serenity-js/mocha": "^3.0.0-rc",
-    "protractor": "^5.0.0 || ^7.0.0",
-    "selenium-webdriver": "^3.6.0"
+    "protractor": "^5.0.0 || ^7.0.0"
   },
   "peerDependenciesMeta": {
     "@serenity-js/cucumber": {
@@ -79,28 +79,28 @@
   "devDependencies": {
     "@documentation/esdoc-template": "3.0.0",
     "@integration/testing-tools": "3.0.0",
-    "@serenity-js/cucumber": "3.0.0-rc.13",
-    "@serenity-js/jasmine": "3.0.0-rc.13",
-    "@serenity-js/local-server": "3.0.0-rc.13",
-    "@serenity-js/mocha": "3.0.0-rc.13",
-    "@serenity-js/rest": "3.0.0-rc.13",
-    "@serenity-js/web": "3.0.0-rc.13",
+    "@serenity-js/cucumber": "3.0.0-rc.16",
+    "@serenity-js/jasmine": "3.0.0-rc.16",
+    "@serenity-js/local-server": "3.0.0-rc.16",
+    "@serenity-js/mocha": "3.0.0-rc.16",
+    "@serenity-js/rest": "3.0.0-rc.16",
+    "@serenity-js/web": "3.0.0-rc.16",
     "@types/chai": "^4.3.0",
     "@types/express": "^4.17.13",
     "@types/html-minifier": "^4.0.2",
     "@types/mocha": "^9.1.0",
     "@types/selenium-webdriver": "^3.0.19",
     "axios": "^0.21.4",
-    "body-parser": "^1.19.2",
+    "body-parser": "^1.20.0",
     "cross-env": "^7.0.3",
-    "express": "^4.17.2",
+    "express": "^4.17.3",
     "html-minifier": "^4.0.0",
-    "mocha": "^9.2.1",
+    "mocha": "^9.2.2",
     "protractor": "^7.0.0",
     "selenium-webdriver": "^3.6.0",
     "start-server-and-test": "^1.14.0",
-    "ts-node": "^10.5.0",
-    "typescript": "^4.5.5"
+    "ts-node": "^10.7.0",
+    "typescript": "^4.6.3"
   },
-  "gitHead": "9fb7df72c7f33cb10504843db890f7855b8c355a"
+  "gitHead": "636519a30032f1ff9a3fcba8c45433ca0e17fc7f"
 }

package/src/adapter/ProtractorFrameworkAdapter.ts

@@ -53,7 +53,7 @@ export class ProtractorFrameworkAdapter {
             .then(() => this.protractorRunner.runTestPreparer(TestRunnerDetector.protractorCliOptions()))
             .then(() => runner.load(specs))
             .then(() => runner.run())
-            .then(() => Promise.resolve((config.onComplete || noop)()))
+            .then(() => (config.onComplete || noop)())
             .then(() => reporter.report());
     }
 

package/src/adapter/browser-detector/StandardisedCapabilities.ts

@@ -11,34 +11,33 @@ export class StandardisedCapabilities {
     constructor(private currentBrowser: () => ProtractorBrowser) {
     }
 
-    browserName(): PromiseLike<string> {
+    browserName(): Promise<string | undefined> {
         return this.get(
             caps => caps.get('browserName'),
         );
     }
 
-    browserVersion(): PromiseLike<string> {
-        return this.get(
+    async browserVersion(): Promise<string | undefined> {
+        const version = await this.get(
             caps => caps.get('version'),
             caps => caps.get('browserVersion'),
             caps => caps.has('deviceManufacturer') && caps.has('deviceModel')
                 ? `${ caps.get('deviceManufacturer') } ${ caps.get('deviceModel') }`
                 : undefined,
             caps => caps.has('mobile') && caps.get('mobile').version,
-        ).
-        then(version =>
-            this.get(
-                caps => !! caps.get('mobileEmulationEnabled') && '(mobile emulation)',
-            ).then(suffix =>
-                [
-                    version,
-                    suffix,
-                ].filter(_ => !!_).join(' '),
-            ),
         );
+
+        const suffix = await this.get(
+            caps => !! caps.get('mobileEmulationEnabled') && '(mobile emulation)',
+        );
+
+        return [
+            version,
+            suffix,
+        ].filter(_ => !!_).join(' ');
     }
 
-    platformName(): PromiseLike<string> {
+    platformName(): Promise<string | undefined> {
         return this.get(
             caps => (!! caps.get('platformName') && ! /any/i.test(caps.get('platformName')))
                 ? caps.get('platformName')
@@ -46,21 +45,22 @@ export class StandardisedCapabilities {
         );
     }
 
-    platformVersion(): PromiseLike<string> {
+    platformVersion(): Promise<string | undefined> {
         return this.get(
             caps => caps.get('platformVersion'),
         );
     }
 
-    private get(...fetchers: Array<(capabilities: Capabilities) => string>): PromiseLike<string> {
-        return this.currentBrowser().getCapabilities().then(caps => {
-            for (const fetcher of fetchers) {
-                const result = fetcher(caps);
-                if (result) {
-                    return result;
-                }
+    private async get(...fetchers: Array<(capabilities: Capabilities) => string>): Promise<string | undefined> {
+        const capabilities = await this.currentBrowser().getCapabilities();
+
+        for (const fetcher of fetchers) {
+            const result = fetcher(capabilities);
+            if (result) {
+                return result;
             }
-            return undefined;   // eslint-disable-line unicorn/no-useless-undefined
-        });
+        }
+
+        return undefined;   // eslint-disable-line unicorn/no-useless-undefined
     }
 }

package/src/adapter/reporter/ProtractorReporter.ts

@@ -85,9 +85,9 @@ export class ProtractorReporter implements StageCrewMember {
         });
     }
 
-    private afterEach(): PromiseLike<void> {
+    private async afterEach(): Promise<void> {
         if (! this.runner.afterEach) {
-            return Promise.resolve();
+            return;
         }
 
         const id = CorrelationId.create();
@@ -98,16 +98,16 @@ export class ProtractorReporter implements StageCrewMember {
             this.stage.currentTime(),
         ));
 
-        return Promise.resolve(this.runner.afterEach() as PromiseLike<void> | undefined)
-            .then(
-                () =>
-                    this.stage.announce(new AsyncOperationCompleted(
-                        new Description(`[${ this.constructor.name }] ProtractorRunner.afterEach succeeded`),
-                        id,
-                        this.stage.currentTime(),
-                    )),
-                error =>
-                    this.stage.announce(new AsyncOperationFailed(error, id, this.stage.currentTime())),
-            );
+        try {
+            await this.runner.afterEach();
+
+            this.stage.announce(new AsyncOperationCompleted(
+                new Description(`[${ this.constructor.name }] ProtractorRunner.afterEach succeeded`),
+                id,
+                this.stage.currentTime(),
+            ));
+        } catch (error) {
+            this.stage.announce(new AsyncOperationFailed(error, id, this.stage.currentTime()));
+        }
     }
 }

package/src/adapter/runner/TestRunnerDetector.ts

@@ -53,7 +53,7 @@ export class TestRunnerDetector {
                 return this.useCucumber(config);
             case !! config.mochaOpts:
                 return this.useMocha(config);
-            case !! config.jasmineNodeOpts:
+            case !! config.jasmineNodeOpts:     // eslint-disable-line unicorn/no-useless-switch-case
             default:
                 return this.useJasmine(config);
         }

package/src/screenplay/models/ProtractorPageElement.ts

@@ -5,6 +5,9 @@ import { WebElement } from 'selenium-webdriver';
 
 import { promised } from '../promised';
 
+/**
+ * @extends {@serenity-js/web/lib/screenplay/models~PageElement}
+ */
 export class ProtractorPageElement extends PageElement<ElementFinder> {
 
     of(parent: ProtractorPageElement): PageElement<ElementFinder> {
@@ -12,13 +15,13 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
     }
 
     async clearValue(): Promise<void> {
-        function removeCharactersFrom(elf: ElementFinder, numberOfCharacters: number): PromiseLike<void> {
-            return numberOfCharacters === 0
-                ? Promise.resolve(void 0)
-                : elf.sendKeys(
+        async function removeCharactersFrom(elf: ElementFinder, numberOfCharacters: number): Promise<void> {
+            if (numberOfCharacters > 0) {
+                await elf.sendKeys(
                     protractor.Key.END,
                     ...times(numberOfCharacters, protractor.Key.BACK_SPACE),
                 );
+            }
         }
 
         // eslint-disable-next-line unicorn/consistent-function-scoping
@@ -37,7 +40,7 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
     async click(): Promise<void> {
         const element: ElementFinder = await this.nativeElement();
 
-        return element.click();
+        return promised(element.click());
     }
 
     async doubleClick(): Promise<void> {
@@ -55,9 +58,9 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
     async enterValue(value: string | number | Array<string | number>): Promise<void> {
         const element: ElementFinder = await this.nativeElement();
 
-        return element.sendKeys(
+        return promised(element.sendKeys(
             [].concat(value).join(''),
-        );
+        ));
     }
 
     async scrollIntoView(): Promise<void> {
@@ -95,13 +98,13 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
     async attribute(name: string): Promise<string> {
         const element: ElementFinder = await this.nativeElement();
 
-        return element.getAttribute(name);
+        return promised(element.getAttribute(name));
     }
 
     async text(): Promise<string> {
         const element: ElementFinder = await this.nativeElement();
 
-        return element.getText();
+        return promised(element.getText());
     }
 
     async value(): Promise<string> {
@@ -134,7 +137,7 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
 
                 return {
                     switchBack: async (): Promise<void> => {
-                        await browser.driver.switchToParentFrame();
+                        await promised(browser.driver.switchToParentFrame());
                     },
                 };
             }
@@ -146,7 +149,7 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
 
                 return {
                     switchBack: async (): Promise<void> => {
-                        await webElement.getDriver().executeScript(`arguments[0].focus()`, previouslyFocusedElement);
+                        await promised(webElement.getDriver().executeScript(`arguments[0].focus()`, previouslyFocusedElement));
                     },
                 };
             }
@@ -159,9 +162,9 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
         const element: ElementFinder = await this.nativeElement();
         const webElement: WebElement = await element.getWebElement();
 
-        return webElement.getDriver().switchTo().activeElement().then((active: WebElement) =>
+        return promised(webElement.getDriver().switchTo().activeElement().then((active: WebElement) =>
             element.equals(active),
-        );
+        ));
     }
 
     async isClickable(): Promise<boolean> {
@@ -171,21 +174,32 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
     async isEnabled(): Promise<boolean> {
         const element: ElementFinder = await this.nativeElement();
 
-        return element.isEnabled();
+        return promised(element.isEnabled());
     }
 
     async isPresent(): Promise<boolean> {
         const element: ElementFinder = await this.nativeElement();
 
-        return element.isPresent();
+        return promised(element.isPresent());
     }
 
     async isSelected(): Promise<boolean> {
         const element: ElementFinder = await this.nativeElement();
 
-        return element.isSelected();
+        return promised(element.isSelected());
     }
 
+    /**
+     * @desc
+     *  Checks if the PageElement:
+     *  - is not hidden, so doesn't have CSS style like `display: none`, `visibility: hidden` or `opacity: 0`
+     *  - is within the browser viewport
+     *  - doesn't have its centre covered by other elements
+     *
+     * @returns {Promise<boolean>}
+     *
+     * @see {@link @serenity-js/web/lib/screenplay/models~PageElement}
+     */
     async isVisible(): Promise<boolean> {
         const element: ElementFinder = await this.nativeElement();