Common Utilities

Some common utilities

此脚本不应直接安装。它是供其他脚本使用的外部库,要使用该库请加入元指令 // @require https://update.gf.qytechs.cn/scripts/558741/1712360/Common%20Utilities.js

您需要先安装一款用户脚本管理器扩展,例如 Tampermonkey 篡改猴Greasemonkey 油猴子Violentmonkey 暴力猴,才能安装此脚本。

您需要先安装一款用户脚本管理器扩展,例如 Tampermonkey 篡改猴,才能安装此脚本。

您需要先安装一款用户脚本管理器扩展,例如 Tampermonkey 篡改猴Violentmonkey 暴力猴,才能安装此脚本。

您需要先安装一款用户脚本管理器扩展,例如 Tampermonkey 篡改猴Userscripts ,才能安装此脚本。

您需要先安装一款用户脚本管理器扩展,例如 Tampermonkey 篡改猴,才能安装此脚本。

您需要先安装一款用户脚本管理器扩展后才能安装此脚本。

(我已经安装了用户脚本管理器,让我安装!)

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

(我已经安装了用户样式管理器,让我安装!)

// ==UserScript==
// @name         Common Utilities
// @description  Some common utilities
// @namespace    https://github.com/dzist
// @version      0.0.1
// @author       Dylan Zhang
// @grant        GM_info
// ==/UserScript==

const utils = {
    log(...args) {
        console.log(
            `%c${GM_info.script.name}`,
            'padding: 0 4px; background: cyan; color: #000;',
            ...args
        )
    },
    ensureCondition(condition, maxAttempts = 600 /* 10s */, failureMessage) {
        const raf = window.requestAnimationFrame

        return new Promise((resolve, reject) => {
            let attempts = 0
            const detect = () => {
                const result = condition()
                if (result) {
                    resolve(result)
                } else if (attempts < maxAttempts) {
                    attempts++
                    raf(detect)
                } else {
                    reject(new Error(failureMessage))
                }
            }
            raf(detect)
        })
    },
    ensureElement(selector, maxAttempts = 600) {
        return utils.ensureCondition(
            () => document.querySelector(selector),
            maxAttempts,
            `Could not detect ${selector} after ${maxAttempts} attempts`
        )
    },
    getProperty(obj, ...props) {
        const stack = [obj]
        let current = obj

        for(let i = 0, len = props.length; i < len; i++) {
            const key = props[i]
            // check for undefined or null
            if (current == null) {
                return [, stack]
            }

            const isArraySearch = Array.isArray(current) && isNaN(Number(key))
            if (isArraySearch) {
                // if the `current` value is an array and the key is not a number,
                // find the first item with the key inside it.
                const foundItem = current.find(item => item && item[key])
                if (foundItem) {
                    stack.push(foundItem)
                    current = foundItem[key]
                } else {
                    return [, stack]
                }
            } else {
                current = current[key]
                if (i < len - 1 && current) {
                    stack.push(current)
                }
            }
        }

        return [current, stack]
    }
}