Solucionar problemas de JavaScript relacionados con la Búsqueda

Esta guía le ayuda a identificar y solucionar problemas de JavaScript que puedan estar bloqueando su página, o contenido específico en páginas basadas en JavaScript, para que no aparezca en la Búsqueda de Google.
Aunque la Búsqueda de Google ejecuta JavaScript, existen algunas diferencias y limitaciones que debe tener en cuenta al diseñar sus páginas y aplicaciones para adaptarse a cómo los rastreadores acceden y renderizan su contenido.
Nuestra guía sobre los fundamentos del SEO en JavaScript contiene más información sobre cómo puede optimizar su sitio de JavaScript para la Búsqueda de Google.

Googlebot está diseñado para ser un buen ciudadano de la web. El rastreo es su principal prioridad, al tiempo que garantiza que no degrade la experiencia de los usuarios que visitan el sitio.
Googlebot y su componente de Servicio de Renderizado Web (WRS) analizan e identifican continuamente los recursos que no contribuyen al contenido esencial de la página y es posible que no recuperen dichos recursos.
Por ejemplo, las solicitudes de informes y errores que no contribuyen al contenido esencial de la página, y otros tipos similares de solicitudes, no se utilizan o son innecesarias para extraer el contenido esencial de la página. Los análisis del lado del cliente pueden no proporcionar una representación completa o precisa de la actividad de Googlebot y WRS en su sitio.
Utilice el informe de estadísticas de rastreo en Google Search Console para supervisar la actividad y los comentarios de Googlebot y WRS en su sitio.

Si sospecha que los problemas de JavaScript pueden estar bloqueando su página, o contenido específico en páginas basadas en JavaScript, para que no aparezcan en la Búsqueda de Google, siga estos pasos. Si no está seguro de si JavaScript es la causa principal, siga nuestra guía general de depuración para determinar el problema específico.

1. Para probar cómo Google rastrea y renderiza una URL, utilice la Prueba de resultados enriquecidos o la Herramienta de inspección de URLs en Search Console.
   Puede ver los recursos cargados, la salida y las excepciones de la consola de JavaScript, el DOM renderizado y más información.

   Opcionalmente, también recomendamos recopilar y auditar los errores de JavaScript encontrados por los usuarios, incluido Googlebot, en su sitio para identificar posibles problemas que puedan afectar a cómo se renderiza el contenido.
   Aquí tiene un ejemplo que muestra cómo registrar los errores de JavaScript que se registran en el gestor onerror global. Tenga en cuenta que algunos tipos de errores de JavaScript, como un error de análisis, no se pueden registrar con este método.
2. Asegúrese de prevenir soft 404 errores. En una aplicación de página única (SPA), esto puede ser especialmente difícil. Para evitar que se indexen las páginas de error, puede utilizar una o ambas de las siguientes estrategias:
   • Redirigir a una URL donde el servidor responde con un 404 código de estado.
   • Añadir o cambiar la etiqueta meta robots a.

   noindex 200 Cuando una SPA utiliza JavaScript del lado del cliente para gestionar errores, a menudo informan de un código de estado HTTP en lugar delcódigo de estado adecuado

3. . Esto puede provocar que las páginas de error se indexen y posiblemente se muestren en los resultados de búsqueda. Espere que Googlebot rechace.
   
   las solicitudes de permisos de usuario Las funciones que requieren el permiso del usuario no tienen sentido para Googlebot ni para todos los usuarios. Por ejemplo, si hace que la API de la cámara
4. sea obligatoria, Googlebot no puede proporcionarle una cámara.
   En su lugar, proporcione una forma para que los usuarios accedan a su contenido sin verse obligados a permitir el acceso a la cámara.
   
   No utilice fragmentos de URL para cargar contenido diferente. Una SPA puede utilizar fragmentos de URL (por ejemplo, https://example.com/#/products) para cargar diferentes vistas. El esquema de rastreo AJAX ha quedado obsoleto desde 2015, por lo que no puede confiar en que los fragmentos de URL funcionen con Googlebot.
   Recomendamos utilizar la History API
5. para cargar contenido diferente según la URL en una SPA.
   
   No confíe en la persistencia de datos para servir contenido. WRS carga cada URL (consulte Cómo funciona la Búsqueda de Google
   • para obtener una visión general de cómo Google descubre el contenido), siguiendo redireccionamientos de servidor y de cliente, igual que un navegador normal.
     Sin embargo, WRS no retiene el estado entre cargas de página:
   • Los datos de Almacenamiento Local y Almacenamiento de Sesión se borran entre cargas de página.
6. Las cookies HTTP se borran entre cargas de página.
   
   Utilice el registro de huellas digitales de contenido (content fingerprinting) para evitar problemas de caché con Googlebot. Googlebot almacena en caché de forma agresiva para reducir las solicitudes de red y el uso de recursos. WRS puede ignorar las cabeceras de caché. Esto puede hacer que WRS utilice recursos de JavaScript o CSS obsoletos. El registro de huellas digitales de contenido evita este problema haciendo que una huella digital del contenido forme parte del nombre de archivo, comomain.2bb85551.js .
   La huella digital depende del contenido del archivo, por lo que las actualizaciones generan un nombre de archivo diferente cada vez. Consulte la guía de web.dev sobre estrategias de almacenamiento en caché de larga duración
7. para obtener más información. Asegúrese de que su aplicación utiliza detección de características
   
   para todas las API críticas que necesita y proporcione un comportamiento alternativo (fallback) o un polyfill cuando corresponda.
8. Es posible que algunas características web aún no sean adoptadas por todos los agentes de usuario y algunas pueden deshabilitar intencionalmente ciertas características. Por ejemplo, si utiliza WebGL para renderizar efectos fotográficos en el navegador, la detección de características muestra que Googlebot no es compatible con WebGL.
   Para solucionar esto, podría omitir el efecto fotográfico o decidir utilizar el renderizado del lado del servidor para pre-renderizar los efectos fotográficos, lo que hace que su contenido sea accesible para todos, incluido Googlebot.
   
   Asegúrese de que su contenido funcione con conexiones HTTP. Googlebot utiliza solicitudes HTTP para recuperar contenido de su servidor. No es compatible con otros tipos de conexiones, como WebSockets o WebRTC conexiones.
   Para evitar problemas con este tipo de conexiones, asegúrese de proporcionar una alternativa HTTP para recuperar contenido y utilice un manejo de errores robusto y.
9. detección de características.
   Asegúrese de que sus componentes web se rendericen como se espera. Utilice la Prueba de resultados enriquecidos o la Herramienta de inspección de URLs
   
   para comprobar si el HTML renderizado tiene todo el contenido que espera. WRS aplana elDOM ligero y el DOM sombra (light DOM and shadow DOM), unificándolos para su procesamiento. <slot> mecanismo para contenido DOM ligero, consulte la documentación del componente web para obtener más información o utilice otro componente web en su lugar.
   Para más información, consulte mejores prácticas para componentes web.
10. Si utilizas un muro de pago (paywall) basado en JavaScript, considera la implementación.
    
    Algunas soluciones de paywall con JavaScript incluyen todo el contenido en la respuesta del servidor y luego usan JavaScript para ocultarlo hasta que se confirma el estado de la suscripción. Esta no es una forma fiable de limitar el acceso al contenido. Asegúrate de que tu paywall solo proporcione el contenido completo una vez que se confirme el estado de la suscripción.
11. Después de corregir los elementos de esta lista de verificación, prueba tu página con la Prueba de Resultados Ricos o la herramienta de inspección de URLs en Search Console de nuevo.
    
    Si solucionaste el problema, aparecerá una marca de verificación verde y no se mostrarán errores. Si sigues viendo errores, publica en la comunidad de ayuda de Search Central.