@serenity-js/protractor 2.32.2 → 3.0.0-rc.0

package/lib/screenplay/interactions/Wait.js

@@ -1,247 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Wait = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-const abilities_1 = require("../abilities");
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
- *  wait before proceeding either for a set {@link @serenity-js/core/lib/model~Duration}
- *  or until a given {@link @serenity-js/core/lib/screenplay/questions~Expectation} is met.
- *
- *  Useful when a test scenario can't take advantage of automatic synchronisation between
- *  Protractor and Angular (see {@link UseAngular}), or when the application under test is animation-heavy.
- *
- * @example <caption>Example widget</caption>
- *  <!--
- *      After about 1 second, the text will change from 'Loading...' to 'Ready!'
- *  -->
- *  <h1 id="status">Loading...</h1>
- *  <script>
- *      (function () {
- *          setTimeout(function () {
- *              document.getElementById('status').textContent = 'Ready!'
- *          }, 1000);
- *      })();
- *  </script>
- *
- * @example <caption>Lean Page Object describing the widget</caption>
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class App {
- *      static status = Target.the('status widget')
- *          .located(by.id('status'));
- *  }
- *
- * @example <caption>Waiting for a set amount of time</caption>
- *  import { actorCalled, Duration } from '@serenity-js/core';
- *  import { BrowseTheWeb, Wait } from '@serenity-js/protractor';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Aurora')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Wait.for(Duration.ofSeconds(1.5)),
- *          Ensure.that(App.status, equals('Ready!')),
- *      );
- *
- *  // Please note that while the above implementation works,
- *  // this approach is inefficient because at best
- *  // the actor might wait too long and at worst the test
- *  // might become "flaky" if any external interference
- *  // (like network glitches, animations taking a bit too long etc.)
- *  // makes the actor wait not long enough.
- *
- * @example <caption>Waiting until a condition is met</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Wait, Text } from '@serenity-js/protractor';
- *  import { equals } from '@serenity-js/assertions';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Aurora')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Wait.until(Text.of(App.status), equals('Ready!')),
- *          // app is ready, proceed with the scenario
- *      );
- *
- *  // Wait.until makes the Actor keep asking a Question,
- *  // in this case Text.of(App.status), until the answer meets
- *  // the expectation, or a timeout expires (default: 5s).
- *  //
- *  // Please note that both Ensure and Wait can be used with
- *  // the same expectations, like `equals`.
- *
- * @example <caption>Changing the default timeout</caption>
- *  import { actorCalled, Duration } from '@serenity-js/core';
- *  import { BrowseTheWeb, Wait, Text } from '@serenity-js/protractor';
- *  import { equals } from '@serenity-js/assertions';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Aurora')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Wait.upTo(Duration.ofSeconds(3))
- *              .until(Text.of(App.status), equals('Ready!')),
- *          // app is ready, proceed with the scenario
- *      );
- *
- * @see {@link BrowseTheWeb}
- * @see {@link Target}
- * @see {@link Text}
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/assertions/lib/expectations~equals}
- * @see {@link @serenity-js/core/lib/model~Duration}
- *
- * @extends {@serenity-js/core/lib/screenplay~Interaction}
- */
-class Wait {
-    /**
-     * @desc
-     *  Instantiates a version of this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  configured to wait for a set duration.
-     *
-     * @param {Answerable<Duration>} duration
-     *  A set duration the {@link @serenity-js/core/lib/screenplay/actor~Actor} should wait for
-     *  before proceeding
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     */
-    static for(duration) {
-        return new WaitFor(duration);
-    }
-    /**
-     * @desc
-     *  Instantiates a version of this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  configured to wait until the answer to the question (`actual`) meets the `expectation`,
-     *  or a custom timeout expires.
-     *
-     * @param {Duration} duration
-     *  Custom timeout to override {@link Wait.Default_Timeout}
-     *
-     * @returns {WaitBuilder}
-     */
-    static upTo(duration) {
-        return {
-            until: (actual, expectation) => new WaitUntil(actual, expectation, duration),
-        };
-    }
-    /**
-     * @desc
-     *  Instantiates a version of this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  configured to wait until the answer to the question (`actual`) meets the `expectation`,
-     *  or a {@link Wait.Default_Timeout} expires.
-     *
-     * @param {Answerable<Actual>} actual
-     *  A {@link @serenity-js/core/lib/screenplay~Question}
-     *  that the {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  will keep asking until the answer meets
-     *  the {@link @serenity-js/core/lib/screenplay/questions~Expectation} provided
-     *
-     * @param {@serenity-js/core/lib/screenplay/questions~<any,Actual>} expectation
-     *  An {@link @serenity-js/core/lib/screenplay/questions~Expectation} to be met before proceeding
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     */
-    static until(actual, expectation) {
-        return new WaitUntil(actual, expectation, Wait.Default_Timeout);
-    }
-}
-exports.Wait = Wait;
-/**
- * @desc
- *  Default timeout of 5 seconds used with {@link Wait.until}.
- *
- * @type {@serenity-js/core~Duration}
- */
-Wait.Default_Timeout = core_1.Duration.ofSeconds(5);
-/**
- * @package
- */
-class WaitFor extends core_1.Interaction {
-    constructor(duration) {
-        super();
-        this.duration = duration;
-    }
-    /**
-     * @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 actor.answer(this.duration)
-            .then(duration => abilities_1.BrowseTheWeb.as(actor).sleep(duration.inMilliseconds()));
-    }
-    /**
-     * @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 waits for ${this.duration}`;
-    }
-}
-/**
- * @package
- */
-class WaitUntil extends core_1.Interaction {
-    constructor(actual, expectation, timeout) {
-        super();
-        this.actual = actual;
-        this.expectation = expectation;
-        this.timeout = timeout;
-    }
-    /**
-     * @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) {
-        const actual = this.actual, expectation = this.expectation.answeredBy(actor);
-        let expectationOutcome;
-        return abilities_1.BrowseTheWeb.as(actor)
-            .wait(function () {
-            return actor.answer(actual)
-                .then(act => expectation(act))
-                .then(outcome => {
-                expectationOutcome = outcome;
-                return outcome instanceof core_1.ExpectationMet;
-            });
-        }, this.timeout.inMilliseconds())
-            .then(_ => void 0)
-            .catch(error => {
-            if (expectationOutcome) {
-                throw new core_1.AssertionError(`Waited ${this.timeout.toString()} for ${(0, io_1.formatted) `${this.actual}`} to ${this.expectation.toString()}`, expectationOutcome.expected, expectationOutcome.actual, error);
-            }
-            throw error;
-        });
-    }
-    /**
-     * @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 waits up to ${this.timeout} until ${this.actual} does ${this.expectation}`;
-    }
-}
-//# sourceMappingURL=Wait.js.map

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

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

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

@@ -1,33 +0,0 @@
-import { Answerable, Expectation } from '@serenity-js/core';
-import { Interaction } from '@serenity-js/core/lib/screenplay';
-/**
- * @desc
- *  Fluent interface to make the instantiation of
- *  the {@link @serenity-js/core/lib/screenplay~Interaction}
- *  to {@link Wait} more readable.
- *
- * @see {@link Wait}
- *
- * @interface
- */
-export interface WaitBuilder {
-    /**
-     * @desc
-     *  Instantiates an {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  to {@link Wait}.
-     *
-     * @param {Answerable<Actual>} actual
-     *  A {@link @serenity-js/core/lib/screenplay~Question}
-     *  that the {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  will keep asking until the answer meets
-     *  the {@link @serenity-js/core/lib/screenplay/questions~Expectation} provided
-     *
-     * @param {@serenity-js/core/lib/screenplay/questions~Expectation<any,Actual>} expectation
-     *  An {@link @serenity-js/assertions~Expectation} to be met before proceeding
-     *
-     * @returns {Interaction}
-     *
-     * @see {@link Target}
-     */
-    until: <Actual>(actual: Answerable<Actual>, expectation: Expectation<any, Actual>) => Interaction;
-}

package/lib/screenplay/interactions/WaitBuilder.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=WaitBuilder.js.map

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

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

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

@@ -1,29 +0,0 @@
-import { Answerable, AnswersQuestions, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-export declare class Attribute extends Question<Promise<string>> {
-    private readonly target;
-    private readonly name;
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     * @returns {AttributeBuilder}
-     */
-    static of(target: Question<ElementFinder> | ElementFinder): AttributeBuilder;
-    constructor(target: Question<ElementFinder> | ElementFinder, name: Answerable<string>);
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string>;
-}
-interface AttributeBuilder {
-    called(name: Answerable<string>): Attribute;
-}
-export {};

package/lib/screenplay/questions/Attribute.js

@@ -1,56 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Attribute = 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");
-// todo: it might be better to swap the order of arguments
-//  - Attribute.called('href').of(link) to make it work with ArrayListFilter
-class Attribute extends core_1.Question {
-    constructor(target, name) {
-        super((0, io_1.formatted) `the value of the ${name} attribute of ${target}`);
-        this.target = target;
-        this.name = name;
-    }
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     * @returns {AttributeBuilder}
-     */
-    static of(target) {
-        return {
-            called: (name) => new Attribute(target, name),
-        };
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor) {
-        return actor.answer(this.name)
-            .then(name => (0, withAnswerOf_1.withAnswerOf)(actor, this.target, (elf) => elf.getAttribute(name).then(value => {
-            return value !== null // workaround for bug in Chromium 91 - https://bugs.chromium.org/p/chromium/issues/detail?id=1205107&start=300
-                ? value
-                : abilities_1.BrowseTheWeb.as(actor).executeFunction(
-                /* istanbul ignore next */
-                function getAttribute(webElement, attributeName) {
-                    // eslint-disable-next-line no-var
-                    var value = (webElement[attributeName] || webElement.getAttribute(attributeName));
-                    if (value !== null && value !== undefined) {
-                        return '' + value;
-                    }
-                    return value;
-                }, elf.getWebElement(), name);
-        })));
-    }
-}
-exports.Attribute = Attribute;
-//# sourceMappingURL=Attribute.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Attribute.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Attribute.ts"],"names":[],"mappings":";;;AAAA,4CAA0F;AAC1F,iDAAqD;AAGrD,4CAA4C;AAC5C,kDAA+C;AAE/C,0DAA0D;AAC1D,4EAA4E;AAE5E,MAAa,SAAU,SAAQ,eAAyB;IAWpD,YACqB,MAA+C,EAC/C,IAAwB;QAEzC,KAAK,CAAC,IAAA,cAAS,EAAC,oBAAqB,IAAK,iBAAkB,MAAM,EAAE,CAAC,CAAC;QAHrD,WAAM,GAAN,MAAM,CAAyC;QAC/C,SAAI,GAAJ,IAAI,CAAoB;IAG7C,CAAC;IAfD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAA+C;QACrD,OAAO;YACH,MAAM,EAAE,CAAC,IAAwB,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC;SACpE,CAAC;IACN,CAAC;IASD;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACzB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAA,2BAAY,EAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,GAAkB,EAAE,EAAE,CAClE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;YAChC,OAAO,KAAK,KAAK,IAAI,CAAe,8GAA8G;gBAC9I,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,eAAe;gBACpC,0BAA0B;gBAC1B,SAAS,YAAY,CAAC,UAAU,EAAE,aAAqB;oBACnD,kCAAkC;oBAClC,IAAI,KAAK,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC;oBAClF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE;wBACvC,OAAO,EAAE,GAAG,KAAK,CAAC;qBACrB;oBACD,OAAO,KAAK,CAAC;gBACjB,CAAC,EACD,GAAG,CAAC,aAAa,EAAE,EACnB,IAAI,CACP,CAAC;QACV,CAAC,CAAC,CACL,CAAC,CAAC;IACX,CAAC;CACJ;AApDD,8BAoDC"}

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

@@ -1,47 +0,0 @@
-import { Question } from '@serenity-js/core';
-import { logging } from 'selenium-webdriver';
-export declare class Browser {
-    /**
-     * @desc
-     *  Creates a {@link Question} that reads the entries of the browser log
-     *  so that they can be asserted on.
-     *
-     *  Please note that in order to ensure that the automated test has access to the browser log,
-     *  Protractor needs to be configured with the desired logging level, as per the example below.
-     *
-     * @example <caption>Enabling Protractor browser logging</caption>
-     * // protractor.conf.js
-     * exports.config = {
-     *   capabilities: {
-     *     loggingPrefs: {
-     *         // available options: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL
-     *         browser: 'SEVERE'
-     *     },
-     *   }
-     * }
-     *
-     * @example <caption>Ensure the app didn't log anything to the console during the test</caption>
-     * import { Actor, BrowseTheWeb, Browser } from '@serenity-js/core';
-     * import { Ensure, property, equals } from '@serenity-js/assertions';
-     *
-     * actor.attemptsTo(
-     *   Ensure.that(Browser.log(), property('length', equals(0))),
-     * );
-     *
-     * @example <caption>Mark the test as "compromised" if the server responds with a 500 to any AJAX request during the test</caption>
-     * import { Actor, BrowseTheWeb, Browser, TestCompromisedError } from '@serenity-js/core';
-     * import { Ensure, property, equals, not, contrainAtLeastOneItemThat } from '@serenity-js/assertions'
-     *
-     * actor.attemptsTo(
-     *   Ensure.that(Browser.log(),
-     *     not(contrainAtLeastOneItemThat(
-     *       property('message', includes('the server responded with a status of 500'))
-     *     ))
-     *   ).otherwiseFailWith(TestCompromisedError, 'The server is down'),
-     * );
-     *
-     * @see https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities#loggingpreferences-json-object
-     * @returns {Question<Promise<logging.Entry[]>>}
-     */
-    static log(): Question<Promise<logging.Entry[]>>;
-}

package/lib/screenplay/questions/Browser.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Browser = void 0;
-const core_1 = require("@serenity-js/core");
-const promiseOf_1 = require("../../promiseOf");
-const abilities_1 = require("../abilities");
-class Browser {
-    /**
-     * @desc
-     *  Creates a {@link Question} that reads the entries of the browser log
-     *  so that they can be asserted on.
-     *
-     *  Please note that in order to ensure that the automated test has access to the browser log,
-     *  Protractor needs to be configured with the desired logging level, as per the example below.
-     *
-     * @example <caption>Enabling Protractor browser logging</caption>
-     * // protractor.conf.js
-     * exports.config = {
-     *   capabilities: {
-     *     loggingPrefs: {
-     *         // available options: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL
-     *         browser: 'SEVERE'
-     *     },
-     *   }
-     * }
-     *
-     * @example <caption>Ensure the app didn't log anything to the console during the test</caption>
-     * import { Actor, BrowseTheWeb, Browser } from '@serenity-js/core';
-     * import { Ensure, property, equals } from '@serenity-js/assertions';
-     *
-     * actor.attemptsTo(
-     *   Ensure.that(Browser.log(), property('length', equals(0))),
-     * );
-     *
-     * @example <caption>Mark the test as "compromised" if the server responds with a 500 to any AJAX request during the test</caption>
-     * import { Actor, BrowseTheWeb, Browser, TestCompromisedError } from '@serenity-js/core';
-     * import { Ensure, property, equals, not, contrainAtLeastOneItemThat } from '@serenity-js/assertions'
-     *
-     * actor.attemptsTo(
-     *   Ensure.that(Browser.log(),
-     *     not(contrainAtLeastOneItemThat(
-     *       property('message', includes('the server responded with a status of 500'))
-     *     ))
-     *   ).otherwiseFailWith(TestCompromisedError, 'The server is down'),
-     * );
-     *
-     * @see https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities#loggingpreferences-json-object
-     * @returns {Question<Promise<logging.Entry[]>>}
-     */
-    static log() {
-        return core_1.Question.about(`browser log`, actor => (0, promiseOf_1.promiseOf)(abilities_1.BrowseTheWeb.as(actor).manage().logs().get('browser')));
-    }
-}
-exports.Browser = Browser;
-//# sourceMappingURL=Browser.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Browser.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Browser.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAG7C,+CAA4C;AAC5C,4CAA4C;AAE5C,MAAa,OAAO;IAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,MAAM,CAAC,GAAG;QACN,OAAO,eAAQ,CAAC,KAAK,CAA2B,aAAa,EAAE,KAAK,CAAC,EAAE,CACnE,IAAA,qBAAS,EAAC,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;CACJ;AAhDD,0BAgDC"}

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

@@ -1,94 +0,0 @@
-import { AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-/**
- * @desc
- *  Resolves to an array of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
- *  of a given {@link WebElement}, represented by {@link ElementFinder} or `Question<ElementFinder>`.
- *
- * @example <caption>Example widget</caption>
- *  <ul id="shopping-list" class="active favourite">
- *    <li class="bought">Coffee<li>
- *    <li class="buy">Honey<li>
- *    <li class="buy">Chocolate<li>
- *  </ul>
- *
- * @example <caption>Retrieve CSS classes of a given WebElement</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { BrowseTheWeb, CSSClasses, Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  const shoppingList = () =>
- *      Target.the('shopping list').located(by.id('shopping-list'))
- *
- *  actorCalled('Lisa')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Ensure.that(CSSClasses.of(shoppingList()), equals([ 'active', 'favourite' ])),
- *      )
- *
- * @example <caption>Find WebElements with a given class</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { BrowseTheWeb, CSSClasses, Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class ShoppingList {
- *      static items = () =>
- *          Target.all('items')
- *              .located(by.css('#shopping-list li'))
- *
- *      static outstandingItems = () =>
- *          ShoppingList.items
- *              .where(CSSClasses, contain('buy'))
- *  }
- *
- *  actorCalled('Lisa')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Ensure.that(
- *              Text.ofAll(ShoppingList.outstandingItems()),
- *              equals([ 'Honey', 'Chocolate' ])
- *          ),
- *      )
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-export declare class CSSClasses extends Question<Promise<string[]>> implements MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string[]>> {
-    private readonly target;
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     * @returns {CSSClasses}
-     */
-    static of(target: Question<ElementFinder> | ElementFinder): CSSClasses;
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     */
-    constructor(target: Question<ElementFinder> | ElementFinder);
-    /**
-     * @desc
-     *  Resolves to an array of CSS classes of the `target` element,
-     *  located in the context of a `parent` element.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {Question<Promise<string[]>>}
-     *
-     * @see {@link Target.all}
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    of(parent: Question<ElementFinder> | ElementFinder): Question<Promise<string[]>>;
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string[]>;
-}