setMutationHandler

MutationObserver wrapper to wait for the specified CSS selector

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.greasyfork.org/scripts/12228/175122/setMutationHandler.js

You will need to install an extension such as Tampermonkey, Greasemonkey or Violentmonkey to install this script.

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

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

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

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

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

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.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

Author
woxxom
Version
3.0.2
Created
2015-09-05
Updated
2017-02-14
Size
3.1 KB
License
N/A

A MutationObserver wrapper to wait for an element (or elements) with the specified CSS selector.

First, load the function in your script metablock:

..............
// @require       https://greasyfork.org/scripts/12228/code/setMutationHandler.js
..............
// ==/UserScript==
  • Watch for added nodes:

    setMutationHandler(document, '.container p.some-child', nodes => {
        nodes.forEach(node => node.style.display = 'none');
        return false; // disconnect the observer, this is useful for one-time jobs
    });
    
  • The observation target parameter may be omitted so "document" will be used by default:

    setMutationHandler('.container p.some-selector', nodes => { ...... });
    
  • Options form:

    setMutationHandler({
        processExisting: true, // Process existing elements and watch for mutations from now on
        selector: '.container p.some-child',
        handler: nodes => nodes.forEach(node => node.style.display = 'none')
    });
    
  • Watch for added nodes only inside the specified container element that already exists in the document:

    setMutationHandler({
        target: document.querySelector('.container-selector'),
        selector: 'p.some-child',
        handler: nodes => nodes.forEach(node => node.style.display = 'none')
    });
    
  • Advanced example with customized mutation options:

    setMutationHandler({
        selector: '.container p.some-child',
        processExisting: false,       // optional
        target: document,             // optional
        childList: true,              // optional
        subtree: true,                // optional
        attributes: false,            // optional
        attributeFilter: [],          // optional
        attributeOldValue: false,     // optional
        characterData: false,         // optional
        characterDataOldValue: false, // optional
        handler: nodes => {
            console.log(nodes);
            return false; // disconnect the observer, this is useful for one-time jobs
        },
    });
    
  • Make your userscript run at document-start to catch the mutations during page load:

    ..............
    // @run-at        document-start
    // @require       https://greasyfork.org/scripts/12228/code/setMutationHandler.js
    ..............
    // ==/UserScript==