Web Worker non disponibile? Diagnosi per piattaforma e ambiente
Sintomi che riscontri
In fondo a Any3D appare un avviso giallo: "Il browser attuale non supporta l'Web Worker". L'anteprima potrebbe comunque funzionare, ma l'elaborazione di file di grandi dimensioni può bloccare la pagina, e i percorsi Worker per la compressione delle texture e la conversione di immagini in modelli non possono essere attivati.
L'Web Worker permette ai calcoli intensivi di essere eseguiti in un thread in background. La compressione delle texture e parte dei processi di conversione di Any3D si basano sulla combinazione di Worker + OffscreenCanvas + createImageBitmap.
Cause comuni
| Causa | Scenari tipici |
|---|---|
| Contesto non sicuro | Apertura con file://, pagina su HTTP in rete interna (non localhost) |
| Browser obsoleto / WebView | Browser di sistema vecchie versioni, pagine integrate in app |
| Restrizioni CSP | iframe di portali aziendali, client zero-trust che inietta worker-src |
| Blocco da estensione | Plugin per la privacy che impedisce Worker o URL blob: |
| Anomalia nella cache di rete | Proxy/VPN che restituisce script Worker incompleti |
| Gestione del dispositivo | Profili di configurazione che disabilitano gli script in background |
Diagnosi per piattaforma
Windows
- Accedi obbligatoriamente tramite HTTPS (
https://any3d.cc), non utilizzare file HTML locali. - Criteri di group policy (GPO) di Edge: in
Computer Configuration → Administrative Templates → Microsoft Edgeverifica se vengono limitati i Worker o i cookie di terze parti (indirettamente influiscono sul caricamento di alcuni Worker). - Sicurezza famiglia di Windows: i limiti web imposti per i sottoutenti potrebbero causare la creazione fallita del Worker.
macOS
- Safari / Chrome richiedono entrambi macOS 12+ e una versione recente del browser.
- Tempo di utilizzo dello schermo → Contenuti e privacy → se sono attivate "Restrizioni per i siti per adulti" o filtri personalizzati, potrebbero bloccare accidentalmente i nomi di dominio degli script Worker.
- Se il profilo MDM aziendale disabilita capacità di script diverse dal "cross-site tracking", contatta l'IT.
Linux
- Verifica che l'URL di accesso sia HTTPS; i proxy Squid aziendali devono consentire le relative richieste
blob:eworker-src.
iOS / Android
- Non utilizzare il browser integrato in WeChat/DingTalk per l'elaborazione di file di grandi dimensioni; aprili con il browser di sistema.
- La modalità di risparmio energetico di iOS di solito non disabilita i Worker, ma vecchie versioni di WebKit potrebbero non supportare le API necessarie — mantieni il sistema aggiornato.
- Una versione obsoleta di Android WebView (WebView di sistema non aggiornato) può rendere il Worker non disponibile: aggiorna "Android System WebView" dal Play Store.
Rete, VPN e intranet aziendale
| Scenari | Descrizione |
|---|---|
| VPN aziendale | Alcune VPN forzano la decrittazione HTTPS e iniettano CSP; è necessario che l'IT autorizzi i Worker |
| Portallo SSO intranet in iframe | La CSP della pagina esterna potrebbe proibire worker-src blob:; è necessaria una configurazione separata nella pagina nidificata o aprire Any3D in una nuova scheda |
| Reverse proxy | Una configurazione errata di Nginx/gateway potrebbe causare un tipo MIME errato per gli script Worker |
| Filtraggio DNS su router parentali | Raro per i Worker, ma se l'intero sito viene declassato a uno specchio HTTP, i Worker smettono di funzionare |
Test autonomo: disconnettiti dalla VPN, passa a un hotspot 4G/5G e verifica se l'avviso scompare.
Riferimenti per CSP aziendali (per l'IT)
Se Any3D è incorporato in un iframe, si consente:
worker-src 'self' blob:;
script-src 'self' 'unsafe-eval' blob:;
Gli utenti privati non devono modificare manualmente la CSP.
Procedura di correzione passo-passo (generica)
- Verifica l'accesso tramite HTTPS e ricarica la pagina (Ctrl+F5 / Cmd+Shift+R).
- Utilizza una finestra di navigazione in incognito per escludere le estensioni.
- Aggiorna il browser e (su Android) il WebView di sistema.
- Apri Any3D direttamente in una nuova scheda, evitando l'incorporamento in iframe di portali aziendali.
Test rapido
typeof Worker !== "undefined"
Un valore di ritorno true indica solo la presenza dell'API; Any3D richiede anche OffscreenCanvas e createImageBitmap per percorrere l'intero percorso Worker.
Impatto dell'assenza di Worker
| Funzionalità | Impatto |
|---|---|
| Compressione dei vertici (Draco, ecc.) | Generalmente ancora disponibile (thread principale + WASM) |
| Compressione texture / KTX2 | Percorso Worker non disponibile, possibile blocco con file grandi |
| Conversione da immagine a modello | Potrebbe essere degradata o con prestazioni significativamente ridotte |
Riepilogo
Gli avvisi sull'Web Worker derivano spesso da mancanza di HTTPS, WebView obsolete, CSP/VPN aziendali, estensioni che bloccano. Aggiornando il browser per piattaforma, cambiando rete per verifica e facendo controllare iframe/CSP dall'IT, si può normalmente ripristinare la capacità di elaborazione in background.