Migrar un userscript de Tampermonkey a una regla JustZix
Tienes un userscript Tampermonkey que quieres mover a JustZix. La mayor parte del código se vuelve a pegar sin cambios — pero algunas cosas funcionan de forma distinta. Esta guía te acompaña paso a paso.
Qué se vuelve a pegar sin cambios
El JavaScript normal que opera sobre el DOM — querySelector, addEventListener, fetch, MutationObserver — se comporta de forma idéntica. El núcleo de un userscript típico va en la pestaña JavaScript de una regla y funciona.
La cabecera de los metadatos — córtala, muévela a la UI
El bloque // ==UserScript== no es código — es configuración. En JustZix su equivalente es la interfaz:
| En el userscript | En JustZix |
|---|---|
@match / @include | el patrón de URL de la regla |
@name | el nombre de la regla |
@run-at | las reglas se ejecutan tras la carga de la página |
@grant | no necesario — mira abajo |
Funciones GM_* — qué falta y qué lo sustituye
GM_addStyle— no necesario: usa la pestaña CSS de la regla en lugar de inyectar estilos desde el JS.GM_setValue/GM_getValue— sustitúyelos por ellocalStoragede la página si los datos pueden vivir con la página.GM_xmlhttpRequest— JustZix no tiene un equivalente que esquive el CORS; un simplefetchfunciona dentro de la CSP de la página.unsafeWindow— no necesario: el código de una regla se ejecuta de todos modos en el contexto de la página, tienes acceso directo awindow.
Qué ganas a cambio
La migración no es solo reescritura. En JustZix obtienes una jerarquía (carpeta/grupo/regla), una barra de acciones de botones a demanda, ventanas de desarrollo en la página y la sincronización de las reglas entre dispositivos — cosas que un gestor de userscripts no tiene.
Trampas
- Un userscript que carga una librería externa mediante
@require— mueve su código a la regla o carga la librería en el código mismo (dentro de la CSP). - Un script que cuenta con un arranque muy temprano (
@run-at document-start) — las reglas JustZix arrancan un poco más tarde; rara vez un problema, pero tenlo presente.
Mira también
- JustZix contra Tampermonkey — comparación de las filosofías de las herramientas
- Patrones de URL — el equivalente de @match
- La jerarquía de las carpetas — una organización que los userscripts no tienen
Instala JustZix — y mueve tus userscripts a algo que crece contigo.
Valora este artículo
Sin valoraciones — sé el primero.