setMutationHandler

MutationObserver wrapper to wait for the specified CSS selector

目前為 2017-02-13 提交的版本，檢視最新版本。

此腳本不應該直接安裝，它是一個供其他腳本使用的函式庫。欲使用本函式庫，請在腳本 metadata 寫上： // @require https://update.greatest.deepsurf.us/scripts/12228/174877/setMutationHandler.js

發表問題、評論、或檢舉該腳本。

作者: woxxom
版本: 3.0.1
建立日期: 2015-09-05
更新日期: 2017-02-13
尺寸: 4.0 KB
授權條款: 未知

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://greatest.deepsurf.us/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://greatest.deepsurf.us/scripts/12228/code/setMutationHandler.js
..............
// ==/UserScript==