chrome 111+ · JavaScript
A mensagem
SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
O que significa
O que você passou a JSON.parse era HTML, não JSON. O fragmento <!DOCTYPE citado na mensagem é a prova, e quer dizer que o servidor respondeu com uma página HTML — um 404, um 502 ou um redirecionamento de login — então o bug real está antes do parse, na requisição. Causas típicas: URL errada, um proxy do servidor de desenvolvimento que serviu index.html em vez da API, ou uma sessão expirada que redirecionou para a tela de login. Verifique res.ok antes de chamar res.json() e leia res.text() para ver o que chegou; bater na URL com curl -s é o jeito mais rápido de olhar. Antes do Chrome 111 e do Node 20 o mesmo erro dizia Unexpected token < in JSON at position 0.
A correção
curl -s https://api.example.com/data | head -5- Impresso por
- chrome 111+
- JavaScript
- 15
Erros de navegador e de Node costumam dizer o que quebrou e não por que o valor ficou assim — você leu undefined, não era uma função, não era JSON — então o lugar de corrigir está acima da linha que estourou, e calar só aquela linha com ?. e valores padrão faz o mesmo problema reaparecer mais longe, numa forma mais difícil de reconhecer.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON”?
O que você passou a JSON.parse era HTML, não JSON. O fragmento <!DOCTYPE citado na mensagem é a prova, e quer dizer que o servidor respondeu com uma página HTML — um 404, um 502 ou um redirecionamento de login — então o bug real está antes do parse, na requisição. Causas típicas: URL errada, um proxy do servidor de desenvolvimento que serviu index.html em vez da API, ou uma sessão expirada que redirecionou para a tela de login. Verifique res.ok antes de chamar res.json() e leia res.text() para ver o que chegou; bater na URL com curl -s é o jeito mais rápido de olhar. Antes do Chrome 111 e do Node 20 o mesmo erro dizia Unexpected token < in JSON at position 0.
Q. Como corrigir?
curl -s https://api.example.com/data | head -5 — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
chrome 111+. Fica em JavaScript e a mensagem tem 10 palavras.