O seu conteúdo é visível sem JavaScript?

Porque é importante

Quando alguém abre o seu site, o navegador recebe do seu servidor um ficheiro de código HTML. Na maioria dos sites, esse ficheiro já contém o seu texto: os seus serviços, preços, horário. Em alguns sites modernos, o ficheiro está quase vazio. Um programa escrito em JavaScript executa-se então no navegador e constrói o texto no ecrã.

Para uma pessoa, os dois aspetos são iguais. Para um crawler, não são. A Google executa o JavaScript antes de ler uma página, mas a própria Google diz que "nem todos os bots conseguem executar JavaScript". Um crawler que só lê o ficheiro que o seu servidor envia pode não encontrar texto nenhum, e não tem nada para citar sobre si.

<body>
  <div id="root"></div>
  <script src="/app.js"></script>
</body>

<body>
  <h1>Kastell Consultores</h1>
  <p>Contabilidade e salários para
  pequenas empresas em Portugal.</p>
</body>

Ilustração com um negócio fictício.

Antes de começar

Tenha isto à mão

• O Google Chrome num computador. Os atalhos abaixo são os do próprio Chrome.
• Três endereços para testar: a sua página inicial, a sua página de serviço mais importante e a sua página de contactos.
• Para cada página, uma frase que veja no ecrã e que seja importante, por exemplo a primeira linha da descrição de um serviço. Escolha uma frase curta sem apóstrofos, aspas ou "&": no ficheiro HTML estes carateres são muitas vezes escritos como códigos, por isso uma pesquisa exata pode não os encontrar.

Passos

Três verificações, e uma a evitar

1. Verificação 1: procure no código-fonte da página

   Abra a página no Chrome. Prima Ctrl + U (Windows, Linux) ou ⌘ + Option + U (Mac). O Chrome abre um novo separador com o ficheiro HTML exatamente como o seu servidor o enviou, antes de qualquer JavaScript se executar.

   Nesse separador, prima Ctrl + F (Windows, Linux) ou ⌘ + F (Mac) e escreva algumas palavras da sua frase.

   • Encontrada. Bom: os crawlers que não executam JavaScript conseguem ler este texto.
   • Não encontrada. O texto é acrescentado mais tarde pelo JavaScript. Experimente uma segunda frase da mesma página para ter a certeza e depois passe às correções abaixo.

   view-source:https://letzscale.com

   

   Na nossa própria página inicial, letzscale.com, a frase (em inglês) "Get a free report on what ChatGPT, Gemini and Google AI Overviews say about you" aparece no código-fonte da página, por isso está no ficheiro HTML.

2. Verificação 2: obtenha a página como um crawler simples programador

   Isto faz a mesma verificação a partir de um Terminal, o que é útil para testar muitas páginas. O curl transfere o ficheiro HTML e não executa JavaScript. O -s esconde a barra de progresso, o -L segue redirecionamentos (por exemplo de asuaempresa.pt para www.asuaempresa.pt). O grep -io imprime a frase se a encontrar, ignorando as maiúsculas.

   Terminal · a nossa própria página inicial, 24 de outubro de 2026Copiar

   curl -sL https://letzscale.com/ | grep -io "Get a free report on what ChatGPT, Gemini and Google AI Overviews say"

   Se a frase estiver no HTML, o Terminal imprime-a de volta. Se não imprimir nada, a frase não está no ficheiro que o seu servidor envia. Substitua o endereço e a frase pelos seus.

3. Verificação 3: desligue o JavaScript no Chrome

   Isto mostra-lhe, no ecrã, o que um leitor sem JavaScript recebe.

   1. Abra a página e abra as DevTools: F12 ou Ctrl + Shift + J (Windows, Linux), ⌘ + Option + I (Mac).
   2. Abra o Command Menu: Ctrl + Shift + P (Windows, Linux) ou ⌘ + Shift + P (Mac).
   3. Escreva javascript, selecione Disable JavaScript e prima Enter.
   4. Volte a carregar a página, com as DevTools ainda abertas.

   Veja o que sobra. Uma página em branco, um ícone de carregamento, ou uma página com menus mas sem o texto dos serviços significa que o conteúdo depende do JavaScript. O JavaScript fica desligado neste separador só enquanto as DevTools estiverem abertas. Para o voltar a ligar, execute Enable JavaScript a partir do Command Menu, ou feche as DevTools.

4. Não use "Inspecionar" para isto

   Clicar com o botão direito numa frase e escolher Inspecionar abre o painel Elements. Quase sempre mostra o seu texto, mesmo num site com HTML vazio, porque mostra a página depois de o JavaScript se ter executado. A própria documentação do Chrome di-lo assim: "O HTML representa o conteúdo inicial da página e o DOM representa o conteúdo ativo e atual da página." O painel Elements mostra o DOM. Os crawlers que não executam JavaScript só recebem o HTML, por isso use as verificações 1 a 3.

Correção

Ponha o texto no HTML

Se as suas verificações encontraram texto em falta, o objetivo é simples: o seu servidor deve enviar o texto importante dentro do ficheiro HTML, e não construí-lo mais tarde no navegador.

Para o seu programador

As armadilhas do JavaScript segundo a Google

Mesmo quando o texto está no HTML, algumas coisas correm mal em sites com JavaScript. Vêm da página da Google sobre os fundamentos de SEO com JavaScript:

• As ligações têm de ser ligações verdadeiras. "A Google só consegue descobrir as suas ligações se forem elementos HTML <a> com um atributo href." Um botão ou um <div> que altera a página ao clicar não é uma ligação que os crawlers possam seguir.
• Defina o canonical no HTML. "A melhor forma de definir o URL canónico é usar HTML." Se o JavaScript o definir também, tem de coincidir com o valor do HTML original.
• Defina o noindex no HTML original, ou não o defina de todo. Quando a Google vê uma etiqueta noindex, pode saltar a execução do JavaScript. Um noindex que o JavaScript remove mais tarde pode manter a página fora da Google. Se quer a página indexada, não ponha noindex no código original da página.
• As páginas em falta têm de devolver um 404 verdadeiro. A Google usa os códigos de estado HTTP para ver se algo correu mal. Uma mensagem de "página não encontrada" mostrada por JavaScript numa página que responde 200 (OK) parece uma página verdadeira. A Google sugere um redirecionamento para um URL que devolva 404, ou acrescentar noindex às páginas de erro.

Verifique se funcionou

Repita as verificações

Depois de a alteração entrar em produção, repita a verificação 1 ou a verificação 2 nas mesmas páginas, com as mesmas frases. Use uma janela privada do navegador para ver a versão ativa e não uma cópia guardada.

Erros comuns

O que costuma correr mal

• Verificar com o Inspecionar. O painel Elements mostra a página depois de o JavaScript se ter executado, por isso esconde o problema.
• Testar só a página inicial. As páginas de serviços, as listas de preços e as páginas de contactos são muitas vezes construídas de forma diferente. Verifique as páginas que quer que os assistentes de IA citem.
• Procurar uma frase com apóstrofo ou "&". Estes carateres são muitas vezes escritos como códigos no HTML, por isso a pesquisa não encontra nada mesmo quando o texto lá está.
• Texto principal dentro de um carrossel ou separador. O título está no HTML, mas os preços ou o horário só carregam quando um visitante clica.
• Escolher a renderização dinâmica como solução a longo prazo. A Google chama-lhe uma solução alternativa. A renderização no servidor ou estática é a solução duradoura.