@serenity-js/web 3.0.0-rc.9 → 3.0.1

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

@@ -1,150 +1,127 @@
 import { Activity, Answerable, AnswersQuestions, Interaction, Task, UsesAbilities } from '@serenity-js/core';
-import { PageElement } from '../models';
+import { Switchable } from '../models';
 /**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor}
- *  to switch to a different [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/frame),
- *  [inline frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe),
- *  or browser window/tab.
- *
- * @example <caption>Lean Page Object describing a login form, embedded in an iframe</caption>
- *
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class LoginForm {
- *      static iframe           = Target.the('login form').located(by.tagName('iframe'));
- *      static usernameField    = Target.the('username field').located(by.css('[data-test="username"]'));
- *      static passwordField    = Target.the('password field').located(by.css('[data-test="password"]'));
- *      static submitButton     = Target.the('submit button').located(by.css(`button[type='submit']`));
- *  }
- *
- * @example <caption>Switch to an iframe and back</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Enter, Click } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toFrame(LoginForm.iframe),
- *
- *          Enter.theValue('francesca@example.org').into(LoginForm.usernameField),
- *          Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField),
- *          Click.on(LoginForm.submitButton),
- *
- *          Switch.toParentFrame(),
- *      );
+ * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
+ * to switch the context for future activities to a {@apilink Switchable}, such as a {@apilink Page} or a {@apilink PageElement}.
  *
- * @example <caption>Perform activities in the context of an iframe</caption>
+ * Please note that when the {@apilink PageElement} implementing {@apilink Switchable} represents an {@apilink iframe},
+ * using {@apilink Switch} will result in switching the top-level browsing context to that {@apilink iframe}.
  *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Enter, Click } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
+ * When the {@apilink PageElement} represents any other [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
+ * using {@apilink Switch} sets [`HTMLElement#focus`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)
+ * on the specified element. Assuming it can be focused.
  *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toFrame(LoginForm.iframe).and(
- *              Enter.theValue('francesca@example.org').into(LoginForm.usernameField),
- *              Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField),
- *              Click.on(LoginForm.submitButton),
- *          ),
- *          // Note that Switch.toParentFrame() is invoked automatically
- *      );
+ * **Note:** The focused element is the element which will receive keyboard {@apilink Press} events by default.
  *
- * @example <caption>Switch to a new window/tab and back</caption>
+ * ## Perform activities in the context of an iframe
  *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Close } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { By, Click, Enter, PageElement, Switch } from '@serenity-js/web'
  *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toNewWindow(), // or: Switch.toWindow(...)
+ * // Lean Page Object describing a login form, embedded in an iframe
+ * class LoginForm {
+ *   static iframe = () =>
+ *     PageElement.located(By.css('iframe'))
+ *       .describedAs('login form')
  *
- *          // perform some activities in the context of the new window
+ *   static usernameField = () =>
+ *     PageElement.located(By.css('[data-testid="username"]'))
+ *       .describedAs('username field')
  *
- *          Close.currentWindow(),
+ *   static passwordField = () =>
+ *     PageElement.located(By.css('[data-testid="password"]'))
+ *       .describedAs('password field')
  *
- *          Switch.toOriginalWindow(),
- *      );
- *
- * @example <caption>Perform activities in the context of a different window/tab</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Close } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toNewWindow().and(
- *              // perform some activities in the context of the new window
- *
- *              Close.currentWindow()
- *          ),
- *
- *          // Note that Switch.toOriginalWindow() is invoked automatically
- *      );
+ *   static submitButton = () =>
+ *     PageElement.located(By.css('button[type="submit"]'))
+ *       .describedAs('submit button')
+ *  }
  *
- * @see {@link Close}
- * @see {@link BrowseTheWeb}
+ *  await actorCalled('Francesca')
+ *    .attemptsTo(
+ *      Switch.to(LoginForm.iframe).and(
+ *        Enter.theValue('francesca@example.org').into(LoginForm.usernameField()),
+ *        Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField()),
+ *        Click.on(LoginForm.submitButton()),
+ *      )
+ *    )
+ * ```
+ *
+ * ## Perform activities in the context of another page
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Click, Enter, Switch } from '@serenity-js/web'
+ *
+ * await actorCalled('Francesca')
+ *   .whoCan(BrowseTheWebWithWebdriverIO.using(browser))
+ *   .attemptsTo(
+ *     Switch.to(Page.whichName(startsWith('popup'))).and(
+ *       // perform some activities in the context of the new window
+ *
+ *       // optionally, close the browser tab
+ *       Page.current().close(),
+ *     ),
+ *
+ *     // Note that switching back to the original page happens automatically
+ *     // after the last activity from the list finishes
+ *   )
+ * ```
+ *
+ * ## Perform activities in the context of a focused page element
+ *
+ * ```ts
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Key, PageElement, Press, Switch, Value } from '@serenity-js/web'
+ *
+ * const inputField = () =>
+ *   PageElement.located(By.css('input'));
+ *
+ * await actorCalled('Francesca')
+ *   .whoCan(BrowseTheWebWithWebdriverIO.using(browser))
+ *   .attemptsTo(
+ *     Switch.to(inputField()).and(
+ *       Press.the('h', 'e', 'l', 'l', 'o'),
+ *       Press.the(Key.Tab),
+ *     ),
+ *     Ensure.that(Value.of(inputField()), equals('hello'))
+ *   )
+ * ```
+ *
+ * ## Learn more
+ *
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink Switchable}
+ * - {@apilink SwitchableOrigin}
+ *
+ * @group Activities
  */
-export declare class Switch {
+export declare class Switch extends Interaction {
+    private readonly switchable;
     /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to a [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/frame)
-     *  or an [inline frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe)
-     *  identified by its name, index or `Question<ElementFinder>`.
+     * Instructs the {@apilink Actor}
+     * to switch the context for future activities to a {@apilink Switchable},
+     * such as a {@apilink Page} or a {@apilink PageElement}.
      *
-     * @param {Answerable<ElementFinder | number | string>} targetOrIndex
-     *
-     * @returns {SwitchToFrame}
-     *
-     * @see {@link Switch.toParentFrame}
-     * @see {@link Switch.toDefaultContent}
-     * @see {@link Target}
+     * @param switchable
      */
-    static toFrame(targetOrIndex: Answerable<PageElement | number | string>): SwitchToFrame;
+    static to(switchable: Answerable<Switchable>): Switch;
+    protected constructor(switchable: Answerable<Switchable>);
     /**
-     * @desc
-     *  Sets the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the parent of the current browsing context,
-     *  i.e. an `iframe` in which the current `iframe` is nested.
-     *
-     *  If the current context is the top-level browsing context, the context remains unchanged.
+     * Instructs the {@apilink Actor}
+     * to switch the context for future activities to a {@apilink Switchable},
+     * such as a {@apilink Page} or a {@apilink PageElement},
+     * perform a sequence of `activities`, and then switch the context back.
      *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link Switch.toFrame}
-     * @see https://w3c.github.io/webdriver/#switch-to-parent-frame
-     * @see https://w3c.github.io/webdriver/#dfn-current-browsing-context
+     * @param activities
+     *  A sequence of activities to perform
      */
-    static toParentFrame(): Interaction;
+    and(...activities: Activity[]): Task;
     /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the first frame on the page, or the main document
-     *  when a page contains [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe)s.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link Switch.toFrame}
+     * @inheritDoc
      */
-    static toDefaultContent(): Interaction;
-}
-/**
- * @package
- */
-declare class SwitchToFrame extends Interaction {
-    private readonly targetOrIndex;
-    constructor(targetOrIndex: Answerable<PageElement | number | string>);
-    and(...activities: Activity[]): Task;
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void>;
-    toString(): string;
+    performAs(actor: UsesAbilities & AnswersQuestions): Promise<void>;
 }
-export {};
+//# sourceMappingURL=Switch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Switch.d.ts","sourceRoot":"","sources":["../../../src/screenplay/interactions/Switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAS,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGG;AACH,qBAAa,MAAO,SAAQ,WAAW;IAab,OAAO,CAAC,QAAQ,CAAC,UAAU;IAXjD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,MAAM;IAIrD,SAAS,aAA8B,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;IAIzE;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI;IAIpC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAK1E"}

package/lib/screenplay/interactions/Switch.js

@@ -2,208 +2,157 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Switch = void 0;
 const core_1 = require("@serenity-js/core");
-const abilities_1 = require("../abilities");
 /**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor}
- *  to switch to a different [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/frame),
- *  [inline frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe),
- *  or browser window/tab.
- *
- * @example <caption>Lean Page Object describing a login form, embedded in an iframe</caption>
- *
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class LoginForm {
- *      static iframe           = Target.the('login form').located(by.tagName('iframe'));
- *      static usernameField    = Target.the('username field').located(by.css('[data-test="username"]'));
- *      static passwordField    = Target.the('password field').located(by.css('[data-test="password"]'));
- *      static submitButton     = Target.the('submit button').located(by.css(`button[type='submit']`));
- *  }
- *
- * @example <caption>Switch to an iframe and back</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Enter, Click } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toFrame(LoginForm.iframe),
- *
- *          Enter.theValue('francesca@example.org').into(LoginForm.usernameField),
- *          Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField),
- *          Click.on(LoginForm.submitButton),
- *
- *          Switch.toParentFrame(),
- *      );
- *
- * @example <caption>Perform activities in the context of an iframe</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Enter, Click } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toFrame(LoginForm.iframe).and(
- *              Enter.theValue('francesca@example.org').into(LoginForm.usernameField),
- *              Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField),
- *              Click.on(LoginForm.submitButton),
- *          ),
- *          // Note that Switch.toParentFrame() is invoked automatically
- *      );
- *
- * @example <caption>Switch to a new window/tab and back</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Close } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
+ * Instructs an {@apilink Actor|actor} who has the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
+ * to switch the context for future activities to a {@apilink Switchable}, such as a {@apilink Page} or a {@apilink PageElement}.
  *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toNewWindow(), // or: Switch.toWindow(...)
+ * Please note that when the {@apilink PageElement} implementing {@apilink Switchable} represents an {@apilink iframe},
+ * using {@apilink Switch} will result in switching the top-level browsing context to that {@apilink iframe}.
  *
- *          // perform some activities in the context of the new window
+ * When the {@apilink PageElement} represents any other [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement),
+ * using {@apilink Switch} sets [`HTMLElement#focus`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)
+ * on the specified element. Assuming it can be focused.
  *
- *          Close.currentWindow(),
+ * **Note:** The focused element is the element which will receive keyboard {@apilink Press} events by default.
  *
- *          Switch.toOriginalWindow(),
- *      );
+ * ## Perform activities in the context of an iframe
  *
- * @example <caption>Perform activities in the context of a different window/tab</caption>
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { By, Click, Enter, PageElement, Switch } from '@serenity-js/web'
  *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Close } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
+ * // Lean Page Object describing a login form, embedded in an iframe
+ * class LoginForm {
+ *   static iframe = () =>
+ *     PageElement.located(By.css('iframe'))
+ *       .describedAs('login form')
  *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toNewWindow().and(
- *              // perform some activities in the context of the new window
+ *   static usernameField = () =>
+ *     PageElement.located(By.css('[data-testid="username"]'))
+ *       .describedAs('username field')
  *
- *              Close.currentWindow()
- *          ),
+ *   static passwordField = () =>
+ *     PageElement.located(By.css('[data-testid="password"]'))
+ *       .describedAs('password field')
  *
- *          // Note that Switch.toOriginalWindow() is invoked automatically
- *      );
+ *   static submitButton = () =>
+ *     PageElement.located(By.css('button[type="submit"]'))
+ *       .describedAs('submit button')
+ *  }
  *
- * @see {@link Close}
- * @see {@link BrowseTheWeb}
+ *  await actorCalled('Francesca')
+ *    .attemptsTo(
+ *      Switch.to(LoginForm.iframe).and(
+ *        Enter.theValue('francesca@example.org').into(LoginForm.usernameField()),
+ *        Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField()),
+ *        Click.on(LoginForm.submitButton()),
+ *      )
+ *    )
+ * ```
+ *
+ * ## Perform activities in the context of another page
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Click, Enter, Switch } from '@serenity-js/web'
+ *
+ * await actorCalled('Francesca')
+ *   .whoCan(BrowseTheWebWithWebdriverIO.using(browser))
+ *   .attemptsTo(
+ *     Switch.to(Page.whichName(startsWith('popup'))).and(
+ *       // perform some activities in the context of the new window
+ *
+ *       // optionally, close the browser tab
+ *       Page.current().close(),
+ *     ),
+ *
+ *     // Note that switching back to the original page happens automatically
+ *     // after the last activity from the list finishes
+ *   )
+ * ```
+ *
+ * ## Perform activities in the context of a focused page element
+ *
+ * ```ts
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Key, PageElement, Press, Switch, Value } from '@serenity-js/web'
+ *
+ * const inputField = () =>
+ *   PageElement.located(By.css('input'));
+ *
+ * await actorCalled('Francesca')
+ *   .whoCan(BrowseTheWebWithWebdriverIO.using(browser))
+ *   .attemptsTo(
+ *     Switch.to(inputField()).and(
+ *       Press.the('h', 'e', 'l', 'l', 'o'),
+ *       Press.the(Key.Tab),
+ *     ),
+ *     Ensure.that(Value.of(inputField()), equals('hello'))
+ *   )
+ * ```
+ *
+ * ## Learn more
+ *
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink Switchable}
+ * - {@apilink SwitchableOrigin}
+ *
+ * @group Activities
  */
-class Switch {
+class Switch extends core_1.Interaction {
     /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to a [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/frame)
-     *  or an [inline frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe)
-     *  identified by its name, index or `Question<ElementFinder>`.
-     *
-     * @param {Answerable<ElementFinder | number | string>} targetOrIndex
-     *
-     * @returns {SwitchToFrame}
+     * Instructs the {@apilink Actor}
+     * to switch the context for future activities to a {@apilink Switchable},
+     * such as a {@apilink Page} or a {@apilink PageElement}.
      *
-     * @see {@link Switch.toParentFrame}
-     * @see {@link Switch.toDefaultContent}
-     * @see {@link Target}
+     * @param switchable
      */
-    static toFrame(targetOrIndex) {
-        return new SwitchToFrame(targetOrIndex);
+    static to(switchable) {
+        return new Switch(switchable);
+    }
+    constructor(switchable) {
+        super(`#actor switches to ${switchable}`);
+        this.switchable = switchable;
     }
     /**
-     * @desc
-     *  Sets the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the parent of the current browsing context,
-     *  i.e. an `iframe` in which the current `iframe` is nested.
-     *
-     *  If the current context is the top-level browsing context, the context remains unchanged.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
+     * Instructs the {@apilink Actor}
+     * to switch the context for future activities to a {@apilink Switchable},
+     * such as a {@apilink Page} or a {@apilink PageElement},
+     * perform a sequence of `activities`, and then switch the context back.
      *
-     * @see {@link Switch.toFrame}
-     * @see https://w3c.github.io/webdriver/#switch-to-parent-frame
-     * @see https://w3c.github.io/webdriver/#dfn-current-browsing-context
+     * @param activities
+     *  A sequence of activities to perform
      */
-    static toParentFrame() {
-        return new SwitchToParentFrame();
+    and(...activities) {
+        return new SwitchAndPerformActivities(this.switchable, activities);
     }
     /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the first frame on the page, or the main document
-     *  when a page contains [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe)s.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link Switch.toFrame}
+     * @inheritDoc
      */
-    static toDefaultContent() {
-        return new SwitchToDefaultContent();
+    async performAs(actor) {
+        const switchable = await actor.answer(this.switchable);
+        await switchable.switchTo();
     }
 }
 exports.Switch = Switch;
 /**
  * @package
  */
-class SwitchToFrame extends core_1.Interaction {
-    constructor(targetOrIndex) {
-        super();
-        this.targetOrIndex = targetOrIndex;
-    }
-    and(...activities) {
-        return new SwitchToFrameAndPerformActivities(this.targetOrIndex, activities);
-    }
-    performAs(actor) {
-        return actor.answer(this.targetOrIndex)
-            .then((targetOrIndex) => {
-            return abilities_1.BrowseTheWeb.as(actor).switchToFrame(targetOrIndex);
-        });
-    }
-    toString() {
-        return `#actor switches to frame: ${this.targetOrIndex}`;
-    }
-}
-/**
- * @package
- */
-class SwitchToFrameAndPerformActivities extends core_1.Task {
-    constructor(targetOrIndex, activities) {
-        super();
-        this.targetOrIndex = targetOrIndex;
+class SwitchAndPerformActivities extends core_1.Task {
+    constructor(switchable, activities) {
+        super(`#actor switches to ${switchable}`);
+        this.switchable = switchable;
         this.activities = activities;
     }
-    performAs(actor) {
-        return actor.attemptsTo(new SwitchToFrame(this.targetOrIndex), ...this.activities, new SwitchToParentFrame());
-    }
-    toString() {
-        return `#actor switches to frame: ${this.targetOrIndex}`;
-    }
-}
-/**
- * @package
- */
-class SwitchToParentFrame extends core_1.Interaction {
-    performAs(actor) {
-        return abilities_1.BrowseTheWeb.as(actor).switchToParentFrame();
-    }
-    toString() {
-        return `#actor switches to parent frame`;
-    }
-}
-/**
- * @package
- */
-class SwitchToDefaultContent extends core_1.Interaction {
-    performAs(actor) {
-        return abilities_1.BrowseTheWeb.as(actor).switchToDefaultContent();
-    }
-    toString() {
-        return `#actor switches to default content`;
+    /**
+     * @inheritDoc
+     */
+    async performAs(actor) {
+        const switchable = await actor.answer(this.switchable);
+        const origin = await switchable.switchTo();
+        await actor.attemptsTo(...this.activities);
+        await origin.switchBack();
     }
 }
 //# sourceMappingURL=Switch.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Switch.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/Switch.ts"],"names":[],"mappings":";;;AAAA,4CAAiI;AAEjI,4CAA4C;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,MAAa,MAAM;IAEf;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,aAAwD;QACnE,OAAO,IAAI,aAAa,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,aAAa;QAChB,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,gBAAgB;QACnB,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACxC,CAAC;CACJ;AApDD,wBAoDC;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,kBAAW;IACnC,YAA6B,aAAwD;QACjF,KAAK,EAAE,CAAC;QADiB,kBAAa,GAAb,aAAa,CAA2C;IAErF,CAAC;IAED,GAAG,CAAC,GAAG,UAAsB;QACzB,OAAO,IAAI,iCAAiC,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACjF,CAAC;IAED,SAAS,CAAC,KAAuC;QAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;aAClC,IAAI,CAAC,CAAC,aAA4C,EAAE,EAAE;YACnD,OAAO,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACX,CAAC;IAED,QAAQ;QACJ,OAAO,6BAA8B,IAAI,CAAC,aAAc,EAAE,CAAC;IAC/D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,iCAAkC,SAAQ,WAAI;IAChD,YACqB,aAAwD,EACxD,UAAsB;QAEvC,KAAK,EAAE,CAAC;QAHS,kBAAa,GAAb,aAAa,CAA2C;QACxD,eAAU,GAAV,UAAU,CAAY;IAG3C,CAAC;IAED,SAAS,CAAC,KAAyB;QAC/B,OAAO,KAAK,CAAC,UAAU,CACnB,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,EACrC,GAAG,IAAI,CAAC,UAAU,EAClB,IAAI,mBAAmB,EAAE,CAC5B,CAAA;IACL,CAAC;IAED,QAAQ;QACJ,OAAO,6BAA8B,IAAI,CAAC,aAAc,EAAE,CAAC;IAC/D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,mBAAoB,SAAQ,kBAAW;IACzC,SAAS,CAAC,KAAuC;QAC7C,OAAO,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,mBAAmB,EAAE,CAAC;IACxD,CAAC;IAED,QAAQ;QACJ,OAAO,iCAAiC,CAAC;IAC7C,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,sBAAuB,SAAQ,kBAAW;IAC5C,SAAS,CAAC,KAAuC;QAC7C,OAAO,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,sBAAsB,EAAE,CAAC;IAC3D,CAAC;IAED,QAAQ;QACJ,OAAO,oCAAoC,CAAC;IAChD,CAAC;CACJ"}
+{"version":3,"file":"Switch.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/Switch.ts"],"names":[],"mappings":";;;AAAA,4CAAoH;AAIpH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGG;AACH,MAAa,MAAO,SAAQ,kBAAW;IAEnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,UAAkC;QACxC,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,YAAuC,UAAkC;QACrE,KAAK,CAAC,sBAAuB,UAAW,EAAE,CAAC,CAAC;QADT,eAAU,GAAV,UAAU,CAAwB;IAEzE,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,UAAsB;QACzB,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAAuC;QACnD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvD,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;CACJ;AAtCD,wBAsCC;AAED;;GAEG;AACH,MAAM,0BAA2B,SAAQ,WAAI;IACzC,YACqB,UAAkC,EAClC,UAAsB;QAEvC,KAAK,CAAC,sBAAuB,UAAW,EAAE,CAAC,CAAC;QAH3B,eAAU,GAAV,UAAU,CAAwB;QAClC,eAAU,GAAV,UAAU,CAAY;IAG3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAAY;QAExB,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;QAE3C,MAAM,KAAK,CAAC,UAAU,CAClB,GAAG,IAAI,CAAC,UAAU,CACrB,CAAA;QAED,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;CACJ"}