Come ispezionare la console del browser per individuare gli errori di SeaText AI

Risposta rapida

Premi F12 (oppure Cmd+Option+I su Mac) per aprire gli Strumenti per sviluppatori. Fai clic sulla scheda Console. Gli errori vengono visualizzati in rosso e spesso includono l'URL dello script o un messaggio come "Failed to load resource." Passa alla scheda Network, ricarica la pagina e filtra per "seatext" per verificare se la richiesta dello snippet è riuscita (stato 200) o non è riuscita (4xx/5xx).

Perché la console è importante per SeaText AI

SeaText AI viene eseguito come snippet JavaScript incorporato nella pagina. Lo snippet viene caricato in modo asincrono per evitare di bloccare il rendering della pagina, come indicato nella guida all'integrazione SPA. Se lo snippet non viene caricato, viene eseguito con un errore di sintassi o incontra una restrizione cross-origin, gli agenti AI (traduzione, CRO, abbinamento Google Ads, protezione dai bot) non possono attivarsi. La console del browser è il primo punto in cui emergono questi problemi, perché registra sia gli errori di rete sia gli errori di runtime JavaScript.

Lo snippet memorizza inoltre un identificatore nell'archiviazione locale. Se il browser o un iframe blocca l'archiviazione locale, lo script genera un errore di sicurezza che viene visualizzato nella console. Comprendere questi meccanismi aiuta a distinguere tra un problema di rete, un errore dello script o un problema causato dalle policy del browser.

Prerequisiti prima di iniziare

• Una pagina in cui è stato aggiunto lo snippet di SeaText. Sono disponibili guide all'installazione per WordPress, Shopify, React, Vue, Angular e HTML personalizzato.
• Un browser con gli Strumenti per sviluppatori: Chrome, Firefox, Safari o Edge.
• L'autorizzazione ad accedere all'archiviazione locale: lo snippet vi memorizza un ID.
• Se esegui una Single Page Application (SPA), devi conoscere il file del punto di ingresso (index.html, main.tsx, ecc.) in cui è stato inserito lo snippet.
• Per i test su dispositivi mobili, un cavo USB e il debug USB abilitato (Android) o Web Inspector (iOS).

Procedura dettagliata: Chrome / Edge / Brave (Chromium)

1. Apri la pagina che vuoi testare.
2. Premi F12 oppure fai clic con il pulsante destro del mouse → Ispeziona.
3. Seleziona la scheda Console.
4. Cerca le righe rosse contenenti "seatext", "SEATEXT" o il dominio dello snippet.
5. Fai clic sulla scheda Network, seleziona Disabilita cache e ricarica la pagina (Ctrl+R / Cmd+R).
6. Digita "seatext" nella casella di filtro. Verifica che la richiesta dello snippet restituisca 200 OK e che la risposta sia JavaScript.
7. Se necessario, abilita Conserva registro per mantenere gli errori durante la navigazione.

Procedura dettagliata: Firefox

1. Premi F12 oppure Ctrl+Shift+K.
2. Seleziona il pannello Console.
3. Gli errori vengono visualizzati in rosso con un'icona a forma di croce. Filtra digitando "seatext" nella casella di ricerca.
4. Apri la scheda Network, ricarica la pagina e filtra per l'URL dello snippet.
5. Controlla il corpo della risposta per confermare che si tratti di JavaScript valido.

Procedura dettagliata: Safari (macOS)

1. Abilita il menu Sviluppo: Safari → Impostazioni → Avanzate → Mostra il menu Sviluppo nella barra dei menu.
2. Premi Cmd+Option+I oppure seleziona Sviluppo → Mostra Inspector Web.
3. Fai clic su Console. Gli errori vengono visualizzati in rosso.
4. Usa la scheda Network per confermare che lo snippet sia stato caricato con stato 200.
5. Se esegui il test su iOS, collega il dispositivo, abilita Web Inspector in Impostazioni → Safari → Avanzate, quindi seleziona il dispositivo dal menu Sviluppo sul Mac.

Procedura dettagliata: browser mobili (debug remoto)

I browser mobili non dispongono del tasto F12. Usa invece il debug remoto.

1. Android (Chrome): abilita il debug USB nelle Opzioni sviluppatore. Collega il telefono al computer. Apri Chrome sul computer, vai a chrome://inspect, trova il dispositivo e fai clic su Ispeziona nella scheda desiderata.
2. iOS (Safari): abilita Web Inspector su iOS (Impostazioni → Safari → Avanzate). Collega il dispositivo al Mac. Apri Safari sul Mac, vai al menu Sviluppo e seleziona il dispositivo e la scheda aperta.
3. Una volta collegato il dispositivo, usa le schede Console e Network degli Strumenti per sviluppatori sul computer esattamente come su un computer desktop.

Come si presentano in genere gli errori di SeaText AI

In base alla documentazione di integrazione e ai comportamenti comuni dei browser, i messaggi tipici della console includono:

• Errore di rete: "Failed to load resource: net::ERR_CONNECTION_REFUSED" oppure 404/500 per l'URL dello snippet. Ciò significa che lo script non è stato scaricato.
• Blocco cross-origin: "Blocked by CORS policy" quando la SPA fornisce lo snippet da un dominio diverso senza gli header Access-Control-Allow-Origin appropriati.
• Archiviazione locale negata: "SecurityError: Failed to read the 'localStorage' property" se il browser o l'iframe blocca l'archiviazione. La guida SPA avverte esplicitamente di questo problema.
• Errore di esecuzione dello script: "Uncaught SyntaxError" o "Uncaught TypeError" proveniente dallo script di SeaText: spesso è un segnale che lo snippet è stato troncato o modificato durante l'inserimento.
• Violazione della Content Security Policy: "Refused to load the script because it violates the following Content Security Policy directive": richiede modifiche agli header del server.

Errore comune: controllare solo la Console

La Console mostra gli errori di runtime JavaScript, ma un errore di rete silenzioso (quando lo script non è mai stato scaricato) potrebbe non lasciare alcuna riga rossa nella Console. Associa sempre l'ispezione della Console al controllo della scheda Network dopo il ricaricamento. La scheda Network mostra i codici di stato HTTP, le dimensioni della risposta e i tempi, informazioni che la Console non può visualizzare.

Passaggio di verifica dopo una correzione

1. Svuota la Console (Ctrl+L / Cmd+K).
2. Ricarica la pagina.
3. Conferma che non compaiano nuovi errori rossi.
4. Nella scheda Network, verifica che la richiesta dello snippet restituisca 200 e che la dimensione della risposta sia < 0 byte.
5. Attiva una funzionalità di SeaText (ad esempio, cambia lingua o fai clic su una variante) e controlla la presenza di nuovi errori.

Limitazioni e casi in cui questo approccio non è applicabile

• Gli errori di rendering lato server (ad esempio getServerSideProps di Next.js) non raggiungono mai la console del browser.
• Se lo snippet viene caricato all'interno di un <iframe sandbox> con sandbox e senza allow-scripts, la console potrebbe non mostrare nulla mentre lo script viene bloccato silenziosamente.
• Le violazioni della Content Security Policy (CSP) vengono visualizzate nella Console, ma richiedono modifiche agli header del server, non modifiche allo snippet.
• Browser mobili: usa il debug remoto descritto sopra perché sul dispositivo F12 non è disponibile.
• Gli errori che si verificano prima del caricamento dello snippet (ad esempio nel tuo codice di bootstrap) possono nascondere gli errori di SeaText.

Avanzate: usare i filtri della console e conservare i registri

Chrome ed Edge consentono di filtrare la Console digitando "seatext" nella casella di filtro. Firefox dispone di un campo di ricerca nella barra degli strumenti della Console. Abilita Conserva registro (Chrome) o Mantieni i registri (Firefox) per conservare gli errori durante la navigazione tra le pagine, una funzione essenziale per le SPA in cui i cambi di route non attivano ricaricamenti completi. Puoi anche fare clic con il pulsante destro del mouse su un messaggio della Console e scegliere Memorizza come variabile globale per esaminare in dettaglio l'oggetto dell'errore.

Informazioni chiave

FAQ

Cosa succede se la Console è pulita ma le funzionalità di SeaText continuano a non funzionare?

Controlla nella scheda Network la presenza di una risposta 200 con un corpo dello script vuoto o non valido. Verifica inoltre che la pagina non abbia rimosso lo snippet tramite una direttiva CSP script-src.

Posso filtrare i messaggi della Console per visualizzare solo SeaText?

Sì. In Chrome/Edge, digita "seatext" nella casella di filtro della Console. In Firefox, usa il campo di ricerca nella barra degli strumenti della Console.

L'attributo async nasconde gli errori?

No. async controlla solo quando lo script viene scaricato ed eseguito. Gli errori continuano a comparire nella Console una volta eseguito lo script.

Cosa succede se visualizzo un errore CORS?

Il server deve inviare gli header Access-Control-Allow-Origin per il dominio dello snippet oppure ospitare lo snippet sulla stessa origine.

Come posso eseguire un test su un dispositivo mobile?

Collega il telefono tramite USB, abilita il debug USB (Android) o Web Inspector (iOS) e usa l'istanza degli Strumenti per sviluppatori sul computer per ispezionare le schede Console e Network della pagina mobile.

Esiste un elenco di codici di errore specifici di SeaText?

Non è stato pubblicato. Considera qualsiasi riga rossa della Console che faccia riferimento all'URL dello script di SeaText o ai nomi delle variabili come un errore di SeaText e condividi l'intero stack trace con l'assistenza.

Perché lo snippet usa l'archiviazione locale?

La guida all'integrazione SPA afferma che lo script memorizza un ID nell'archiviazione locale per mantenere la continuità della sessione tra le visualizzazioni di pagina nelle applicazioni a pagina singola.

Una Content Security Policy può bloccare silenziosamente lo snippet?

Sì. Una direttiva CSP script-src che omette l'origine dello snippet ne bloccherà l'esecuzione. L'errore viene visualizzato nella Console come violazione CSP.