@tecgovtnzwebdev/puppeteer 1.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/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,66 @@
+"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;
+/**
+ * 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* () {
+        if (!(yield isChecked(page, selector))) {
+            yield page.click(selector);
+            if (!(yield isChecked(page, selector))) {
+                throw new Error(`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* () {
+        if (yield isChecked(page, selector)) {
+            yield page.click(selector);
+            if (yield isChecked(page, selector)) {
+                throw new Error(`Expected checkbox '${selector}' to be unchecked`);
+            }
+        }
+    });
+}
+exports.uncheck = uncheck;

package/cjs/click-helper.d.ts

@@ -0,0 +1,9 @@
+import * as puppeteer from 'puppeteer';
+/**
+ *
+ * @param page The puppeteer page.
+ * @param elementOrSelector The HTMLElement or string selector to click.
+ * @param waitUntil Optional wait settings.
+ * @returns A promise which resolves after the page has navigated.
+ */
+export declare function clickAndWaitForNavigation(page: puppeteer.Page, elementOrSelector: HTMLElement | string | puppeteer.ElementHandle, waitUntil?: puppeteer.WaitForOptions): Promise<[puppeteer.HTTPResponse | null, void]>;

package/cjs/click-helper.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickAndWaitForNavigation = void 0;
+/**
+ *
+ * @param page The puppeteer page.
+ * @param elementOrSelector The HTMLElement or string selector to click.
+ * @param waitUntil Optional wait settings.
+ * @returns A promise which resolves after the page has navigated.
+ */
+function clickAndWaitForNavigation(page, elementOrSelector, waitUntil) {
+    const click = typeof elementOrSelector === 'string'
+        ? page.click(elementOrSelector)
+        : elementOrSelector.click();
+    return Promise.all([
+        page.waitForNavigation(waitUntil),
+        click
+    ]);
+}
+exports.clickAndWaitForNavigation = clickAndWaitForNavigation;
+;

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<Element> | 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';
+/**
+ *
+ * @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<string | null | undefined>;

package/cjs/get-attribute.js

@@ -0,0 +1,40 @@
+"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;
+/**
+ *
+ * @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':
+                const elementBySelector = yield page.waitForSelector(elementSelectorOrHandle);
+                if (!elementBySelector) {
+                    throw new Error(`Failed to find element with selector '${elementSelectorOrHandle}'`);
+                }
+                element = elementBySelector;
+                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<Element>): Promise<string | null | undefined>;

package/cjs/get-text.js

@@ -0,0 +1,31 @@
+"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;
+/**
+ * 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);
+                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,10 @@
+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';

package/cjs/index.js

@@ -0,0 +1,22 @@
+"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);

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<Element>): 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,47 @@
+"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);
+                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, selector: string): Promise<boolean>;

package/cjs/is-visible.js

@@ -0,0 +1,26 @@
+"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, selector) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return page.evaluate((selector_) => {
+            const element = document.querySelector(selector_);
+            if (!element) {
+                return false;
+            }
+            const style = getComputedStyle(element);
+            const rect = element.getBoundingClientRect();
+            return style.visibility !== 'hidden' && !!(rect.bottom || rect.top || rect.height || rect.width) && style.opacity !== '0';
+        }, selector);
+    });
+}
+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<string>;
+/**
+ * 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<string[]>;
+/**
+ * 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>;

package/cjs/select.js

@@ -0,0 +1,90 @@
+"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.uncheckAll = exports.getTextsOfSelectedOptions = exports.getTextOfSelectedOption = exports.selectWithText = void 0;
+const throw_helper_1 = require("./throw-helper");
+/**
+ * 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.
+ */
+function selectWithText(page, selector, ...texts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const select = (yield page.$(selector));
+        throw_helper_1.assertSuccessfulSelector(selector, select);
+        const options = yield select.$$('option');
+        // Pull out just the option value and text
+        const optionData = (yield Promise.all(options.map((opt) => __awaiter(this, void 0, void 0, function* () {
+            const value = yield page.evaluate(element => element.value, opt);
+            const text = (yield page.evaluate(element => element.textContent, opt)).trim();
+            return {
+                value: value.toString(),
+                text
+            };
+        })))).filter(opt => texts.includes(opt.text));
+        return select.select(...optionData.map(opt => opt.value));
+    });
+}
+exports.selectWithText = selectWithText;
+/**
+ * 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
+ */
+function getTextOfSelectedOption(page, selector) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const select = (yield page.$(selector));
+        throw_helper_1.assertSuccessfulSelector(selector, select);
+        return page.evaluate((select) => select.options[select.selectedIndex].text, select);
+    });
+}
+exports.getTextOfSelectedOption = getTextOfSelectedOption;
+/**
+ * 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.
+ */
+function getTextsOfSelectedOptions(page, selector) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return yield page.evaluate((selector_) => {
+            const select = document.querySelector(selector_);
+            if (!select) {
+                throw new Error(`Could find select element by '${selector}'`);
+            }
+            return Array.from(select.options)
+                .filter(opt => opt.selected)
+                .map(opt => opt.innerText);
+        }, selector);
+    });
+}
+exports.getTextsOfSelectedOptions = getTextsOfSelectedOptions;
+/**
+ * Uncheck all options of a select.
+ * @param page The puppeteer page.
+ * @param selector A selector to a <select /> element.
+ */
+function uncheckAll(page, selector) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield page.evaluate((selector_) => {
+            const select = document.querySelector(selector_);
+            if (!select) {
+                throw new Error(`Could not find select with selector '${selector_}'`);
+            }
+            for (const opt of select.options) {
+                opt.selected = false;
+            }
+        }, selector);
+    });
+}
+exports.uncheckAll = uncheckAll;

package/cjs/throw-helper.d.ts

@@ -0,0 +1,2 @@
+import * as puppeteer from 'puppeteer';
+export declare function assertSuccessfulSelector(selector: string, element: puppeteer.ElementHandle | null): void;

package/cjs/throw-helper.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertSuccessfulSelector = void 0;
+function assertSuccessfulSelector(selector, element) {
+    if (!element) {
+        throw new Error(`Failed to find object by selector '${selector}'`);
+    }
+}
+exports.assertSuccessfulSelector = assertSuccessfulSelector;

package/cjs/wait-until.d.ts

@@ -0,0 +1,2 @@
+import * as puppeteer from 'puppeteer';
+export declare function waitUntil(page: puppeteer.Page, waitFunction: () => Promise<boolean>, errorMessage?: string, timeOut?: number, pollInterval?: number): Promise<void>;

package/cjs/wait-until.js

@@ -0,0 +1,26 @@
+"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.waitUntil = void 0;
+function waitUntil(page, waitFunction, errorMessage = 'Timed out waiting for something', timeOut = 5000, pollInterval = 100) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const endTime = Date.now() + timeOut;
+        let conditionMet = yield waitFunction();
+        while (!conditionMet && Date.now() < endTime) {
+            yield page.waitForTimeout(pollInterval);
+            conditionMet = yield waitFunction();
+        }
+        if (!conditionMet) {
+            throw new Error(errorMessage);
+        }
+    });
+}
+exports.waitUntil = waitUntil;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@tecgovtnzwebdev/puppeteer",
+  "version": "1.0.1",
+  "description": "puppeteer helpers",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "/cjs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://bitbucket.org/careersnz/npm-puppeteer.git"
+  },
+  "author": "",
+  "license": "ISC",
+  "homepage": "https://bitbucket.org/careersnz/npm-puppeteer#readme",
+  "dependencies": {
+    "@types/mailparser": "^3.0.2",
+    "@types/node-fetch": "^2.5.10",
+    "mailparser": "^3.2.0",
+    "node-fetch": "^2.6.1",
+    "puppeteer": "^9.1.1",
+    "typescript": "^4.2.4"
+  }
+}