Fast GM Cache System

Lightweight cache with TTL using GM_setValue

Dovrai installare un'estensione come Tampermonkey, Greasemonkey o Violentmonkey per installare questo script.

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

Dovrai installare un'estensione come Tampermonkey o Violentmonkey per installare questo script.

Dovrai installare un'estensione come Tampermonkey o Userscripts per installare questo script.

Dovrai installare un'estensione come ad esempio Tampermonkey per installare questo script.

Dovrai installare un gestore di script utente per installare questo script.

(Ho già un gestore di script utente, lasciamelo installare!)

Dovrai installare un'estensione come ad esempio Stylus per installare questo stile.

Dovrai installare un'estensione come ad esempio Stylus per installare questo stile.

Dovrai installare un'estensione come ad esempio Stylus per installare questo stile.

Dovrai installare un'estensione per la gestione degli stili utente per installare questo stile.

Dovrai installare un'estensione per la gestione degli stili utente per installare questo stile.

Dovrai installare un'estensione per la gestione degli stili utente per installare questo stile.

(Ho già un gestore di stile utente, lasciamelo installare!)

// ==UserScript==
// @name         Fast GM Cache System
// @namespace    fast.cache.system
// @version      1.0
// @description  Lightweight cache with TTL using GM_setValue
// @match        *://*/*
// @grant        GM_setValue
// @grant        GM_getValue
// @grant        GM_deleteValue
// @license      MIT
// ==/UserScript==

(function () {
    'use strict';

    const CACHE_PREFIX = "fastcache_";

    const Cache = {

        // 📦 Сохранить значение с временем жизни (в секундах)
        set(key, value, ttlSeconds = 300) {
            const data = {
                value: value,
                expiry: Date.now() + ttlSeconds * 1000
            };
            GM_setValue(CACHE_PREFIX + key, JSON.stringify(data));
        },

        // 📥 Получить значение (null если просрочено)
        get(key) {
            const raw = GM_getValue(CACHE_PREFIX + key, null);
            if (!raw) return null;

            try {
                const data = JSON.parse(raw);

                if (Date.now() > data.expiry) {
                    GM_deleteValue(CACHE_PREFIX + key);
                    return null;
                }

                return data.value;

            } catch {
                GM_deleteValue(CACHE_PREFIX + key);
                return null;
            }
        },

        // 🗑 Удалить вручную
        delete(key) {
            GM_deleteValue(CACHE_PREFIX + key);
        },

        // 🧹 Очистить всё
        clearAll() {
            const keys = Object.keys(localStorage);
            keys.forEach(k => {
                if (k.startsWith(CACHE_PREFIX)) {
                    GM_deleteValue(k);
                }
            });
        }
    };

    // ====== ПРИМЕР ИСПОЛЬЗОВАНИЯ ======

    const cached = Cache.get("userData");

    if (cached) {
        console.log("Из кеша:", cached);
    } else {
        console.log("Создаём новые данные");

        const newData = {
            id: 123,
            name: "FastUser"
        };

        Cache.set("userData", newData, 600); // 10 минут
    }

})();