Ein Userscript von Tampermonkey zu einer JustZix-Regel migrieren
Du hast ein Tampermonkey-Userscript, das du zu JustZix verschieben willst. Der Großteil des Codes lässt sich unverändert übernehmen — aber ein paar Dinge funktionieren anders. Dieser Leitfaden führt dich Schritt für Schritt durch.
Was sich unverändert übernehmen lässt
Schlichtes JavaScript, das am DOM arbeitet — querySelector, addEventListener, fetch, MutationObserver — verhält sich identisch. Der Kern eines typischen Userscripts kommt in den JavaScript-Tab einer Regel und funktioniert.
Der Metadaten-Header — schneide ihn aus, verschiebe ihn in die UI
Der // ==UserScript==-Block ist kein Code — er ist Konfiguration. In JustZix ist sein Gegenstück die Oberfläche:
| Im Userscript | In JustZix |
|---|---|
@match / @include | das URL-Muster der Regel |
@name | der Regelname |
@run-at | Regeln laufen nach dem Laden der Seite |
@grant | nicht nötig — siehe unten |
GM_*-Funktionen — was fehlt und was es ersetzt
GM_addStyle— nicht nötig: nutze den CSS-Tab der Regel, statt Stile aus JS zu injizieren.GM_setValue/GM_getValue— ersetze durch denlocalStorageder Seite, wenn die Daten bei der Seite leben können.GM_xmlhttpRequest— JustZix hat kein CORS-umgehendes Gegenstück; ein schlichtesfetchfunktioniert innerhalb der CSP der Seite.unsafeWindow— nicht nötig: Regelcode läuft ohnehin im Seitenkontext, du hast direkten Zugriff aufwindow.
Was du im Gegenzug gewinnst
Migration ist nicht nur Umschreiben. In JustZix bekommst du eine Hierarchie (Ordner/Gruppe/Regel), eine Aktionsleiste mit Abruf-Buttons, On-Page-Entwicklerfenster und Regel-Synchronisierung über Geräte hinweg — Dinge, die ein Userscript-Manager nicht hat.
Fallstricke
- Ein Userscript, das eine externe Bibliothek lädt per
@require— verschiebe ihren Code in die Regel oder lade die Bibliothek im Code selbst (innerhalb der CSP). - Ein Skript, das auf einen sehr frühen Start angewiesen ist (
@run-at document-start) — JustZix-Regeln starten etwas später; selten ein Problem, aber sei dir bewusst.
Siehe auch
- JustZix gegen Tampermonkey — die Philosophien der Werkzeuge im Vergleich
- URL-Muster — das Gegenstück zu @match
- Die Ordner-Hierarchie — Organisation, die Userscripts nicht haben
Installiere JustZix — und verschiebe deine Userscripts auf etwas, das mit dir wächst.
Bewerte diesen Beitrag
Noch keine Bewertungen — sei der Erste.