@tecgovtnzwebdev/puppeteer 3.0.1

package/README.md

@@ -0,0 +1,26 @@
+# Puppeteer helper packages
+## Getting started
+```
+npm ci
+```
+## Dev
+Helpers are written in typescript and then transpiled out to various formats and module systems (currently only CJS).
+
+### Build
+Run the following command. This will emit the `cjs` directory.
+```
+npx tsc
+```
+
+## Use
+`npm` has support for `bitbucket` package sources (https://docs.npmjs.com/cli/v7/commands/npm-install)
+
+So to install the `@tecgovtnz/puppeteer` package, run:
+```
+npm i bitbucket:careersnz/npm-puppeteer
+```
+
+If you are developing a new package and which to test your branch you can use the syntax:
+```
+npm i bitbucket:careersnz/npm-puppeteer\#BRANCH_NAME
+```

package/checkbox.ts

@@ -0,0 +1,54 @@
+import * as puppeteer from 'puppeteer';
+import { repeatUntil } from './wait-until';
+
+/**
+ * Is a checkbox checked?
+ * @param selector The selector for the HTMLInputElement element.
+ * @param page The puppeteer page.
+ * @returns true if the checkbox is checked, false otherwise.
+ */
+export async function isChecked(page: puppeteer.Page, selector: string): Promise<boolean> {
+    const isChecked = await page.evaluate((selector_: string) => {
+        const checkbox = document.querySelector(selector_) as HTMLInputElement;
+        if (!checkbox) {
+            return null;
+        }
+        return checkbox.checked;
+    }, selector);
+
+    if (isChecked === null) {
+        throw new Error(`Failed to get the checked value of '${selector}'`);
+    }
+
+    return isChecked;
+}
+
+/**
+ * Checks a checkbox.
+ * @param page The puppeteer page.
+ * @param selector The selector for the HTMLInputElement element.
+ */
+export async function check(page: puppeteer.Page, selector: string) {
+    await repeatUntil(async () => {
+        if (await isChecked(page, selector)) {
+            return true;
+        }
+
+        await page.click(selector);
+    }, `Expected checkbox '${selector}' to be checked`);
+}
+
+/**
+ * Unchecks a checkbox.
+ * @param page The puppeteer page.
+ * @param selector The selector for the HTMLInputElement element.
+ */
+export async function uncheck(page: puppeteer.Page, selector: string) {
+    await repeatUntil(async () => {
+        if (!(await isChecked(page, selector))) {
+            return true;
+        }
+
+        await page.click(selector);
+    }, `Expected checkbox '${selector}' to be unchecked`);
+}

package/cjs/checkbox.d.ts

@@ -0,0 +1,20 @@
+import * as puppeteer from 'puppeteer';
+/**
+ * Is a checkbox checked?
+ * @param selector The selector for the HTMLInputElement element.
+ * @param page The puppeteer page.
+ * @returns true if the checkbox is checked, false otherwise.
+ */
+export declare function isChecked(page: puppeteer.Page, selector: string): Promise<boolean>;
+/**
+ * Checks a checkbox.
+ * @param page The puppeteer page.
+ * @param selector The selector for the HTMLInputElement element.
+ */
+export declare function check(page: puppeteer.Page, selector: string): Promise<void>;
+/**
+ * Unchecks a checkbox.
+ * @param page The puppeteer page.
+ * @param selector The selector for the HTMLInputElement element.
+ */
+export declare function uncheck(page: puppeteer.Page, selector: string): Promise<void>;

package/cjs/checkbox.js

@@ -0,0 +1,67 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uncheck = exports.check = exports.isChecked = void 0;
+const wait_until_1 = require("./wait-until");
+/**
+ * Is a checkbox checked?
+ * @param selector The selector for the HTMLInputElement element.
+ * @param page The puppeteer page.
+ * @returns true if the checkbox is checked, false otherwise.
+ */
+function isChecked(page, selector) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const isChecked = yield page.evaluate((selector_) => {
+            const checkbox = document.querySelector(selector_);
+            if (!checkbox) {
+                return null;
+            }
+            return checkbox.checked;
+        }, selector);
+        if (isChecked === null) {
+            throw new Error(`Failed to get the checked value of '${selector}'`);
+        }
+        return isChecked;
+    });
+}
+exports.isChecked = isChecked;
+/**
+ * Checks a checkbox.
+ * @param page The puppeteer page.
+ * @param selector The selector for the HTMLInputElement element.
+ */
+function check(page, selector) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield wait_until_1.repeatUntil(() => __awaiter(this, void 0, void 0, function* () {
+            if (yield isChecked(page, selector)) {
+                return true;
+            }
+            yield page.click(selector);
+        }), `Expected checkbox '${selector}' to be checked`);
+    });
+}
+exports.check = check;
+/**
+ * Unchecks a checkbox.
+ * @param page The puppeteer page.
+ * @param selector The selector for the HTMLInputElement element.
+ */
+function uncheck(page, selector) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield wait_until_1.repeatUntil(() => __awaiter(this, void 0, void 0, function* () {
+            if (!(yield isChecked(page, selector))) {
+                return true;
+            }
+            yield page.click(selector);
+        }), `Expected checkbox '${selector}' to be unchecked`);
+    });
+}
+exports.uncheck = uncheck;

package/cjs/click-helper.d.ts

@@ -0,0 +1,11 @@
+import * as puppeteer from 'puppeteer';
+/**
+ * Clicks an element and waits for the page to navigate to a new URL or to reload.
+ * @param page The puppeteer page.
+ * @param elementOrSelector The HTMLElement or string selector to click.
+ * @param waitOptions Optional wait settings.
+ * @returns A promise which resolves after the page has navigated.
+ */
+export declare function clickAndWaitForNavigation(page: puppeteer.Page, elementOrSelector: string | puppeteer.ElementHandle, waitOptions?: puppeteer.WaitForOptions): Promise<[puppeteer.HTTPResponse | null, void]>;
+export declare function clickSelectorAndWaitForNavigation(page: puppeteer.Page, selector: string, waitOptions?: puppeteer.WaitForOptions): Promise<[puppeteer.HTTPResponse | null, void]>;
+export declare function clickElementAndWaitForNavigation(page: puppeteer.Page, element: puppeteer.ElementHandle, waitOptions?: puppeteer.WaitForOptions): Promise<[puppeteer.HTTPResponse | null, void]>;

package/cjs/click-helper.js

@@ -0,0 +1,46 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickElementAndWaitForNavigation = exports.clickSelectorAndWaitForNavigation = exports.clickAndWaitForNavigation = void 0;
+/**
+ * Clicks an element and waits for the page to navigate to a new URL or to reload.
+ * @param page The puppeteer page.
+ * @param elementOrSelector The HTMLElement or string selector to click.
+ * @param waitOptions Optional wait settings.
+ * @returns A promise which resolves after the page has navigated.
+ */
+function clickAndWaitForNavigation(page, elementOrSelector, waitOptions) {
+    if (typeof elementOrSelector === 'string') {
+        return clickSelectorAndWaitForNavigation(page, elementOrSelector, waitOptions);
+    }
+    else {
+        return clickElementAndWaitForNavigation(page, elementOrSelector, waitOptions);
+    }
+}
+exports.clickAndWaitForNavigation = clickAndWaitForNavigation;
+function clickSelectorAndWaitForNavigation(page, selector, waitOptions) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return Promise.all([
+            page.waitForNavigation(waitOptions),
+            page.click(selector)
+        ]);
+    });
+}
+exports.clickSelectorAndWaitForNavigation = clickSelectorAndWaitForNavigation;
+function clickElementAndWaitForNavigation(page, element, waitOptions) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return Promise.all([
+            page.waitForNavigation(waitOptions),
+            element.click()
+        ]);
+    });
+}
+exports.clickElementAndWaitForNavigation = clickElementAndWaitForNavigation;

package/cjs/find-element-with-text.d.ts

@@ -0,0 +1,8 @@
+import * as puppeteer from 'puppeteer';
+/**
+ * Tries to find an element containing the specified text in its innerText value.
+ * @param page The puppeteer page.
+ * @param elementSelector The set of elements to search in.
+ * @param text The text to search for. This value is case-sensitive.
+ */
+export declare function findElementWithText(page: puppeteer.Page, elementSelector: string, text: string): Promise<puppeteer.ElementHandle<HTMLElement> | null>;

package/cjs/find-element-with-text.js

@@ -0,0 +1,33 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findElementWithText = void 0;
+const get_text_1 = require("./get-text");
+/**
+ * Tries to find an element containing the specified text in its innerText value.
+ * @param page The puppeteer page.
+ * @param elementSelector The set of elements to search in.
+ * @param text The text to search for. This value is case-sensitive.
+ */
+function findElementWithText(page, elementSelector, text) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const elements = (yield page.$$(elementSelector));
+        for (const element of elements) {
+            const textOfElement = yield get_text_1.getText(page, element);
+            if (textOfElement && textOfElement.includes(text)) {
+                return element;
+            }
+        }
+        return null;
+    });
+}
+exports.findElementWithText = findElementWithText;
+;

package/cjs/get-attribute.d.ts

@@ -0,0 +1,8 @@
+import * as puppeteer from 'puppeteer';
+/**
+ * Get the attirbute value from an element.
+ * @param page The puppeteer page.
+ * @param elementSelectorOrHandle An element selector or handle to an element.
+ * @param attributeName The name of the attribute to get the value for.
+ */
+export declare function getAttribute(page: puppeteer.Page, elementSelectorOrHandle: string | puppeteer.ElementHandle<Element>, attributeName: string): Promise<any>;

package/cjs/get-attribute.js

@@ -0,0 +1,38 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAttribute = void 0;
+const throw_helper_1 = require("./throw-helper");
+/**
+ * Get the attirbute value from an element.
+ * @param page The puppeteer page.
+ * @param elementSelectorOrHandle An element selector or handle to an element.
+ * @param attributeName The name of the attribute to get the value for.
+ */
+function getAttribute(page, elementSelectorOrHandle, attributeName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let element;
+        switch (typeof elementSelectorOrHandle) {
+            case 'string':
+                element = (yield page.waitForSelector(elementSelectorOrHandle));
+                throw_helper_1.assertSuccessfulSelector(elementSelectorOrHandle, element);
+                break;
+            case 'object':
+                element = elementSelectorOrHandle;
+                break;
+            default:
+                throw new Error(`Unsupported type ${typeof elementSelectorOrHandle}`);
+        }
+        return yield page.evaluate((el, att) => el.getAttribute(att), element, attributeName);
+    });
+}
+exports.getAttribute = getAttribute;
+;

package/cjs/get-text.d.ts

@@ -0,0 +1,7 @@
+import * as puppeteer from 'puppeteer';
+/**
+ * Gets the innerText value of an element.
+ * @param page The puppeteer page.
+ * @param elementSelectorOrHandle The HTMLElement or string selector to get the innerText value from.
+ */
+export declare function getText(page: puppeteer.Page, elementSelectorOrHandle: string | puppeteer.ElementHandle<HTMLElement>): Promise<string | null | undefined>;

package/cjs/get-text.js

@@ -0,0 +1,33 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getText = void 0;
+const throw_helper_1 = require("./throw-helper");
+/**
+ * Gets the innerText value of an element.
+ * @param page The puppeteer page.
+ * @param elementSelectorOrHandle The HTMLElement or string selector to get the innerText value from.
+ */
+function getText(page, elementSelectorOrHandle) {
+    return __awaiter(this, void 0, void 0, function* () {
+        switch (typeof elementSelectorOrHandle) {
+            case 'string':
+                const element = (yield page.waitForSelector(elementSelectorOrHandle));
+                throw_helper_1.assertSuccessfulSelector(elementSelectorOrHandle, element);
+                return (page.evaluate(el => el.innerText, element));
+            case 'object':
+                return (page.evaluate(el => el.innerText, elementSelectorOrHandle));
+            default:
+                throw new Error(`Unsupported type ${typeof elementSelectorOrHandle}`);
+        }
+    });
+}
+exports.getText = getText;

package/cjs/index.d.ts

@@ -0,0 +1,11 @@
+export * from './checkbox';
+export * from './click-helper';
+export * from './find-element-with-text';
+export * from './get-attribute';
+export * from './get-text';
+export * from './input';
+export * from './is-visible';
+export * from './mail-hog';
+export * from './select';
+export * from './wait-until';
+export * from './wait';

package/cjs/index.js

@@ -0,0 +1,23 @@
+"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("./checkbox"), exports);
+__exportStar(require("./click-helper"), exports);
+__exportStar(require("./find-element-with-text"), exports);
+__exportStar(require("./get-attribute"), exports);
+__exportStar(require("./get-text"), exports);
+__exportStar(require("./input"), exports);
+__exportStar(require("./is-visible"), exports);
+__exportStar(require("./mail-hog"), exports);
+__exportStar(require("./select"), exports);
+__exportStar(require("./wait-until"), exports);
+__exportStar(require("./wait"), exports);

package/cjs/input.d.ts

@@ -0,0 +1,12 @@
+import * as puppeteer from 'puppeteer';
+/**
+ * Gets the value from an HTMLInputElement.
+ * @param page The puppeteer page.
+ * @param elementSelectorOrHandle A selector for a <input /> element, or a handle.
+ */
+export declare function getValue(page: puppeteer.Page, elementSelectorOrHandle: string | puppeteer.ElementHandle<HTMLInputElement>): Promise<any>;
+/**
+ * @param selector A selector for a <input /> element.
+ * @param text The text to type into the <input />.
+ */
+export declare function clearAndType(page: puppeteer.Page, selector: string, text: string): Promise<void>;

package/cjs/input.js

@@ -0,0 +1,48 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearAndType = exports.getValue = void 0;
+const throw_helper_1 = require("./throw-helper");
+/**
+ * Gets the value from an HTMLInputElement.
+ * @param page The puppeteer page.
+ * @param elementSelectorOrHandle A selector for a <input /> element, or a handle.
+ */
+function getValue(page, elementSelectorOrHandle) {
+    return __awaiter(this, void 0, void 0, function* () {
+        switch (typeof elementSelectorOrHandle) {
+            case 'string':
+                const element = (yield page.waitForSelector(elementSelectorOrHandle));
+                throw_helper_1.assertSuccessfulSelector(elementSelectorOrHandle, element);
+                return page.evaluate(el => el.value, element);
+            case 'object':
+                return page.evaluate(el => el.value, elementSelectorOrHandle);
+            default:
+                throw new Error(`Unsupported type ${typeof elementSelectorOrHandle}`);
+        }
+    });
+}
+exports.getValue = getValue;
+/**
+ * @param selector A selector for a <input /> element.
+ * @param text The text to type into the <input />.
+ */
+function clearAndType(page, selector, text) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const input = (yield page.$(selector));
+        throw_helper_1.assertSuccessfulSelector(selector, input);
+        yield page.evaluate(i => {
+            i.value = '';
+        }, input);
+        yield page.type(selector, text);
+    });
+}
+exports.clearAndType = clearAndType;

package/cjs/is-visible.d.ts

@@ -0,0 +1,2 @@
+import * as puppeteer from 'puppeteer';
+export declare function isVisible(page: puppeteer.Page, selectorOrElementHandle: string | puppeteer.ElementHandle): Promise<any>;

package/cjs/is-visible.js

@@ -0,0 +1,28 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isVisible = void 0;
+function isVisible(page, selectorOrElementHandle) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const element = typeof selectorOrElementHandle === 'string'
+            ? yield page.$(selectorOrElementHandle)
+            : selectorOrElementHandle;
+        if (element === null) {
+            throw new Error(`Failed to find object`);
+        }
+        return page.evaluate((element) => {
+            const style = getComputedStyle(element);
+            const rect = element.getBoundingClientRect();
+            return style.visibility !== 'hidden' && !!(rect.bottom || rect.top || rect.height || rect.width) && style.opacity !== '0';
+        }, element);
+    });
+}
+exports.isVisible = isVisible;

package/cjs/mail-hog.d.ts

@@ -0,0 +1,10 @@
+import parseEmail from 'mailparser';
+export declare class MailHog {
+    private _mailHogUrl;
+    constructor(mailHogUrl: string);
+    /**
+     * Gets email from the mailhog inbox which match the specified 'to' address.
+     * @param addressNeedle A 'to' address filter.
+     */
+    get(addressNeedle: string): Promise<parseEmail.ParsedMail[]>;
+}

package/cjs/mail-hog.js

@@ -0,0 +1,35 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailHog = void 0;
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const mailparser_1 = __importDefault(require("mailparser"));
+class MailHog {
+    constructor(mailHogUrl) {
+        this._mailHogUrl = mailHogUrl;
+    }
+    /**
+     * Gets email from the mailhog inbox which match the specified 'to' address.
+     * @param addressNeedle A 'to' address filter.
+     */
+    get(addressNeedle) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield node_fetch_1.default(`${this._mailHogUrl}/api/v2/search?kind=to&query=${encodeURIComponent(addressNeedle)}`);
+            const messagesJson = yield response.json();
+            const messages = messagesJson.items;
+            return Promise.all(messages.map(message => mailparser_1.default.simpleParser(message.Raw.Data)));
+        });
+    }
+}
+exports.MailHog = MailHog;

package/cjs/select.d.ts

@@ -0,0 +1,28 @@
+import * as puppeteer from 'puppeteer';
+/**
+ * Selects one (or many) dropdown items by matching their <option /> text values.
+ * @param page The puppeteer page.
+ * @param selector A selector to a <select /> element.
+ * @param  texts A set of <option /> innerText values to match on.
+ * @returns An array of option values that have been successfully selected.
+ */
+export declare function selectWithText(page: puppeteer.Page, selector: string, ...texts: string[]): Promise<string[]>;
+/**
+ * Gets the text of the currently selected option of a <select />.
+ * @param page The puppeteer page.
+ * @param selector A selector to a <select /> element.
+ * @returns
+ */
+export declare function getTextOfSelectedOption(page: puppeteer.Page, selector: string): Promise<any>;
+/**
+ * Gets the set of text of the currently selected options of a <select /> element.
+ * @param page The puppeteer page.
+ * @param selector A selector to a <select /> element.
+ */
+export declare function getTextsOfSelectedOptions(page: puppeteer.Page, selector: string): Promise<any>;
+/**
+ * Uncheck all options of a select.
+ * @param page The puppeteer page.
+ * @param selector A selector to a <select /> element.
+ */
+export declare function uncheckAll(page: puppeteer.Page, selector: string): Promise<void>;