Questo documento spiega perché WebGPU potrebbe non essere utilizzabile o non funzionare come previsto nel browser Chrome, con passaggi chiari per risolvere i problemi, ove possibile.
navigator.gpu non è definito
L'esempio seguente mostra un errore JavaScript che potresti ricevere quando gpu
non è disponibile in navigator
:
const adapter = await navigator.gpu.requestAdapter();
cancel Uncaught TypeError: Cannot read properties of undefined (reading 'requestAdapter')
Ciò potrebbe essere dovuto a uno dei seguenti motivi. Dai un'occhiata a questi contenuti in questo ordine specifico:
WebGPU richiede Chrome 113 o versioni successive su ChromeOS, macOS, Windows e Chrome 121 o versioni successive su Android. Controlla la versione all'indirizzo
chrome://version
e, se necessario, aggiornala.Al momento non è possibile accedere a WebGPU da un service worker o da un worker condiviso. Se utilizzi un service worker o un worker condiviso, sposta il codice WebGPU in un worker dedicato o nel contesto della finestra globale.
WebGPU è accessibile solo a contesti sicuri. Se pubblichi il codice tramite un protocollo non sicuro (ad esempio,
http:
,file:
), utilizza il protocollo sicurohttps:
o risolvi il problema durante lo sviluppo dell'app web in uno dei seguenti modi:Pubblica il tuo codice localmente su
http://localhost
ohttp://127.0.0.1
con uno di questi comandi:npx http-server
opython3 -m http.server
.Aggiungi l'origine all'elenco "Origini non sicure trattate come sicure" di
chrome://flags/#unsafely-treat-insecure-origin-as-secure
e riavvia Chrome.Installa Node.js ed esegui
npx servez --ssl
per gestire la cartella su https con un certificato falso. In Chrome riceverai ancora un avviso che puoi ignorare facendo clic su "Avanzate" e poi su "Procedi a...".Esposizione del server web locale su internet con ngrok.
L'adattatore GPU è nullo
Di seguito è riportato un esempio di errore JavaScript che potresti ricevere quando l'adattatore generato dalla chiamata a requestAdapter()
è nullo:
const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice();
cancel Uncaught TypeError: Cannot read properties of undefined (reading requestDevice)
Ciò si verifica per uno dei seguenti motivi. Dai un'occhiata a questi contenuti in questo ordine specifico:
La WebGPU è disattivata se l'utente ha disattivato l'opzione "Usa accelerazione grafica quando disponibile" in
chrome://settings/system
. Verifica se questa impostazione è disattivata e riattivalaWebGPU non è ancora supportato su questa piattaforma. Puoi attivare il flag
chrome://flags/#enable-unsafe-webgpu
e riavviare Chrome. Per il supporto sperimentale in Linux, devi attivare anche il flagchrome://flags/#enable-vulkan
. Per saperne di più, consulta Supporto WebGPU in Chrome headless.L'hardware GPU è stato specificamente inserito in una lista bloccata. Se in
chrome://gpu
viene visualizzato il messaggio "WebGPU è stato disattivato tramite la lista bloccata o la riga di comando", puoi disattivare la lista bloccata degli adattatori WebGPU attivando il flagchrome://flags/#enable-unsafe-webgpu
e riavviando Chrome.Non esiste un adattatore GPU corrispondente per le opzioni trasmesse in
requestAdapter()
. Prova a chiamare il numerorequestAdapter()
con opzioni diverse.WebGPU richiede una GPU (emulata hardware o software). Puoi verificare se Chrome rileva una GPU visitando
chrome://gpu
.
La WebGPU è più lenta di WebGL
Apri
chrome://gpu
e assicurati di poter leggere "WebGPU: accelerazione hardware". Se visualizzi il messaggio "WebGPU: solo software, accelerazione hardware non disponibile", potrebbe essere necessario aggiornare i driver GPU.La traduzione diretta dei concetti di WebGL in WebGPU potrebbe non sfruttare appieno le ottimizzazioni esclusive di WebGPU. Dai un'occhiata ad Da WebGL a WebGPU per conoscere alcune delle loro differenze.
Limitazioni specifiche di Windows
Tieni presente le seguenti limitazioni quando utilizzi WebGPU sui dispositivi Windows:
Chrome non supporta l'utilizzo di più adattatori GPU contemporaneamente. Vedi issue chromium:329211593.
Chrome utilizza sempre lo stesso adattatore GPU assegnato per altri carichi di lavoro di Chrome, che per i laptop è in genere la scheda grafica integrata, a causa dell'utilizzo della batteria (ad esempio, risparmio energetico). Significa che l'opzione
powerPreference
non ha alcun impatto sulla chiamata arequestAdapter()
.