Retour au Centre de connaissances
Empreinte

Informations de l’adaptateur WebGPU et vie privée

Comprendre ce que représente un adaptateur WebGPU, quand il peut être indisponible et comment choisir un repli graphique sans profiler l’appareil.

BotBrowser Team

Documentation

Vous voulez la documentation structurée pour Empreinte ?

Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.

WebGPU permet à une application de demander un adaptateur graphique capable d’exécuter un appareil WebGPU. L’adaptateur décrit une capacité utile à une tâche, pas une identité. Sa disponibilité dépend du navigateur, du système, de la pile graphique, des règles et des ressources. Une application respectueuse de la vie privée ne demande que ce qui suffit à choisir une expérience et prévoit un repli clair en cas d’échec. BotBrowser peut présenter de façon cohérente les informations d’adaptateur WebGPU d’un profil dans un contexte contrôlé ; il ne peut pas faire prendre en charge au matériel ou au pilote sous-jacent des fonctions qu’il n’a pas.

Flux de demande d’adaptateur WebGPU, création d’appareil et repli accessible

TL;DR

  • navigator.gpu.requestAdapter() peut renvoyer null ; c’est une branche de compatibilité, pas une panne à signaler.
  • Ne vérifiez que ce que le mode prévu exige, adapter.features.has('timestamp-query'), adapter.limits.maxTextureDimension2D, au lieu de sonder tous les champs.
  • requestDevice({ requiredFeatures, requiredLimits }) échoue si une fonction ou limite demandée n’est pas prise en charge : demandez donc le minimum requis par le mode.
  • Gardez les données de capacité locales à la session : ne recopiez pas les limites de l’adaptateur dans des libellés d’analytique, des URL, des dossiers de compte ou des tickets de support.
  • Rendez le contenu et les contrôles essentiels en HTML ordinaire, avec scène réduite, image statique ou tableau de données comme repli documenté.

Sommaire

Ce que représente un adaptateur

La spécification WebGPU du W3C décrit l’adaptateur comme un objet représentant une implémentation graphique physique ou logicielle permettant de créer un appareil. L’application peut demander un adaptateur puis un appareil avec les limites et fonctions nécessaires. Le navigateur peut ne renvoyer aucun adaptateur, et une réponse positive ne garantit pas la création de l’appareil.

L’adaptateur n’est pas un inventaire du moteur de rendu. Commencez par un objectif visible, comme une scène interactive, un calcul ou un mode visuel réduit. La référence WebGPU de MDN documente l’API publique sans garantir une prise en charge universelle. La guide WebGL sur les capacités et la vie privée distingue les contrôles de capacité du suivi.

Disponibilité et limites d’autorisation

navigator.gpu n’est exposé que lorsque le navigateur implémente et autorise WebGPU dans le contexte courant. La demande d’adaptateur peut échouer ou ne rien renvoyer. La demande d’appareil peut ensuite échouer si des fonctions, limites ou ressources manquent. Ce sont des branches normales de compatibilité, pas des preuves sur une personne ou une machine particulière.

La spécification W3C définit le contrat de l’API ; la documentation du navigateur explique les restrictions propres aux versions. N’affirmez pas que WebGPU est disponible partout et ne promettez pas une invite ou des champs stables. Documentez la plage testée et gardez un parcours utile pour les contextes non pris en charge.

Décisions respectueuses de la vie privée

Utilisez la décision minimale qui choisit l’expérience. S’il suffit de savoir si l’appareil peut démarrer, conservez ce résultat et l’acceptation des fonctions requises. Ne retenez pas une description complète de l’adaptateur, ne combinez pas les données graphiques avec celles du compte ou du réseau et ne transformez pas les différences en identifiant persistant. Une décision de session suffit souvent ; une préférence de qualité mémorisée doit être un choix explicite de l’utilisateur.

Les diagnostics ont un but distinct. Si le support a besoin d’informations supplémentaires, expliquez la collecte, limitez l’accès et fixez une durée de conservation. Ne demandez pas par défaut un inventaire de l’adaptateur. Le guide de vie privée entre surfaces décrit l’impact de la combinaison de signaux.

Repli et récupération accessible

Gardez le contenu et les commandes essentielles hors de la surface graphique. Si l’adaptateur ou l’appareil échoue, proposez une scène réduite, une image, un tableau ou une autre représentation qui accomplit la même tâche. Conservez les filtres et les saisies, expliquez le changement et évitez une toile vide ou des tentatives infinies.

Testez le succès, l’absence d’adaptateur, le refus de l’appareil, une panne de ressources et une perte ultérieure du contexte. Le résultat attendu est une expérience utilisable, pas une description détaillée du matériel. Utilisez le HTML pour les noms, états, commandes clavier et informations équivalentes. Le guide du fingerprinting WebGPU traite le suivi ; le propos reste centré sur les décisions normales de capacité.

Planifier la demande selon le résultat

Définissez qui est responsable de l’appel à navigator.gpu.requestAdapter() et quel résultat la personne doit voir. Un visualiseur peut exiger rotation et sélection mais rendre les ombres optionnelles ; un outil scientifique peut exiger graphique et libellés, l’animation restant un enrichissement. Un effet vidéo peut demander une texture précise tout en offrant une image fixe si cette voie ne démarre pas. N’initialisez pas WebGPU au simple chargement : attendez l’ouverture de la fonction et gardez navigation, compte, achat, consentement et aide en HTML ordinaire.

Traitez la demande comme une transaction de compatibilité courte : préparez l’interface, demandez l’adaptateur, vérifiez seulement les fonctions et limites du mode prévu, demandez l’appareil puis annoncez un petit nombre d’états : standard, réduit, statique ou indisponible avec aide. Si une fonction requise manque, expliquez la fonction visible indisponible et choisissez le mode inférieur documenté. Ne sondez pas des champs sans question produit et séparez ce cas d’une ressource réseau manquante.

Garder les données temporairement

Définissez le cycle de vie des capacités. Gardez adapter.limits.maxTextureDimension2D en mémoire pour la visite, choisissez la taille de la scène puis supprimez la valeur à la fin de la session, sans l’écrire dans le stockage ni l’envoyer à un serveur. Si l’utilisateur souhaite mémoriser la qualité, enregistrez son choix explicite, comme « effets réduits », plutôt que les faits de l’adaptateur. Ne copiez pas objets ou listes détaillées dans l’analytique, les comptes, les URL, les captures ou les tickets. Un événement de support peut dire que la scène WebGPU standard n’a pas démarré, avec une étape et une version expurgées.

La capacité graphique ne prouve ni identité, lieu, revenu, handicap, intention ni propriété de l’appareil. Ne la combinez pas avec des signaux de compte, réseau, polices, stockage ou temps pour profiler. Vérifiez aussi les moteurs et bibliothèques d’observabilité : envoient-ils des détails à distance, ce transfert est-il requis pour rendre, combien de temps sont-ils conservés ? Le chemin principal doit rester disponible lorsque la télémétrie optionnelle est désactivée.

Traiter les échecs comme un produit

Cet exemple vérifie seulement le démarrage du chemin appareil WebGPU. Il ne crée pas de rendu et ne lit aucune sortie graphique. Remplacez les deux blocs par les vues réelles ; startGraphics accepte un double de test pour exercer le cas adaptateur nul sur toute machine.

<p id="graphics-status" role="status" aria-live="polite">Préparation des graphiques…</p>
<section id="gpu-view" hidden>Le chemin WebGPU est prêt ; cet exemple ne dessine rien.</section>
<section id="html-view">Le contenu et les commandes standard restent disponibles.</section>
<script>
  const status = document.querySelector('#graphics-status');
  const gpuView = document.querySelector('#gpu-view');
  const htmlView = document.querySelector('#html-view');
  function showFallback() {
    gpuView.hidden = true;
    htmlView.hidden = false;
    status.textContent = 'Les graphiques améliorés sont indisponibles. Le contenu standard est prêt.';
  }
  async function startGraphics(gpu = navigator.gpu) {
    try {
      if (!gpu) throw new Error('unavailable');
      const adapter = await gpu.requestAdapter();
      if (!adapter) throw new Error('unavailable');
      const device = await adapter.requestDevice();
      gpuView.hidden = false;
      htmlView.hidden = true;
      status.textContent = 'Le chemin appareil WebGPU est prêt.';
      device.lost.then(showFallback);
    } catch {
      showFallback();
    }
  }
  void startGraphics();
  // Fixture : la vue HTML reste visible et aucun nouvel essai ne démarre.
  // void startGraphics({ requestAdapter: async () => null });
</script>

Le fixture commenté force requestAdapter() à renvoyer null ; décommentez-le à la place de l’appel normal. Un rejet de l’adaptateur ou de l’appareil rejoint le même repli. Gardez filtres, sélections et travail non enregistré hors de l’appareil GPU.

ObservationRésultat utilisateurConserver pour la tâche actuelle
navigator.gpu absentGarder l’expérience HTML standardAucune donnée d’adaptateur
Demande null ou rejetéeUtiliser l’alternative statique ou réduite documentéeAu plus le mode choisi en mémoire
Demande d’appareil rejetéePréserver l’état et montrer le même repliL’étape seulement si le support en a besoin
Appareil créé puis perduRevenir au repli et proposer un nouvel essai expliciteAucun objet adaptateur ou appareil
Création réussieDémarrer uniquement la charge demandéeJeter la référence à l’adaptateur devenue inutile

Testez API absente, adaptateur nul ou rejeté, appareil rejeté et perte de l’appareil. Testez une fonction optionnelle seulement si la tâche la requiert ; n’énumérez pas les fonctions pour classer l’environnement. Le critère est un état utilisable, pas une explication détaillée du matériel. Injectez gpu et vérifiez l’état visible plutôt que des valeurs propres au navigateur.

Chaque état doit être accessible : nommez la vue par son objectif, gardez instructions, prix, mentions légales, statut et valeurs importantes en HTML, et rendez réinitialisation, pause, sélection et repli accessibles au clavier. Respectez la préférence de réduction des mouvements et fournissez une vue stable. Le repli doit partager les mêmes filtres et données ; deux représentations contradictoires restent un défaut.

Limitez la récupération. Un essai peut être pertinent après une perte transitoire, mais les répétitions font attendre et bruitent les journaux. Après la limite, expliquez que la vue simple est utilisée et laissez le reste de la page actif. Documentez navigateurs testés, génération WebGPU, fonctions de chaque mode, repli et responsable. Une nouvelle version du navigateur est une observation de compatibilité, pas un motif pour créer un profil durable.

Les calculs suivent la même règle : définissez le résultat, l’attente acceptable et la représentation sans GPU avant de demander l’adaptateur. Attribuez les contrôles de fonctions, l’accessibilité, la conservation et la divulgation à des responsables. Donnez un but et une expiration à toute préférence mémorisée par cache ou service worker ; après effacement des données, recalculez normalement. Respectez les politiques gérées et distinguez les erreurs réseau.

Ne conservez que des événements opérationnels dont un responsable a encore besoin : mode, étape, version grossière et horodatage selon la politique habituelle. Excluez objets, tableaux complets, identifiants de compte et signaux étrangers. Concevez le repli lors de la revue, avec la même hiérarchie, les mêmes libellés et les mêmes actions. Pour une amélioration facultative, laissez l’utilisateur ouvrir la vue enrichie et revenir facilement à la page standard.

Avant publication, confrontez les affirmations aux spécifications W3C et à MDN. Le contrat API ne garantit pas le résultat sur chaque navigateur, système ou politique. Gardez les garanties plus étroites que les preuves et notez date, plage testée, résultat visible et responsable. Lorsqu’une fonction disparaît, retirez ensemble contrôles, caches, champs analytiques et consignes de support.

L’interface doit préparer son état visible avant tout appel à l’API.

Une décision de capacité n’autorise pas l’identification de la machine.

L’absence de l’adaptateur peut dépendre du contexte courant.

Un appareil créé peut être perdu après une demande pourtant réussie.

Le repli doit rester utilisable au clavier et avec un lecteur d’écran.

Un message bref aide davantage qu’une liste de limites techniques.

Les exigences de la scène doivent rester liées à leur mode alternatif.

Les fonctions facultatives ne doivent pas devenir des exigences silencieuses.

La télémétrie demande un but explicite et un accès restreint.

Des données temporaires ne doivent pas devenir des étiquettes de compte.

Une politique d’administration peut expliquer l’absence sans exposer l’environnement.

L’effacement des données doit permettre une nouvelle décision normale.

Une ressource distante peut échouer même si l’adaptateur local est prêt.

N’enregistrez que l’étape nécessaire pour répondre à une question de support.

La revue d’accessibilité couvre aussi l’état d’erreur.

La limite d’essais évite attentes et diagnostics répétés.

La documentation distingue le comportement testé de la garantie produit.

Le responsable du repli doit revoir les changements de navigateur.

BotBrowser permet d’utiliser les modes WebGPU profil, réel ou désactivé pour aligner le comportement de l’adaptateur sur le profil choisi, mais BotBrowser ne garantit pas la disponibilité de WebGPU ni des capacités identiques sur tous les backends et hôtes.

Sources

Conclusion pratique

Livrez quatre résultats identifiés (mode standard, mode réduit, alternative statique et indisponible avec consignes) et rendez chacun atteignable dans un test sans GPU particulier. Traitez la perte de l’appareil (raison destroyed ou unknown) comme un état récupérable qui laisse la vue HTML utilisable, et non comme une impasse.

Consignez la version du navigateur, le chemin graphique de l’hôte et le profil avec chaque ligne acceptée, puis remesurez après un changement de pilote, de navigateur ou d’image hôte. Un mode qui démarre sur une machine est une preuve pour cette ligne, pas une promesse pour un autre hôte.

#WebGPU#Adaptateur#Vie Privée#Capacités#Repli

Cet article fait partie du guide : Qu'est-ce qu'une empreinte de navigateur ?

Exécutez la même vérification dans BotBrowser

Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.