Ce document explique pourquoi WebGPU peut être inopérant ou ne pas fonctionner comme prévu dans le navigateur Chrome, en indiquant clairement comment résoudre les problèmes dans la mesure du possible.
navigateurator.gpu non défini
L'exemple suivant présente une erreur JavaScript que vous pouvez rencontrer lorsque gpu
n'est pas disponible dans navigator
:
const adapter = await navigator.gpu.requestAdapter();
cancel Uncaught TypeError: Cannot read properties of undefined (reading 'requestAdapter')
L'une des raisons suivantes peut expliquer ce problème. Consultez-les dans cet ordre spécifique:
WebGPU nécessite Chrome 113 ou version ultérieure sous ChromeOS, macOS, Windows et Chrome 121 ou version ultérieure sur Android. Vérifiez votre version sur
chrome://version
et mettez-la à jour si nécessaire.WebGPU n'est actuellement pas accessible depuis un service worker ou un worker partagé. Si vous utilisez un service worker ou un worker partagé, déplacez votre code WebGPU vers un nœud de calcul dédié ou le contexte de fenêtre globale.
WebGPU n'est accessible que pour les contextes sécurisés. Si vous diffusez votre code via un protocole non sécurisé (par exemple,
http:
oufile:
), utilisez le protocole sécuriséhttps:
ou résolvez ce problème lors du développement de votre application Web de l'une des manières suivantes:Diffusez votre code localement sur
http://localhost
ouhttp://127.0.0.1
à l'aide de l'une des commandes suivantes:npx http-server
oupython3 -m http.server
.Ajoutez l'origine à la liste "Origines non sécurisées traitées comme sécurisées" de
chrome://flags/#unsafely-treat-insecure-origin-as-secure
, puis redémarrez Chrome.Installez Node.js et exécutez
npx servez --ssl
pour diffuser votre dossier via HTTPS avec un faux certificat. Un avertissement continuera de s'afficher dans Chrome. Vous pouvez contourner cette éventualité en cliquant sur "Paramètres avancés", puis sur "Continuer à".Exposez votre serveur Web local à Internet avec ngrok.
L'adaptateur GPU est nul
Voici un exemple d'erreur JavaScript que vous pouvez rencontrer lorsque l'adaptateur obtenu en appelant requestAdapter()
est nul:
const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice();
cancel Uncaught TypeError: Cannot read properties of undefined (reading requestDevice)
Cela peut se produire pour l'une des raisons suivantes. Consultez-les dans cet ordre spécifique:
WebGPU est désactivé lorsque l'utilisateur a désactivé l'option "Utiliser l'accélération graphique si disponible" dans
chrome://settings/system
. Vérifiez si ce paramètre est désactivé, puis réactivez-le.WebGPU n'est pas encore compatible avec cette plate-forme. Vous pouvez activer l'indicateur
chrome://flags/#enable-unsafe-webgpu
et redémarrer Chrome. Pour la prise en charge expérimentale de Linux, vous devez également activer l'indicateurchrome://flags/#enable-vulkan
. Pour en savoir plus, consultez Compatibilité de WebGPU dans Chrome sans interface graphique.Le matériel GPU a été spécifiquement ajouté à la liste de blocage. Si le message "WebGPU a été désactivé via la liste de blocage ou la ligne de commande" s'affiche dans
chrome://gpu
, vous pouvez désactiver la liste de blocage des adaptateurs WebGPU en activant l'indicateurchrome://flags/#enable-unsafe-webgpu
et en redémarrant Chrome.Il n'existe aucun adaptateur GPU correspondant pour les options transmises dans
requestAdapter()
. Essayez d'appelerrequestAdapter()
avec d'autres options.WebGPU nécessite un GPU (émulé matériel ou logiciel). Pour vérifier si Chrome détecte un GPU, accédez à
chrome://gpu
.
WebGPU est plus lent que WebGL
Ouvrez
chrome://gpu
et assurez-vous que vous pouvez lire "WebGPU: accélération matérielle". Si vous lisez "WebGPU: Logiciel uniquement, accélération matérielle indisponible", vous devrez peut-être mettre à jour les pilotes de votre GPU.La traduction directe des concepts WebGL en WebGPU ne permet peut-être pas de tirer pleinement parti des optimisations uniques de WebGPU. Consultez De WebGL à WebGPU pour en savoir plus sur leurs différences.
Limites propres à Windows
Tenez compte des limites suivantes lors de l'utilisation de WebGPU sur les appareils Windows:
Chrome ne permet pas d'utiliser plusieurs adaptateurs GPU simultanément. Consultez problème chromium:329211593.
Chrome utilise toujours le même adaptateur GPU que celui alloué pour les autres charges de travail Chrome. Pour les ordinateurs portables, il s'agit généralement de la carte graphique intégrée en raison de la consommation d'énergie (par exemple, économie d'énergie). Cela signifie que l'option
powerPreference
n'a aucune incidence lorsque vous appelezrequestAdapter()
.