Beaucoup de sites modernes construisent leurs pages côté navigateur, avec du JavaScript. Google sait traiter ce cas, mais le processus comporte des étapes et des pièges précis. La documentation officielle sur les bases du SEO pour JavaScript en donne la mécanique et des recommandations concrètes. Voici l'essentiel.
Les trois étapes : exploration, rendu, indexation
Exploration. Googlebot prend une URL dans sa file d'exploration et vérifie d'abord robots.txt. Les URL interdites ne sont pas explorées, et Google n'exécute pas le JavaScript des fichiers ou des pages bloqués. Il lit ensuite les attributs href des liens HTML pour ajouter de nouvelles URL à sa file.
Rendu. Les pages qui renvoient un code HTTP 200 passent dans une file de rendu, même sans JavaScript. Le rendu peut être ignoré pour les autres codes, comme 404. Une page peut attendre dans cette file quelques secondes, ou davantage selon les ressources de Google. Un navigateur Chromium sans interface exécute alors le JavaScript, et Googlebot relit le HTML obtenu pour y chercher des liens.
Indexation. Google indexe le HTML rendu. Il recommande tout de même le rendu côté serveur ou le pré-rendu, qui accélère le site pour les utilisateurs comme pour les robots, tous les robots n'exécutant pas le JavaScript.
Les points d'attention
Liens
Google ne suit que les éléments <a> munis d'un attribut href. Des liens injectés par JavaScript fonctionnent s'ils respectent ces règles.
Titres et méta descriptions
Chaque page doit avoir un <title> et une méta description uniques et descriptifs. Le JavaScript peut les définir ou les modifier.
Canonique
Placez si possible rel="canonical" dans le HTML d'origine. Le JavaScript peut le définir, mais la valeur doit correspondre à celle du HTML et ne pas pointer ailleurs. Il ne doit y avoir qu'une seule balise canonique : des balises contradictoires donnent des résultats imprévisibles. Si le canonique ne peut pas figurer dans le HTML, vous pouvez l'injecter uniquement par JavaScript.
Meta robots
Un noindex peut être ajouté par JavaScript, par exemple quand une API renvoie une erreur. Attention : quand Google voit noindex, il peut sauter le rendu. Retirer noindex par JavaScript peut donc échouer. Pour une page à indexer, n'incluez pas noindex dans le code d'origine.
Codes HTTP et erreurs
Utilisez des codes exacts : 404 pour une page absente, 401 pour une page derrière une connexion, des redirections pour une URL déplacée. Dans une application monopage, le routage côté client rend cela difficile. Google propose deux options : rediriger en JavaScript vers une URL qui renvoie un vrai 404, ou injecter <meta name="robots" content="noindex"> quand le contenu est introuvable.
Routage
N'utilisez pas les fragments (#/page) pour le routage, car Googlebot ne sait pas les résoudre de façon fiable. Utilisez de vrais chemins dans les href et l'API History (pushState) pour mettre à jour l'URL.
Cache, données structurées, composants web, images
- Googlebot met en cache de façon agressive et peut ignorer les en-têtes de cache de son service de rendu. Google recommande l'empreinte de contenu dans les noms de fichiers (par exemple
main.2bb85551.js). - Vous pouvez générer du JSON-LD par JavaScript, à condition de le tester.
- Pour les composants web, Google aplatit le shadow DOM et le light DOM au rendu. Seul le contenu visible dans le HTML rendu peut être indexé ; l'élément
<slot>permet d'y faire apparaître le contenu. - Le chargement différé des images est recommandé, en suivant les consignes de Google pour que le contenu reste indexable.
Comment vérifier
- L'outil d'inspection d'URL de Search Console affiche le HTML rendu : vous voyez ce que Google voit.
- Le test des résultats enrichis valide les données structurées et montre le rendu.
- Le guide de dépannage JavaScript de Google couvre les problèmes qui bloquent pages ou contenus.
Checklist
- Contenu critique dans du HTML rendu côté serveur ou pré-rendu, si possible.
- Aucun blocage robots.txt sur les pages ou fichiers JavaScript utiles.
- Liens en
<a href>avec de vrais chemins, sans fragments. - Titre, méta description et canonique uniques, canonique dans le HTML d'origine.
- Pas de
noindexdans le code d'origine d'une page à indexer. - Vrais codes HTTP, ou redirection vers un 404 et
noindexinjecté dans une application monopage. - Fichiers fingerprintés pour le JavaScript et le CSS.
- Vérification du rendu dans l'outil d'inspection d'URL.
Sur le même thème, voir la canonicalisation. Pour vérifier ces points sur votre site, lancez un audit gratuit.