Résoudre les problèmes JavaScript liés à la recherche

Ce guide vous permet d'identifier et de résoudre les problèmes JavaScript susceptibles d'empêcher l'affichage dans la recherche Google de votre page ou de contenus spécifiques associés à des pages JavaScript. Même si Googlebot exécute JavaScript, vous devez tenir compte de certaines différences et restrictions lors de la conception de vos pages et de vos applications afin de permettre aux robots d'exploration d'accéder au contenu et de l'afficher. Le guide sur les principes de base du référencement JavaScript fournit des informations supplémentaires sur la façon d'optimiser votre site JavaScript pour la recherche Google.

Googlebot est conçu pour être un bon citoyen du Web. Il fait de l'exploration sa priorité, tout en s'assurant de ne pas nuire à l'expérience des internautes qui consultent le site. Googlebot et le service WRS analysent et identifient en permanence les ressources qui ne contribuent pas au contenu essentiel de la page, et ne les explorent pas toujours. Par exemple, les requêtes de rapport et d'erreur, ainsi que d'autres types de requêtes similaires qui ne contribuent pas au contenu essentiel de la page, ne sont pas utilisées ni nécessaires pour extraire ce contenu. Les données analytiques côté client peuvent ne pas fournir une représentation complète ou précise de l'activité de Googlebot et de WRS sur votre site. Utilisez la Search Console pour contrôler l'activité et les commentaires de Googlebot et de WRS sur votre site.

Si vous pensez que des problèmes JavaScript peuvent empêcher l'affichage de votre page ou de contenus spécifiques sur des pages JavaScript dans la recherche Google, procédez comme suit : Si vous ne savez pas si JavaScript est la cause principale, suivez notre guide de débogage général afin de déterminer le problème spécifique.

  1. Pour tester la manière dont Google explore et affiche une URL, utilisez le test d'optimisation mobile ou l'outil d'inspection d'URL dans la Search Console. Vous pouvez consulter les ressources chargées, la sortie et les exceptions de la console JavaScript, le rendu DOM ainsi que d'autres informations.

    Nous vous recommandons également de collecter et de vérifier les erreurs JavaScript rencontrées par les utilisateurs, y compris Googlebot, sur votre site afin d'identifier les problèmes susceptibles de nuire à l'affichage du contenu.

  2. Veillez à éviter les erreurs "soft 404". Dans une SPA (Single Page Application), cela peut être particulièrement difficile. Pour éviter l'indexation des pages d'erreur, vous pouvez adopter les stratégies suivantes, à votre convenance :
    • Redirigez les internautes vers une URL où le serveur répond avec un code d'état 404.
    • Ajoutez la balise Meta pour les robots noindex.
  3. Attendez-vous à ce que Googlebot refuse les demandes d'autorisation utilisateur.
  4. N'utilisez pas d'URL à fragments pour charger un contenu différent.
  5. Ne comptez pas sur la persistance des données pour diffuser le contenu.
  6. Utilisez les empreintes de contenu pour éviter les problèmes de mise en cache avec Googlebot.
  7. Assurez-vous que votre application utilise la détection de fonctionnalité pour toutes les API critiques dont elle a besoin et configurez un comportement de remplacement ou un polyfill, le cas échéant.
  8. Assurez-vous que votre contenu fonctionne avec les connexions HTTP.
  9. Assurez-vous que vos composants Web s'affichent comme prévu. Utilisez le test d'optimisation mobile ou l'outil d'inspection d'URL pour vérifier que le rendu HTML affiche le contenu souhaité.
  10. Après avoir corrigé les éléments de cette checklist, testez à nouveau votre page avec le test d'optimisation mobile ou l'outil d'inspection d'URL dans la Search Console.

    Si vous avez résolu le problème, une coche verte apparaît et aucune erreur ne s'affiche. S'il reste des erreurs, demandez de l'aide dans le groupe intitulé JavaScript Sites in Search Working Group.