Migrer un userscript de Tampermonkey vers une règle JustZix
Vous avez un userscript Tampermonkey que vous voulez déplacer vers JustZix. La majeure partie du code se recolle sans changement — mais quelques choses fonctionnent différemment. Ce guide vous accompagne pas à pas.
Ce qui se recolle sans changement
Le JavaScript ordinaire travaillant sur le DOM — querySelector, addEventListener, fetch, MutationObserver — se comporte de façon identique. Le cœur d'un userscript typique va dans l'onglet JavaScript d'une règle et fonctionne.
L'en-tête de métadonnées — coupez-le, déplacez-le dans l'UI
Le bloc // ==UserScript== n'est pas du code — c'est de la configuration. Dans JustZix, son équivalent est l'interface :
| Dans le userscript | Dans JustZix |
|---|---|
@match / @include | le motif d'URL de la règle |
@name | le nom de la règle |
@run-at | les règles s'exécutent après le chargement de la page |
@grant | pas nécessaire — voir ci-dessous |
Fonctions GM_* — ce qui manque et ce qui le remplace
GM_addStyle— pas nécessaire : utilisez l'onglet CSS de la règle au lieu d'injecter des styles depuis le JS.GM_setValue/GM_getValue— remplacez par lelocalStoragede la page si les données peuvent vivre avec la page.GM_xmlhttpRequest— JustZix n'a pas d'équivalent contournant le CORS ; un simplefetchfonctionne dans les limites de la CSP de la page.unsafeWindow— pas nécessaire : le code d'une règle s'exécute de toute façon dans le contexte de la page, vous avez un accès direct àwindow.
Ce que vous gagnez en échange
La migration n'est pas que de la réécriture. Dans JustZix vous obtenez une hiérarchie (dossier/groupe/règle), une barre d'actions de boutons à la demande, des fenêtres de dev dans la page et la synchro des règles entre appareils — des choses qu'un gestionnaire de userscripts n'a pas.
Pièges
- Un userscript chargeant une bibliothèque externe via
@require— déplacez son code dans la règle ou chargez la bibliothèque dans le code lui-même (dans les limites de la CSP). - Un script comptant sur un démarrage très précoce (
@run-at document-start) — les règles JustZix démarrent un peu plus tard ; rarement un problème, mais sachez-le.
À voir aussi
- JustZix contre Tampermonkey — comparer les philosophies des outils
- Motifs d'URL — l'équivalent de @match
- La hiérarchie de dossiers — une organisation que les userscripts n'ont pas
Installez JustZix — et déplacez vos userscripts vers quelque chose qui grandit avec vous.
Notez cet article
Aucune note — soyez le premier.