Tampermonkey не работает: почему пользовательский скрипт не запускается и как исправить

hannadev

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

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

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

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

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

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

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

Проблема	Решение	Браузер
Настройки не открываются	Разрешить в приватных окнах	Все
Скрипт не виден	Включить режим разработчика	Chrome, Yandex
Нет разрешений на сайт	Добавить в исключения	Vivaldi

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

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

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

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

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

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

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

Расширение	Тип конфликта	Как обойти
AdBlock	Блокировка JS	Исключения
VPN	Перехват трафика	Порядок загрузки
Dark Reader	Изменение DOM	Отключить на тесте

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

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

Скрипт может быть битым из коробки. Если код скопирован с форума, в нём могут быть лишние пробелы, сломанные селекторы или устаревший 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==: Убедитесь, что шапка не сломана.

Ошибка в консоли	Причина	Исправление
Uncaught ReferenceError	Нет @match	Добавить URL
CSP violation	Content Security Policy	@run-at document-idle
SyntaxError	Пробелы в коде	Проверить редактор

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

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

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

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