Cómo inspeccionar la consola del navegador para errores de SeaText AI

Respuesta rápida

Presione F12 (o Cmd+Opción+I en Mac) para abrir las herramientas de desarrollador. Haga clic en la pestaña Consola. Los errores aparecen en rojo y a menudo incluyen la URL del script o un mensaje como "No se pudo cargar el recurso". Cambie a la pestaña Red, recargue la página y filtre por "seatext" para ver si la solicitud del fragmento tuvo éxito (estado 200) o falló (4xx/5xx).

Por qué la consola es importante para SeaText AI

SeaText AI se ejecuta como un fragmento de JavaScript incrustado en su página. El fragmento se carga de forma asíncrona para evitar bloquear la representación de la página, como se indica en la guía de integración para SPA. Si el fragmento no se carga, se ejecuta con un error de sintaxis o encuentra una restricción de origen cruzado, los agentes de IA (traducción, CRO, coincidencia de anuncios de Google, protección contra bots) no pueden activarse. La consola del navegador es el primer lugar donde aparecen esas fallas porque captura tanto fallas de red como errores de tiempo de ejecución de JavaScript.

El fragmento también almacena un identificador en el almacenamiento local. Si el navegador o un iframe bloquea el almacenamiento local, el script lanza un error de seguridad que aparece en la consola. Comprender estos mecanismos le ayuda a distinguir entre un problema de red, un error de script o un problema de política del navegador.

Requisitos previos antes de comenzar

• Una página donde se haya agregado el fragmento de SeaText. Existen guías de instalación para WordPress, Shopify, React, Vue, Angular y HTML personalizado.
• Navegador con herramientas de desarrollador: Chrome, Firefox, Safari o Edge.
• Permiso para acceder al almacenamiento local: el fragmento almacena una ID allí.
• Si ejecuta una aplicación de página única (SPA), conozca el archivo de punto de entrada (index.html, main.tsx, etc.) donde se inyectó el fragmento.
• Para pruebas móviles, un cable USB y depuración USB habilitada (Android) o Web Inspector (iOS).

Paso a paso: Chrome / Edge / Brave (Chromium)

1. Abra la página que desea probar.
2. Presione F12 o haga clic derecho → Inspeccionar.
3. Seleccione la pestaña Consola.
4. Busque líneas en rojo que contengan "seatext", "SEATEXT" o el dominio del fragmento.
5. Haga clic en la pestaña Red, marque Deshabilitar caché, recargue (Ctrl+R / Cmd+R).
6. Escriba "seatext" en el cuadro de filtro. Verifique que la solicitud del fragmento devuelva 200 OK y que la respuesta sea JavaScript.
7. Opcionalmente, active Preservar registro para mantener los errores durante la navegación.

Paso a paso: Firefox

1. Presione F12 o Ctrl+Shift+K.
2. Elija el panel Consola.
3. Los errores se muestran en rojo con un icono de cruz. Filtre escribiendo "seatext" en el cuadro de búsqueda.
4. Abra la pestaña Red, recargue y filtre por la URL del fragmento.
5. Verifique el cuerpo de la respuesta para confirmar que es JavaScript válido.

Paso a paso: Safari (macOS)

1. Active el menú Desarrollar: Safari → Ajustes → Avanzado → Mostrar menú Desarrollar en la barra de menús.
2. Presione Cmd+Opción+I o Desarrollar → Mostrar inspector web.
3. Haga clic en Consola. Los errores aparecen en rojo.
4. Use la pestaña Red para confirmar que el fragmento se cargó con estado 200.
5. Si prueba en iOS, conecte el dispositivo, active Web Inspector en Ajustes → Safari → Avanzado, luego seleccione el dispositivo desde el menú Desarrollar en Mac.

Paso a paso: Navegadores móviles (depuración remota)

Los navegadores móviles no tienen tecla F12. Use la depuración remota en su lugar.

1. Android (Chrome): Active la depuración USB en Opciones de desarrollador. Conecte el teléfono al escritorio. Abra Chrome en el escritorio, vaya a chrome://inspect, encuentre su dispositivo, haga clic en Inspeccionar en la pestaña objetivo.
2. iOS (Safari): Active Web Inspector en iOS (Ajustes → Safari → Avanzado). Conecte al Mac. Abra Safari en Mac, vaya al menú Desarrollar, seleccione su dispositivo y la pestaña abierta.
3. Una vez conectado, use las pestañas Consola y Red de las herramientas de desarrollador del escritorio exactamente como en el escritorio.

Cómo se ven típicamente los errores de SeaText AI

Según la documentación de integración y los comportamientos comunes del navegador, los mensajes típicos de consola incluyen:

• Fallo de red: "No se pudo cargar el recurso: net::ERR_CONNECTION_REFUSED" o 404/500 para la URL del fragmento. Esto significa que el script no se descargó.
• Bloqueo de origen cruzado: "Bloqueado por la política CORS" cuando la SPA sirve el fragmento desde un dominio diferente sin los encabezados Access-Control-Allow-Origin adecuados.
• Almacenamiento local denegado: "SecurityError: No se pudo leer la propiedad 'localStorage'" si el navegador o iframe bloquea el almacenamiento. La guía de SPA advierte explícitamente sobre esto.
• Error de ejecución del script: "Uncaught SyntaxError" o "Uncaught TypeError" originado del script de SeaText: a menudo es una señal de que el fragmento se truncó o modificó durante la inyección.
• Violación de la política de seguridad de contenido: "Se negó a cargar el script porque viola la siguiente directiva de política de seguridad de contenido" — requiere cambios en los encabezados del servidor.

Error común: revisar solo la Consola

La Consola muestra errores de tiempo de ejecución de JavaScript, pero una falla de red silenciosa (el script nunca se descargó) puede no dejar ninguna línea roja en la Consola. Siempre combine la inspección de la Consola con la verificación de recarga en la pestaña Red. La pestaña Red revela códigos de estado HTTP, tamaño de respuesta y tiempos que la Consola no puede mostrar.

Paso de verificación después de una corrección

1. Limpie la Consola (Ctrl+L / Cmd+K).
2. Recargue la página.
3. Confirme que no aparezcan nuevos errores en rojo.
4. En la pestaña Red, verifique que la solicitud del fragmento devuelva 200 y que el tamaño de la respuesta sea > 0 bytes.
5. Active una función de SeaText (por ejemplo, cambiar de idioma, hacer clic en una variante) y observe si hay nuevos errores.

Limitaciones y cuándo este enfoque no aplica

• Los errores de renderizado del lado del servidor (por ejemplo, getServerSideProps de Next.js) nunca llegan a la consola del navegador.
• Si el fragmento se carga dentro de un <iframe sandbox> sin allow-scripts, la consola puede no mostrar nada mientras el script se bloquea silenciosamente.
• Las violaciones de la política de seguridad de contenido (CSP) aparecen en la Consola, pero requieren cambios en los encabezados del servidor, no ediciones del fragmento.
• Navegadores móviles: use la depuración remota como se describió anteriormente porque F12 no está disponible en el dispositivo.
• Los errores que ocurren antes de que se cargue el fragmento (por ejemplo, en su propio código de arranque) pueden enmascarar los errores de SeaText.

Avanzado: uso de filtros de consola y preservación de registros

Chrome y Edge le permiten filtrar la Consola escribiendo "seatext" en el cuadro de filtro. Firefox tiene un campo de búsqueda en la barra de herramientas de la Consola. Active Preservar registro (Chrome) o Persistir registros (Firefox) para mantener los errores a través de las navegaciones de página, lo cual es esencial para SPA donde los cambios de ruta no activan recargas completas. También puede hacer clic derecho en un mensaje de la Consola y elegir Almacenar como variable global para inspeccionar el objeto de error en detalle.

Datos clave

Preguntas frecuentes

¿Qué pasa si la Consola está limpia pero las funciones de SeaText aún no funcionan?

Revise la pestaña Red para ver una respuesta 200 con un cuerpo de script vacío o malformado. También verifique que la página no haya eliminado el fragmento mediante una directiva CSP script-src.

¿Puedo filtrar los mensajes de la Consola solo para SeaText?

Sí. En Chrome/Edge, escriba "seatext" en el cuadro de filtro de la Consola. En Firefox, use el campo de búsqueda en la barra de herramientas de la Consola.

¿El atributo async oculta errores?

No. async solo controla cuándo se descarga y ejecuta el script. Los errores aún aparecen en la Consola una vez que el script se ejecuta.

¿Qué pasa si veo un error CORS?

Su servidor debe enviar encabezados Access-Control-Allow-Origin para el dominio del fragmento, o alojar el fragmento en el mismo origen.

¿Cómo pruebo en un dispositivo móvil?

Conecte el teléfono por USB, active la depuración USB (Android) o Web Inspector (iOS), y use la instancia de DevTools del escritorio para inspeccionar las pestañas Consola y Red de la página móvil.

¿Existe una lista de códigos de error específicos de SeaText?

No publicada. Trate cualquier línea roja en la Consola que haga referencia a la URL del script de SeaText o a nombres de variables como un error de SeaText y comparta el seguimiento de pila completo con el soporte.

¿Por qué el fragmento usa almacenamiento local?

La guía de integración de SPA indica que el script almacena una ID en el almacenamiento local para mantener la continuidad de la sesión a través de las vistas de página en aplicaciones de página única.

¿Puede una política de seguridad de contenido bloquear el fragmento silenciosamente?

Sí. Una directiva CSP script-src que omita el origen del fragmento bloqueará la ejecución. El error aparece en la Consola como una violación de CSP.