Fast GM Cache System

Lightweight cache with TTL using GM_setValue

Aby zainstalować ten skrypt, wymagana jest instalacje jednego z następujących rozszerzeń: Tampermonkey, Greasemonkey lub Violentmonkey.

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

Aby zainstalować ten skrypt, wymagana jest instalacje jednego z następujących rozszerzeń: Tampermonkey, Violentmonkey.

Aby zainstalować ten skrypt, wymagana będzie instalacja rozszerzenia Tampermonkey lub Userscripts.

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

Aby zainstalować ten skrypt, musisz zainstalować rozszerzenie menedżera skryptów użytkownika.

(Mam już menedżera skryptów użytkownika, pozwól mi to zainstalować!)

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.

Będziesz musiał zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

Będziesz musiał zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

Musisz zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

(Mam już menedżera stylów użytkownika, pozwól mi to zainstalować!)

// ==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 минут
    }

})();