waitForElementCancel

Exactly the same as waitForKeyElements but with a cancel switch to stop a current running wait. Example Usage:

    waitForKeyElements("div", (object) => {
      object.text("do something only for the first found object...");
    });
    
    waitForKeyElements.cancel("div")

---

waitForElement

A alternative for waitForKeyElements that uses MutationObserver instead of intervals.

This is basically just a drop in direct conversion replacement to using MutationObserver, so you don't have to change anything to switch over to this version.

Definitely not recommened for excessive use on sites that have a lot of dymanic loading and such, or else you'll lag or freeze the page, for cases like that just use the original version.

Examples:

    waitForKeyElements("div.comments", (object) => {
      object.text("do something only for the first found object...");
    });

    waitForKeyElements("div.comments", (object) => {
      object.text("keep doing something to all found objects...");
    }, 0);

    function deleteDiv(object) {
      object.remove() // Remove and stop waiting for matching objects
    }

    waitForKeyElements("div#1", deleteDiv);
    waitForKeyElements("div#3", deleteDiv);
    waitForKeyElements("div#6", deleteDiv);

    function deleteDiv(object) {
      object.remove() // Remove and keep waiting for new objects to also remove
    }

    waitForKeyElements("div.magic", deleteDiv, 0);
    waitForKeyElements("div.rainbow_tag", deleteDiv, 0);
    waitForKeyElements("div.dislike", deleteDiv, 0);

    // ==UserScript==
    // @name         Example UserScript using waitForElement
    // @require      https://code.jquery.com/jquery-3.7.1.min.js
    // @require      https://raw.githubusercontent.com/GentlePuppet/waitForElement/refs/heads/main/waitForElement.js
    // ==/UserScript==
    
    waitForKeyElements("div.comments", (object) => {
        object.text("do something only for the first found object...");
    });

waitForKeyElements(selector, callback, 1, document)

• selector {string} - jQuery selector for the desired element(s).
• callback {function} - Function to call when elements are found. Receives a jQuery-wrapped element.
• [once=true] {boolean} - If true, stops observing after first match.
• [root=document] {string|Element|jQuery} - Optional root or iframe selector to observe within.