← Все статьи

Гайды

Миграция userscript с Tampermonkey в правило JustZix

15 мая 2026 · автор JustZix Team

У тебя есть userscript Tampermonkey, который ты хочешь перенести на JustZix. Большая часть кода вставляется обратно без изменений — но некоторые вещи работают иначе. Это руководство проводит тебя шаг за шагом.

Что вставляется без изменений

Обычный JavaScript, работающий с DOM — querySelector, addEventListener, fetch, MutationObserver — ведёт себя идентично. Ядро типичного userscript идёт на вкладку JavaScript правила и работает.

Заголовок метаданных — вырежи, перенеси в UI

Блок // ==UserScript== — это не код, это конфигурация. В JustZix его эквивалент — интерфейс:

Функции GM_* — чего не хватает и что это заменяет

• GM_addStyle — не нужен: используй вкладку CSS правила вместо внедрения стилей из JS.
• GM_setValue / GM_getValue — замени на localStorage страницы, если данные могут жить со страницей.
• GM_xmlhttpRequest — у JustZix нет эквивалента, обходящего CORS; обычный fetch работает в пределах CSP страницы.
• unsafeWindow — не нужен: код правила всё равно выполняется в контексте страницы, у тебя прямой доступ к window.

Что ты получаешь взамен

Миграция — не только переписывание. В JustZix ты получаешь иерархию (папка/группа/правило), панель действий из кнопок по запросу, окна разработки на странице и синхронизацию правил между устройствами — вещи, которых нет у менеджера userscript'ов.

Ловушки

• Userscript, загружающий внешнюю библиотеку через @require — перенеси её код в правило или загрузи библиотеку в самом коде (в пределах CSP).
• Скрипт, рассчитывающий на очень ранний запуск (@run-at document-start) — правила JustZix стартуют чуть позже; редко проблема, но имей в виду.

Смотри также

• JustZix против Tampermonkey — сравнение философий инструментов
• URL-паттерны — эквивалент @match
• Иерархия папок — организация, которой нет у userscript'ов

Установи JustZix — и перенеси свои userscript'ы на что-то, что растёт вместе с тобой.