Observe

Observe and wait for elements

Stan na 11-10-2025. Zobacz najnowsza wersja.

Ten skrypt nie powinien być instalowany bezpośrednio. Jest to biblioteka dla innych skyptów do włączenia dyrektywą meta // @require https://update.greasyfork.org/scripts/552301/1675893/Observe.js

Aby zainstalować ten skrypt, wymagana jest instalacje jednego z następujących rozszerzeń: Tampermonkey, Greasemonkey lub Violentmonkey.

You will need to install an extension such as Tampermonkey to install this script.

Aby zainstalować ten skrypt, wymagana jest instalacje jednego z następujących rozszerzeń: Tampermonkey, Violentmonkey.

Aby zainstalować ten skrypt, wymagana będzie instalacja rozszerzenia Tampermonkey lub Userscripts.

You will need to install an extension such as Tampermonkey to install this script.

Aby zainstalować ten skrypt, musisz zainstalować rozszerzenie menedżera skryptów użytkownika.

(Mam już menedżera skryptów użytkownika, pozwól mi to zainstalować!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

Będziesz musiał zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

Będziesz musiał zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

Musisz zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

(Mam już menedżera stylów użytkownika, pozwól mi to zainstalować!)

// ==UserScript==
// @name         Observe
// @license      MIT
// @version      1.2
// @description  Observe and wait for elements
// @author       tukars
// @match        *://*/*
// ==/UserScript==

(function () {
  // Define the namespace structure
  const NAMESPACE_ROOT = "userscript";
  const NAMESPACE_DOMAIN = "com";
  const NAMESPACE_AUTHOR = "tukars";
  const NAMESPACE_LIB_NAME = "Observe";

  window[NAMESPACE_ROOT] = window[NAMESPACE_ROOT] || {};
  window[NAMESPACE_ROOT][NAMESPACE_DOMAIN] =
    window[NAMESPACE_ROOT][NAMESPACE_DOMAIN] || {};
  window[NAMESPACE_ROOT][NAMESPACE_DOMAIN][NAMESPACE_AUTHOR] =
    window[NAMESPACE_ROOT][NAMESPACE_DOMAIN][NAMESPACE_AUTHOR] || {};

  if (
    window[NAMESPACE_ROOT][NAMESPACE_DOMAIN][NAMESPACE_AUTHOR][
      NAMESPACE_LIB_NAME
    ]
  ) {
    return;
  }

  const timeStamp = function () {
    const now = new Date();
    const pad = (num, size) => String(num).padStart(size, "0");

    const hours = pad(now.getHours(), 2);
    const minutes = pad(now.getMinutes(), 2);
    const seconds = pad(now.getSeconds(), 2);
    const milliseconds = pad(now.getMilliseconds(), 3);

    return `${hours}:${minutes}:${seconds}.${milliseconds}`;
  };

  const contextPrint = function (message, ENABLE_DEBUG_LOGGING) {
    const messageTime = () => `[${message}] ${timeStamp()} -`;

    const log = function (...args) {
      console.log(messageTime(), ...args);
    };
    const warn = function (...args) {
      console.warn(messageTime(), ...args);
    };
    const error = function (...args) {
      console.error(messageTime(), ...args);
    };
    const info = function (...args) {
      console.info(messageTime(), ...args);
    };
    var debug = function (...args) {
      console.debug(messageTime(), ...args);
    };
    if (!ENABLE_DEBUG_LOGGING) {
      debug = function () {};
    }

    return { log, warn, error, info, debug };
  };

  const observeChildren = function (element, config, callback) {
    const observer = new MutationObserver((mutationsList) => {
      for (const mutation of mutationsList) {
        if (mutation.type === "childList") {
          callback(Array.from(mutation.addedNodes));
        }
      }
    });
    const use_config = config || { childList: true, subtree: false };
    observer.observe(element, use_config);
    return observer;
  };

  const observeChildrenWithFilter = function (element, config, filter, callback) {
    return observeChildren(element, config, (addedNodes) =>
      callback(addedNodes.filter(filter))
    );
  };

  const observeChildrenWithTags = function (element, config, filterTags, callback) {
    return observeChildrenWithFilter(
      element,
      config,
      (node) =>
        node.nodeType === Node.ELEMENT_NODE &&
        filterTags.includes(node.tagName.toLowerCase()),
      callback
    );
  };

  const observeAndHandle = function (element, tags, fun, config) {
    const use_config = config || { childList: true, subtree: true };
    observeChildrenWithTags(element, use_config, tags, (nodes) =>
      nodes.forEach((node) => fun(node))
    );
  };

  function waitForElement(selector, callback) {
    const element = document.querySelector(selector);
    if (element) {
      callback(element);
    } else {
      const observer = new MutationObserver((_, obs) => {
        const el = document.querySelector(selector);
        if (el) {
          obs.disconnect();
          callback(el);
        }
      });
      observer.observe(document.body, { childList: true, subtree: true });
    }
  }

  window[NAMESPACE_ROOT][NAMESPACE_DOMAIN][NAMESPACE_AUTHOR][NAMESPACE_LIB_NAME] =
    {
      timeStamp,
      contextPrint,
      observeChildren,
      observeChildrenWithFilter,
      observeChildrenWithTags,
      observeAndHandle,
      waitForElement,
    };
})();