Назначение: Решение распространенных проблем и ошибок
🚨 Частые проблемы и решения
- Проверьте интернет-соединение - расширение требует доступ к Google Translate API
- Убедитесь, что текст выделен - выделите текст в письме перед вызовом контекстного меню
- Проверьте консоль браузера - откройте Инструменты разработчика (Ctrl+Shift+J) для просмотра ошибок
- Перезагрузите расширение - перезайдите в about:debugging и перезагрузите расширение
- Перезагрузите расширение - в about:debugging нажмите "Reload"
- Проверьте настройки языка - убедитесь, что в popup выбран корректный язык перевода
- Переустановите расширение - удалите и установите расширение заново
- Проверьте разрешения - убедитесь, что расширение имеет разрешение "menus"
- Нажмите кнопку "Close" вручную - используйте кнопку закрытия в окне перевода
- Используйте клавишу Escape - нажмите Esc для немедленного закрытия
- Проверьте настройки времени - в popup убедитесь, что установлено корректное время отображения
- Перезапустите Thunderbird - иногда помогает перезапуск приложения
- Проверьте доступ к Google Translate - убедитесь, что сайт translate.googleapis.com доступен
- Проверьте длину текста - очень длинные тексты могут превышать лимиты API
- Попробуйте позже - возможны временные проблемы с сервисом Google
- Проверьте файрволл - убедитесь, что нет блокировки запросов к Google API
🔧 Включение отладки и логирования
В Thunderbird откройте about:debugging или нажмите Ctrl+Shift+J
В списке расширений найдите BuxarTranslate и нажмите "Inspect"
В открывшемся окне разработчика перейдите на вкладку "Console"
Выполните перевод и просмотрите сообщения в консоли для диагностики проблем
Ключевые сообщения в логах:
🔍 Диагностика распространенных ошибок
Ошибка 429 - Too Many Requests
Причина: Превышен лимит запросов к Google Translate API
Решение: Подождите несколько минут и повторите попытку
Ошибка 403 - Forbidden
Причина: Проблемы с доступом к API или блокировка
Решение: Проверьте интернет-соединение и файрволл
Ошибка загрузки переводов
Причина: Отсутствует файл перевода для выбранного языка
Решение: Проверьте наличие файла messages.json в _locales
Расширение не загружается
Причина: Ошибка в manifest.json или несовместимость версий
Решение: Проверьте версию Thunderbird (должна быть 78.0+)
🔄 Процесс переустановки
Перейдите в Дополнения → Управление расширениями → Удалить BuxarTranslate
Перезапустите Thunderbird для очистки кэшированных данных
Установите расширение снова через файл .xpi или временную установку
Проверьте работу расширения на тестовом письме
📞 Поддержка и отчеты об ошибках
- Проверьте эту документацию на наличие решения вашей проблемы
- Включите логирование и предоставьте сообщения об ошибках
- Опишите шаги для воспроизведения проблемы
- Укажите версию Thunderbird и операционной системы