Migrare un userscript da Tampermonkey a una regola JustZix
Hai un userscript Tampermonkey che vuoi spostare su JustZix. La maggior parte del codice si reincolla senza modifiche — ma alcune cose funzionano diversamente. Questa guida ti accompagna passo dopo passo.
Cosa si reincolla senza modifiche
Il normale JavaScript che opera sul DOM — querySelector, addEventListener, fetch, MutationObserver — si comporta in modo identico. Il nucleo di un tipico userscript va nella scheda JavaScript di una regola e funziona.
L'intestazione dei metadati — tagliala, spostala nell'UI
Il blocco // ==UserScript== non è codice — è configurazione. In JustZix il suo equivalente è l'interfaccia:
| Nell'userscript | In JustZix |
|---|---|
@match / @include | il pattern di URL della regola |
@name | il nome della regola |
@run-at | le regole vengono eseguite dopo il caricamento della pagina |
@grant | non necessario — vedi sotto |
Funzioni GM_* — cosa manca e cosa lo sostituisce
GM_addStyle— non necessario: usa la scheda CSS della regola invece di iniettare stili dal JS.GM_setValue/GM_getValue— sostituisci collocalStoragedella pagina se i dati possono vivere con la pagina.GM_xmlhttpRequest— JustZix non ha un equivalente che aggira il CORS; un semplicefetchfunziona entro la CSP della pagina.unsafeWindow— non necessario: il codice di una regola viene comunque eseguito nel contesto della pagina, hai accesso diretto awindow.
Cosa guadagni in cambio
La migrazione non è solo riscrittura. In JustZix ottieni una gerarchia (cartella/gruppo/regola), una barra delle azioni di pulsanti su richiesta, finestre di sviluppo nella pagina e la sincronizzazione delle regole tra dispositivi — cose che un gestore di userscript non ha.
Trappole
- Un userscript che carica una libreria esterna tramite
@require— sposta il suo codice nella regola o carica la libreria nel codice stesso (entro la CSP). - Uno script che conta su un avvio molto precoce (
@run-at document-start) — le regole JustZix partono un po' più tardi; raramente un problema, ma tienilo presente.
Vedi anche
- JustZix contro Tampermonkey — confronto delle filosofie degli strumenti
- Pattern di URL — l'equivalente di @match
- La gerarchia delle cartelle — un'organizzazione che gli userscript non hanno
Installa JustZix — e sposta i tuoi userscript su qualcosa che cresce con te.
Valuta questo articolo
Nessuna valutazione — sii il primo.