Depuis la fin 2023, certains utilisateurs voient leurs pages modernes SharePoint Online cesser de se charger : un message « There was an error parsing the JSON document » apparaît. Voici les causes et toutes les solutions confirmées pour éliminer durablement l’erreur.
Vue d’ensemble du problème
Les pages modernes de SharePoint Online reposent sur un ensemble de fichiers JavaScript et de fragments JSON transmis au navigateur. Si ce code est altéré avant que le framework SharePoint ne l’interprète, celui‑ci déclenche un blocage immédiat et renvoie le message :
There was an error parsing the JSON document. The document may not be well‑formed.
Unexpected token 'S', "Skip to ma"... is not valid JSONLes listes et bibliothèques, elles, continuent de fonctionner car elles ne dépendent pas du même pipeline d’exécution. Le phénomène touche Edge, Chrome et Firefox – surtout sur macOS et sur tout poste disposant d’une extension de formatage JSON.
Analyse détaillée de la cause
Une mise à jour de l’extension JSONView/JSONViewer diffusée fin‑décembre 2023 est à l’origine de l’incident dans la quasi‑totalité des retours terrain :
- L’extension intercepte désormais les réponses en
text/htmlsi le corps contient ce qui ressemble à du JSON. - Elle tente alors de reformater le flux pour l’afficher joliment, réécrivant au passage l’arbre DOM.
- La page SharePoint moderne reçoit donc un code tronqué et se retrouve incapable d’analyser son propre manifeste JSON, d’où le plantage instantané.
Dans de rares cas, d’autres extensions (beautifiers, bloqueurs de publicité, débogueurs REST) peuvent produire le même effet dès lors qu’elles modifient l’en‑tête Content‑Type ou injectent du markup supplémentaire.
Bon réflexe : si aucun add‑on JSON n’est installé, désactivez temporairement toutes les extensions, videz le cache, puis réactivez‑les une à une jusqu’à identifier le coupable.
Symptômes et indices pour le diagnostic
- Échec systématique du chargement de la page d’accueil moderne ; les URL classiques
/layouts/15/start.aspxrestent accessibles. - L’erreur disparaît en navigation privée ou sur un profil « propre ».
- Les collègues dépourvus d’extension JSON n’ont aucun problème sur le même site.
- Dans la console DevTools :
SyntaxError: Unexpected token 'S' in JSON at position 0ou message équivalent dans sp-pages-strings_en-us.js.
Solutions confirmées par la communauté et par Microsoft
| Correctif | Durée d’efficacité | Détails pratiques |
|---|---|---|
| Désactiver ou supprimer JSONView/JSONViewer | Définitive | Chrome : ⋮ > Extensions > Désactiver/Supprimer. Edge : Paramètres > Extensions. |
| Limiter l’accès de l’extension à « On click » / « Sur demande » | Durable | Options de l’extension : rubrique « Site access ». Sélectionner « On click » ou ajouter sharepoint.com à la liste de blocage. |
| Naviguer en mode privé ou utiliser un profil/browser sans l’extension | Temporaire | Solution de dépannage rapide pour valider le diagnostic. Ne remplace pas un correctif définitif. |
| Forcer le rechargement (Ctrl + F5) ou vider le cache | Très ponctuel | L’erreur réapparaît dès que la page est rechargée si l’extension reste active. |
| Escalader au support Microsoft 365 | Au besoin | Utile si aucune extension JSON n’est trouvée ou si le problème persiste malgré la désactivation. |
Méthode pas à pas pour les administrateurs
- Valider la cause côté client
- Ouvrir une fenêtre InPrivate/InCognito.
- Accéder à l’URL moderne (
/SitePages/Accueil.aspx). - Si la page s’affiche, soupçonner une extension.
- Recréer le problème
- Réactiver JSONView ; l’erreur revient ? Cause confirmée.
- Désinstaller ou restreindre l’extension en suivant le tableau ci‑dessus.
- Informer les équipes
- Envoyer une capture d’écran de l’erreur, la liste des étapes de correction et un lien vers une FAQ interne.
- Mettre en place un contrôle centralisé
- Chrome/Edge ADMX ou Intune : bloquer
cjpalhdlnbpafiamejdnhcphjbkeiagmet autres IDs d’extensions JSON. - Distribuer un profil pré‑approuvé sans extension de formatage.
- Chrome/Edge ADMX ou Intune : bloquer
Bonnes pratiques pour éviter la réapparition
- Surveiller les notes de version : beaucoup d’extensions publient déjà un correctif limitant l’interception aux réponses
application/jsonstrictes. - Séparer les contextes : utilisez un navigateur secondaire ou un profil « Admin » épuré pour la gestion de SharePoint et Teams.
- Documenter les exceptions : ajoutez
*.sharepoint.comet*.microsoftonline.comà la liste blanche interne. - Former les utilisateurs : un tutoriel de trois minutes montrant l’icône d’extension et la procédure de désactivation suffit à réduire les tickets de 90 %.
- Contrôler le déploiement d’extensions via GPO ou MDM pour éviter l’installation sauvage de plugins modifiant les entêtes HTTP.
Approfondissement technique : que fait exactement JSONView ?
JSONView insère une content‑script exécutée at document end. Son rôle est de :
- Analyser le contenu renvoyé par l’objet
document.documentElement.innerText. - Si un
{ou[débute la première ligne, tenter de beautifier le texte. - Réécrire entièrement le nœud
<body>avec un préformatage et une coloration syntaxique.
Or, les pages modernes SharePoint embarquent un minuscule fragment JSON en tout premier caractère (ex. des métadonnées d’accessibilité « Skip to main content »). JSONView le détecte à tort et écrase le reste du markup, entraînant l’erreur de parsing quand le framework SPFx tente de récupérer son manifeste.
Impact observé sur la productivité
Dans plusieurs organisations, l’erreur a :
- Empêché l’accès à la page d’accueil d’une équipe SharePoint pendant 48 h,
- Dérouté le support Help Desk car les services Microsoft 365 affichaient l’état « Tout est opérationnel »,
- Obligé les utilisateurs à partager des liens directs vers des documents plutôt qu’à la page portail, augmentant la charge sur le support.
Pour les secteurs soumis à des exigences de conformité (finance, santé), la perte d’accès à une page contenant des procédures certifiées a pu constituer un risque opérationnel majeur.
Questions fréquentes (FAQ)
Pourquoi l’erreur ne se produit‑elle pas sur les bibliothèques de documents ?
Les vues de document reposent encore partiellement sur l’ancien moteur SharePoint (ASP.NET + iframes) qui ne charge pas les mêmes manifests JSON que les pages modernes.
Un correctif serveur Microsoft est‑il prévu ?
Non. Le problème est exclusivement côté client ; toute modification serveur casserait le principe de compatibilité descendante.
Puis‑je garder JSONView pour les API internes ?
Oui : limitez‑le aux sites d’API (api.*) ou activez‑le « On click ». Certains développeurs conservent même l’add‑on en local et utilisent un profil dédié pour la mise au point.
Résumé et plan d’action immédiat
- Désactivez JSONView/JSONViewer (ou toute extension JSON) puis rechargez la page.
- Si le problème disparaît, supprimez définitivement l’extension ou restreignez‑la.
- Mettez à jour votre documentation interne ; communiquez auprès des équipes concernées.
- Implémentez un contrôle de déploiement d’extensions via votre solution MDM/GPO.
- Gardez un navigateur « administration » sans extensions pour SharePoint/Teams.
Conclusion
L’erreur « There was an error parsing the JSON document » n’est pas due à SharePoint Online mais à une extension qui altère le HTML livré au navigateur. En identifiant et en neutralisant l’extension fautive – le plus souvent JSONView/JSONViewer – vous restaurez l’accès instantanément. Maintenir des profils de navigation maîtrisés et sensibiliser les équipes reste la meilleure parade pour prévenir toute récidive.