Ao abrir páginas modernas no SharePoint Online, alguns utilizadores começaram a ver a mensagem “There was an error parsing the JSON document… Unexpected token ‘S’”. Este guia explica a causa (conflito com extensões tipo JSONView/JSON Viewer) e traz passos práticos para corrigir de forma definitiva.
O que está a acontecer
Em inúmeros ambientes Microsoft 365, sobretudo a partir do final de 2023, proprietários e editores de sites passaram a enfrentar falhas apenas nas páginas modernas do SharePoint (home, páginas de site, páginas de notícias). As Listas e Bibliotecas de Documentos continuavam acessíveis.
- O erro aparece em Edge, Chrome e Firefox (mais frequente em macOS, mas também em Windows).
- Em navegação privada/Incógnito ou noutro navegador, o problema às vezes desaparece.
- A mensagem típica é:
There was an error parsing the JSON document. The document may not be well‑formed. Unexpected token 'S', 'Skip to ma'…
Diagnóstico rápido
- Abra a mesma página moderna do SharePoint em InPrivate/Incognito. Se funcionou, a causa tende a estar no perfil do navegador (extensões, cache, service worker).
- Desative temporariamente todas as extensões. Se a página voltar a abrir, reative-as uma a uma até encontrar a culpada.
- Na maioria dos casos, a extensão relacionada é algum “JSONView / JSON Viewer / JSON Formatter” ou similar.
Causa mais comum: conflito com extensões de visualização de JSON
Extensões como JSONView/JSON Viewer foram concebidas para “embelezar” respostas JSON no navegador. O problema é que versões recentes passaram a interceptar agressivamente respostas e a tentar interpretá-las como JSON, mesmo quando o SharePoint devolve HTML válido.
O texto “Unexpected token ‘S’, ‘Skip to ma…’” acontece porque a primeira letra do HTML da página (por exemplo, “Skip to main content”) é o S. A extensão tenta fazer parse dessa resposta como JSON, encontra um carácter inesperado e injeta o erro antes que o JavaScript do SharePoint inicialize.
Por que só as páginas modernas falham?
As páginas modernas do SharePoint carregam o framework SPFx (SharePoint Framework), que injeta <script data-spfx> e outros recursos dinâmicos. Quando uma extensão altera ou bloqueia a resposta do servidor, o bootstrap do SPFx não ocorre e a página quebra com erro de JSON.
Soluções validadas (resumo)
| Solução | Detalhes / Quando usar |
|---|---|
| Desativar/Remover JSONView | A ação mais eficaz. Em quase todos os cenários, o erro desaparece imediatamente após desativar ou desinstalar. |
| Manter a extensão, mas mudar “Site access” para “On click” | Permite usar a extensão em APIs quando necessário, evitando interferência nas páginas do SharePoint. |
| Desativar apenas no SharePoint | No Edge/Chrome, em Gerir extensões → Permissões de site, remova/evite acesso a https://*.sharepoint.com/. |
| Limpar cache/cookies | Ajuda só temporariamente; o erro tende a voltar ao reiniciar o navegador se a extensão continuar ativa. |
| Usar navegação privada ou outro browser | Bom para diagnóstico rápido, mas não corrige a causa raiz. |
| Abrir ticket no Microsoft 365 Admin Center | Use se não houver JSONView nem extensões semelhantes, ou se o problema persistir após as desativar. |
Passo a passo detalhado por navegador
Microsoft Edge (Chromium)
- Clique em … (menu) → Extensões → Gerir extensões.
- Procure por extensões do tipo JSONView / JSON Viewer / JSON Formatter.
- Opção A – remover a causa: clique em Remover ou desligue o toggle para desativar.
- Opção B – manter a extensão sem afetar o SharePoint:
Em Detalhes → Acesso ao site (Site access), selecione Ao clicar (On click). Assim, a extensão só atua quando você clicar no ícone.
Em Permissões de site, garanta quehttps://*.sharepoint.com/não está listado como permitido. - (Opcional) Em Permitir em InPrivate, mantenha Desativado para evitar afetar janelas privadas de teste.
- Feche e reabra as abas do SharePoint.
Google Chrome
- Abra Menu → Extensões → Gerir Extensões.
- Encontre as extensões de “visualização de JSON”.
- Desative ou Remova a extensão problemática.
- Para manter a extensão: em Detalhes → Acesso ao site, escolha Ao clicar ou Em sites específicos (liste somente domínios de APIs internas, nunca
*.sharepoint.com). - Reabra as páginas do SharePoint.
Mozilla Firefox
- Vá a Menu → Extras → Extensões e Temas.
- Localize JSONView/JSON Viewer (ou semelhantes) e clique em Desativar ou Remover.
- Se pretender manter: abra as Opções da extensão e restrinja o seu escopo (quando disponível). Em caso de dúvida, mantenha-a desativada e ative apenas quando precisar visualizar uma resposta JSON.
- Teste a página do SharePoint novamente.
Alternativas seguras para quem precisa de “ver JSON”
- Usar “Ao clicar”: deixe a extensão inativa por padrão e ative-a só na aba onde precisa observar uma API.
- Ferramentas de desenvolvimento: o painel Network do DevTools já formata JSON sem interferir no carregamento das páginas.
- Aplicações externas: utilize um cliente HTTP (ex.: cURL, Postman) para inspecionar APIs fora do navegador principal.
Quando não é o JSONView
Se a extensão acima não existir ou se desativá-la não resolver, investigue:
- Outras extensões de Pretty Print/visualização de JSON/XML/HTML, bloqueadores de anúncios, “segurança”/privacy, leitores RSS.
- Proxies/firewalls corporativos que injetam cabeçalhos, scripts ou alteram o Content-Type.
- Service Worker ou cache storage corrompidos para o domínio do site.
Como limpar dados do site e service worker
- Abrir a página do site SharePoint com erro.
- Premir F12 (ou Cmd+Opt+I no macOS) para abrir o DevTools.
- Ir a Application (ou Aplicação).
- Em Storage / Armazenamento, selecionar Clear storage → marcar Cookies, Local/Session Storage, Cache Storage e Service Workers.
- Clicar em Clear site data e atualizar a página.
- No painel Application → Service Workers, use Unregister se houver SWs órfãos.
Checklist de diagnóstico
| Cenário | O que esperar | Ação recomendada |
|---|---|---|
| Em InPrivate/Incognito funciona | Problema no perfil (extensão ou cache) | Desativar extensões; ajustar “Site access”; limpar dados do site |
| Noutro navegador funciona | Problema local do navegador | Revisar extensões, atualizar navegador, criar perfil novo |
| Com todas as extensões desligadas ainda falha | Possível proxy/cabeçalho injetado ou cache corrompido | Limpar dados do site, confirmar cabeçalhos, consultar equipa de rede |
| Apenas alguns utilizadores são afetados | Configuração/perfil do utilizador | Comparar lista de extensões, políticas, sistemas operativos |
Boas práticas recomendadas
- Audite extensões que manipulam cabeçalhos ou transformam conteúdo (JSON/HTML/XML).
- Restrinja o âmbito das extensões: “Ao clicar” ou só em sites específicos.
- Mantenha tudo atualizado: SharePoint, navegador e extensões podem introduzir mudanças após atualizações silenciosas.
- Documente internamente o conflito e publique orientação para a organização.
- Políticas de navegador: considere allowlist/blocklist de extensões e predefinição de “Site access = On click”.
Notas técnicas para equipas de TI
- SPFx: a página moderna injeta
<script data-spfx>e carrega bundles JS. Ao ser interceptado, o HTML deixa de ser inicializado e a página quebra. - Content-Type: as páginas modernas regressam
text/html. Extensões que tentam “forçar” JSON sobre HTML causam o erro de token inesperado. - Logs e evidências:
- DevTools → Network: exporte um HAR com Preserve log ativo, incluindo Response headers/body.
- DevTools → Console: recolha erros JS e mensagens de extensão.
- Hora do incidente, URL da página, tenant, utilizador afetado, fuso horário.
- Políticas (Edge/Chrome): utilize chaves como ExtensionSettings, ExtensionInstallBlocklist/Allowlist para controlar extensões e o acesso a sites (definir “On click”).
- Exceções granulares: bloquear acesso da extensão a
.sharepoint.come.sharepoint-df.com(se aplicável), permitindo apenas domínios de APIs internas.
Procedimentos detalhados de correção
Remoção/Desativação da extensão
- Identifique todas as extensões relacionadas a JSON/XML Viewer e formatação.
- Desative-as e teste. Se resolver, remova a extensão problemática para evitar regressões.
- Reinicie o navegador ou, pelo menos, as abas do SharePoint.
Manter a extensão sem afetar o SharePoint
- Abra Detalhes da extensão.
- Defina Acesso ao site = Ao clicar (On click).
- Se usar “Em sites específicos”, liste apenas domínios de APIs (por exemplo, dev, test, api da sua organização). Não inclua
*.sharepoint.com. - Confirme que a extensão não tem permissão para ler/alterar dados nos sites do SharePoint.
Limpeza de cache e dados do site
- Abra a página que falha.
- Use DevTools → Application → Clear storage e limpe tudo.
- Faça Hard Reload (Ctrl+F5 / Cmd+Shift+R).
Perfil novo (teste final)
- Crie um novo perfil de navegador sem extensões.
- Entre no Microsoft 365 e aceda ao site. Se funcionar, confirma-se a origem no perfil/extensões.
Exemplos de mensagens de erro e como interpretar
| Mensagem/Sintoma | Interpretação | Ação |
|---|---|---|
Unexpected token 'S', 'Skip to ma'... | Extensão tentou ler text/html como JSON; “S” vem de “Skip to main content”. | Desativar/limitar JSONView/Viewer; limpar dados do site; recarregar. |
| Páginas modernas falham; listas/bibliotecas abrem | Quebra do bootstrap SPFx; HTML interceptado ou alterado. | Rever extensões e proxies; verificar service worker. |
| Funciona em anónima/anônima | Perfil principal tem extensão ou cache a interferir. | Testar sem extensões; reconfigurar “Site access”. |
FAQ
Preciso mesmo remover a extensão? Eu uso-a para APIs.
Não necessariamente. Defina Acesso ao site = Ao clicar. Assim, a extensão só atua quando você clica no ícone. Em ambientes corporativos, aplique política para impor este comportamento.
Limpar cache resolveu, mas o erro voltou no dia seguinte. Por quê?
Porque a causa raiz (intercepção da resposta pela extensão) permanece. Ao encerrar/reabrir o navegador, a extensão volta a atuar. A correção definitiva é desativá-la, removê-la ou limitar o acesso.
Não tenho JSONView instalado. O que mais pode ser?
Outras extensões de “Viewer/Formatter” (JSON, XML, HTML), bloqueadores de anúncios, extensões de segurança/privacidade ou mesmo proxies que alteram cabeçalhos. Teste com todas as extensões desativadas e num perfil novo. Se persistir, escale via suporte do Microsoft 365.
Há risco de perder dados ao limpar “Clear site data”?
Perde-se apenas dados locais do site (cookies, armazenamento). Não afeta ficheiros no SharePoint. Pode precisar iniciar sessão novamente.
Modelo de comunicação (para TI enviar aos utilizadores)
Assunto: SharePoint Online – erro “error parsing the JSON document” ao abrir páginas
Olá,
Identificámos que a mensagem “There was an error parsing the JSON document… Unexpected token ‘S’” é causada por conflito com extensões de visualização de JSON (ex.: JSONView/JSON Viewer). Para corrigir:
- Vá a Extensões do navegador e desative/remova JSONView/JSON Viewer (ou configure Acesso ao site = Ao clicar).
- Reabra a página do SharePoint.
- Se persistir, abra em janela InPrivate/Incognito e contacte o suporte.
Obrigado.
Quando abrir um ticket no Microsoft 365 Admin Center
Se não houver extensões do género ou se, após desativá-las e limpar dados do site, o problema continuar, recolha as evidências e abra um chamado com:
- URL exata da página que falha e site/coleção de sites.
- Conta afetada, horário local e fuso, quantidade de utilizadores impactados.
- HAR (DevTools → Network → Export HAR) e capturas do Console.
- Se disponível, Activity/Correlation ID exibido pelo SharePoint.
Resumo prático
- O erro “error parsing the JSON document” em páginas modernas do SharePoint é, na grande maioria dos relatos, causado por conflito com JSONView/JSON Viewer ou extensões semelhantes.
- Correção definitiva: Desativar/remover a extensão, ou definir Acesso ao site = Ao clicar e bloquear o domínio
*.sharepoint.compara essa extensão. - Limpar cache/cookies e abrir em anónima/anônima ajuda a diagnosticar, mas é paliativo.
- Se não existirem extensões relevantes ou se o problema persistir, investigue outras extensões/proxies e abra ticket no Microsoft 365.
Checklist final de remediação
- Confirmar que o erro ocorre apenas em páginas modernas e não em listas/bibliotecas.
- Testar em InPrivate/Incognito e noutro navegador.
- Desativar/remover JSONView/JSON Viewer (ou similares) OU configurar “Site access = On click”.
- Bloquear o acesso da extensão a
*.sharepoint.com. - Limpar “Clear site data” e Service Workers do site.
- Reabrir o navegador e validar.
- Se persistir: recolher logs (HAR/Console) e abrir ticket no Microsoft 365.
Conclusão: tratar a extensão é o que resolve de forma consistente. As demais ações (limpar cache, janelas privadas, mudar de navegador) são úteis para diagnóstico e mitigação temporária, mas não eliminam a causa de fundo.