Vai al contenuto
IT · $
Accesso al pannello Acquista pacchetto
SEO tecnica

Nozioni base di SEO JavaScript: guida a render, SSR e CSR

6 minuti di lettura

La SEO per JavaScript è l'insieme di interventi che assicurano che i siti che generano contenuti o link con JavaScript vengano scansionati, eseguiti e indicizzati correttamente dai motori di ricerca. In un sito costruito con framework come React, Vue o Angular nel suo browser tutto può sembrare perfetto; ma Googlebot elabora la stessa pagina in condizioni diverse e in due fasi. Per questo "sul mio computer funziona" non basta. In questo articolo trattiamo come Google elabora JavaScript, quale architettura comporta quali rischi e che cosa conviene controllare nella pratica.

Cos'è la SEO per JavaScript?

In una pagina web classica il server invia il contenuto direttamente come HTML. Nei siti basati prevalentemente su JavaScript, invece, il server di solito invia uno scheletro vuoto e un pacchetto di script; il contenuto vero compare nel browser dopo l'esecuzione dello script. Dal punto di vista del motore di ricerca questo solleva una domanda: il bot riesce a eseguire lo script e a vedere il contenuto finale, quando e con quale affidabilità?

Oggi Google è in grado di eseguire JavaScript; il problema è che questa capacità non è incondizionata e istantanea. Le sezioni seguenti mostrano dove emerge la differenza.

Come Google elabora JavaScript?

Nella documentazione di Google il processo è descritto in tre fasi:

  1. Scansione (crawling): Googlebot richiede l'indirizzo, riceve la risposta HTML e controlla le regole di robots.txt.
  2. Elaborazione (rendering): la pagina viene eseguita con una versione aggiornata di Chromium e si vede il contenuto finale generato da JavaScript. Questa fase entra in coda, quindi potrebbe non avvenire subito.
  3. Indicizzazione: testo e link della pagina elaborata vengono inseriti nell'indice; i nuovi link vengono accodati alla scansione.

In pratica: tutto ciò che si trova nell'HTML iniziale viene visto per primo e in modo più affidabile. Il contenuto aggiunto solo tramite JavaScript attende nella coda di elaborazione ed è più esposto a rischi: se lo script genera un errore, supera il tempo limite o viene bloccato, quel contenuto potrebbe non essere visto affatto.

Importante: i motori di ricerca diversi da Google e alcuni bot di intelligenza artificiale potrebbero non eseguire JavaScript con la stessa efficacia di Google. Presentare i contenuti critici del sito nell'HTML iniziale è il modo più sicuro anche per questi bot.

CSR, SSR e generazione statica

MetodoCome funziona?Dal punto di vista SEO
CSR (lato client)Il browser riceve lo scheletro vuoto e il contenuto viene generato dallo scriptL'opzione più rischiosa; il contenuto dipende dalla fase di elaborazione
SSR (lato server)Il server genera a ogni richiesta l'HTML completo, poi lo script nel browser prende il controlloIl contenuto arriva nella prima risposta; è una scelta solida per la maggior parte dei siti di contenuti
SSG (generazione statica)Le pagine vengono generate come HTML prima della pubblicazioneVeloce e affidabile; ideale per contenuti che cambiano poco
IbridoCombinazione di SSR, SSG o CSR a seconda della paginaApproccio diffuso nei framework moderni; le pagine critiche devono essere SSR o SSG

Il "rendering dinamico" (servire ai bot un HTML separato), suggerito in passato, Google non lo indica più come soluzione duratura; lo definisce una soluzione provvisoria. Se sta avviando un nuovo progetto, scegliere SSR o SSG riduce anche il carico di manutenzione. Consulti la documentazione del framework che usa (per esempio Next.js, Nuxt o Astro) per vedere come offre queste opzioni.

I problemi più frequenti della SEO JavaScript

  • Contenuto critico presente solo tramite JS: se titolo, descrizione del prodotto, prezzo e testo principale non sono nell'HTML iniziale, sono a rischio.
  • File JS/CSS bloccati da robots.txt: il bot non riesce a eseguire correttamente la pagina. Non blocchi gli script importanti; per le regole consulti la nostra guida a robots.txt.
  • Navigazione che non usa link reali: gli elementi che funzionano solo con un evento di clic non sono link scansionabili.
  • Contenuto caricato con lo scorrimento o con il clic: Googlebot non scorre né clicca la pagina; il contenuto dietro il pulsante "mostra di più" potrebbe non essere visto.
  • Indirizzi basati su hash (#): una parte dopo il cancelletto (#/prodotti) non viene considerata una pagina diversa.
  • Contenuto caricato in ritardo o con errori: risposte API molto lente, timeout o errori di script lasciano il contenuto vuoto durante l'elaborazione.
  • Gestione errata dei meta tag: title, description e canonical non vengono generati correttamente per ogni pagina.

Link e struttura degli URL

Per scoprire i link Google guarda l'attributo href dell'elemento <a>. I due esempi seguenti producono lo stesso risultato visivo, ma solo il primo è scansionabile:

<!-- Scansionabile -->
<a href="https://hitbot.org/urunler/ayakkabi">Scarpe</a>

<!-- Non scansionabile: nessun href, solo un listener di evento -->
<span onclick="git('/urunler/ayakkabi')">Scarpe</span>

Nelle applicazioni a pagina singola (SPA), per il passaggio tra le pagine usi la History API del browser, creando per ogni vista un indirizzo reale e unico. Ogni indirizzo, anche quando viene aperto direttamente (ricaricamento o link condiviso), deve mostrare lo stesso contenuto. Per la logica generale dei link interni può consultare il nostro articolo sulla strategia di link interni.

Codici di stato, noindex e canonical

Nelle applicazioni JavaScript è l'argomento più trascurato:

  • Pagine di errore: un indirizzo inesistente, in una SPA, può mostrare la scritta "Pagina non trovata" e restituire HTTP 200. Questo è un soft 404. Faccia in modo che il server restituisca un vero 404 oppure aggiunga noindex nella vista di errore. Per i dettagli consulti il nostro articolo 404 e SEO.
  • Noindex e JavaScript: se l'HTML originale contiene noindex, Google può saltare l'elaborazione della pagina; in questo caso cercare di rimuovere il noindex con JavaScript non funziona. Nelle pagine che deve far indicizzare, l'HTML iniziale non deve contenere noindex.
  • Canonical: se possibile scriva il canonical nell'HTML iniziale. Può essere aggiunto con JavaScript, ma due canonical in conflitto (uno nell'HTML e un altro dallo script) confondono Google. Per la logica del canonical consulti la nostra guida al canonical.
  • Reindirizzamenti: preferisca il reindirizzamento HTTP lato server a quello JavaScript; le differenze le abbiamo spiegate nel nostro articolo su 301 e 302.

Verificare ciò che vede Google

  1. Confronti il sorgente: nel browser confronti "Visualizza sorgente pagina" (HTML grezzo) con la scheda Elements (DOM elaborato) degli strumenti per sviluppatori. Se il testo principale compare solo nella seconda, il contenuto dipende da JS.
  2. Ispezione URL: in Search Console controlli l'indirizzo, usi "Testa URL live" e, con "Visualizza pagina testata", esamini l'HTML elaborato da Google e lo screenshot.
  3. Test senza JavaScript: disattivi JavaScript nel browser e apra la pagina. Se non si vede nulla, anche il bot nella prima fase vedrà una pagina vuota.
  4. Risorse non caricate: nello strumento Ispezione URL verifichi se ci sono script o chiamate API bloccati o non caricabili.
  5. Controllo dell'indice: cerchi tra virgolette una frase della pagina con site:tuodominio.com (sostituisca con il proprio dominio) e verifichi se il contenuto è nell'indice.

Se le pagine non entrano nell'indice, può collegare gli stati di Search Console alla nostra guida ai problemi di indicizzazione per restringere la causa.

Checklist prima della pubblicazione

Se lavora con un team di sviluppo, faccia segnare ogni voce come "sì / no" prima di ogni pubblicazione importante:

  • Il titolo della pagina, il testo principale e l'immagine principale sono presenti nella prima risposta HTML?
  • Ogni pagina ha un title e una description unici e un tag canonical che indica il proprio indirizzo?
  • I menu e i link di paginazione sono veri <a href>?
  • Gli indirizzi inesistenti restituiscono un vero 404?
  • I file JS e CSS importanti non sono bloccati da robots.txt?
  • Con JavaScript disattivato la pagina mostra almeno il contenuto principale?
  • In caso di errore dello script o di lentezza dell'API, la pagina resta vuota oppure mostra un contenuto di riserva ragionevole?
  • Quando si aggiunge una nuova vista (route), entra nella sitemap?

Questa lista è utile sia per un sito nuovo sia per il rinnovo di grafica o infrastruttura di un sito esistente. Se il responsabile SEO condivide la lista all'inizio dello sviluppo, il costo di correzione si riduce molto; una volta presa la decisione architetturale, cambiare il metodo di rendering è la cosa più costosa.

Prestazioni e JavaScript

I pacchetti JavaScript pesanti gravano non solo sul bot ma anche sull'utente. Script di grandi dimensioni possono peggiorare il ritardo di interazione (INP) e il tempo di caricamento (LCP). Passaggi fondamentali sono lo code splitting, la rimozione del codice non utilizzato, la limitazione degli script di terze parti e il differimento degli script non critici. Per le metriche consulti la nostra guida ai Core Web Vitals, mentre per i lavori generali sulla velocità può consultare i metodi per aumentare la velocità della pagina. Per la spiegazione ufficiale di Google consulti la documentazione sulle basi della SEO JavaScript.

Domande frequenti

Google comprende JavaScript completamente?

In gran parte sì, lo esegue; ma l'elaborazione comporta una coda aggiuntiva e un ritardo. Presentare il contenuto critico nell'HTML iniziale è la strada più sicura.

React o Vue sono un problema per la SEO?

No. Il problema non è il framework, ma il modo in cui il contenuto viene servito. Con SSR o generazione statica la SEO con questi framework è solida.

Devo usare il rendering dinamico?

Google non lo raccomanda come soluzione a lungo termine. Per i nuovi progetti SSR o SSG sono una scelta più corretta.

Il lazy loading danneggia la SEO?

Se fatto bene, no. Usi il caricamento nativo del browser e non richieda un'interazione dell'utente per mostrare il contenuto; Googlebot non clicca né scorre.

Conclusione

Il cuore della SEO per JavaScript è questo: tutto ciò che desidera che Google veda deve essere accessibile nel momento in cui il bot visita la pagina. Presenti il contenuto nell'HTML iniziale, usi link reali e indirizzi reali, restituisca i codici di stato corretti, non blocchi gli script importanti e verifichi regolarmente la pagina elaborata con lo strumento Ispezione URL. Se inserisce queste abitudini nella sua checklist di SEO tecnica, la maggior parte dei problemi viene individuata prima della pubblicazione.

Mancano clic sulla Sua parola chiave?

HitBot genera sessioni reali che effettuano la ricerca sulla parola chiave di destinazione, trovano il Suo sito e lo cliccano. Il risultato si accumula in Search Console come impressioni e clic.

Altri articoli