@serenity-js/playwright-test 3.31.17 → 3.32.1

package/lib/api/SerenityOptions.d.ts

@@ -1,271 +0,0 @@
-import type { PlaywrightTestOptions, PlaywrightWorkerArgs, TestFixture } from '@playwright/test';
-import type { Cast, ClassDescription, Duration, StageCrewMember, StageCrewMemberBuilder } from '@serenity-js/core';
-import type { PlaywrightOptions } from '@serenity-js/playwright';
-/**
- * Configuration object accepted by `@serenity-js/playwright-test`.
- *
- * ## Example
- *
- * ```typescript
- * // playwright.config.ts
- * import type { Cast, TakeNotes } from '@serenity-js/core'
- * import type { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
- * import type { PlaywrightTestConfig } from '@serenity-js/playwright-test'
- * import type { CallAnApi } from '@serenity-js/rest'
- *
- * // Define any custom configuration options, if needed
- * interface MyCustomOptions {
- *     apiUrl: string;
- * }
- *
- * const config: PlaywrightTestConfig<MyCustomOptions> = {
- *
- *     // Register Serenity/JS reporter for Playwright Test
- *     // to enable integration with Serenity/JS stage crew members
- *     // and have them instantiated in the Playwright reporter process
- *     reporter: [
- *         [ '@serenity-js/playwright-test', {
- *             // Stage crew members instantiated in the test reporter process
- *             crew: [
- *                 '@serenity-js/serenity-bdd',
- *                 '@serenity-js/console-reporter',
- *                 [ '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
- *             ]
- *         }]
- *     ],
- *
- *     use: {
- *
- *         // Register Serenity/JS stage crew members
- *         // and have them instantiated in Playwright Test worker processes
- *         crew: [
- *             [ '@serenity-js/web:Photographer', { strategy: 'TakePhotosOfFailures' } ]
- *         ],
- *
- *         // Register a custom cast of Serenity/JS actors
- *         // if you don't want to use the default ones
- *         actors: ({ browser, contextOptions, apiUrl }, use) => {
- *              const cast = Cast.where(actor =>
- *                  actor.whoCan(
- *                      BrowseTheWebWithPlaywright.using(browser, contextOptions),
- *                      TakeNotes.usingAnEmptyNotepad(),
- *                      CallAnApi.at(apiUrl),
- *                  )
- *              )
- *
- *              use(cast)
- *         },
- *
- *         // Name to be given to an actor injected via `actor` fixture
- *         defaultActorName: 'Alice',
- *
- *         // Any custom options, as per the MyCustomOptions interface
- *         apiUrl: 'https://api.serenity-js.org/v1'
- *
- *         // Any other Playwright options
- *         baseURL: 'https://todo-app.serenity-js.org/',
- *         video: 'on-first-retry',
- *         trace: 'on-first-retry',
- *     },
- * }
- *
- * export default config
- * ```
- *
- * ## Learn more
- * - [`PlaywrightTestConfig`](https://serenity-js.org/api/playwright-test/#PlaywrightTestConfig)
- * - [`Cast`](https://serenity-js.org/api/core/class/Cast/)
- * - [`SerenityFixtures`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/)
- */
-export interface SerenityOptions {
-    /**
-     * Configures the [`Cast`](https://serenity-js.org/api/core/class/Cast/) of [`actors`](https://serenity-js.org/api/core/class/SerenityConfig/#actors) to be used when injecting an [`actor`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actor)
-     * or invoking [`actorCalled`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actorCalled) in a [test scenario](https://serenity-js.org/api/playwright-test/function/it/).
-     *
-     * :::info Did you know?
-     * When you use `@serenity-js/playwright-test` [test APIs](https://serenity-js.org/api/playwright-test/function/it/), Serenity/JS already provides a default cast of actors for you.
-     * Each one of the default actors receives [abilities](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWebWithPlaywright`](https://serenity-js.org/api/playwright/class/BrowseTheWebWithPlaywright/) and [`TakeNotes.usingAnEmptyNotepad`](https://serenity-js.org/api/core/class/TakeNotes/#usingAnEmptyNotepad).
-     *
-     * The default abilities should be sufficient in most web testing scenarios. However, you might want to override this default configuration
-     * when you need your actors to [interact with REST APIs](https://serenity-js.org/api/rest/class/CallAnApi/),
-     * [manage local servers](https://serenity-js.org/api/local-server/class/ManageALocalServer/),
-     * start with a notepad that has some [initial state](https://serenity-js.org/api/core/class/TakeNotes/#using),
-     * or receive [custom abilities](https://serenity-js.org/api/core/class/Ability/).
-     * :::
-     *
-     * #### Using a custom crew of Serenity/JS actors
-     *
-     * ```typescript
-     * // playwright.config.ts
-     * import type { PlaywrightTestConfig } from '@serenity-js/playwright-test'
-     * import { Cast, TakeNotes } from '@serenity-js/core'
-     * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
-     * import { CallAnApi } from '@serenity-js/rest'
-     *
-     * // Define any custom configuration options, if needed
-     * interface MyCustomOptions {
-     *     apiUrl: string;
-     * }
-     *
-     * // Parameterise PlaywrightTestConfig with MyCustomOptions
-     * // to enable type checking of any custom properties
-     * const config: PlaywrightTestConfig<MyCustomOptions> = {
-     *     use: {
-     *         contextOptions: {
-     *             defaultNavigationTimeout: 30_000,
-     *         },
-     *
-     *         // custom properties
-     *         apiUrl: 'https://api.serenity-js.org/v1',
-     *
-     *         // Custom cast of actors receives `contextOptions`
-     *         // with the additional Serenity/JS properties (see `PlaywrightOptions`),
-     *         // as well as any other custom properties you define in the destructuring expression,
-     *         // such as `apiUrl`.
-     *         actors: ({ browser, contextOptions, apiUrl }, use) => {
-     *             const cast = Cast.where(actor => actor.whoCan(
-     *                 BrowseTheWebWithPlaywright.using(browser, contextOptions),
-     *                 TakeNotes.usingAnEmptyNotepad(),
-     *                 CallAnApi.at(apiUrl),
-     *             ))
-     *
-     *             // Make sure to pass your custom cast to Playwright `use` callback
-     *             use(cast)
-     *         },
-     *     },
-     * };
-     * export default config
-     * ```
-     *
-     * #### Learn more
-     * - Declaring a Serenity/JS [test scenario](https://serenity-js.org/api/playwright-test/function/it/)
-     * - [`SerenityFixtures`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/)
-     */
-    actors: TestFixture<Cast, PlaywrightTestOptions & PlaywrightWorkerArgs>;
-    /**
-     * Configures the name given to the default Serenity/JS [`actor`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actor)
-     * injected into a [test scenario](https://serenity-js.org/api/playwright-test/function/it/).
-     *
-     * #### Learn more
-     * - Declaring a Serenity/JS [test scenario](https://serenity-js.org/api/playwright-test/function/it/)
-     * - [`SerenityFixtures`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/)
-     */
-    defaultActorName: string;
-    /**
-     * Configures the [stage crew members](https://serenity-js.org/api/core/class/SerenityConfig/#crew)
-     * to be instantiated in Playwright Test worker processes.
-     *
-     * :::info Did you know?
-     * By default, Serenity/JS registers a [`Photographer`](https://serenity-js.org/api/web/class/Photographer/).whoWill([`TakePhotosOfFailures`](https://serenity-js.org/api/web/class/TakePhotosOfFailures/)),
-     * so that any test failures are automatically accompanied by a screenshot.
-     *
-     * If you prefer a different behaviour, you can configure the `crew` with an empty array to disable taking screenshots altogether (`crew: []`),
-     * or with a [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) who uses a different [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/), like to [`TakePhotosOfInteractions`](https://serenity-js.org/api/web/class/TakePhotosOfInteractions/).
-     * :::
-     *
-     * #### Example
-     *
-     * ```typescript
-     * // playwright.config.ts
-     * import type { PlaywrightTestConfig } from '@serenity-js/playwright-test'
-     *
-     * const config: PlaywrightTestConfig = {
-     *     use: {
-     *         crew: [
-     *             [ '@serenity-js/web:Photographer', { strategy: 'TakePhotosOfFailures' } ]
-     *         ],
-     *     },
-     * };
-     * export default config
-     * ```
-     *
-     * #### Learn more
-     * - [`SerenityConfig.crew`](https://serenity-js.org/api/core/class/SerenityConfig/#crew)
-     */
-    crew: Array<ClassDescription | StageCrewMember | StageCrewMemberBuilder>;
-    /**
-     * Sets the [`cueTimeout`](https://serenity-js.org/api/core/class/SerenityConfig/#cueTimeout) to a given [duration](https://serenity-js.org/api/core/class/Duration/) or a numeric value in milliseconds.
-     * Defaults to **5 seconds**.
-     *
-     * #### Learn more
-     * - [`SerenityConfig.cueTimeout`](https://serenity-js.org/api/core/class/SerenityConfig/#cueTimeout)
-     * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
-     * - [`Ability`](https://serenity-js.org/api/core/class/Ability/)
-     */
-    cueTimeout: number | Duration;
-    /**
-     * The maximum default amount of time allowed for interactions such as [`Wait.until`](https://serenity-js.org/api/core/class/Wait/#until)
-     * to complete.
-     *
-     * Defaults to **5 seconds**, can be overridden per interaction.
-     *
-     * #### Learn more
-     * - [`Wait.until`](https://serenity-js.org/api/core/class/Wait/#until)
-     */
-    interactionTimeout?: Duration;
-    /**
-     * Playwright [BrowserContextOptions](https://playwright.dev/docs/api/class-testoptions#test-options-context-options),
-     * augmented with several convenience properties to be used with the [ability](https://serenity-js.org/api/core/class/Ability/)
-     * to [`BrowseTheWebWithPlaywright`](https://serenity-js.org/api/playwright/class/BrowseTheWebWithPlaywright/).
-     *
-     * Additional convenience properties include:
-     * - [`PlaywrightOptions.defaultNavigationTimeout`](https://serenity-js.org/api/playwright/interface/PlaywrightOptions/#defaultNavigationTimeout)
-     * - [`PlaywrightOptions.defaultNavigationWaitUntil`](https://serenity-js.org/api/playwright/interface/PlaywrightOptions/#defaultNavigationWaitUntil)
-     * - [`PlaywrightOptions.defaultTimeout`](https://serenity-js.org/api/playwright/interface/PlaywrightOptions/#defaultTimeout)
-     *
-     * #### Using `contextOptions` with the default cast of Serenity/JS actors
-     *
-     * ```typescript
-     * // playwright.config.ts
-     * import type { PlaywrightTestConfig } from '@serenity-js/playwright-test'
-     *
-     * const config: PlaywrightTestConfig = {
-     *     use: {
-     *         contextOptions: {
-     *             defaultNavigationTimeout: 30_000,
-     *         }
-     *
-     *         // Since `actors` property is not defined,
-     *         // `contextOptions` will be passed to the default cast of Serenity/JS actors
-     *         // and injected into the ability to `BrowseTheWebWithPlaywright`
-     *         // that each actor receives.
-     *     },
-     * };
-     * export default config;
-     * ```
-     *
-     * #### Using `contextOptions` with a custom cast of Serenity/JS actors
-     *
-     * ```typescript
-     * // playwright.config.ts
-     * import type { PlaywrightTestConfig } from '@serenity-js/playwright-test'
-     *
-     * const config: PlaywrightTestConfig = {
-     *     use: {
-     *         contextOptions: {
-     *             defaultNavigationTimeout: 30_000,
-     *         }
-     *
-     *         // Custom cast of actors receives `contextOptions` with the
-     *         // additional Serenity/JS properties.
-     *         actors: ({ browser, contextOptions }, use) => {
-     *             const cast = Cast.where(actor => actor.whoCan(
-     *                 BrowseTheWebWithPlaywright.using(browser, contextOptions),
-     *                 TakeNotes.usingAnEmptyNotepad(),
-     *             ))
-     *
-     *             use(cast)
-     *         },
-     *     },
-     * };
-     * export default config;
-     * ```
-     *
-     * #### Learn more
-     * - [`SerenityFixtures`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/)
-     * - [Playwright Browser Context options](https://playwright.dev/docs/api/class-testoptions#test-options-context-options)
-     * - [Playwright Test fixtures](https://playwright.dev/docs/test-fixtures)
-     */
-    contextOptions: PlaywrightOptions;
-}
-//# sourceMappingURL=SerenityOptions.d.ts.map

package/lib/api/SerenityOptions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SerenityOptions.d.ts","sourceRoot":"","sources":["../../src/api/SerenityOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACnH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,MAAM,WAAW,eAAe;IAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAAC,CAAA;IAEvE;;;;;;;OAOG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,IAAI,EAAE,KAAK,CAAC,gBAAgB,GAAG,eAAe,GAAG,sBAAsB,CAAC,CAAC;IAEzE;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE9B;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8DG;IACH,cAAc,EAAE,iBAAiB,CAAC;CACrC"}

package/lib/api/SerenityOptions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SerenityOptions.js","sourceRoot":"","sources":["../../src/api/SerenityOptions.ts"],"names":[],"mappings":""}

package/lib/reporter/DomainEventBuffer.d.ts

@@ -1,11 +0,0 @@
-import type { Stage, StageCrewMember } from '@serenity-js/core';
-import type { DomainEvent } from '@serenity-js/core/lib/events';
-export declare class DomainEventBuffer implements StageCrewMember {
-    private stage?;
-    private events;
-    constructor(stage?: Stage);
-    assignedTo(stage: Stage): StageCrewMember;
-    notifyOf(event: DomainEvent): void;
-    flush(): DomainEvent[];
-}
-//# sourceMappingURL=DomainEventBuffer.d.ts.map

package/lib/reporter/DomainEventBuffer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DomainEventBuffer.d.ts","sourceRoot":"","sources":["../../src/reporter/DomainEventBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,qBAAa,iBAAkB,YAAW,eAAe;IAIzC,OAAO,CAAC,KAAK,CAAC;IAF1B,OAAO,CAAC,MAAM,CAAqB;gBAEf,KAAK,CAAC,EAAE,KAAK;IAGjC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;IAMzC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC,KAAK,IAAI,WAAW,EAAE;CAOzB"}

package/lib/reporter/DomainEventBuffer.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DomainEventBuffer = void 0;
-class DomainEventBuffer {
-    stage;
-    events = [];
-    constructor(stage) {
-        this.stage = stage;
-    }
-    assignedTo(stage) {
-        this.stage = stage;
-        return this;
-    }
-    notifyOf(event) {
-        this.events.push(event);
-    }
-    flush() {
-        const events = [...this.events];
-        this.events = [];
-        return events;
-    }
-}
-exports.DomainEventBuffer = DomainEventBuffer;
-//# sourceMappingURL=DomainEventBuffer.js.map

package/lib/reporter/DomainEventBuffer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DomainEventBuffer.js","sourceRoot":"","sources":["../../src/reporter/DomainEventBuffer.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;IAIN;IAFZ,MAAM,GAAkB,EAAE,CAAC;IAEnC,YAAoB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IACjC,CAAC;IAED,UAAU,CAAC,KAAY;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,QAAQ,CAAC,KAAkB;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AAxBD,8CAwBC"}

package/lib/reporter/PlaywrightAttachments.d.ts

@@ -1,2 +0,0 @@
-export declare const SERENITY_JS_DOMAIN_EVENTS_ATTACHMENT_CONTENT_TYPE = "application/vnd.serenity-js.domain-events+json";
-//# sourceMappingURL=PlaywrightAttachments.d.ts.map

package/lib/reporter/PlaywrightAttachments.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PlaywrightAttachments.d.ts","sourceRoot":"","sources":["../../src/reporter/PlaywrightAttachments.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iDAAiD,mDAAmD,CAAC"}

package/lib/reporter/PlaywrightAttachments.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SERENITY_JS_DOMAIN_EVENTS_ATTACHMENT_CONTENT_TYPE = void 0;
-exports.SERENITY_JS_DOMAIN_EVENTS_ATTACHMENT_CONTENT_TYPE = 'application/vnd.serenity-js.domain-events+json';
-//# sourceMappingURL=PlaywrightAttachments.js.map

package/lib/reporter/PlaywrightAttachments.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PlaywrightAttachments.js","sourceRoot":"","sources":["../../src/reporter/PlaywrightAttachments.ts"],"names":[],"mappings":";;;AAAa,QAAA,iDAAiD,GAAG,gDAAgD,CAAC"}

package/src/api/SerenityFixtures.ts

@@ -1,132 +0,0 @@
-import type { Actor, Cast, Serenity } from '@serenity-js/core';
-
-/**
- * Serenity/JS-specific [Playwright Test fixtures](https://playwright.dev/docs/test-fixtures)
- * injected into your [test scenarios](https://serenity-js.org/api/playwright-test/function/it/).
- *
- * ## Example test scenario
- *
- * ```typescript
- * import { Ensure, equals } from '@serenity-js/assertions'
- * import { describe, it, test } from '@serenity-js/playwright-test'
- * import { Photographer, TakePhotosOfFailures } from '@serenity-js/web'
- *
- * describe(`Recording items`, () => {
- *
- *     test.use({
- *         defaultActorName: 'Serena',
- *         crew: [
- *             Photographer.whoWill(TakePhotosOfFailures),
- *         ],
- *     })
- *
- *     describe(`Todo List App`, () => {
- *
- *         it(`should allow me to add a todo item`, async ({ actor }) => {
- *             await actor.attemptsTo(
- *                 startWithAnEmptyList(),
- *
- *                 recordItem('Buy some milk'),
- *
- *                 Ensure.that(itemNames(), equals([
- *                     'Buy some milk',
- *                 ])),
- *             )
- *         })
- *     })
- * })
- * ```
- *
- * ## Learn more
- * - Declaring a Serenity/JS [test scenario](https://serenity-js.org/api/playwright-test/function/it/)
- * - [Grouping test scenarios](https://serenity-js.org/api/playwright-test/function/describe/)
- * - [Serenity/JS + Playwright Test project template](https://github.com/serenity-js/serenity-js-playwright-test-template/)
- */
-export interface SerenityFixtures {
-
-    /**
-     * Retrieves the root object of the Serenity/JS framework.
-     */
-    serenity: Serenity;
-
-    /**
-     * Name and version of the operating system that Playwright Test worker process runs on.
-     */
-    platform: { name: string, version: string };
-
-    /**
-     * A cast of Serenity/JS actors to be used instead of the default cast
-     * when instantiating [`actor`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actor)
-     * and invoking [`actorCalled`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actorCalled).
-     *
-     * #### Overriding the default cast of Serenity/JS actors
-     *
-     * ```typescript
-     * import { Cast, TakeNotes } from '@serenity-js/core'
-     * import { Ensure, equals } from '@serenity-js/assertions'
-     * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
-     * import { describe, it, test } from '@serenity-js/playwright-test'
-     *
-     * describe(`Recording items`, () => {
-     *
-     *     test.use({
-     *         defaultActorName: 'Serena',
-     *         actors: ({ browser, contextOptions }, use) => {
-     *             const cast = Cast.where(actor =>
-     *                 actor.whoCan(
-     *                     BrowseTheWebWithPlaywright.using(browser, contextOptions),
-     *                     TakeNotes.usingAnEmptyNotepad(),
-     *                 )
-     *             )
-     *
-     *             // Make sure to pass your custom cast to Playwright `use` callback
-     *             use(cast)
-     *         },
-     *     })
-     *
-     *     describe(`Todo List App`, () => {
-     *
-     *         it(`should allow me to add a todo item`, async ({ actor }) => {
-     *             await actor.attemptsTo(
-     *                 startWithAnEmptyList(),
-     *
-     *                 recordItem('Buy some milk'),
-     *
-     *                 Ensure.that(itemNames(), equals([
-     *                     'Buy some milk',
-     *                 ])),
-     *             )
-     *         })
-     *     })
-     * })
-     * ```
-     */
-    actors: Cast;
-
-    /**
-     * Uses the provided [cast](https://serenity-js.org/api/core/class/Cast/) of [`actors`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actors) to instantiate an [`Actor`](https://serenity-js.org/api/core/class/Actor/) called `name`
-     * and inject it into a [test scenario](https://serenity-js.org/api/playwright-test/function/it/).
-     *
-     * Retrieves an existing actor if one has already been instantiated.
-     *
-     * #### Learn more
-     * - Declaring a Serenity/JS [test scenario](https://serenity-js.org/api/playwright-test/function/it/)
-     * - [`SerenityOptions.actors`](https://serenity-js.org/api/playwright-test/interface/SerenityOptions/#actors)
-     * - [`SerenityFixtures.actors`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actors)
-     *
-     * @param name
-     */
-    actorCalled: (name: string) => Actor;
-
-    /**
-     * Default [`actor`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actor) injected into a [test scenario](https://serenity-js.org/api/playwright-test/function/it/).
-     *
-     * Using `actor` fixture is equivalent to invoking [`actorCalled`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actorCalled) with [`defaultActorName`](https://serenity-js.org/api/playwright-test/interface/SerenityOptions/#defaultActorName).
-     *
-     * #### Learn more
-     * - [`actorCalled`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/#actorCalled)
-     * - [`SerenityOptions.defaultActorName`](https://serenity-js.org/api/playwright-test/interface/SerenityOptions/#defaultActorName)
-     * - Declaring a Serenity/JS [test scenario](https://serenity-js.org/api/playwright-test/function/it/)
-     */
-    actor: Actor;
-}