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

package/lib/screenplay/questions/Value.js

@@ -1,78 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Value = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-const targets_1 = require("./targets");
-/**
- * @desc
- *  Returns the `value` attribute of a given {@link WebElement},
- *  represented by Answerable<{@link @wdio/types~Element}>
- *
- * @example <caption>Example widget</caption>
- *  <input type="text" id="username" value="Alice" />
- *
- * @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, by, Value, Target } from '@serenity-js/webdriverio';
- *
- *  const usernameField = () =>
- *      Target.the('username field').located(by.id('username'))
- *
- *  actorCalled('Lisa')
- *      .whoCan(BrowseTheWeb.using(browser))
- *      .attemptsTo(
- *          Ensure.that(Value.of(usernameField), equals('Alice')),
- *      )
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-class Value extends core_1.Question {
-    /**
-     * @param {Answerable<Element<'async'>>} element
-     */
-    constructor(element) {
-        super((0, io_1.formatted) `the value of ${element}`);
-        this.element = element;
-    }
-    /**
-     * @param {Answerable<Element<'async'>>} element
-     * @returns {Value}
-     */
-    static of(element) {
-        return new Value(element);
-    }
-    /**
-     * @desc
-     *  Resolves to the value of a given [`input`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input)
-     *  {@link WebElement}, located in the context of a `parent` element.
-     *
-     * @param {Answerable<Element<'async'>>} parent
-     * @returns {Question<Promise<string>>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    of(parent) {
-        return new Value(new targets_1.TargetNestedElement(parent, this.element));
-    }
-    /**
-     * @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}
-     */
-    async answeredBy(actor) {
-        const element = await actor.answer(this.element);
-        return element.getValue();
-    }
-}
-exports.Value = Value;
-//# sourceMappingURL=Value.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Value.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Value.ts"],"names":[],"mappings":";;;AAAA,4CAAwG;AACxG,iDAAqD;AAGrD,uCAAgD;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,KACT,SAAQ,eAAyB;IAWjC;;OAEG;IACH,YAA6B,OAAqC;QAC9D,KAAK,CAAC,IAAA,cAAS,EAAA,gBAAiB,OAAQ,EAAE,CAAC,CAAC;QADnB,YAAO,GAAP,OAAO,CAA8B;IAElE,CAAC;IAbD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAqC;QAC3C,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IASD;;;;;;;;;OASG;IACH,EAAE,CAAC,MAAoC;QACnC,OAAO,IAAI,KAAK,CAAC,IAAI,6BAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;CACJ;AAlDD,sBAkDC"}

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

@@ -1,21 +0,0 @@
-import { Question } from '@serenity-js/core';
-export declare class Website {
-    /**
-     * @desc
-     *  Retrieves the document title of the current top-level browsing context, equivalent to calling `document.title`.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<string>>}
-     *
-     * @see https://webdriver.io/docs/api/webdriver/#gettitle
-     */
-    static title(): Question<Promise<string>>;
-    /**
-     * @desc
-     *  Retrieves the URL of the current top-level browsing context.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<string>>}
-     *
-     * @see https://webdriver.io/docs/api/webdriver/#geturl
-     */
-    static url(): Question<Promise<string>>;
-}

package/lib/screenplay/questions/Website.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Website = void 0;
-const core_1 = require("@serenity-js/core");
-const abilities_1 = require("../abilities");
-class Website {
-    /**
-     * @desc
-     *  Retrieves the document title of the current top-level browsing context, equivalent to calling `document.title`.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<string>>}
-     *
-     * @see https://webdriver.io/docs/api/webdriver/#gettitle
-     */
-    static title() {
-        return core_1.Question.about(`the title of the current page`, actor => abilities_1.BrowseTheWeb.as(actor).browser.getTitle());
-    }
-    /**
-     * @desc
-     *  Retrieves the URL of the current top-level browsing context.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<string>>}
-     *
-     * @see https://webdriver.io/docs/api/webdriver/#geturl
-     */
-    static url() {
-        return core_1.Question.about(`the url of the current page`, actor => abilities_1.BrowseTheWeb.as(actor).browser.getUrl());
-    }
-}
-exports.Website = Website;
-//# sourceMappingURL=Website.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Website.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Website.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAE7C,4CAA4C;AAE5C,MAAa,OAAO;IAEhB;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK;QACR,OAAO,eAAQ,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,EAAE,CAC3D,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAC5C,CAAC;IACN,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG;QACN,OAAO,eAAQ,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,EAAE,CACzD,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAC1C,CAAC;IACN,CAAC;CACJ;AA7BD,0BA6BC"}

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

@@ -1,10 +0,0 @@
-export * from './Attribute';
-export * from './CSSClasses';
-export * from './LastScriptExecution';
-export * from './locators';
-export * from './NestedTargetBuilder';
-export * from './TargetBuilder';
-export * from './targets';
-export * from './Text';
-export * from './Value';
-export * from './Website';

package/lib/screenplay/questions/index.js

@@ -1,23 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./Attribute"), exports);
-__exportStar(require("./CSSClasses"), exports);
-__exportStar(require("./LastScriptExecution"), exports);
-__exportStar(require("./locators"), exports);
-__exportStar(require("./NestedTargetBuilder"), exports);
-__exportStar(require("./TargetBuilder"), exports);
-__exportStar(require("./targets"), exports);
-__exportStar(require("./Text"), exports);
-__exportStar(require("./Value"), exports);
-__exportStar(require("./Website"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B;AAC7B,wDAAsC;AACtC,6CAA2B;AAC3B,wDAAsC;AACtC,kDAAgC;AAChC,4CAA0B;AAC1B,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B"}

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

@@ -1,86 +0,0 @@
-import { Answerable, AnswersQuestions, Expectation, MetaQuestion, UsesAbilities } from '@serenity-js/core';
-import { ListAdapter } from '@serenity-js/core/lib/screenplay/questions/lists';
-import type { Element, ElementArray } from 'webdriverio';
-/**
- * @desc
- *  Adapts {@link ElementArray} so that it can be used with {@link @serenity-js/core/lib/screenplay/questions~List}.
- *
- *  You most likely won't need to use this class directly. Instead, check out {@link Target} and {@link Target.all}.
- *
- * @see {@link Target}
- *
- * @implements {@serenity-js/core/lib/screenplay/questions/lists~ListAdapter}
- */
-export declare class ElementArrayListAdapter implements ListAdapter<Promise<Element<'async'>>, Promise<ElementArray>> {
-    private readonly collection;
-    constructor(collection: Answerable<ElementArray>);
-    /**
-     * @desc
-     *  Returns the number of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<number>}
-     */
-    count(actor: AnswersQuestions & UsesAbilities): Promise<number>;
-    /**
-     * @desc
-     *  Returns the first of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Element<'async'>}
-     */
-    first(actor: AnswersQuestions & UsesAbilities): Promise<Element<'async'>>;
-    /**
-     * @desc
-     *  Returns the last of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Element<'async'>}
-     */
-    last(actor: AnswersQuestions & UsesAbilities): Promise<Element<'async'>>;
-    /**
-     * @desc
-     *  Returns the nth of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     *
-     * @param {number} index
-     *  Zero-based index of the item to return
-     *
-     * @returns {Element<'async'>}
-     */
-    get(actor: AnswersQuestions & UsesAbilities, index: number): Promise<Element<'async'>>;
-    /**
-     * @desc
-     *  Returns the underlying {@link ElementArray},
-     *  with any filters applied.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Element<'async'>}
-     */
-    items(actor: AnswersQuestions & UsesAbilities): Promise<ElementArray>;
-    /**
-     * @desc
-     *  Filters the underlying {@link ElementArray} so that the result contains only those {@link Element<'async'>}s that meet the {@link Expectation}
-     *
-     * @param {@serenity-js/core/lib/screenplay/questions~MetaQuestion<Answerable<Element<'async'>>, Promise<Answer_Type> | Answer_Type>} question
-     * @param {@serenity-js/core/lib/screenplay/questions~Expectation<any, Answer_Type>} expectation
-     *
-     * @returns {@serenity-js/core/lib/screenplay/questions/lists~ListAdapter<Element<'async'>, ElementArrayFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    withFilter<Answer_Type>(question: MetaQuestion<Answerable<Element<'async'>>, Promise<Answer_Type> | Answer_Type>, expectation: Expectation<any, Answer_Type>): ListAdapter<Promise<Element<'async'>>, Promise<ElementArray>>;
-    /**
-     * @desc
-     *  Returns a human-readable description of the underlying {@link ElementArray}.
-     *
-     * @returns {string}
-     */
-    toString(): string;
-    private elements;
-}

package/lib/screenplay/questions/lists.js

@@ -1,137 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ElementArrayListAdapter = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-/**
- * @desc
- *  Adapts {@link ElementArray} so that it can be used with {@link @serenity-js/core/lib/screenplay/questions~List}.
- *
- *  You most likely won't need to use this class directly. Instead, check out {@link Target} and {@link Target.all}.
- *
- * @see {@link Target}
- *
- * @implements {@serenity-js/core/lib/screenplay/questions/lists~ListAdapter}
- */
-class ElementArrayListAdapter {
-    constructor(collection) {
-        this.collection = collection;
-    }
-    /**
-     * @desc
-     *  Returns the number of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<number>}
-     */
-    async count(actor) {
-        const elements = await this.elements(actor);
-        return elements.length;
-    }
-    /**
-     * @desc
-     *  Returns the first of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Element<'async'>}
-     */
-    async first(actor) {
-        const elements = await this.elements(actor);
-        return elements[0];
-    }
-    /**
-     * @desc
-     *  Returns the last of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Element<'async'>}
-     */
-    async last(actor) {
-        const elements = await this.elements(actor);
-        return elements[elements.length - 1];
-    }
-    /**
-     * @desc
-     *  Returns the nth of {@link Element}s that the underlying {@link ElementArray} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     *
-     * @param {number} index
-     *  Zero-based index of the item to return
-     *
-     * @returns {Element<'async'>}
-     */
-    async get(actor, index) {
-        const elements = await this.elements(actor);
-        return elements[index];
-    }
-    /**
-     * @desc
-     *  Returns the underlying {@link ElementArray},
-     *  with any filters applied.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Element<'async'>}
-     */
-    items(actor) {
-        return this.elements(actor);
-    }
-    /**
-     * @desc
-     *  Filters the underlying {@link ElementArray} so that the result contains only those {@link Element<'async'>}s that meet the {@link Expectation}
-     *
-     * @param {@serenity-js/core/lib/screenplay/questions~MetaQuestion<Answerable<Element<'async'>>, Promise<Answer_Type> | Answer_Type>} question
-     * @param {@serenity-js/core/lib/screenplay/questions~Expectation<any, Answer_Type>} expectation
-     *
-     * @returns {@serenity-js/core/lib/screenplay/questions/lists~ListAdapter<Element<'async'>, ElementArrayFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    withFilter(question, expectation) {
-        return new ElementArrayListAdapter(new ElementArrayListFilter(this.collection, question, expectation));
-    }
-    /**
-     * @desc
-     *  Returns a human-readable description of the underlying {@link ElementArray}.
-     *
-     * @returns {string}
-     */
-    toString() {
-        return (0, io_1.formatted) `${this.collection}`;
-    }
-    elements(actor) {
-        return actor.answer(this.collection);
-    }
-}
-exports.ElementArrayListAdapter = ElementArrayListAdapter;
-/**
- * @private
- */
-class ElementArrayListFilter extends core_1.Question {
-    constructor(collection, question, expectation) {
-        super([
-            (0, io_1.formatted) `${collection}`,
-            collection instanceof ElementArrayListFilter ? 'and' : 'where',
-            (0, io_1.formatted) `${question} does ${expectation}`
-        ].join(' '));
-        this.collection = collection;
-        this.question = question;
-        this.expectation = expectation;
-    }
-    async answeredBy(actor) {
-        const collection = await actor.answer(this.collection);
-        const outcomes = await Promise.all(collection.map((element) => actor.answer(this.question.of(element))
-            .then((answer) => this.expectation.answeredBy(actor)(answer))));
-        const matching = collection.filter((element, index) => outcomes[index] instanceof core_1.ExpectationMet);
-        matching.selector = collection.selector;
-        matching.parent = collection.parent;
-        matching.foundWith = collection.foundWith;
-        matching.props = collection.props;
-        return matching;
-    }
-}
-//# sourceMappingURL=lists.js.map

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

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

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

@@ -1,196 +0,0 @@
-import { Question } from '@serenity-js/core';
-import type { Browser, Element, ElementArray, Selector } from 'webdriverio';
-/**
- * @desc
- *  Represents a way to retrieve one and multiple Web elements using a given strategy.
- *
- * @see {@link by}
- * @see {@link Locators}
- */
-export declare class Locator {
-    private readonly description;
-    private readonly locateOne;
-    private readonly locateAll;
-    constructor(description: string, locateOne: (browserInstance: Browser<'async'>) => Promise<Element<'async'>>, locateAll: (browserInstance: Browser<'async'>) => Promise<ElementArray>);
-    /**
-     * @desc
-     *  Returns a {@link @serenity-js/core/lib/screenplay~Question} that resolves
-     *  to the first Web element found using a given strategy.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<Element<'async'>>>}
-     */
-    firstMatching(): Question<Promise<Element<'async'>>>;
-    /**
-     * @desc
-     *  Returns a {@link @serenity-js/core/lib/screenplay~Question} that resolves
-     *  to all the Web elements found using a given strategy.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<ElementArray>>}
-     */
-    allMatching(): Question<Promise<ElementArray>>;
-}
-/**
- * @desc
- *  {@link Locator} factory. You probably want to use {@link by} instead in your tests.
- */
-export declare class Locators {
-    /**
-     * @desc
-     *  Locates elements by their `id` attribute.
-     *
-     * @example <caption>Example widget</caption>
-     *  <input id="username" />
-     *
-     * @example
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const usernameField = Target.the('username field').located(by.id('username'));
-     *
-     * @param {string} id
-     * @returns {Locator}
-     *
-     * @see {@link Target}
-     * @see https://webdriver.io/docs/selectors/#id
-     */
-    id(id: string): Locator;
-    /**
-     * @desc
-     *  Locates elements using a CSS selector
-     *
-     * @example <caption>Example widget</caption>
-     *  <div id="article">
-     *      <h1>Title</h1>
-     *      <h2>Section 1</h2>
-     *      <h2>Section 2</h2>
-     *  </div>
-     *
-     * @example <caption>Locating a single element</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const title = Target.the('article title').located(by.css('#article h1'));
-     *
-     * @example <caption>Locating multiple elements</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const titles = Target.all('section titles').located(by.css('#article h2'));
-     *
-     * @param {Selector} selector
-     * @returns {Locator}
-     *
-     * @see {@link Target}
-     * @see https://webdriver.io/docs/selectors/#css-query-selector
-     */
-    css(selector: Selector): Locator;
-    /**
-     * @desc
-     *  Locates elements by HTML tag name
-     *
-     * @example <caption>Example widget</caption>
-     *  <ul>
-     *      <li>Item 1</li>
-     *      <li>Item 2</li>
-     *  </ul>
-     *  <span>Total price: £5</span>
-     *
-     * @example <caption>Locating a single element</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const totalPrice = Target.the('total price').located(by.tagName('span'));
-     *
-     * @example <caption>Locating multiple elements</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const items = Target.all('shopping basket items').located(by.tagName('li'));
-     *
-     * @param {string} tagName
-     * @returns {Locator}
-     *
-     * @see {@link Target}
-     * @see https://webdriver.io/docs/selectors/#tag-name
-     */
-    tagName(tagName: string): Locator;
-    /**
-     * @desc
-     *  Locates an HTML anchor element with a specific text in it.
-     *
-     * @example <caption>Example widget</caption>
-     *  <a href="https://serenity-js.org">Serenity/JS</a>
-     *
-     * @example <caption>Locating a single element</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const serenityWebsite = Target.the('Serenity/JS website link').located(by.linkText('Serenity/JS'));
-     *
-     * @example <caption>Locating multiple elements</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const items = Target.all('Serenity/JS website links').located(by.linkText('Serenity/JS'));
-     *
-     * @param {string} linkText
-     * @returns {Locator}
-     *
-     * @see {@link Target}
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a
-     * @see https://webdriver.io/docs/selectors/#link-text
-     */
-    linkText(linkText: string): Locator;
-    /**
-     * @desc
-     *  Locates an HTML anchor element with which visible text partially matches `partialLinkText`
-     *
-     * @example <caption>Example widget</caption>
-     *  <a href="https://serenity-js.org">Serenity/JS</a>
-     *  <a href="https://serenity-bdd.info/#/">Serenity BDD</a>
-     *
-     * @example <caption>Locating a single element</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const serenityWebsite = Target.the('Serenity/JS website link').located(by.partialLinkText('JS'));
-     *
-     * @example <caption>Locating multiple elements</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const serenityWebsites = Target.all('Serenity frameworks').located(by.partialLinkText('Serenity'));
-     *
-     * @param {string} partialLinkText
-     * @returns {Locator}
-     *
-     * @see {@link Target}
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a
-     * @see https://webdriver.io/docs/selectors/#link-text
-     */
-    partialLinkText(partialLinkText: string): Locator;
-    /**
-     * @desc
-     *  Locates elements using an [XPath](https://developer.mozilla.org/en-US/docs/Web/XPath) selector.
-     *
-     *  Please note that whenever possible you should use {@link Locators#id} and {@link Locators#css} locators
-     *  instead of XPath to make your tests more robust.
-     *
-     * @example <caption>Example widget</caption>
-     *  <div id="article">
-     *      <h1>Title</h1>
-     *      <h2>Section 1</h2>
-     *      <h2>Section 2</h2>
-     *  </div>
-     *
-     * @example <caption>Locating a single element</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const title = Target.the('article title').located(by.xpath('//*[@id="article"]/h1'));
-     *
-     * @example <caption>Locating multiple elements</caption>
-     *  import { by, Target } from '@serenity-js/webdriverio';
-     *
-     *  const title = Target.the('article title').located(by.xpath('//*[@id="article"]/h2'));
-     *
-     * @param {string} xpath
-     * @returns {Locator}
-     *
-     * @see {@link Target}
-     * @see https://developer.mozilla.org/en-US/docs/Web/XPath
-     * @see https://webdriver.io/docs/selectors/#xpath
-     */
-    xpath(xpath: string): Locator;
-}
-export declare const by: Locators;