setMutationHandler

MutationObserver wrapper to wait for the specified CSS selector

Από την 13/02/2017. Δείτε την τελευταία έκδοση.

Αυτός ο κώδικας δεν πρέπει να εγκατασταθεί άμεσα. Είναι μια βιβλιοθήκη για άλλους κώδικες που περιλαμβάνεται μέσω της οδηγίας meta // @require https://update.greasyfork.org/scripts/12228/174877/setMutationHandler.js

θα χρειαστεί να εγκαταστήσετε μια επέκταση όπως το Tampermonkey, το Greasemonkey ή το Violentmonkey για να εγκαταστήσετε αυτόν τον κώδικα.

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

θα χρειαστεί να εγκαταστήσετε μια επέκταση όπως το Tampermonkey ή το Violentmonkey για να εγκαταστήσετε αυτόν τον κώδικα.

θα χρειαστεί να εγκαταστήσετε μια επέκταση όπως το Tampermonkey ή το Userscripts για να εγκαταστήσετε αυτόν τον κώδικα.

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

Θα χρειαστεί να εγκαταστήσετε μια επέκταση διαχείρισης κώδικα χρήστη για να εγκαταστήσετε αυτόν τον κώδικα.

(Έχω ήδη έναν διαχειριστή κώδικα χρήστη, επιτρέψτε μου να τον εγκαταστήσω!)

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.

(Έχω ήδη έναν διαχειριστή στυλ χρήστη, επιτρέψτε μου να τον εγκαταστήσω!)

/* EXAMPLE:

	setMutationHandler('.container p.some-child', nodes => {
		nodes.forEach(node => node.style.display = 'none');
		return false; // disconnect the observer, this is useful for one-time jobs
	});

	setMutationHandler({
		processExisting: true,
		selector: '.container p.some-child',
		handler: nodes => nodes.forEach(node => node.style.display = 'none')
	});

	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 => {
			nodes.forEach(node => node.style.display = 'none');
			return false; // disconnect the observer, this is useful for one-time jobs
		},
	});
*/

// ==UserScript==
// @name          setMutationHandler
// @description   MutationObserver wrapper to wait for the specified CSS selector
// @namespace     wOxxOm.scripts
// @author        wOxxOm
// @grant         none
// @version       3.0.1
// ==/UserScript==

function setMutationHandler(target, selector, handler, options) {
// or    setMutationHandler(selector, handler, options) {
// or    setMutationHandler(options) {
	if (typeof arguments[0] == 'string') {
		options = arguments[2] || {};
		handler = arguments[1];
		selector = arguments[0];
		target = document;
	} else if (arguments.length == 1 && target && typeof target.handler == 'function') {
		options = arguments[0];
		handler = options.handler;
		selector = options.selector;
		target = options.target || document;
	} else if (!(target instanceof Node)) {
		throw 'Bad params for setMutationHandler.\n' +
			'A: [optional Node] target, [String] selector, [Function] handler, [optional Object] options\n' +
			'B: [Object] options\n' +
			'Options: target, selector, handler, processExisting, childList, attributes, characterData, subtree, attributeOldValue, characterDataOldValue, attributeFilter';
	}
	if (options.processExisting && target.querySelector(selector))
		handler.call(null, Array.prototype.slice.call(target.querySelectorAll(selector)));
	if (!options.attributes && !options.characterData && !options.childList && options.subtree === undefined)
		options.childList = options.subtree = true;

	var cb;
	if (/^#[\w\d-]+$/.test(selector)) {
		selector = selector.substr(1);
		cb = MOhandlerForId;
	} else {
		cb = MOhandler;
	}
	var observer = new MutationObserver(cb);
	observer.observe(target, options || {subtree:true, childList:true});
	return observer;

	function MOhandler(mutations) {
		if (mutations.length > 100 && !document.querySelector(selector))
			return;
		var found = [];
		for (var i=0, m; (m = mutations[i++]); ) {
			switch (m.type) {
				case 'childList':
					var nodes = m.addedNodes, nl = nodes.length;
					var textNodesOnly = true;
					for (var j=0; j < nl; j++) {
						var n = nodes[j];
						textNodesOnly &= n.nodeType == 3; // TEXT_NODE
						if (n.nodeType != 1) // ELEMENT_NODE
							continue;
						if (n.matches(selector))
							found.push(n);
						else if (n.querySelector(selector)) {
							n = n.querySelectorAll(selector);
							if (n.length < 1000)
								found.push.apply(found, n);
							else
								found = found.concat(found.slice.call(n));
						}
					}
					if (textNodesOnly && m.target.matches(selector))
						found.push(m.target);
					break;
				case 'attributes':
					if (m.target.matches(selector))
						found.push(m.target);
					break;
				case 'characterData':
					if (m.target.parentNode && m.target.parentNode.matches(selector))
						found.push(m.target.parentNode);
					break;
			}
		}
		if (!found.length)
			return;
		if (handler.call(observer, found) === false)
			observer.disconnect();
	}

	function MOhandlerForId(mutations) {
		var el = document.getElementById(selector);
		if (el && target.contains(el))
			if (handler.call(observer, [el]) === false)
				observer.disconnect();
	}
}