Useful functions for yinr
اعتبارا من
لا ينبغي أن لا يتم تثبيت هذا السكريت مباشرة. هو مكتبة لسكبتات لتشمل مع التوجيه الفوقية // @require https://update.greatest.deepsurf.us/scripts/458769/1146252/Yinr-libs.js
// ==UserScript==
// @name Yinr-libs
// @namespace https://yinr.cc/
// @version 0.0.3
// @description Useful functions for yinr
// @author Yinr
// @license GPL-v3
// ==/UserScript==
/**
* YinrLibs
* @module YinrLibs
*/
const YinrLibs = (function() {
'use strict';
return {
/** 创建 DOM 监听
* @param {Object} option
* @param {(Element | string)} option.parentNode MutationObserver 绑定的 DOM 对象
* @param {string} option.selector 需要监听变化的 selector
* @param {voidCallback} [option.failCallback=callback] selector 不存在时执行的回调函数
* @param {MutationCallback} [option.successCallback=null] selector 对象发生 Mutation 事件时执行的回调函数
* @param {boolean} [option.stopWhenSuccess=true] 执行一次 `successCallback` 后立即解除监听
* @param {MutationObserverInit} [option.config={childList: true, subtree: true}] MutationObserver 配置参数
*/
launchObserver ({
parentNode,
selector,
failCallback = null,
successCallback = null,
stopWhenSuccess = true,
config = { childList: true, subtree: true }
}) {
if (!parentNode) return
/** @type {MutationCallback} */
const observeFunc = mutationList => {
if (!document.querySelector(selector)) {
if (failCallback) failCallback()
return
}
if (stopWhenSuccess) observer.disconnect()
mutationList.itemFilter = (fn, type = 'addedNodes') => mutationList.map(i => Array.from(i[type]).filter(fn)).reduce((arr, val) => arr.concat(val), [])
if (successCallback) successCallback(mutationList)
}
const observer = new MutationObserver(observeFunc)
observer.observe(parentNode, config)
},
/** 等待延时函数，默认固定延时 1s
* @param {number} [timeoutMin=1000] 最少随机等待时间（ms）
* @param {number} [timeoutMax=timeMin] 最多随机等待时间（ms）
* @returns {Promise<true>}
* @example
* await sleep() // 默认等待 1s
* @example
* await sleep(1000, 3000) // 随机等待 1-3s
*/
sleep(timeoutMin = 1000, timeoutMax = timeoutMin) {
return new Promise((resolve) => {
const timeout = timeoutMin === timeoutMax ? timeoutMin : Math.floor(Math.random() * (timeoutMax - timeoutMin) + timeoutMin)
setTimeout(() => { resolve(true) }, timeout);
})
}
};
})();