← Wszystkie wpisy

Przewodniki

Migracja userscriptu z Tampermonkey na regułę JustZix

15 maja 2026 · autor JustZix Team

Masz userscript z Tampermonkey, który chcesz przenieść do JustZix. Większość kodu przeklejasz bez zmian — ale kilka rzeczy działa inaczej. Ten przewodnik przeprowadza Cię krok po kroku.

Co się przeklei bez zmian

Zwykły JavaScript operujący na DOM-ie — querySelector, addEventListener, fetch, MutationObserver — działa identycznie. Trzon typowego userscriptu wkleisz do zakładki JavaScript reguły i zadziała.

Nagłówek metadanych — wytnij, przenieś do UI

Blok // ==UserScript== nie jest kodem — to konfiguracja. W JustZix jej odpowiednikiem jest interfejs:

Funkcje GM_* — czego brak i czym zastąpić

• GM_addStyle — niepotrzebne: użyj zakładki CSS reguły zamiast wstrzykiwać style z JS.
• GM_setValue / GM_getValue — zastąp localStorage strony, jeśli dane mogą żyć przy stronie.
• GM_xmlhttpRequest — JustZix nie ma odpowiednika omijającego CORS; zwykły fetch działa w granicach CSP strony.
• unsafeWindow — niepotrzebne: kod reguły i tak działa w kontekście strony, masz bezpośredni dostęp do window.

Co zyskujesz w zamian

Migracja to nie tylko przepisywanie. W JustZix dostajesz hierarchię (katalog/grupa/reguła), pasek akcji uruchamianych na żądanie, okna deweloperskie na stronie i synchronizację reguł między urządzeniami — rzeczy, których menedżer userscriptów nie ma.

Pułapki

• Userscript ładujący zewnętrzną bibliotekę przez @require — przenieś jej kod do reguły albo wczytaj bibliotekę w samym kodzie (w granicach CSP).
• Skrypt liczący na bardzo wczesny start (@run-at document-start) — reguły JustZix startują nieco później; rzadko to problem, ale wiedz o tym.

Zobacz też

• JustZix kontra Tampermonkey — porównanie filozofii narzędzi
• Wzorce URL — odpowiednik @match
• Hierarchia katalogów — organizacja, której userscripty nie mają

Zainstaluj JustZix — i przenieś swoje userscripty na coś, co rośnie razem z Tobą.