SuperGM

Extends the GM_setValue and GM_getValue functions for any javascript variable type. basis on https://userscripts-mirror.org/scripts/source/107941.user.js

当前为 2019-08-21 提交的版本,查看 最新版本

此脚本不应直接安装。它是供其他脚本使用的外部库,要使用该库请加入元指令 // @require https://update.cn-greasyfork.org/scripts/389206/726987/SuperGM.js

您需要先安装一个扩展,例如 篡改猴Greasemonkey暴力猴,之后才能安装此脚本。

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

您需要先安装一个扩展,例如 篡改猴暴力猴,之后才能安装此脚本。

您需要先安装一个扩展,例如 篡改猴Userscripts ,之后才能安装此脚本。

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

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

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

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

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

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

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

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

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

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

// ==UserScript==
// @name            SuperGM
// @version      0.0.1
// @description     Extends the GM_setValue and GM_getValue functions for any javascript variable type. basis on https://userscripts-mirror.org/scripts/source/107941.user.js 
// @namespace       userscripts.org/users/158640
// ==/UserScript==

if (!String.prototype.startsWith)
    String.prototype.startsWith = function (str) {
        return this.slice(0, str.length) == str;
    };
if (!String.prototype.endsWith)
    String.prototype.endsWith = function (str) {
        return this.slice(-str.length) == str;
    };
if (!String.prototype.contains)
    String.prototype.contains = function (str) {
        return this.indexOf(str) > -1;
    };
var SuperGM = function (version, _expiredMilliseconds) {
    var versionkeybasic = 'tsharp.org:key:v:';
    var expiredkeybasic = 'tsharp.org:key:e:';
    var JSON_MarkerStr = 'json_val: ';
    var FunctionMarker = 'function_code: ';
    var expiredMilliseconds = -1;
    if (typeof version != 'undefine') version = -1;
    if (typeof _expiredMilliseconds != 'undefine')
        expiredMilliseconds = -1;
    else
        expiredMilliseconds = _expiredMilliseconds;
    function ReportError(msg) {
        if (console && console.error)
            console.log(msg);
        else
            throw new Error(msg);
    }

    //--- Check that the environment is proper.
    if (typeof GM_setValue != "function")
        ReportError('This library requires Greasemonkey! GM_setValue is missing.');
    if (typeof GM_getValue != "function")
        ReportError('This library requires Greasemonkey! GM_getValue is missing.');
    if (typeof version != 'integer') {
        ReportError('Arg version should be a integer type if you wana set it.');
    }
    if (typeof expiredMilliseconds != 'integer') {
        ReportError('Arg expiredMilliseconds should be a integer type if you wana set it.');
    }

    this.set = function (varName, varValue) {

        if (!varName) {
            ReportError('Illegal varName sent to GM_SuperValue.set().');
            return;
        }
        if (/[^\w _-]/.test(varName)) {
            ReportError('Suspect, probably illegal, varName sent to GM_SuperValue.set().');
        }
        var versionKey = versionkeybasic + varName;
        GM_setValue(versionKey, version);
        var expiredkey = expiredkeybasic + varName;
        GM_setValue(expiredkey, new Date().getTime());

        if (typeof varValue == 'function') {
            varValue = varValue();
        }

        switch (typeof varValue) {
            case 'undefined':
                ReportError('Illegal varValue sent to GM_SuperValue.set().');
                break;
            case 'boolean':
            case 'string':
                //--- These 2 types are safe to store, as is.
                GM_setValue(varName, varValue);
                break;
            case 'number':
                /*--- Numbers are ONLY safe if they are integers.
                    Note that hex numbers, EG 0xA9, get converted
                    and stored as decimals, EG 169, automatically.
                    That's a feature of JavaScript.

                    Also, only a 32-bit, signed integer is allowed.
                    So we only process +/-2147483647 here.
                */
                if (varValue === parseInt(varValue) && Math.abs(varValue) < 2147483647) {
                    GM_setValue(varName, varValue);
                    break;
                }
            case 'object':
                /*--- For all other cases (but functions), and for
                    unsafe numbers, store the value as a JSON string.
                */
                var safeStr = JSON_MarkerStr + JSON.stringify(varValue);
                GM_setValue(varName, safeStr);
                break;
            case 'function':
                /*--- Functions need special handling.
                */
                var safeStr = FunctionMarker + varValue.toString();
                GM_setValue(varName, safeStr);
                break;

            default:
                ReportError('Unknown type in GM_SuperValue.set()!');
                break;
        }
    }//-- End of set()

    this.getOrAdd = function (varName, defaultValue) {

        if (!varName) {
            ReportError('Illegal varName sent to GM_SuperValue.get().');
            return;
        }
        if (/[^\w _-]/.test(varName)) {
            ReportError('Suspect, probably illegal, varName sent to GM_SuperValue.get().');
        }
        var versionKey = versionkeybasic + varName;
        var savedversion = GM_getValue(versionKey);
        if (version != savedversion) {  //需判断设置默认-1时
            if (typeof GM_deleteValue != "function") {
                GM_deleteValue(varName);
                GM_deleteValue(versionKey);
            }
            if (typeof defaultValue == 'function') {
                var varvalue = defaultValue();
                set(varName, varvalue);
                return varvalue;
            }
            else {
                set(varName, varvalue);
                return defaultValue;
            }
        }
        var expiredkey = expiredkeybasic + varName;
        var expire = GM_getValue(expiredkey);
        if (new Date().getTime() - expire > expiredMilliseconds) {
            if (typeof GM_deleteValue != "function") {
                GM_deleteValue(varName);
                GM_deleteValue(expiredkey);
            }
        }
        //--- Attempt to get the value from storage.
        var varValue = GM_getValue(varName);
        if (!varValue)
            return defaultValue;

        //--- We got a value from storage. Now unencode it, if necessary.
        if (typeof varValue == "string") {
            //--- Is it a JSON value?
            var regxp = new RegExp('^' + JSON_MarkerStr + '(.+)$');
            var m = varValue.match(regxp);
            if (m && m.length > 1) {
                varValue = JSON.parse(m[1]);
                return varValue;
            }

            //--- Is it a function?
            var regxp = new RegExp('^' + FunctionMarker + '((?:.|\n|\r)+)$');
            var m = varValue.match(regxp);
            if (m && m.length > 1) {
                varValue = eval('(' + m[1] + ')');
                return varValue;
            }
        }

        return varValue;
    }//-- End of get()

    this.del = function (varname) {
        if (typeof GM_deleteValue != "function")
            ReportError('Using del function requires Greasemonkey and grant rights for it! GM_deleteValue is missing.');
        GM_deleteValue(varName);
    };
    this.delStartsWith = function (varname) {
         if (typeof GM_deleteValue != "function")
            ReportError('Using delStartsWith function requires Greasemonkey and grant rights for it! GM_deleteValue is missing.');
        if (typeof GM_listValues != "function")
            ReportError('Using delStartsWith function requires Greasemonkey and grant rights for it! GM_listValues is missing.');
        for (var item in GM_listValues()) {
            if (item.startsWith('tinfo-')) {
                GM_deleteValue(item);
            }
        }
    };
}