@serenity-js/protractor 2.33.1 → 3.0.0-rc.11

package/lib/screenplay/interactions/ExecuteScript.js

@@ -1,291 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExecuteScriptWithArguments = exports.ExecuteScript = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-const model_1 = require("@serenity-js/core/lib/model");
-const abilities_1 = require("../abilities");
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
- *  execute a script within the context of the current browser window.
- *
- *  Please see the tests below for usage examples.
- *
- * @see {@link LastScriptExecution.result}
- */
-class ExecuteScript {
-    /**
-     * @desc
-     *  Instantiates a version of this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  configured to load a script from `sourceUrl`.
-     *
-     * @param {string} sourceUrl
-     *  The URL to load the script from
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     */
-    static from(sourceUrl) {
-        return new ExecuteScriptFromUrl(sourceUrl);
-    }
-    /**
-     * @desc
-     *  Schedules a command to execute asynchronous JavaScript in the context of the currently selected frame or window.
-     *  The script fragment will be executed as the body of an anonymous function.
-     *  If the script is provided as a function object, that function will be converted to a string for injection
-     *  into the target window.
-     *
-     *  Any arguments provided in addition to the script will be included as script arguments and may be referenced
-     *  using the `arguments` object. Arguments may be a `boolean`, `number`, `string`
-     *  or `Target` (`Question<ElementFinder>`).
-     *  Arrays and objects may also be used as script arguments as long as each item adheres
-     *  to the types previously mentioned.
-     *
-     *  Unlike executing synchronous JavaScript with {@link ExecuteScript#sync},
-     *  scripts executed with this function must explicitly signal they are finished by invoking the provided callback.
-     *
-     *  This callback will always be injected into the executed function as the last argument,
-     *  and thus may be referenced with `arguments[arguments.length - 1]`.
-     *
-     *  If the script invokes the `callback` with a return value, this will be made available
-     *  via the {@link LastScriptExecution.result}.
-     *
-     *  **Please note** that in order to signal an error in the `script` you need to throw an {@link Error}
-     *  instead of passing it to the callback function.
-     *
-     * @example <caption>Executing an async script</caption>
-     *  actor.attemptsTo(ExecuteScript.async(
-     *    var callback = arguments[arguments.length - 1];
-     *
-     *    // do stuff
-     *
-     *    callback(result)
-     *  ));
-     *
-     * @example <caption>Passing arguments to an async script</caption>
-     *  actor.attemptsTo(ExecuteScript.async(
-     *    var name = arguments[0];
-     *    var age = arguments[1];
-     *    var callback = arguments[arguments.length - 1];
-     *
-     *    // do stuff
-     *
-     *    callback(result)
-     *  ).withArguments('Bob', 24));
-     *
-     * @example <caption>Passing Target arguments to an async script</caption>
-     *  actor.attemptsTo(ExecuteScript.async(
-     *     var header = arguments[0];    // Target gets converted to a WebElement
-     *     var callback = arguments[arguments.length - 1];
-     *
-     *     callback(header.innerText)
-     *   ).withArguments(Target.the('header').located(by.css('h1'))));
-     *
-     * @param {string | Function} script
-     *  The script to be executed
-     *
-     * @returns {ExecuteScriptWithArguments}
-     *
-     * @see {@link LastScriptExecution.result}
-     */
-    static async(script) {
-        return new ExecuteAsynchronousScript(script);
-    }
-    /**
-     * @desc
-     *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
-     *  execute a synchronous script in the context of the currently selected frame or window.
-     *
-     *  If the script returns a value, it will be made available via {@link LastScriptExecution.result}.
-     *
-     * @example <caption>Executing a sync script and reading the result</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, ExecuteScript, LastScriptExecution } from '@serenity-js/protractor';
-     *  import { Ensure, includes } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Joseph')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          ExecuteScript.sync('return navigator.userAgent'),
-     *          Ensure.that(LastScriptExecution.result<string>(), includes('Chrome')),
-     *      );
-     *
-     * @param {string | Function} script
-     *  The script to be executed
-     *
-     * @returns {ExecuteScriptWithArguments}
-     *
-     * @see {@link LastScriptExecution.result}
-     */
-    static sync(script) {
-        return new ExecuteSynchronousScript(script);
-    }
-}
-exports.ExecuteScript = ExecuteScript;
-/**
- * @desc
- *  Allows for a script to be executed to be parametrised.
- *
- *  **Please note** that the arguments can be both synchronous and asynchronous {@link @serenity-js/core/lib/screenplay~Question}s
- *  as well as regular static values.
- *
- * @abstract
- *
- * @see {@link ExecuteScript}
- *
- * @extends {@serenity-js/core/lib/screenplay~Interaction}
- */
-class ExecuteScriptWithArguments extends core_1.Interaction {
-    /**
-     * @param {string | Function} script
-     *  The script to be executed
-     *
-     * @param {Array<Answerable<any>>} args
-     *  Arguments to parametrise the script with
-     */
-    constructor(script, // eslint-disable-line @typescript-eslint/ban-types
-    args = []) {
-        super();
-        this.script = script;
-        this.args = args;
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  perform this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     *  An {@link @serenity-js/core/lib/screenplay/actor~Actor} to perform this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @returns {PromiseLike<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     */
-    performAs(actor) {
-        return this.answerAll(this.args).as(actor)
-            .then(args => this.executeAs(actor, args))
-            .then(() => actor.collect(model_1.TextData.fromJSON({
-            contentType: 'text/javascript;charset=UTF-8',
-            data: this.script.toString(),
-        }), new model_1.Name('Script source')));
-    }
-    /**
-     * @private
-     *
-     * @param {Array<Answerable<any>>} args
-     */
-    answerAll(args) {
-        return {
-            as: (actor) => Promise.all(args.map(arg => {
-                const maybeElementFinder = core_1.Question.isAQuestion(arg)
-                    ? arg.answeredBy(actor)
-                    : arg;
-                const maybePromise = maybeElementFinder.getWebElement
-                    ? maybeElementFinder.getWebElement()
-                    : maybeElementFinder;
-                return actor.answer(maybePromise);
-            })),
-        };
-    }
-}
-exports.ExecuteScriptWithArguments = ExecuteScriptWithArguments;
-/**
- * @package
- */
-class ExecuteAsynchronousScript extends ExecuteScriptWithArguments {
-    withArguments(...args) {
-        return new ExecuteAsynchronousScript(this.script, args);
-    }
-    executeAs(actor, args) {
-        return abilities_1.BrowseTheWeb.as(actor).executeAsyncScript(this.script, ...args);
-    }
-    toString() {
-        return this.args.length > 0
-            ? (0, io_1.formatted) `#actor executes an asynchronous script with arguments: ${this.args}`
-            : `#actor executes an asynchronous script`;
-    }
-}
-/**
- * @package
- *
- * https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/JavascriptExecutor.html
- * https://developer.mozilla.org/en-US/docs/Web/API/HTMLScriptElement
- */
-class ExecuteScriptFromUrl extends core_1.Interaction {
-    constructor(sourceUrl) {
-        super();
-        this.sourceUrl = sourceUrl;
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  perform this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     */
-    performAs(actor) {
-        return abilities_1.BrowseTheWeb.as(actor)
-            .executeAsyncScript(`   var src = arguments[0];
-                    var callback = arguments[arguments.length - 1];
-        
-                    var alreadyLoadedScripts = Array.prototype.slice
-                        .call(document.getElementsByTagName('script'))
-                        .map(script => script.src);
-        
-                    if (!! ~ alreadyLoadedScripts.indexOf(src)) {
-                        return callback("Script from " + src + " has already been loaded");
-                    }
-        
-                    var script = document.createElement('script');
-                    script.onload = function () {
-                        return callback();
-                    };
-                    script.onerror = function () {
-                        return callback("Couldn't load script from " + src);
-                    };
-        
-                    script.src = src;
-                    script.async = true;
-                    document.head.appendChild(script);
-                `, this.sourceUrl)
-            .then(errorMessage => {
-            if (errorMessage) {
-                throw new core_1.LogicError(errorMessage);
-            }
-        });
-    }
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link @serenity-js/core/lib/screenplay~Activity}.
-     *
-     * @returns {string}
-     */
-    toString() {
-        return `#actor executes a script from ${this.sourceUrl}`;
-    }
-}
-/**
- * @package
- */
-class ExecuteSynchronousScript extends ExecuteScriptWithArguments {
-    withArguments(...args) {
-        return new ExecuteSynchronousScript(this.script, args);
-    }
-    executeAs(actor, args) {
-        return abilities_1.BrowseTheWeb.as(actor).executeScript(this.toString(), this.script, ...args);
-    }
-    toString() {
-        return this.args.length > 0
-            ? (0, io_1.formatted) `#actor executes a synchronous script with arguments: ${this.args}`
-            : `#actor executes a synchronous script`;
-    }
-}
-//# sourceMappingURL=ExecuteScript.js.map

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

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

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

@@ -1,86 +0,0 @@
-import { AnswersQuestions, Interaction, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
- *  hover the mouse pointer over a given Web element.
- *
- * @example <caption>Example widget</caption>
- *  <a data-test="example-link"
- *      class="off"
- *      onmouseover="this.className='on';"
- *      onmouseout="this.className='off';"
- *      href="/">hover over me</a>
- *
- * @example <caption>Lean Page Object describing the widget</caption>
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class Example {
- *      static link = Target.the('example link')
- *          .located(by.css('[data-test="example-link"]'));
- *  }
- *
- * @example <caption>Hovering over an element</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Hover, CSSClasses } from '@serenity-js/protractor';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Hank')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Ensure.that(CSSClasses.of(Example.link), equals([ 'off' ])),
- *
- *          Hover.over(Example.link),
- *          Ensure.that(CSSClasses.of(Example.link), equals([ 'on' ])),
- *      );
- *
- * @see {@link BrowseTheWeb}
- * @see {@link Target}
- * @see {@link CSSClasses}
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/assertions/lib/expectations~equals}
- *
- * @extends {@serenity-js/core/lib/screenplay~Interaction}
- */
-export declare class Hover extends Interaction {
-    private readonly target;
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  The element to be hovered over
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     */
-    static over(target: Question<ElementFinder> | ElementFinder): Interaction;
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  The element to be hovered over
-     */
-    constructor(target: Question<ElementFinder> | ElementFinder);
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  perform this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     *  An {@link @serenity-js/core/lib/screenplay/actor~Actor} to perform this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @returns {PromiseLike<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     */
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void>;
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link @serenity-js/core/lib/screenplay~Activity}.
-     *
-     * @returns {string}
-     */
-    toString(): string;
-}

package/lib/screenplay/interactions/Hover.js

@@ -1,103 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Hover = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-const abilities_1 = require("../abilities");
-const withAnswerOf_1 = require("../withAnswerOf");
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
- *  hover the mouse pointer over a given Web element.
- *
- * @example <caption>Example widget</caption>
- *  <a data-test="example-link"
- *      class="off"
- *      onmouseover="this.className='on';"
- *      onmouseout="this.className='off';"
- *      href="/">hover over me</a>
- *
- * @example <caption>Lean Page Object describing the widget</caption>
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class Example {
- *      static link = Target.the('example link')
- *          .located(by.css('[data-test="example-link"]'));
- *  }
- *
- * @example <caption>Hovering over an element</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Hover, CSSClasses } from '@serenity-js/protractor';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Hank')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Ensure.that(CSSClasses.of(Example.link), equals([ 'off' ])),
- *
- *          Hover.over(Example.link),
- *          Ensure.that(CSSClasses.of(Example.link), equals([ 'on' ])),
- *      );
- *
- * @see {@link BrowseTheWeb}
- * @see {@link Target}
- * @see {@link CSSClasses}
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/assertions/lib/expectations~equals}
- *
- * @extends {@serenity-js/core/lib/screenplay~Interaction}
- */
-class Hover extends core_1.Interaction {
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  The element to be hovered over
-     */
-    constructor(target) {
-        super();
-        this.target = target;
-    }
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  The element to be hovered over
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     */
-    static over(target) {
-        return new Hover(target);
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  perform this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     *  An {@link @serenity-js/core/lib/screenplay/actor~Actor} to perform this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @returns {PromiseLike<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     */
-    performAs(actor) {
-        return (0, withAnswerOf_1.withAnswerOf)(actor, this.target, (elf) => abilities_1.BrowseTheWeb.as(actor).actions()
-            .mouseMove(elf)
-            .perform());
-    }
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link @serenity-js/core/lib/screenplay~Activity}.
-     *
-     * @returns {string}
-     */
-    toString() {
-        return (0, io_1.formatted) `#actor hovers the mouse over ${this.target}`;
-    }
-}
-exports.Hover = Hover;
-//# sourceMappingURL=Hover.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Hover.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/Hover.ts"],"names":[],"mappings":";;;AAAA,4CAA2F;AAC3F,iDAAqD;AAGrD,4CAA4C;AAC5C,kDAA+C;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAa,KAAM,SAAQ,kBAAW;IAelC;;;OAGG;IACH,YAA6B,MAA+C;QACxE,KAAK,EAAE,CAAC;QADiB,WAAM,GAAN,MAAM,CAAyC;IAE5E,CAAC;IAnBD;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CAAC,MAA+C;QACvD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAUD;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,KAAuC;QAC7C,OAAO,IAAA,2BAAY,EAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,GAAkB,EAAE,EAAE,CAC3D,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;aAC3B,SAAS,CAAC,GAAqB,CAAC;aAChC,OAAO,EAAE,CACjB,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACJ,OAAO,IAAA,cAAS,EAAC,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAC;IACnE,CAAC;CACJ;AAtDD,sBAsDC"}

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

@@ -1,149 +0,0 @@
-import { Answerable, Duration, Interaction } from '@serenity-js/core';
-/**
- * @desc
- *  Allows the {@link @serenity-js/core/lib/screenplay/actor~Actor} to navigate to a specific destination,
- *  as well as back and forth in the browser history, or reload the current page.
- */
-export declare class Navigate {
-    /**
-     * @desc
-     *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
-     *  navigate to a given URL.
-     *
-     *  The URL can be:
-     *  - absolute, i.e. `https://example.org/search`
-     *  - relative, i.e. `/search`
-     *
-     *  If the URL is relative, Protractor will append it to `baseUrl` configured in [`protractor.conf.js`](https://github.com/angular/protractor/blob/master/lib/config.ts).
-     *
-     * @example <caption>protractor.conf.js</caption>
-     *  exports.config = {
-     *      baseUrl: 'https://example.org',
-     *      // ...
-     *  }
-     *
-     * @example <caption>Navigate to path relative to baseUrl</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Navigate } from '@serenity-js/protractor';
-     *
-     *  actorCalled('Hannu')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Navigate.to('/search'),
-     *      );
-     *
-     * @example <caption>Navigate to an absolute URL (overrides baseUrl)</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Navigate } from '@serenity-js/protractor';
-     *
-     *  actorCalled('Hannu')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Navigate.to('https://mycompany.org/login'),
-     *      );
-     *
-     * @example <caption>Navigate to URL with timeout</caption>
-     *  import { actorCalled, Duration } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Navigate } from '@serenity-js/protractor';
-     *
-     *  actorCalled('Hannu')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Navigate.to('/search').withTimeout(Duration.ofSeconds(2)),
-     *      );
-     *
-     * @param {Answerable<string>} url
-     *  An absolute URL or path an {@link @serenity-js/core/lib/screenplay/actor~Actor} should navigate to
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction & { withTimeout: (duration: Answerable<Duration>) => Interaction }}
-     *
-     * @see {@link BrowseTheWeb}
-     * @see {@link @serenity-js/core~Duration}
-     */
-    static to(url: Answerable<string>): Interaction & {
-        withTimeout: (duration: Answerable<Duration>) => Interaction;
-    };
-    /**
-     * @desc
-     *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
-     *  navigate back one page in the session history.
-     *
-     * @example <caption>Navigate to path relative to baseUrl</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { Ensure, endsWith } from '@serenity-js/assertions';
-     *  import { BrowseTheWeb, Navigate } from '@serenity-js/protractor';
-     *
-     *  actorCalled('Hannu')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Navigate.to('/first'),
-     *          Navigate.to('/second'),
-     *
-     *          Navigate.back(),
-     *
-     *          Ensure.that(Website.url(), endsWith('/first')),
-     *      );
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link BrowseTheWeb}
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link @serenity-js/assertions/lib/expectations~endsWith}
-     */
-    static back(): Interaction;
-    /**
-     * @desc
-     *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
-     *  navigate forward one page in the session history.
-     *
-     * @example <caption>Navigate to path relative to baseUrl</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { Ensure, endsWith } from '@serenity-js/assertions';
-     *  import { BrowseTheWeb, Navigate } from '@serenity-js/protractor';
-     *
-     *  actorCalled('Hannu')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Navigate.to('/first'),
-     *          Navigate.to('/second'),
-     *
-     *          Navigate.back(),
-     *          Navigate.forward(),
-     *
-     *          Ensure.that(Website.url(), endsWith('/second')),
-     *      );
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link BrowseTheWeb}
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link @serenity-js/assertions/lib/expectations~endsWith}
-     */
-    static forward(): Interaction;
-    /**
-     * @desc
-     *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
-     *  reload the current page.
-     *
-     * @example <caption>Navigate to path relative to baseUrl</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { Ensure, endsWith } from '@serenity-js/assertions';
-     *  import { Navigate, BrowseTheWeb, DeleteCookies } from '@serenity-js/protractor';
-     *
-     *  actorCalled('Hannu')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Navigate.to('/login'),
-     *          DeleteCookies.called('session_id'),
-     *          Navigate.reloadPage(),
-     *      );
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link BrowseTheWeb}
-     * @see {@link DeleteCookies}
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link @serenity-js/assertions/lib/expectations~endsWith}
-     */
-    static reloadPage(): Interaction;
-}