@serenity-js/protractor 3.24.1 → 3.25.1

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.25.1](https://github.com/serenity-js/serenity-js/compare/v3.25.0...v3.25.1) (2024-07-10)
+
+
+### Bug Fixes
+
+* **core:** all the API docs now link to the online Serenity/JS API documentation ([f8f451d](https://github.com/serenity-js/serenity-js/commit/f8f451dffdb4caaa2e31a860f59d59470f4856ad))
+
+
+
+
+
+# [3.25.0](https://github.com/serenity-js/serenity-js/compare/v3.24.1...v3.25.0) (2024-07-03)
+
+
+### Bug Fixes
+
+* **web:** renamed PageElement.outerHtml to PageElement.html for consistency with other methods ([9df6e0f](https://github.com/serenity-js/serenity-js/commit/9df6e0f2eece966d50ddac92e7550baa72bcb5f1))
+
+
+### Features
+
+* **web:** outerHtml lets you retrieve the HTML content of the given PageElement ([1bb6c6a](https://github.com/serenity-js/serenity-js/commit/1bb6c6afbfea3fb0c8883f9fe4aec385aa12ac27))
+
+
+
+
+
 ## [3.24.1](https://github.com/serenity-js/serenity-js/compare/v3.24.0...v3.24.1) (2024-06-26)
 
 **Note:** Version bump only for package @serenity-js/protractor

package/README.md

@@ -17,7 +17,7 @@ of complex software systems faster, more collaborative and easier to scale.
 👋 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),
 - Find answers to your Serenity/JS questions on the [Serenity/JS Forum](https://github.com/orgs/serenity-js/discussions/categories/how-do-i),
-- Learn how to [contribute to Serenity/JS](https://serenity-js.org/contributing),
+- Learn how to [contribute to Serenity/JS](https://serenity-js.org/community/contributing/),
 - Support the project and gain access to [Serenity/JS Playbooks](https://github.com/serenity-js/playbooks) by becoming a [Serenity/JS GitHub Sponsor](https://github.com/sponsors/serenity-js)!
 
 ## Serenity/JS Protractor

package/lib/adapter/Config.d.ts

@@ -6,14 +6,14 @@ import type { Config as ProtractorConfig } from 'protractor';
  *
  * ## Learn more
  * - [Protractor config](https://github.com/angular/protractor/blob/master/lib/config.ts)
- * - {@apilink SerenityConfig}
- * - {@apilink configure}
+ * - [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
+ * - [`configure`](https://serenity-js.org/api/core/function/configure/)
  *
  * @group Configuration
  */
 export interface Config extends ProtractorConfig {
     /**
-     * See {@apilink SerenityConfig}
+     * See [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
      */
     serenity: SerenityConfig & {
         runner?: string;

package/lib/adapter/reporter/ProtractorReport.d.ts

@@ -1,6 +1,7 @@
 import type { SpecResult } from 'protractor/built/plugins';
 /**
- * A JSON object which needs to be returned to Protractor when {@apilink ProtractorFrameworkAdapter}
+ * A JSON object which needs to be returned to Protractor
+ * when [`ProtractorFrameworkAdapter`](https://serenity-js.org/api/protractor-adapter/function/run/)
  * is done with executing the test scenarios.
  *
  * ## Learn more

package/lib/adapter/reporter/ProtractorReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProtractorReport.d.ts","sourceRoot":"","sources":["../../../src/adapter/reporter/ProtractorReport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD"}
+{"version":3,"file":"ProtractorReport.d.ts","sourceRoot":"","sources":["../../../src/adapter/reporter/ProtractorReport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD"}

package/lib/adapter/runner/TestRunnerDetector.d.ts

@@ -2,7 +2,7 @@ import type { TestRunnerAdapter } from '@serenity-js/core/lib/adapter';
 import type { Config as ProtractorConfig } from 'protractor';
 import type { TestRunnerLoader } from './TestRunnerLoader';
 /**
- * Detects the {@apilink TestRunnerAdapter} to use,
+ * Detects the [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) to use,
  * based on Protractor configuration.
  *
  * @group Integration

package/lib/adapter/runner/TestRunnerDetector.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestRunnerDetector = void 0;
 /**
- * Detects the {@apilink TestRunnerAdapter} to use,
+ * Detects the [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) to use,
  * based on Protractor configuration.
  *
  * @group Integration

package/lib/adapter/runner/TestRunnerLoader.d.ts

@@ -2,7 +2,7 @@ import type { TestRunnerAdapter } from '@serenity-js/core/lib/adapter';
 import { Path } from '@serenity-js/core/lib/io';
 import type { CucumberAdapterConfig } from './CucumberAdapterConfig';
 /**
- * Loads a {@apilink TestRunnerAdapter} needed to invoke
+ * Loads a [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) needed to invoke
  * the chosen test runner programmatically.
  *
  * @group Integration
@@ -16,9 +16,9 @@ export declare class TestRunnerLoader {
      * @param cwd
      *  Current working directory; used to resolve glob paths to files for Cucumber.js to `require`,
      *  and instructing Serenity/JS where to look for this module's optional
-     *  dependencies, like [`@serenity-js/cucumber`](/api/cucumber),
-     *  [`@serenity-js/mocha`](/api/mocha),
-     *  [`@serenity-js/jasmine`](/api/jasmine), etc.
+     *  dependencies, like [`@serenity-js/cucumber`](https://serenity-js.org/api/cucumber),
+     *  [`@serenity-js/mocha`](https://serenity-js.org/api/mocha),
+     *  [`@serenity-js/jasmine`](https://serenity-js.org/api/jasmine), etc.
      *
      * @param runnerId
      *  Unique identifier used to differentiate output files produced by native Cucumber.js formatters.
@@ -26,19 +26,19 @@ export declare class TestRunnerLoader {
      */
     constructor(cwd: Path, runnerId: number | string);
     /**
-     * See {@apilink JasmineConfig}
+     * See [`JasmineConfig`](https://serenity-js.org/api/jasmine-adapter/interface/JasmineConfig/)
      *
      * @param jasmineNodeOpts
      */
     forJasmine(jasmineNodeOpts: object): TestRunnerAdapter;
     /**
-     * See {@apilink MochaConfig}
+     * See [`MochaConfig`](https://serenity-js.org/api/mocha-adapter/interface/MochaConfig/)
      *
      * @param mochaOpts
      */
     forMocha(mochaOpts: object): TestRunnerAdapter;
     /**
-     * See {@apilink CucumberConfig}
+     * See [`CucumberConfig`](https://serenity-js.org/api/cucumber-adapter/interface/CucumberConfig/)
      *
      * @param cucumberOpts
      * @param adapterConfig

package/lib/adapter/runner/TestRunnerLoader.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestRunnerLoader = void 0;
 const io_1 = require("@serenity-js/core/lib/io");
 /**
- * Loads a {@apilink TestRunnerAdapter} needed to invoke
+ * Loads a [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) needed to invoke
  * the chosen test runner programmatically.
  *
  * @group Integration
@@ -17,9 +17,9 @@ class TestRunnerLoader {
      * @param cwd
      *  Current working directory; used to resolve glob paths to files for Cucumber.js to `require`,
      *  and instructing Serenity/JS where to look for this module's optional
-     *  dependencies, like [`@serenity-js/cucumber`](/api/cucumber),
-     *  [`@serenity-js/mocha`](/api/mocha),
-     *  [`@serenity-js/jasmine`](/api/jasmine), etc.
+     *  dependencies, like [`@serenity-js/cucumber`](https://serenity-js.org/api/cucumber),
+     *  [`@serenity-js/mocha`](https://serenity-js.org/api/mocha),
+     *  [`@serenity-js/jasmine`](https://serenity-js.org/api/jasmine), etc.
      *
      * @param runnerId
      *  Unique identifier used to differentiate output files produced by native Cucumber.js formatters.
@@ -32,7 +32,7 @@ class TestRunnerLoader {
         this.finder = new io_1.FileFinder(cwd);
     }
     /**
-     * See {@apilink JasmineConfig}
+     * See [`JasmineConfig`](https://serenity-js.org/api/jasmine-adapter/interface/JasmineConfig/)
      *
      * @param jasmineNodeOpts
      */
@@ -41,7 +41,7 @@ class TestRunnerLoader {
         return new JasmineAdapter(jasmineNodeOpts, this.moduleLoader);
     }
     /**
-     * See {@apilink MochaConfig}
+     * See [`MochaConfig`](https://serenity-js.org/api/mocha-adapter/interface/MochaConfig/)
      *
      * @param mochaOpts
      */
@@ -50,7 +50,7 @@ class TestRunnerLoader {
         return new MochaAdapter(mochaOpts, this.moduleLoader);
     }
     /**
-     * See {@apilink CucumberConfig}
+     * See [`CucumberConfig`](https://serenity-js.org/api/cucumber-adapter/interface/CucumberConfig/)
      *
      * @param cucumberOpts
      * @param adapterConfig

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

@@ -1,8 +1,8 @@
 import { BrowseTheWeb } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 /**
- * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * enables the {@apilink Actor} to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
+ * This implementation of the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * enables the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
  *
  * ## Using Protractor to `BrowseTheWeb`
  *
@@ -28,9 +28,9 @@ import type * as protractor from 'protractor';
  *
  * ## Learn more
  * - [Protractor website](https://www.protractortest.org/)
- * - {@apilink BrowseTheWeb}
- * - {@apilink Ability}
- * - {@apilink Actor}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Abilities
  */
@@ -83,7 +83,7 @@ export declare class BrowseTheWebWithProtractor extends BrowseTheWeb<protractor.
      * @param path
      *  Either a name or a dot-delimited path to the param.
      *
-     * @throws {@apilink ConfigurationError}
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
      *  Throws a `ConfigurationError` if the parameter is `undefined`
      */
     param<T = any>(path: string): T;

package/lib/screenplay/abilities/BrowseTheWebWithProtractor.js

@@ -5,8 +5,8 @@ const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
 const models_1 = require("../models");
 /**
- * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * enables the {@apilink Actor} to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
+ * This implementation of the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * enables the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
  *
  * ## Using Protractor to `BrowseTheWeb`
  *
@@ -32,9 +32,9 @@ const models_1 = require("../models");
  *
  * ## Learn more
  * - [Protractor website](https://www.protractortest.org/)
- * - {@apilink BrowseTheWeb}
- * - {@apilink Ability}
- * - {@apilink Actor}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Abilities
  */
@@ -92,7 +92,7 @@ class BrowseTheWebWithProtractor extends web_1.BrowseTheWeb {
      * @param path
      *  Either a name or a dot-delimited path to the param.
      *
-     * @throws {@apilink ConfigurationError}
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
      *  Throws a `ConfigurationError` if the parameter is `undefined`
      */
     param(path) {

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

@@ -1,6 +1,6 @@
 import { Interaction } from '@serenity-js/core';
 /**
- * Instructs the {@apilink Actor} to enable or disable automated synchronisation between Protractor and Angular 1.x application.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable or disable automated synchronisation between Protractor and Angular 1.x application.
  *
  * Useful when a test scenario needs to interact with both Angular-based
  * and non-Angular web apps, e.g. use an external sign-in form.
@@ -51,12 +51,12 @@ import { Interaction } from '@serenity-js/core';
  */
 export declare class UseAngular {
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to disable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to disable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static disableSynchronisation(): Interaction;
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to enable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static enableSynchronisation(): Interaction;

package/lib/screenplay/interactions/UseAngular.js

@@ -4,7 +4,7 @@ exports.UseAngular = void 0;
 const core_1 = require("@serenity-js/core");
 const abilities_1 = require("../abilities");
 /**
- * Instructs the {@apilink Actor} to enable or disable automated synchronisation between Protractor and Angular 1.x application.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable or disable automated synchronisation between Protractor and Angular 1.x application.
  *
  * Useful when a test scenario needs to interact with both Angular-based
  * and non-Angular web apps, e.g. use an external sign-in form.
@@ -55,7 +55,7 @@ const abilities_1 = require("../abilities");
  */
 class UseAngular {
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to disable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to disable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static disableSynchronisation() {
@@ -65,7 +65,7 @@ class UseAngular {
         });
     }
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to enable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static enableSynchronisation() {

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

@@ -3,7 +3,7 @@ import { BrowsingSession } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 import { ProtractorPage } from '../models';
 /**
- * Protractor-specific implementation of {@apilink BrowsingSession}.
+ * Protractor-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorBrowsingSession.js

@@ -8,7 +8,7 @@ const promised_1 = require("../promised");
 const ProtractorErrorHandler_1 = require("./ProtractorErrorHandler");
 const ProtractorModalDialogHandler_1 = require("./ProtractorModalDialogHandler");
 /**
- * Protractor-specific implementation of {@apilink BrowsingSession}.
+ * Protractor-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
  *
  * @group Models
  */

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

@@ -2,7 +2,7 @@ import type { CookieData } from '@serenity-js/web';
 import { Cookie } from '@serenity-js/web';
 import type { ProtractorBrowser } from 'protractor';
 /**
- * Protractor-specific implementation of {@apilink Cookie}.
+ * Protractor-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorCookie.js

@@ -6,7 +6,7 @@ const web_1 = require("@serenity-js/web");
 const tiny_types_1 = require("tiny-types");
 const promised_1 = require("../promised");
 /**
- * Protractor-specific implementation of {@apilink Cookie}.
+ * Protractor-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
  *
  * @group Models
  */

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

@@ -3,7 +3,7 @@ import { ModalDialogHandler } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 /**
- * Protractor-specific implementation of {@apilink ModalDialogHandler}.
+ * Protractor-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorModalDialogHandler.js

@@ -5,7 +5,7 @@ const web_1 = require("@serenity-js/web");
 const protractor_1 = require("protractor");
 const promised_1 = require("../promised");
 /**
- * Protractor-specific implementation of {@apilink ModalDialogHandler}.
+ * Protractor-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/).
  *
  * @group Models
  */

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

@@ -7,7 +7,7 @@ import { URL } from 'url';
 import type { ProtractorBrowsingSession } from './ProtractorBrowsingSession';
 import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 /**
- * Protractor-specific implementation of {@apilink Page}.
+ * Protractor-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * @group Models
  */

package/lib/screenplay/models/ProtractorPage.js

@@ -34,7 +34,7 @@ const ProtractorSelectors_1 = require("./locators/ProtractorSelectors");
 const ProtractorCookie_1 = require("./ProtractorCookie");
 const ProtractorPageElement_1 = require("./ProtractorPageElement");
 /**
- * Protractor-specific implementation of {@apilink Page}.
+ * Protractor-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * @group Models
  */

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

@@ -2,7 +2,7 @@ import type { SwitchableOrigin } from '@serenity-js/web';
 import { PageElement, SelectOption } from '@serenity-js/web';
 import type { ElementFinder } from 'protractor';
 /**
- * Protractor-specific implementation of {@apilink PageElement}.
+ * Protractor-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * @group Models
  */
@@ -21,6 +21,7 @@ export declare class ProtractorPageElement extends PageElement<ElementFinder> {
     attribute(name: string): Promise<string>;
     text(): Promise<string>;
     value(): Promise<string>;
+    html(): Promise<string>;
     switchTo(): Promise<SwitchableOrigin>;
     isActive(): Promise<boolean>;
     isClickable(): Promise<boolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"ProtractorPageElement.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/ProtractorPageElement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAM/C;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,WAAW,CAAC,aAAa,CAAC;IAEjE,EAAE,CAAC,MAAM,EAAE,qBAAqB,GAAG,WAAW,CAAC,aAAa,CAAC;IAI7D,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB;IAIxD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,aAAa,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxD,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA8B1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAMvB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAaxB,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAoCrC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAM7B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAM7B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAM9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAyBtC"}
+{"version":3,"file":"ProtractorPageElement.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/ProtractorPageElement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAM/C;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,WAAW,CAAC,aAAa,CAAC;IAEjE,EAAE,CAAC,MAAM,EAAE,qBAAqB,GAAG,WAAW,CAAC,aAAa,CAAC;IAI7D,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB;IAIxD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,aAAa,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxD,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA8B1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAMvB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAaxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IASvB,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAoCrC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAS5B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAM7B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAM7B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAM9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAyBtC"}

package/lib/screenplay/models/ProtractorPageElement.js

@@ -30,7 +30,7 @@ const scripts = __importStar(require("@serenity-js/web/lib/scripts"));
 const protractor_1 = require("protractor");
 const promised_1 = require("../promised");
 /**
- * Protractor-specific implementation of {@apilink PageElement}.
+ * Protractor-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * @group Models
  */
@@ -153,6 +153,11 @@ class ProtractorPageElement extends web_1.PageElement {
             return webElement.value;
         }, webElement));
     }
+    async html() {
+        const element = await this.nativeElement();
+        const webElement = await element.getWebElement();
+        return await (0, promised_1.promised)(webElement.getDriver().executeScript('return arguments[0].outerHTML;', webElement));
+    }
     async switchTo() {
         const element = await this.locator.nativeElement();
         try {

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/locators/ProtractorLocator.d.ts

@@ -4,7 +4,7 @@ import type * as protractor from 'protractor';
 import type { ProtractorErrorHandler } from '../ProtractorErrorHandler';
 import type { ProtractorRootLocator } from './ProtractorRootLocator';
 /**
- * Protractor-specific implementation of {@apilink Locator}.
+ * Protractor-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
  *
  * @group Models
  */

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

@@ -7,7 +7,7 @@ const unpromisedWebElement_1 = require("../../unpromisedWebElement");
 const ProtractorPageElement_1 = require("../ProtractorPageElement");
 const ProtractorSelectors_1 = require("./ProtractorSelectors");
 /**
- * Protractor-specific implementation of {@apilink Locator}.
+ * Protractor-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
  *
  * @group Models
  */

package/lib/screenplay/models/locators/ProtractorRootLocator.d.ts

@@ -1,7 +1,7 @@
 import { RootLocator } from '@serenity-js/web';
 import type * as protractor from 'protractor';
 /**
- * Protractor-specific implementation of {@apilink RootLocator}.
+ * Protractor-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
  *
  * @group Models
  */

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

@@ -4,7 +4,7 @@ exports.ProtractorRootLocator = void 0;
 const web_1 = require("@serenity-js/web");
 const promised_1 = require("../../promised");
 /**
- * Protractor-specific implementation of {@apilink RootLocator}.
+ * Protractor-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
  *
  * @group Models
  */

package/lib/screenplay/questions/ProtractorParam.d.ts

@@ -56,7 +56,7 @@ import type { Answerable, QuestionAdapter } from '@serenity-js/core';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWebWithProtractor.param}
+ * - [`BrowseTheWebWithProtractor.param`](https://serenity-js.org/api/protractor/class/BrowseTheWebWithProtractor/#param)
  *
  * @group Questions
  */

package/lib/screenplay/questions/ProtractorParam.js

@@ -60,7 +60,7 @@ const abilities_1 = require("../abilities");
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWebWithProtractor.param}
+ * - [`BrowseTheWebWithProtractor.param`](https://serenity-js.org/api/protractor/class/BrowseTheWebWithProtractor/#param)
  *
  * @group Questions
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/protractor",
-  "version": "3.24.1",
+  "version": "3.25.1",
   "description": "Test your web apps with Serenity/JS",
   "author": {
     "name": "Jan Molak",
@@ -49,9 +49,9 @@
     "node": "^16.13 || ^18.12 || ^20"
   },
   "dependencies": {
-    "@serenity-js/core": "3.24.1",
-    "@serenity-js/rest": "3.24.1",
-    "@serenity-js/web": "3.24.1",
+    "@serenity-js/core": "3.25.1",
+    "@serenity-js/rest": "3.25.1",
+    "@serenity-js/web": "3.25.1",
     "deepmerge": "4.3.1",
     "query-selector-shadow-dom": "1.0.1",
     "tiny-types": "1.22.0"
@@ -76,11 +76,11 @@
   },
   "devDependencies": {
     "@integration/testing-tools": "3.0.0",
-    "@serenity-js/assertions": "3.24.1",
-    "@serenity-js/cucumber": "3.24.1",
-    "@serenity-js/jasmine": "3.24.1",
-    "@serenity-js/local-server": "3.24.1",
-    "@serenity-js/mocha": "3.24.1",
+    "@serenity-js/assertions": "3.25.1",
+    "@serenity-js/cucumber": "3.25.1",
+    "@serenity-js/jasmine": "3.25.1",
+    "@serenity-js/local-server": "3.25.1",
+    "@serenity-js/mocha": "3.25.1",
     "@serenity-js/web": "3.1.1",
     "@types/chai": "4.3.16",
     "@types/express": "4.17.21",
@@ -92,12 +92,12 @@
     "cross-env": "7.0.3",
     "express": "4.19.2",
     "html-minifier": "4.0.0",
-    "mocha": "10.5.1",
+    "mocha": "10.6.0",
     "mocha-multi": "1.1.7",
     "protractor": "7.0.0",
     "start-server-and-test": "2.0.4",
     "ts-node": "10.9.2",
     "typescript": "5.2.2"
   },
-  "gitHead": "f7378fd85f00f055322f4d28624735ba3d2e2782"
+  "gitHead": "450b994115cf9f1a1547ef92ac9387e0c57821ce"
 }

package/src/adapter/Config.ts

@@ -7,14 +7,14 @@ import type { Config as ProtractorConfig } from 'protractor';
  *
  * ## Learn more
  * - [Protractor config](https://github.com/angular/protractor/blob/master/lib/config.ts)
- * - {@apilink SerenityConfig}
- * - {@apilink configure}
+ * - [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
+ * - [`configure`](https://serenity-js.org/api/core/function/configure/)
  *
  * @group Configuration
  */
 export interface Config extends ProtractorConfig {
     /**
-     * See {@apilink SerenityConfig}
+     * See [`SerenityConfig`](https://serenity-js.org/api/core/class/SerenityConfig/)
      */
     serenity: SerenityConfig & { runner?: string };
 }

package/src/adapter/reporter/ProtractorReport.ts

@@ -1,7 +1,8 @@
 import type { SpecResult } from 'protractor/built/plugins';
 
 /**
- * A JSON object which needs to be returned to Protractor when {@apilink ProtractorFrameworkAdapter}
+ * A JSON object which needs to be returned to Protractor
+ * when [`ProtractorFrameworkAdapter`](https://serenity-js.org/api/protractor-adapter/function/run/)
  * is done with executing the test scenarios.
  *
  * ## Learn more

package/src/adapter/runner/TestRunnerDetector.ts

@@ -4,7 +4,7 @@ import type { Config as ProtractorConfig } from 'protractor';
 import type { TestRunnerLoader } from './TestRunnerLoader';
 
 /**
- * Detects the {@apilink TestRunnerAdapter} to use,
+ * Detects the [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) to use,
  * based on Protractor configuration.
  *
  * @group Integration

package/src/adapter/runner/TestRunnerLoader.ts

@@ -6,7 +6,7 @@ import type { CucumberConfig } from '@serenity-js/cucumber/lib/adapter';
 import type { CucumberAdapterConfig } from './CucumberAdapterConfig';
 
 /**
- * Loads a {@apilink TestRunnerAdapter} needed to invoke
+ * Loads a [`TestRunnerAdapter`](https://serenity-js.org/api/core-adapter/interface/TestRunnerAdapter/) needed to invoke
  * the chosen test runner programmatically.
  *
  * @group Integration
@@ -21,9 +21,9 @@ export class TestRunnerLoader {
      * @param cwd
      *  Current working directory; used to resolve glob paths to files for Cucumber.js to `require`,
      *  and instructing Serenity/JS where to look for this module's optional
-     *  dependencies, like [`@serenity-js/cucumber`](/api/cucumber),
-     *  [`@serenity-js/mocha`](/api/mocha),
-     *  [`@serenity-js/jasmine`](/api/jasmine), etc.
+     *  dependencies, like [`@serenity-js/cucumber`](https://serenity-js.org/api/cucumber),
+     *  [`@serenity-js/mocha`](https://serenity-js.org/api/mocha),
+     *  [`@serenity-js/jasmine`](https://serenity-js.org/api/jasmine), etc.
      *
      * @param runnerId
      *  Unique identifier used to differentiate output files produced by native Cucumber.js formatters.
@@ -36,7 +36,7 @@ export class TestRunnerLoader {
     }
 
     /**
-     * See {@apilink JasmineConfig}
+     * See [`JasmineConfig`](https://serenity-js.org/api/jasmine-adapter/interface/JasmineConfig/)
      *
      * @param jasmineNodeOpts
      */
@@ -46,7 +46,7 @@ export class TestRunnerLoader {
     }
 
     /**
-     * See {@apilink MochaConfig}
+     * See [`MochaConfig`](https://serenity-js.org/api/mocha-adapter/interface/MochaConfig/)
      *
      * @param mochaOpts
      */
@@ -56,7 +56,7 @@ export class TestRunnerLoader {
     }
 
     /**
-     * See {@apilink CucumberConfig}
+     * See [`CucumberConfig`](https://serenity-js.org/api/cucumber-adapter/interface/CucumberConfig/)
      *
      * @param cucumberOpts
      * @param adapterConfig

package/src/screenplay/abilities/BrowseTheWebWithProtractor.ts

@@ -5,8 +5,8 @@ import type * as protractor from 'protractor';
 import { ProtractorBrowsingSession } from '../models';
 
 /**
- * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
- * enables the {@apilink Actor} to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
+ * This implementation of the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * enables the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to interact with web front-ends using [Protractor](http://www.protractortest.org/#/).
  *
  * ## Using Protractor to `BrowseTheWeb`
  *
@@ -32,9 +32,9 @@ import { ProtractorBrowsingSession } from '../models';
  *
  * ## Learn more
  * - [Protractor website](https://www.protractortest.org/)
- * - {@apilink BrowseTheWeb}
- * - {@apilink Ability}
- * - {@apilink Actor}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)
  *
  * @group Abilities
  */
@@ -93,7 +93,7 @@ export class BrowseTheWebWithProtractor extends BrowseTheWeb<protractor.ElementF
      * @param path
      *  Either a name or a dot-delimited path to the param.
      *
-     * @throws {@apilink ConfigurationError}
+     * @throws [`ConfigurationError`](https://serenity-js.org/api/core/class/ConfigurationError/)
      *  Throws a `ConfigurationError` if the parameter is `undefined`
      */
     param<T = any>(path: string): T {

package/src/screenplay/interactions/UseAngular.ts

@@ -4,7 +4,7 @@ import { BrowseTheWebWithProtractor } from '../abilities';
 import type { ProtractorPage } from '../models';
 
 /**
- * Instructs the {@apilink Actor} to enable or disable automated synchronisation between Protractor and Angular 1.x application.
+ * Instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable or disable automated synchronisation between Protractor and Angular 1.x application.
  *
  * Useful when a test scenario needs to interact with both Angular-based
  * and non-Angular web apps, e.g. use an external sign-in form.
@@ -56,7 +56,7 @@ import type { ProtractorPage } from '../models';
 export class UseAngular {
 
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to disable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to disable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static disableSynchronisation(): Interaction {
@@ -68,7 +68,7 @@ export class UseAngular {
     }
 
     /**
-     * Produces an {@apilink Interaction} that instructs the {@apilink Actor} to enable
+     * Produces an [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) that instructs the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to enable
      * synchronisation between Protractor and an Angular 1.x app.
      */
     static enableSynchronisation(): Interaction {

package/src/screenplay/models/ProtractorBrowsingSession.ts

@@ -9,7 +9,7 @@ import { ProtractorErrorHandler } from './ProtractorErrorHandler';
 import { ProtractorModalDialogHandler } from './ProtractorModalDialogHandler';
 
 /**
- * Protractor-specific implementation of {@apilink BrowsingSession}.
+ * Protractor-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorCookie.ts

@@ -7,7 +7,7 @@ import { ensure, isDefined } from 'tiny-types';
 import { promised } from '../promised';
 
 /**
- * Protractor-specific implementation of {@apilink Cookie}.
+ * Protractor-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorModalDialogHandler.ts

@@ -7,7 +7,7 @@ import { promised } from '../promised';
 import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 
 /**
- * Protractor-specific implementation of {@apilink ModalDialogHandler}.
+ * Protractor-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorPage.ts

@@ -15,7 +15,7 @@ import type { ProtractorErrorHandler } from './ProtractorErrorHandler';
 import { ProtractorPageElement } from './ProtractorPageElement';
 
 /**
- * Protractor-specific implementation of {@apilink Page}.
+ * Protractor-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
  *
  * @group Models
  */

package/src/screenplay/models/ProtractorPageElement.ts

@@ -9,7 +9,7 @@ import { promised } from '../promised';
 import type { ProtractorLocator } from './locators';
 
 /**
- * Protractor-specific implementation of {@apilink PageElement}.
+ * Protractor-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * @group Models
  */
@@ -188,6 +188,15 @@ export class ProtractorPageElement extends PageElement<ElementFinder> {
         ));
     }
 
+    async html(): Promise<string> {
+        const element: ElementFinder = await this.nativeElement();
+        const webElement: WebElement = await element.getWebElement();
+
+        return await promised(
+            webElement.getDriver().executeScript('return arguments[0].outerHTML;', webElement),
+        );
+    }
+
     async switchTo(): Promise<SwitchableOrigin> {
         const element: ElementFinder = await this.locator.nativeElement();
 

package/src/screenplay/models/locators/ProtractorLocator.ts

@@ -10,7 +10,7 @@ import type { ProtractorRootLocator } from './ProtractorRootLocator';
 import { ProtractorSelectors } from './ProtractorSelectors';
 
 /**
- * Protractor-specific implementation of {@apilink Locator}.
+ * Protractor-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
  *
  * @group Models
  */

package/src/screenplay/models/locators/ProtractorRootLocator.ts

@@ -4,7 +4,7 @@ import type * as protractor from 'protractor';
 import { promised } from '../../promised';
 
 /**
- * Protractor-specific implementation of {@apilink RootLocator}.
+ * Protractor-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
  *
  * @group Models
  */

package/src/screenplay/questions/ProtractorParam.ts

@@ -61,7 +61,7 @@ import { BrowseTheWebWithProtractor } from '../abilities';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWebWithProtractor.param}
+ * - [`BrowseTheWebWithProtractor.param`](https://serenity-js.org/api/protractor/class/BrowseTheWebWithProtractor/#param)
  *
  * @group Questions
  */