Propósito: Solución de problemas comunes y errores
🚨 Problemas Comunes y Soluciones
- Verificar conexión a internet - extensión requiere acceso a Google Translate API
- Asegurarse de que texto esté seleccionado - seleccione texto en correo antes de llamar menú contextual
- Verificar consola de navegador - abra Herramientas de Desarrollo (Ctrl+Shift+J) para ver errores
- Recargar extensión - regrese a about:debugging y recargue extensión
- Recargar extensión - en about:debugging haga clic en "Reload"
- Verificar configuraciones de idioma - asegúrese de que en popup esté seleccionado idioma de traducción correcto
- Reinstalar extensión - elimine e instale extensión nuevamente
- Verificar permisos - asegúrese de que extensión tenga permiso "menus"
- Presionar botón "Cerrar" manualmente - use botón de cierre en ventana de traducción
- Usar tecla Escape - presione Esc para cierre inmediato
- Verificar configuraciones de tiempo - en popup asegúrese de que tiempo de visualización correcto esté establecido
- Reiniciar Thunderbird - a veces reiniciar aplicación ayuda
- Verificar acceso a Google Translate - asegúrese de que translate.googleapis.com sea accesible
- Verificar longitud de texto - textos muy largos pueden exceder límites de API
- Intentar más tarde - posibles problemas temporales con servicio de Google
- Verificar firewall - asegúrese de que no haya bloqueo de solicitudes a API de Google
🔧 Habilitar Depuración y Registro
En Thunderbird abra about:debugging o presione Ctrl+Shift+J
En lista de extensiones encuentre BuxarTranslate y haga clic en "Inspect"
En ventana de desarrollador abierta vaya a pestaña "Console"
Realice traducción y vea mensajes en consola para diagnóstico de problemas
Mensajes clave en registros:
🔍 Diagnóstico de Errores Comunes
Error 429 - Demasiadas Solicitudes
Causa: Límite excedido de solicitudes a Google Translate API
Solución: Espere unos minutos e intente nuevamente
Error 403 - Prohibido
Causa: Problemas con acceso a API o bloqueo
Solución: Verifique conexión a internet y firewall
Error de carga de traducciones
Causa: Falta archivo de traducción para idioma seleccionado
Solución: Verifique presencia de messages.json en _locales
Extensión no carga
Causa: Error en manifest.json o incompatibilidad de versiones
Solución: Verifique versión de Thunderbird (debe ser 78.0+)
🔄 Proceso de Reinstalación
Vaya a Complementos → Gestionar extensiones → Eliminar BuxarTranslate
Reinicie Thunderbird para limpiar datos en caché
Instale extensión nuevamente mediante archivo .xpi o instalación temporal
Pruebe operación de extensión en un correo de prueba
📞 Soporte y Reportes de Errores
- Verifique esta documentación para solución de su problema
- Habilite registro y proporcione mensajes de error
- Describa pasos para reproducir el problema
- Especifique versión de Thunderbird y sistema operativo