☰

UTILS_DOM Library

dom manipulation library

As of 2025-03-01. See the latest version.

This script should not be not be installed directly. It is a library for other scripts to include with the meta directive // @require https://update.greatest.deepsurf.us/scripts/528456/1545251/UTILS_DOM%20Library.js 

// ==UserScript==
// @name         UTILS_DOM Library
// @namespace    dannysaurus.epik
// @version      1.0
// @description  dom manipulation library
//
// @license      MIT
// @grant        unsafeWindow
// ==/UserScript==

/* jslint esversion: 11 */
/* global unsafeWindow */
(() => {
    'use strict';
    unsafeWindow.dannysaurus_epik ||= {};
    unsafeWindow.dannysaurus_epik.libraries ||= {};
    unsafeWindow.dannysaurus_epik.libraries.UTILS_DOM = (() => {

        /**
         * Tries to select an element by repeatedly attempting to find it.
         * 
         * @param {Object} options - The options for selecting the element.
         * @param {String} [options.selectors] - The function to select the element.
         * @param {number} [options.maxAttempts=6] - The number of attempts to make.
         * @param {number} [options.intervalMs=10000] - The interval between attempts in milliseconds.
         * @returns {Promise<Element|NodeList>} The selected element(s).
         * 
         * @throws {Error} If the element(s) could not be found.
         */
        const trySelectElement = async ({ selectors, maxAttempts = 6, intervalMs = 10000 } = {}) => {
            const sleep = () => new Promise(resolve => setTimeout(resolve, intervalMs));

            for (let attemptCount = 0; attemptCount < maxAttempts; attemptCount++) {
                const elements = document.querySelector(selectors);
                if (elements instanceof Element || (elements instanceof NodeList && elements.length)) {
                    return elements;
                }
                await sleep();
            }
            throw new Error('Element(s) not found');
        };

        const getUsername = () => {
            return document.querySelector(CONFIG.selectors.usernameContainer)?.textContent || '';
        };

        return {
            trySelectElement,
            getUsername,
        };
    })();
})();