Если вы добавили скрипт, а он не срабатывает, то проблема может быть в настройках, конфликтах или ошибках кода. Мы пройдёмся по типичным ситуациям, чтобы вы быстро вернули всё в строй. Это сэкономит часы поисков в форумах и гугле.

Проблемы с настройками расширения

Многие забывают, что Tampermonkey требует правильной настройки для работы. Например, в новых версиях Chrome и производных браузерах скрипты не запускаются без активации режима разработчика. Это защитный механизм, который блокирует потенциально опасный код. Без него иконка скрипта может быть чёрной, без индикаторов, и ничего не происходит.

Другая частая беда — настройки не открываются. Пользователи жалуются, что клик по иконке ничего не даёт. Это может быть из-за приватных окон или блокировки браузером. Плюс, после обновлений Tampermonkey иногда теряет разрешения на сайты. В итоге скрипт установлен, статус «включён», но эффекта ноль. Такие случаи типичны для Chrome, Vivaldi и Yandex Browser.

Вот что проверить в первую очередь:

• Откройте chrome://extensions/ (или аналог для вашего браузера) и включите режим разработчика в правом верхнем углу.
• Правой кнопкой кликните иконку Tampermonkey в панели расширений и выберите «Управление расширением». Убедитесь, что все разрешения активны.
• В настройках Tampermonkey проверьте раздел «Исключения» — добавьте проблемные сайты, если скрипт их игнорирует.

Важно: после изменений перезапустите браузер полностью, не просто вкладки.

Конфликты с другими расширениями и браузером

Расширения часто дерутся между собой. Блокировщики рекламы, VPN или другие скриптовые менеджеры вроде Violentmonkey могут мешать Tampermonkey. Например, на закреплённых вкладках после перезапуска блокировщики перестают работать, а скрипты Tampermonkey — тем более. Это выглядит как системный сбой, но на деле конфликт.

Обновления браузера добавляют масла в огонь. После апдейта Chrome скрипты могут слетать, потому что изменились политики безопасности. Пользователи Vivaldi отмечают, что там настройки вообще не открываются без танцев с бубном. А в Firefox скрипты на about: страницах требуют специальных хуков в коде. Без тестов на конфликты ничего не заработает.

Шаги по диагностике:

1. Отключите все расширения кроме Tampermonkey.
2. Перезапустите браузер и проверьте скрипт.
3. Включайте по одному, чтобы найти виновника.

• uBlock Origin или AdBlock: Часто блокируют инъекцию скриптов — добавьте исключения для целевых сайтов.
• VPN/Proxy: Меняйте порядок в списке расширений, поставьте Tampermonkey первым.
• Другие скрипт-менеджеры: Удалите их полностью, они дублируют функции.

Перезапуск с чистыми вкладками — ключевой шаг, закреплённые часто глючат.

Ошибки в самом скрипте или его версии

Скрипт может быть битым из коробки. Если код скопирован с форума, в нём могут быть лишние пробелы, сломанные селекторы или устаревший API. В редакторе Tampermonkey всё выглядит ок, но на странице — тишина. Плюс, версии скрипта не всегда совместимы с последними Tampermonkey.

Пример: скрипт для YouTube перевода работает в Vivaldi, но в Chrome — нет. Причина — изменившийся DOM сайта или требования к манифесту (@match, @run-at). Обновление Tampermonkey до 5.1.x иногда ломает старые скрипты. Пользователи жалуются на отсутствие кнопок или индикаторов (красный квадратик не появляется).

Как дебажить:

• Откройте консоль разработчика (F12) и ищите ошибки JS.

• Проверьте метаданные скрипта: @match должен точно совпадать с URL.

• Обновите скрипт до свежей версии с Greasy Fork или GitHub.

• *@match https://youtube.com/ **: Укажите полный URL, без поддоменов.

• @run-at document-start: Для раннего запуска.

• // ==UserScript==: Убедитесь, что шапка не сломана.

Всегда тестируйте на incognito-окне без кэша.

Что остаётся за кадром в типичных случаях

Мы разобрали 90% проблем: настройки, конфликты и код. Но иногда дело в экзотике вроде корпоративных политик браузера или специфических ОС вроде Windows 11 с новыми ограничениями на расширения. Там нужны deeper хаки, как ручная правка manifest.json или смена на Firefox с аналогом Tampermonkey.

Подумайте о логах: включите verbose-режим в Tampermonkey для детального дампа ошибок. Это поможет, если скрипт кастомный и требует подгонки под ваш стек. В будущем браузеры ещё ужесточат правила — следите за обновлениями.