portadom 1.0.0

package/dist/cjs/dom/dom.js

@@ -0,0 +1,813 @@
+"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.playwrightLocatorPortadom = exports.playwrightHandlePortadom = exports.cheerioPortadom = exports.browserPortadom = void 0;
+const get_1 = __importDefault(require("lodash/get"));
+const format_1 = require("../utils/format");
+const url_1 = require("../utils/url");
+const error_1 = require("../utils/error");
+const domUtils_1 = require("./domUtils");
+const types_1 = require("./types");
+/** Implementation of Portadom in browser (using Browser API) */
+const browserPortadom = (node) => {
+    const getDoc = () => node.ownerDocument;
+    ///////////////////////
+    // SCALAR OPERATIONS
+    ///////////////////////
+    const text = ({ allowEmpty } = {}) => {
+        var _a, _b;
+        const txt = (_b = (_a = node.textContent) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : null;
+        return (0, format_1.strOrNull)(txt, allowEmpty);
+    };
+    const textAsUpper = (options) => {
+        const txt = text(options);
+        return txt ? txt.toLocaleUpperCase() : txt;
+    };
+    const textAsLower = (options) => {
+        const txt = text(options);
+        return txt ? txt.toLocaleLowerCase() : txt;
+    };
+    const textAsNumber = (options) => {
+        const txt = text(options);
+        return (0, format_1.strAsNumber)(txt, options);
+    };
+    const prop = (propOrPath, { allowEmpty = false } = {}) => {
+        var _a;
+        const propPath = Array.isArray(propOrPath) ? propOrPath : [propOrPath];
+        let propVal = (_a = (0, get_1.default)(node, propPath)) !== null && _a !== void 0 ? _a : null;
+        propVal = typeof propVal === 'string' ? propVal.trim() : propVal;
+        return (0, format_1.strOrNull)(propVal, allowEmpty);
+    };
+    const props = (propsOrPaths, options = {}) => {
+        const propPaths = propsOrPaths.map((p) => (Array.isArray(p) ? p : [p]));
+        const propData = propPaths.map((path) => prop(path, options));
+        return propData;
+    };
+    const attr = (propName, { allowEmpty } = {}) => {
+        var _a;
+        let attrVal = (_a = node.getAttribute(propName)) !== null && _a !== void 0 ? _a : null;
+        attrVal = typeof attrVal === 'string' ? attrVal.trim() : attrVal;
+        return (0, format_1.strOrNull)(attrVal, allowEmpty);
+    };
+    const attrs = (attrNames, options = {}) => {
+        const attrData = attrNames.reduce((agg, name) => {
+            agg[name] = attr(name, options);
+            return agg;
+        }, {});
+        return attrData;
+    };
+    const href = ({ allowEmpty, allowRelative, baseUrl } = {}) => __awaiter(void 0, void 0, void 0, function* () {
+        const val = prop('href', { allowEmpty });
+        return (0, url_1.formatUrl)(val, { allowRelative, baseUrl: baseUrl !== null && baseUrl !== void 0 ? baseUrl : (yield url()) });
+    });
+    const src = ({ allowEmpty, allowRelative, baseUrl } = {}) => __awaiter(void 0, void 0, void 0, function* () {
+        const val = prop('src', { allowEmpty });
+        return (0, url_1.formatUrl)(val, { allowRelative, baseUrl: baseUrl !== null && baseUrl !== void 0 ? baseUrl : (yield url()) });
+    });
+    const nodeName = () => {
+        // On UPPER- vs lower-case https://stackoverflow.com/questions/27223756/
+        const val = prop('nodeName');
+        return typeof val === 'string' ? val.toLocaleUpperCase() : val;
+    };
+    const url = () => {
+        var _a, _b;
+        // See https://stackoverflow.com/a/16010322/9788634
+        const urlVal = ((_b = (_a = getDoc().defaultView) === null || _a === void 0 ? void 0 : _a.location) === null || _b === void 0 ? void 0 : _b.href) || null;
+        return urlVal;
+    };
+    const map = (mapFn) => {
+        return mapFn(node);
+    };
+    ///////////////////////
+    // NODE OPERATIONS
+    ///////////////////////
+    const findOne = (selector) => {
+        var _a;
+        if (![Node.ELEMENT_NODE, Node.DOCUMENT_NODE].includes(node.nodeType)) {
+            return (0, types_1.createPortadomPromise)(null);
+        }
+        const resultEl = ((_a = node.querySelector(selector)) !== null && _a !== void 0 ? _a : null);
+        const dom = resultEl ? (0, exports.browserPortadom)(resultEl) : null;
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const findMany = (selector) => {
+        if (![Node.ELEMENT_NODE, Node.DOCUMENT_NODE].includes(node.nodeType)) {
+            return (0, types_1.createPortadomArrayPromise)([]);
+        }
+        const resultEls = [...node.querySelectorAll(selector)]; // prettier-ignore
+        const dom = resultEls.map((el) => (0, exports.browserPortadom)(el));
+        return (0, types_1.createPortadomArrayPromise)(dom);
+    };
+    const closest = (selector) => {
+        var _a;
+        if (![Node.ELEMENT_NODE, Node.DOCUMENT_NODE].includes(node.nodeType)) {
+            return (0, types_1.createPortadomPromise)(null);
+        }
+        const resultEl = ((_a = node.closest(selector)) !== null && _a !== void 0 ? _a : null);
+        const dom = resultEl ? (0, exports.browserPortadom)(resultEl) : null;
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const parent = () => {
+        const parentEl = (node.parentNode || null);
+        const dom = parentEl ? (0, exports.browserPortadom)(parentEl) : null;
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const children = () => {
+        const childEls = [...node.children];
+        const dom = childEls.map((el) => (0, exports.browserPortadom)(el));
+        return (0, types_1.createPortadomArrayPromise)(dom);
+    };
+    const root = () => {
+        var _a;
+        const rootEl = (((_a = node.ownerDocument) === null || _a === void 0 ? void 0 : _a.documentElement) || null);
+        const dom = rootEl ? (0, exports.browserPortadom)(rootEl) : null;
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const remove = () => {
+        node.remove();
+    };
+    const _getCommonAncestor = (el1, el2) => {
+        // https://stackoverflow.com/a/25154092
+        // https://developer.mozilla.org/en-US/docs/Web/API/Range/commonAncestorContainer
+        const _getCommonAncestorFromRange = (el1, el2) => {
+            const range = new Range();
+            range.setStartBefore(el1);
+            range.setEndAfter(el2);
+            const containerEl = range.commonAncestorContainer;
+            return containerEl;
+        };
+        // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition
+        const isEl1BeforeEl2 = !!(el1.compareDocumentPosition(el2) & Node.DOCUMENT_POSITION_FOLLOWING);
+        const { firstEl, lastEl } = isEl1BeforeEl2
+            ? { firstEl: el1, lastEl: el2 }
+            : { firstEl: el2, lastEl: el1 };
+        const containerEl = _getCommonAncestorFromRange(firstEl, lastEl);
+        return containerEl;
+    };
+    const getCommonAncestor = (otherEl) => {
+        const ancestor = _getCommonAncestor(node, otherEl);
+        const dom = ancestor ? (0, exports.browserPortadom)(ancestor) : null;
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const _getCommonAncestorFromSelector = _createCommonAncestorFromSelectorFn({
+        querySelectorAll: (selector) => node.querySelectorAll(selector),
+        getParent: (el) => el.parentElement,
+        isAncestor: (el1, el2) => {
+            return !!(el1.compareDocumentPosition(el2) & Node.DOCUMENT_POSITION_CONTAINED_BY);
+        },
+        getCommonAncestor: (el1, el2) => _getCommonAncestor(el1, el2),
+    });
+    const getCommonAncestorFromSelector = (selector) => {
+        const dom = _getCommonAncestorFromSelector(selector).then((ancestor) => (ancestor ? (0, exports.browserPortadom)(ancestor) : null));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    return {
+        node,
+        text,
+        textAsLower,
+        textAsUpper,
+        textAsNumber,
+        attr,
+        attrs,
+        prop,
+        props,
+        href,
+        src,
+        nodeName,
+        url,
+        map,
+        findOne,
+        findMany,
+        closest,
+        parent,
+        children,
+        root,
+        remove,
+        getCommonAncestor,
+        getCommonAncestorFromSelector,
+    };
+};
+exports.browserPortadom = browserPortadom;
+/** Implementation of Portadom in Cheerio */
+const cheerioPortadom = (cheerioNode, srcUrl) => {
+    ///////////////////////
+    // SCALAR OPERATIONS
+    ///////////////////////
+    const text = ({ allowEmpty } = {}) => {
+        var _a, _b;
+        const txt = (_b = (_a = cheerioNode.text()) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : null;
+        return (0, format_1.strOrNull)(txt, allowEmpty);
+    };
+    const textAsUpper = (options) => {
+        const txt = text(options);
+        return txt ? txt.toLocaleUpperCase() : txt;
+    };
+    const textAsLower = (options) => {
+        const txt = text(options);
+        return txt ? txt.toLocaleLowerCase() : txt;
+    };
+    const textAsNumber = (options) => {
+        const txt = text(options);
+        return (0, format_1.strAsNumber)(txt, options);
+    };
+    const attr = (attrName, { allowEmpty } = {}) => {
+        var _a;
+        let attrVal = (_a = cheerioNode.attr(attrName)) !== null && _a !== void 0 ? _a : null;
+        attrVal = typeof attrVal === 'string' ? attrVal.trim() : attrVal;
+        return (0, format_1.strOrNull)(attrVal, allowEmpty);
+    };
+    const attrs = (attrNames, options = {}) => {
+        const attrData = attrNames.reduce((agg, name) => {
+            agg[name] = attr(name, options);
+            return agg;
+        }, {});
+        return attrData;
+    };
+    const prop = (propOrPath, { allowEmpty = false } = {}) => {
+        var _a;
+        const propPath = Array.isArray(propOrPath) ? propOrPath : [propOrPath];
+        let propVal = (_a = cheerioNode.prop(propPath[0])) !== null && _a !== void 0 ? _a : null;
+        if (propPath.length > 1)
+            propVal = (0, get_1.default)(propVal, propPath.slice(1));
+        propVal = typeof propVal === 'string' ? propVal.trim() : propVal;
+        return (0, format_1.strOrNull)(propVal, allowEmpty);
+    };
+    const props = (propsOrPaths, options = {}) => {
+        const propPaths = propsOrPaths.map((p) => (Array.isArray(p) ? p : [p]));
+        const propData = propPaths.map((path) => prop(path, options));
+        return propData;
+    };
+    const href = ({ allowEmpty, allowRelative, baseUrl } = {}) => {
+        const val = prop('href', { allowEmpty });
+        return (0, url_1.formatUrl)(val, { allowRelative, baseUrl: baseUrl !== null && baseUrl !== void 0 ? baseUrl : srcUrl });
+    };
+    const src = ({ allowEmpty, allowRelative, baseUrl } = {}) => {
+        const val = prop('src', { allowEmpty });
+        return (0, url_1.formatUrl)(val, { allowRelative, baseUrl: baseUrl !== null && baseUrl !== void 0 ? baseUrl : srcUrl });
+    };
+    const nodeName = () => {
+        // On UPPER- vs lower-case https://stackoverflow.com/questions/27223756/
+        const val = prop('nodeName');
+        return typeof val === 'string' ? val.toLocaleUpperCase() : val;
+    };
+    const url = () => {
+        return srcUrl !== null && srcUrl !== void 0 ? srcUrl : null;
+    };
+    const map = (mapFn) => {
+        return mapFn(cheerioNode);
+    };
+    ///////////////////////
+    // NODE OPERATIONS
+    ///////////////////////
+    const findOne = (selector) => {
+        const resultEl = cheerioNode.find(selector).first();
+        if (!resultEl.get(0))
+            return (0, types_1.createPortadomPromise)(null);
+        const dom = (0, exports.cheerioPortadom)(resultEl, srcUrl);
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const findMany = (selector) => {
+        const resultEls = (0, domUtils_1.splitCheerioSelection)(cheerioNode.find(selector));
+        const doms = resultEls.map((ch) => (0, exports.cheerioPortadom)(ch, srcUrl));
+        return (0, types_1.createPortadomArrayPromise)(doms);
+    };
+    const closest = (selector) => {
+        const resultEl = cheerioNode.closest(selector).first();
+        if (!resultEl.get(0))
+            return (0, types_1.createPortadomPromise)(null);
+        const dom = (0, exports.cheerioPortadom)(resultEl, srcUrl);
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const parent = () => {
+        const parentEl = cheerioNode.parent().first();
+        if (!parentEl.get(0))
+            return (0, types_1.createPortadomPromise)(null);
+        const dom = (0, exports.cheerioPortadom)(parentEl, srcUrl);
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const children = () => {
+        const childEls = (0, domUtils_1.splitCheerioSelection)(cheerioNode.children());
+        const doms = childEls.map((ch) => (0, exports.cheerioPortadom)(ch, srcUrl));
+        return (0, types_1.createPortadomArrayPromise)(doms);
+    };
+    const root = () => {
+        var _a;
+        const rootEl = (_a = cheerioNode._root) === null || _a === void 0 ? void 0 : _a.first();
+        if (!(rootEl === null || rootEl === void 0 ? void 0 : rootEl.get(0)))
+            return (0, types_1.createPortadomPromise)(null);
+        const dom = (0, exports.cheerioPortadom)(rootEl, srcUrl);
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const remove = () => {
+        cheerioNode.remove();
+    };
+    /** Function that finds the closest common ancestor for `el1` and `el2`. */
+    const _getCommonAncestor = (el1, el2) => __awaiter(void 0, void 0, void 0, function* () {
+        const ch1Parents = (0, domUtils_1.splitCheerioSelection)(el1.parents());
+        const ch2Parents = (0, domUtils_1.splitCheerioSelection)(el2.parents());
+        let commonAncestor = null;
+        for (const comparerParent of ch1Parents) {
+            for (const compareeParent of ch2Parents) {
+                if (!comparerParent.is(compareeParent))
+                    continue;
+                commonAncestor = comparerParent;
+                break;
+            }
+            if (commonAncestor)
+                break;
+        }
+        return commonAncestor;
+    });
+    const getCommonAncestor = (otherEl) => {
+        const dom = _getCommonAncestor(cheerioNode, otherEl).then((ancestor) => {
+            if (!(ancestor === null || ancestor === void 0 ? void 0 : ancestor.get(0)))
+                return null;
+            return (0, exports.cheerioPortadom)(ancestor, srcUrl);
+        });
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const _getCommonAncestorFromSelector = _createCommonAncestorFromSelectorFn({
+        querySelectorAll: (selector) => (0, domUtils_1.splitCheerioSelection)(cheerioNode.find(selector)),
+        getParent: (el) => el.parent(),
+        isAncestor: (el1, el2) => el1.is(el2.parents()),
+        getCommonAncestor: (el1, el2) => _getCommonAncestor(el1, el2),
+    });
+    const getCommonAncestorFromSelector = (selector) => {
+        const dom = _getCommonAncestorFromSelector(selector).then((ancestor) => {
+            if (!(ancestor === null || ancestor === void 0 ? void 0 : ancestor.get(0)))
+                return null;
+            return (0, exports.cheerioPortadom)(ancestor, srcUrl);
+        });
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    return {
+        node: cheerioNode,
+        text,
+        textAsLower,
+        textAsUpper,
+        textAsNumber,
+        attr,
+        attrs,
+        prop,
+        props,
+        href,
+        src,
+        nodeName,
+        url,
+        map,
+        findOne,
+        findMany,
+        closest,
+        parent,
+        children,
+        root,
+        remove,
+        getCommonAncestor,
+        getCommonAncestorFromSelector,
+    };
+};
+exports.cheerioPortadom = cheerioPortadom;
+const verifyHandleEl = (el) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!el)
+        return null;
+    const exists = yield el.evaluate((el) => !!el).catch(error_1.logAndRethrow);
+    return exists ? el : null;
+});
+/** Implementation of Portadom in Playwright using Handles */
+const playwrightHandlePortadom = (node, page) => {
+    ///////////////////////
+    // SCALAR OPERATIONS
+    ///////////////////////
+    const text = ({ allowEmpty } = {}) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
+        const txt = (_b = (_a = (yield node.textContent())) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : null;
+        return (0, format_1.strOrNull)(txt, allowEmpty);
+    });
+    const textAsUpper = (options) => __awaiter(void 0, void 0, void 0, function* () {
+        const txt = yield text(options);
+        return txt ? txt.toLocaleUpperCase() : txt;
+    });
+    const textAsLower = (options) => __awaiter(void 0, void 0, void 0, function* () {
+        const txt = yield text(options);
+        return txt ? txt.toLocaleLowerCase() : txt;
+    });
+    const textAsNumber = (options) => __awaiter(void 0, void 0, void 0, function* () {
+        const txt = yield text(options);
+        return (0, format_1.strAsNumber)(txt, options);
+    });
+    const prop = (propOrPath, options = {}) => __awaiter(void 0, void 0, void 0, function* () {
+        const [resProp] = yield props([propOrPath], options);
+        return resProp;
+    });
+    const props = (propsOrPaths, { allowEmpty = false } = {}) => __awaiter(void 0, void 0, void 0, function* () {
+        const propPaths = propsOrPaths.map((p) => (Array.isArray(p) ? p : [p]));
+        const data = yield node
+            .evaluate((el, { propPaths, allowEmpty }) => {
+            return propPaths.map((propPath) => {
+                let val = el;
+                for (const prop of propPath) {
+                    if (el == null)
+                        break;
+                    val = val[prop];
+                }
+                val = typeof val === 'string' ? val.trim() : val;
+                return (0, format_1.strOrNull)(val, allowEmpty);
+            });
+        }, { propPaths, allowEmpty })
+            .catch(error_1.logAndRethrow);
+        return data;
+    });
+    const attr = (attrName, options) => __awaiter(void 0, void 0, void 0, function* () {
+        var _c;
+        const data = yield attrs([attrName], options);
+        return (_c = data[attrName]) !== null && _c !== void 0 ? _c : null;
+    });
+    const attrs = (attrNames, { allowEmpty = false } = {}) => {
+        const data = node
+            .evaluate((el, { attrNames, allowEmpty }) => {
+            const attrData = attrNames.reduce((agg, name) => {
+                var _a;
+                let attrVal = (_a = el.getAttribute(name)) !== null && _a !== void 0 ? _a : null;
+                attrVal = typeof attrVal === 'string' ? attrVal.trim() : attrVal;
+                agg[name] = (0, format_1.strOrNull)(attrVal, allowEmpty);
+                return agg;
+            }, {});
+            return attrData;
+        }, { attrNames, allowEmpty })
+            .catch(error_1.logAndRethrow);
+        return data;
+    };
+    const href = ({ allowEmpty, allowRelative, baseUrl, } = {}) => __awaiter(void 0, void 0, void 0, function* () {
+        const val = (yield prop('href', { allowEmpty }));
+        return (0, url_1.formatUrl)(val, { allowRelative, baseUrl: baseUrl !== null && baseUrl !== void 0 ? baseUrl : (yield url()) });
+    });
+    const src = ({ allowEmpty, allowRelative, baseUrl, } = {}) => __awaiter(void 0, void 0, void 0, function* () {
+        const val = (yield prop('src', { allowEmpty }));
+        return (0, url_1.formatUrl)(val, { allowRelative, baseUrl: baseUrl !== null && baseUrl !== void 0 ? baseUrl : (yield url()) });
+    });
+    const nodeName = () => __awaiter(void 0, void 0, void 0, function* () {
+        // On UPPER- vs lower-case https://stackoverflow.com/questions/27223756/
+        const val = (yield prop('nodeName'));
+        return typeof val === 'string' ? val.toLocaleUpperCase() : val;
+    });
+    const url = () => __awaiter(void 0, void 0, void 0, function* () {
+        return page.url() || null;
+    });
+    const map = (mapFn) => {
+        return mapFn(node);
+    };
+    ///////////////////////
+    // NODE OPERATIONS
+    ///////////////////////
+    const findOne = (selector) => {
+        const dom = node
+            .evaluateHandle((el, s) => {
+            if (![Node.ELEMENT_NODE, Node.DOCUMENT_NODE].includes(el.nodeType))
+                return null;
+            return el.querySelector(s) || null;
+        }, selector)
+            .catch(error_1.logAndRethrow)
+            .then((resultEl) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield verifyHandleEl(resultEl);
+            return hasResult ? (0, exports.playwrightHandlePortadom)(resultEl, page) : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const findMany = (selector) => {
+        const doms = node
+            .evaluateHandle((el, s) => {
+            if (![Node.ELEMENT_NODE, Node.DOCUMENT_NODE].includes(el.nodeType))
+                return [];
+            return [...el.querySelectorAll(s)];
+        }, selector)
+            .catch(error_1.logAndRethrow)
+            .then((elsHandle) => __awaiter(void 0, void 0, void 0, function* () {
+            const resultEls = yield (0, domUtils_1.splitPlaywrightSelection)(elsHandle);
+            return resultEls.map((el) => (0, exports.playwrightHandlePortadom)(el, page));
+        }));
+        return (0, types_1.createPortadomArrayPromise)(doms);
+    };
+    const closest = (selector) => {
+        const dom = node
+            .evaluateHandle((el, s) => {
+            if (![Node.ELEMENT_NODE, Node.DOCUMENT_NODE].includes(el.nodeType))
+                return null;
+            return el.closest(s) || null;
+        }, selector)
+            .catch(error_1.logAndRethrow)
+            .then((resultEl) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield verifyHandleEl(resultEl);
+            return hasResult ? (0, exports.playwrightHandlePortadom)(resultEl, page) : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const parent = () => {
+        const dom = node
+            .evaluateHandle((el) => el.parentElement || null)
+            .catch(error_1.logAndRethrow)
+            .then((resultEl) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield verifyHandleEl(resultEl);
+            return hasResult ? (0, exports.playwrightHandlePortadom)(resultEl, page) : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const children = () => {
+        const doms = node
+            .evaluateHandle((el) => [...el.children])
+            .catch(error_1.logAndRethrow)
+            .then((elsHandle) => __awaiter(void 0, void 0, void 0, function* () {
+            const resultEls = yield (0, domUtils_1.splitPlaywrightSelection)(elsHandle);
+            return resultEls.map((el) => (0, exports.playwrightHandlePortadom)(el, page));
+        }));
+        return (0, types_1.createPortadomArrayPromise)(doms);
+    };
+    const root = () => {
+        const dom = node
+            .evaluateHandle((el) => { var _a; return ((_a = el.ownerDocument) === null || _a === void 0 ? void 0 : _a.documentElement) || null; })
+            .catch(error_1.logAndRethrow)
+            .then((resultEl) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield verifyHandleEl(resultEl);
+            return hasResult ? (0, exports.playwrightHandlePortadom)(resultEl, page) : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const remove = () => __awaiter(void 0, void 0, void 0, function* () {
+        yield node.evaluate((el) => el.remove()).catch(error_1.logAndRethrow);
+    });
+    const _getCommonAncestor = (loc1, loc2) => __awaiter(void 0, void 0, void 0, function* () {
+        const isEl1BeforeEl2 = yield (yield (0, domUtils_1.mergeHandles)([loc1, loc2]))
+            .evaluate(([el1, el2]) => {
+            if (!el1 || !el2)
+                return false;
+            // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition
+            const result = !!(el1.compareDocumentPosition(el2) & Node.DOCUMENT_POSITION_FOLLOWING);
+            return result;
+        })
+            .catch(error_1.logAndRethrow);
+        const { firstEl, lastEl } = isEl1BeforeEl2
+            ? { firstEl: loc1, lastEl: loc2 }
+            : { firstEl: loc2, lastEl: loc1 };
+        const ancestor = yield (yield (0, domUtils_1.mergeHandles)([firstEl, lastEl]))
+            .evaluateHandle(([el1, el2]) => {
+            if (!el1 || !el2)
+                return null;
+            // https://stackoverflow.com/a/25154092
+            // https://developer.mozilla.org/en-US/docs/Web/API/Range/commonAncestorContainer
+            const range = new Range();
+            range.setStartBefore(el1);
+            range.setEndAfter(el2);
+            const containerEl = range.commonAncestorContainer;
+            return containerEl;
+        })
+            .catch(error_1.logAndRethrow);
+        const hasResult = yield ancestor.evaluate((el) => !!el).catch(error_1.logAndRethrow);
+        return hasResult ? ancestor : null;
+    });
+    const getCommonAncestor = (otherEl) => {
+        const dom = _getCommonAncestor(node, otherEl).then((resultEl) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield verifyHandleEl(resultEl);
+            return resultEl && hasResult
+                ? (0, exports.playwrightHandlePortadom)(resultEl, page)
+                : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const _getCommonAncestorFromSelector = _createCommonAncestorFromSelectorFn({
+        querySelectorAll: (selector) => __awaiter(void 0, void 0, void 0, function* () {
+            const resultEls = (yield findMany(selector).map((d) => d.node)).filter(Boolean);
+            return resultEls;
+        }),
+        getParent: (el) => __awaiter(void 0, void 0, void 0, function* () {
+            return (0, exports.playwrightHandlePortadom)(el, page).parent().node;
+        }),
+        isAncestor: (el1, el2) => __awaiter(void 0, void 0, void 0, function* () {
+            return (yield (0, domUtils_1.mergeHandles)([el1, el2]))
+                .evaluate(([el1, el2]) => {
+                if (!el1 || !el2)
+                    return false;
+                // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition
+                const result = !!(el1.compareDocumentPosition(el2) & Node.DOCUMENT_POSITION_CONTAINED_BY);
+                return result;
+            })
+                .catch(error_1.logAndRethrow);
+        }),
+        getCommonAncestor: _getCommonAncestor,
+    });
+    const getCommonAncestorFromSelector = (selector) => {
+        const dom = _getCommonAncestorFromSelector(selector).then((resultEl) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield verifyHandleEl(resultEl);
+            return resultEl && hasResult
+                ? (0, exports.playwrightHandlePortadom)(resultEl, page)
+                : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    return {
+        node,
+        text,
+        textAsLower,
+        textAsUpper,
+        textAsNumber,
+        attr,
+        attrs,
+        prop,
+        props,
+        href,
+        src,
+        nodeName,
+        url,
+        map,
+        findOne,
+        findMany,
+        closest,
+        parent,
+        children,
+        root,
+        remove,
+        getCommonAncestor,
+        getCommonAncestorFromSelector,
+    };
+};
+exports.playwrightHandlePortadom = playwrightHandlePortadom;
+/** Implementation of Portadom in Playwright using Locators */
+const playwrightLocatorPortadom = (node, page) => {
+    // NOTE: Where possible, make use of the already-existing logic for Handles
+    const handleDom = (0, exports.playwrightHandlePortadom)(node, page);
+    ///////////////////////
+    // SCALAR OPERATIONS
+    ///////////////////////
+    /** Empty */
+    ///////////////////////
+    // NODE OPERATIONS
+    ///////////////////////
+    const findOne = (selector) => {
+        const resultEl = node.locator(selector);
+        const dom = verifyHandleEl(resultEl).then((hasResult) => {
+            return hasResult ? (0, exports.playwrightLocatorPortadom)(resultEl, page) : null;
+        });
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const findMany = (selector) => {
+        const doms = node
+            .locator(selector)
+            .all()
+            .then((resultEls) => {
+            return resultEls.map((el) => (0, exports.playwrightLocatorPortadom)(el, page));
+        });
+        return (0, types_1.createPortadomArrayPromise)(doms);
+    };
+    const closest = (selector) => {
+        // Find closest ancestor matching the given selector.
+        // See https://stackoverflow.com/a/40333166/9788634
+        const resultEl = node.locator(`xpath=ancestor::${selector.trim()}[position() = 1]`);
+        const dom = verifyHandleEl(resultEl).then((hasResult) => {
+            return hasResult ? (0, exports.playwrightLocatorPortadom)(resultEl, page) : null;
+        });
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const parent = () => {
+        return closest('*');
+    };
+    const children = () => {
+        const doms = node
+            .locator('xpath=child::*')
+            .all()
+            .then((resultEls) => {
+            return resultEls.map((el) => (0, exports.playwrightLocatorPortadom)(el, page));
+        });
+        return (0, types_1.createPortadomArrayPromise)(doms);
+    };
+    const root = () => {
+        // Find closest ancestor matching the given selector.
+        // See https://stackoverflow.com/a/40333166/9788634 and https://stackoverflow.com/q/31562639/9788634
+        const resultEl = node.locator(`xpath=ancestor::*[position() = last()]`);
+        const dom = verifyHandleEl(resultEl).then((hasResult) => {
+            return hasResult ? (0, exports.playwrightLocatorPortadom)(resultEl, page) : null;
+        });
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const remove = () => __awaiter(void 0, void 0, void 0, function* () {
+        yield node.evaluate((el) => el.remove()).catch(error_1.logAndRethrow);
+    });
+    /** Function that finds the closest common ancestor for `el1` and `el2`. */
+    const _getCommonAncestor = (el1, el2) => __awaiter(void 0, void 0, void 0, function* () {
+        const ch1Parents = yield el1.locator(`xpath=ancestor::*`).all();
+        const ch2Parents = yield el2.locator(`xpath=ancestor::*`).all();
+        let commonAncestor = null;
+        for (const comparerParent of ch1Parents) {
+            for (const compareeParent of ch2Parents) {
+                const handle = yield (0, domUtils_1.mergeHandles)([comparerParent, compareeParent]);
+                const isSame = yield handle.evaluate(([el1, el2]) => {
+                    return el1 === el2;
+                });
+                if (isSame) {
+                    commonAncestor = comparerParent;
+                    break;
+                }
+            }
+            if (commonAncestor)
+                break;
+        }
+        return commonAncestor;
+    });
+    const getCommonAncestor = (otherEl) => {
+        const dom = _getCommonAncestor(node, otherEl).then((resultEl) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield verifyHandleEl(resultEl);
+            return resultEl && hasResult
+                ? (0, exports.playwrightLocatorPortadom)(resultEl, page)
+                : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    const _getCommonAncestorFromSelector = _createCommonAncestorFromSelectorFn({
+        querySelectorAll: (selector) => __awaiter(void 0, void 0, void 0, function* () {
+            const resultEls = (yield findMany(selector).map((d) => d.node)).filter(Boolean);
+            return resultEls;
+        }),
+        getParent: (el) => __awaiter(void 0, void 0, void 0, function* () {
+            return (0, exports.playwrightLocatorPortadom)(el, page).parent().node;
+        }),
+        isAncestor: (el1, el2) => __awaiter(void 0, void 0, void 0, function* () {
+            return (yield (0, domUtils_1.mergeHandles)([el1, el2]))
+                .evaluate(([el1, el2]) => {
+                if (!el1 || !el2)
+                    return false;
+                // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition
+                const result = !!(el1.compareDocumentPosition(el2) & Node.DOCUMENT_POSITION_CONTAINED_BY);
+                return result;
+            })
+                .catch(error_1.logAndRethrow);
+        }),
+        getCommonAncestor: _getCommonAncestor,
+    });
+    const getCommonAncestorFromSelector = (selector) => {
+        const dom = _getCommonAncestorFromSelector(selector).then((ancestor) => __awaiter(void 0, void 0, void 0, function* () {
+            const hasResult = yield (ancestor === null || ancestor === void 0 ? void 0 : ancestor.evaluate((el) => !!el).catch(error_1.logAndRethrow));
+            return ancestor && hasResult
+                ? (0, exports.playwrightHandlePortadom)(ancestor, page)
+                : null;
+        }));
+        return (0, types_1.createPortadomPromise)(dom);
+    };
+    return {
+        node,
+        text: handleDom.text,
+        textAsLower: handleDom.textAsLower,
+        textAsUpper: handleDom.textAsUpper,
+        textAsNumber: handleDom.textAsNumber,
+        attr: handleDom.attr,
+        attrs: handleDom.attrs,
+        prop: handleDom.prop,
+        props: handleDom.props,
+        href: handleDom.href,
+        src: handleDom.src,
+        nodeName: handleDom.nodeName,
+        url: handleDom.url,
+        map: handleDom.map,
+        findOne,
+        findMany,
+        closest,
+        parent,
+        children,
+        root,
+        remove,
+        getCommonAncestor,
+        getCommonAncestorFromSelector,
+    };
+};
+exports.playwrightLocatorPortadom = playwrightLocatorPortadom;
+const _createCommonAncestorFromSelectorFn = (input) => {
+    const getCommonAncestorFromSelector = (selector) => __awaiter(void 0, void 0, void 0, function* () {
+        const els = [...(yield input.querySelectorAll(selector))];
+        if (!els.length)
+            return null;
+        if (els.length === 1)
+            return input.getParent(els[0]);
+        const comparerEl = els.shift();
+        let ancestorEl = null;
+        for (const el of els) {
+            const currAncestorEl = comparerEl ? yield input.getCommonAncestor(comparerEl, el) : null;
+            const newAncestorEl = !ancestorEl
+                ? currAncestorEl
+                : currAncestorEl && (yield input.isAncestor(currAncestorEl, ancestorEl))
+                    ? currAncestorEl
+                    : ancestorEl;
+            ancestorEl = newAncestorEl;
+        }
+        return ancestorEl;
+    });
+    return getCommonAncestorFromSelector;
+};
+(0, exports.browserPortadom)(document.body);
+//# sourceMappingURL=dom.js.map