← Tutti gli articoli

Guide

Migrare da Tampermonkey o Greasemonkey a JustZix

17 maggio 2026 · di JustZix Team

Se hai convissuto con Tampermonkey o Greasemonkey, capisci già l'idea di base: eseguire il tuo codice sul sito di qualcun altro. JustZix mantiene quel potere ma lo rimodella attorno a regole abbinate per URL — unità CSS o JS piccole, limitate e attivabili individualmente. Questa guida mappa il modello degli userscript su JustZix e mostra dove ciascuno strumento eccelle.

Il modello mentale: script contro regole

Un userscript è un file con un'intestazione di metadati. JustZix divide lo stesso lavoro in due cose: una corrispondenza URL (dove viene eseguito) e un payload (CSS o JS). Il blocco di metadati che scrivevi diventa un campo nell'editor di regole.

• @match / @include → il pattern URL della regola, es. *://*.youtube.com/*
• @run-at document-end → JustZix esegue le regole JS dopo che il DOM è pronto per impostazione predefinita
• Stile via GM_addStyle → una regola CSS dedicata, niente JS necessario
• Un grande script → diverse piccole regole che attivi in modo indipendente

Il cambiamento più grande: in JustZix, il CSS è di prima classe. Tutto ciò che facevi con GM_addStyle diventa una pura regola CSS che è più veloce, più sicura e più facile da leggere.

Portare uno userscript di solo CSS

Molti userscript esistono solo per iniettare un foglio di stile. Eccone uno tipico:

// ==UserScript==
// @name    Hide YouTube Shorts
// @match   *://*.youtube.com/*
// ==/UserScript==
GM_addStyle(`
  ytd-reel-shelf-renderer { display: none !important; }
`);

In JustZix questo si riduce a una regola CSS. Corrispondenza URL: *://*.youtube.com/*. Payload:

ytd-reel-shelf-renderer { display: none !important; }

Questa è l'intera migrazione. Nessun involucro, nessun GM_addStyle, nessun commento di metadati — l'editor di regole tiene la corrispondenza per te.

Portare uno userscript di manipolazione del DOM

Gli script che cambiano la pagina a runtime diventano regole JS. Il corpo dello script di solito si porta alla lettera; basta eliminare l'intestazione di metadati. Uno userscript che aspetta un elemento:

// ==UserScript==
// @name    Auto-expand comments
// @match   *://example.com/*
// @run-at  document-end
// ==/UserScript==
(function () {
  const btn = document.querySelector('.show-comments');
  if (btn) btn.click();
})();

Diventa una regola JS JustZix con corrispondenza *://example.com/* e payload:

const btn = document.querySelector('.show-comments');
if (btn) btn.click();

Per le app a pagina singola, lo stesso schema che usavi negli userscript si applica ancora — osserva il DOM anziché assumere un singolo caricamento:

function run() {
  const btn = document.querySelector('.show-comments');
  if (btn && !btn.dataset.done) {
    btn.dataset.done = '1';
    btn.click();
  }
}
run();
new MutationObserver(run).observe(document.body, {
  childList: true, subtree: true
});

Cosa non si porta direttamente

JustZix esegue il tuo JS nel contesto della pagina con le API web standard. Gli extra dei gestori di userscript richiedono un ripensamento:

• GM_setValue / GM_getValue → usa localStorage per la persistenza per singolo sito
• GM_xmlhttpRequest (fetch cross-origin) → non è un obiettivo di JustZix; tieni quegli script nel tuo gestore di userscript
• @require librerie esterne → integra in linea ciò che ti serve, o incolla la libreria nella regola
• GM_registerMenuCommand → costruisci invece un tuo pulsante nella pagina

Questa è la onesta linea di demarcazione qui sotto.

Quando usare quale

JustZix è la scelta migliore quando il tuo obiettivo è ritoccare l'aspetto e il comportamento dei siti: nascondere il disordine, ridare stile, piccole scorciatoie di UX, automazione limitata. Il modello di regole tiene ogni ritocco isolato, facile da attivare e banale da condividere come semplice CSS o JS.

Tieni un gestore di userscript quando uno script ha bisogno di accesso di rete cross-origin, di una pesante libreria di terze parti o di un archivio di valori che sopravvive a molti siti. I due strumenti coesistono bene — molti utenti usano JustZix per le decine di piccoli ritocchi visivi e riservano il loro gestore di userscript per i due o tre script pesanti.

Una lista di controllo per la migrazione

• Elenca i tuoi userscript ed etichetta ciascuno: solo CSS, ritocco del DOM o pesante a livello di rete.
• Sposta ogni script di solo CSS a una regola CSS JustZix — di solito un copia-incolla del blocco di stile.
• Sposta i ritocchi del DOM a regole JS; elimina l'intestazione di metadati, tieni il corpo.
• Dividi i grandi script multiuso in diverse piccole regole così puoi attivare le funzionalità.
• Lascia gli script pesanti a livello di rete dove sono.

Il vantaggio è la chiarezza: invece di un opaco file di script, ottieni un elenco ordinato di regole nominate, ciascuna limitata esattamente a un sito. Inizia con i nostri esempi pronti all'uso per vedere il formato delle regole in azione, oppure salta a un tutorial concreto come i ritocchi per sviluppatori su GitHub. Scarica JustZix e porta oggi il tuo primo foglio di stile.