Volver al Centro de conocimiento
Huella digital

Información del adaptador WebGPU y privacidad del usuario

Comprende qué representa un adaptador WebGPU, cuándo puede no estar disponible y cómo elegir alternativas gráficas sin crear un perfil del dispositivo.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Huella digital?

Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.

WebGPU permite que una aplicación solicite un adaptador gráfico capaz de ejecutar un dispositivo WebGPU. El adaptador marca una capacidad para una tarea, no una identidad. Su disponibilidad depende del navegador, el sistema operativo, la pila gráfica, las políticas y los recursos actuales. Una aplicación respetuosa con la privacidad pregunta solo lo necesario para elegir una experiencia y ofrece una alternativa clara si la solicitud falla. BotBrowser puede presentar de forma coherente la información del adaptador WebGPU de un perfil en un contexto controlado; no puede hacer que el hardware o el controlador subyacentes admitan funciones que no tienen.

Flujo de solicitud de adaptador WebGPU, dispositivo y alternativa accesible

TL;DR

  • navigator.gpu.requestAdapter() puede resolverse en null; es una rama de compatibilidad, no un fallo que haya que reportar.
  • Comprueba solo lo que el modo previsto necesita , adapter.features.has('timestamp-query'), adapter.limits.maxTextureDimension2D, en lugar de sondear todos los campos.
  • requestDevice({ requiredFeatures, requiredLimits }) falla cuando una función o límite pedido no está soportado, así que solicita el mínimo que exige el modo.
  • Mantén los datos de capacidad en la sesión: no copies los límites del adaptador a etiquetas de analítica, URL, registros de cuenta ni tickets de soporte.
  • Renderiza el contenido y los controles esenciales en HTML normal, con escena reducida, imagen estática o tabla de datos como alternativa documentada.

Contenido

Qué representa un adaptador

La especificación WebGPU del W3C describe el adaptador como un objeto que representa una implementación gráfica física o de software con la que se puede crear un dispositivo. La aplicación puede solicitar un adaptador y después un dispositivo con los límites y funciones necesarios. El navegador puede no devolver ningún adaptador, y una respuesta positiva no garantiza que el dispositivo se cree.

El adaptador no es un inventario del renderizador. Empieza por un objetivo visible, como una escena interactiva, una tarea de cálculo o un modo visual reducido. La referencia de WebGPU en MDN documenta la API pública, pero no promete compatibilidad universal. Para distinguir comprobaciones de capacidad y seguimiento, consulta la guía de capacidades y privacidad de WebGL.

Disponibilidad y límites de permiso

navigator.gpu solo aparece cuando el navegador implementa y permite WebGPU en el contexto actual. La solicitud de adaptador puede fallar o no producir resultado. La solicitud posterior del dispositivo también puede fallar si faltan funciones, límites o recursos. Son ramas normales de compatibilidad, no pruebas sobre una persona o una máquina única.

La especificación W3C define el contrato de la API y la documentación del navegador explica las restricciones de cada versión. No afirmes que WebGPU está disponible en todos los navegadores ni que siempre habrá un aviso o campos estables. Documenta el rango probado y conserva una ruta útil para contextos no compatibles.

Decisiones respetuosas con la privacidad

Usa la decisión mínima que seleccione la experiencia. Si basta saber si puede iniciarse el dispositivo, guarda ese resultado y si se aceptaron las funciones necesarias. No conserves una descripción completa del adaptador, no combines datos gráficos con datos de cuenta o red y no conviertas diferencias de capacidad en un identificador persistente. Una decisión de sesión suele bastar; una preferencia de calidad guardada debe ser una elección comprensible del usuario.

Los diagnósticos tienen otro propósito. Si soporte necesita más información, explica qué se recoge, limita el acceso y fija un plazo de conservación. No pidas por defecto un inventario del adaptador. La guía de privacidad entre superficies explica el impacto de combinar señales.

Alternativas y recuperación accesible

Mantén el contenido y los controles esenciales fuera de la superficie gráfica. Si falla el adaptador o el dispositivo, ofrece una escena reducida, una imagen, una tabla u otra representación que cumpla la misma tarea. Conserva filtros y entradas, informa del cambio y evita un lienzo vacío o reintentos infinitos.

Prueba el éxito, la ausencia de adaptador, el rechazo del dispositivo, el fallo de recursos y la pérdida posterior de contexto. El resultado esperado es una experiencia utilizable, no una explicación detallada del hardware. Usa HTML normal para nombres, estados, controles de teclado e información equivalente. La guía sobre fingerprinting de WebGPU trata el riesgo de seguimiento; aquí nos limitamos a decisiones normales de capacidad.

Planificar la solicitud según el resultado

Define quién es responsable de la llamada a navigator.gpu.requestAdapter() y qué resultado debe ver la persona. Un visor puede necesitar rotación y selección, pero hacer opcionales las sombras; una herramienta científica puede necesitar gráficos y etiquetas, mientras la animación es solo una mejora. Un efecto de vídeo puede requerir una textura concreta y aun así ofrecer una imagen fija si esa ruta no arranca. No inicialices WebGPU solo porque se cargó la página: espera a que se abra la función y conserva navegación, cuenta, compras, consentimiento y ayuda como HTML normal.

Trata la solicitud como una transacción breve de compatibilidad: prepara la interfaz, solicita el adaptador, comprueba únicamente las funciones y límites del modo previsto, solicita el dispositivo y comunica uno de pocos resultados: estándar, reducido, alternativa estática o no disponible con instrucciones de soporte. Si falta una función necesaria, explica la función visible que no está disponible y selecciona el modo inferior documentado. No sigas sondeando campos que no responden a una pregunta del producto ni mezcles este fallo con un recurso de red ausente.

Mantener los datos temporalmente

Define el ciclo de vida de los datos de capacidad. Puedes conservar adapter.limits.maxTextureDimension2D en memoria durante la visita, elegir el tamaño de la escena y descartarlo al terminar la sesión, sin escribir nada en el almacenamiento ni enviarlo a un servidor. Si alguien quiere recordar la calidad, guarda su elección explícita, por ejemplo “efectos reducidos”, y no la colección de hechos del adaptador. No copies objetos ni listas de funciones a analítica, cuentas, URL, capturas o tickets. Un evento de soporte puede indicar que la escena WebGPU estándar no se inicializó, junto con una fase redactada y la versión de la aplicación.

La capacidad gráfica no demuestra identidad, ubicación, ingresos, discapacidad, intención ni propiedad del dispositivo. No la combines con señales de cuenta, red, fuentes, almacenamiento o tiempo para crear un perfil. Revisa también motores y bibliotecas de observabilidad: averigua si envían detalles a un servidor, si el envío es necesario para renderizar y cuánto se conservan. La telemetría opcional debe poder desactivarse sin romper el flujo principal.

Tratar fallos como producto

El siguiente ejemplo solo comprueba que puede iniciarse la ruta del dispositivo WebGPU. No crea una carga de renderizado ni lee información gráfica. Sustituye los dos bloques de contenido por las vistas reales; startGraphics acepta un objeto de prueba para verificar el adaptador nulo en cualquier equipo.

<p id="graphics-status" role="status" aria-live="polite">Preparando gráficos…</p>
<section id="gpu-view" hidden>La ruta WebGPU está lista; este ejemplo no dibuja nada.</section>
<section id="html-view">El contenido y los controles estándar siguen 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 = 'Los gráficos mejorados no están disponibles. El contenido estándar está listo.';
  }
  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 = 'La ruta del dispositivo WebGPU está lista.';
      device.lost.then(showFallback);
    } catch {
      showFallback();
    }
  }
  void startGraphics();
  // Fixture: la vista HTML debe seguir visible y no debe haber reintento automático.
  // void startGraphics({ requestAdapter: async () => null });
</script>

El fixture comentado fuerza que requestAdapter() devuelva null; descoméntalo en lugar de la llamada normal para comprobar la alternativa. Una promesa rechazada del adaptador o del dispositivo llega al mismo estado. Conserva filtros, selecciones y trabajo sin guardar fuera del dispositivo GPU.

ObservaciónResultado para la personaConservar para la tarea actual
Falta navigator.gpuMantener disponible la experiencia HTMLNingún dato del adaptador
La solicitud devuelve null o se rechazaUsar la alternativa estática o reducida documentadaComo máximo el modo elegido en memoria
Se rechaza la solicitud del dispositivoMantener el estado y mostrar la misma alternativaLa fase del fallo solo si soporte la necesita
Se pierde un dispositivo creadoVolver a la alternativa y ofrecer un reintento deliberadoNingún objeto de adaptador o dispositivo
Se crea el dispositivoIniciar solo la carga solicitadaDescartar la referencia al adaptador cuando ya no haga falta

Prueba API ausente, adaptador nulo o rechazado, dispositivo rechazado y pérdida del dispositivo. Comprueba una función opcional solo si el trabajo real la necesita; no enumeres funciones para clasificar el entorno. El criterio es un estado utilizable, no una explicación detallada del hardware. Usa el objeto inyectado y afirma el estado visible y la alternativa, no valores específicos del navegador.

Cada estado necesita accesibilidad. Da a la imagen un nombre que describa su propósito, conserva instrucciones, precios, texto legal, estado y valores importantes en HTML, y ofrece reinicio, pausa, selección y alternativa como controles con foco de teclado. Respeta la preferencia de reducir movimiento y ofrece una vista estable. La alternativa debe reflejar los mismos filtros y datos; dos representaciones discordantes son un error de corrección.

Limita la recuperación: un solo reintento puede tener sentido después de una pérdida transitoria, pero los reintentos repetidos hacen esperar y llenan los registros. Tras agotar el límite, explica que se usa la vista sencilla y deja activa la página. Documenta el rango de navegadores probado, la generación WebGPU, las funciones de cada modo, la alternativa y su responsable. Los cambios del navegador son observaciones de compatibilidad, no permiso para crear campos de perfil persistentes.

Los trabajos de cálculo siguen la misma disciplina: define el resultado, el tiempo aceptable y la representación sin GPU antes de solicitar el adaptador. Asigna responsables a requisitos, accesibilidad, retención y divulgación. Si una cache o un service worker recuerda la elección, declara propósito y caducidad, y permite recalcular tras borrar datos. Respeta políticas administradas y explica por separado los errores de red de los gráficos.

Conserva solo eventos operativos con responsable actual: modo, fase, versión aproximada y marca temporal normal. Elimina objetos del adaptador, listas completas, identificadores de cuenta y señales ajenas. Diseña la alternativa durante la revisión, con la misma jerarquía, etiquetas y acciones; si la vista lleva un resultado o acción, repítelo en texto o con un control nombrado. Cuando la mejora sea opcional, deja que la persona la abra deliberadamente y pueda volver a la página estándar.

Antes de publicar, contrasta las afirmaciones con W3C y MDN. El contrato de la API no garantiza el resultado en todo navegador, sistema o política. Mantén las promesas más estrechas que la evidencia y registra fecha, rango probado, resultado visible y responsable. Al retirar una función, elimina juntos comprobaciones, decisiones almacenadas, campos analíticos y documentación.

La aplicación debe preparar el estado visible antes de tocar la API.

Una decisión de capacidad no es una autorización para identificar el equipo.

La ausencia del adaptador puede depender del contexto actual.

Un dispositivo creado puede perderse aunque la solicitud inicial haya funcionado.

La vista alternativa debe poder usarse con teclado y lector de pantalla.

Un mensaje breve orienta mejor que una lista de límites técnicos.

Los requisitos de la escena deben mantenerse junto con su modo alternativo.

Las funciones opcionales no deben convertirse en requisitos silenciosos.

La telemetría requiere una finalidad concreta y un acceso limitado.

Los datos temporales no deben convertirse en etiquetas de cuenta.

Una política del administrador puede explicar una ausencia sin revelar el entorno completo.

El borrado de datos del sitio debe permitir una nueva decisión limpia.

Un recurso remoto puede fallar aunque el adaptador local esté listo.

Registra solo la etapa necesaria para responder una pregunta de soporte.

La revisión de accesibilidad incluye también el estado de error.

El límite de reintentos evita esperas y diagnósticos repetidos.

La documentación debe distinguir comportamiento probado de garantía del producto.

El propietario de la alternativa debe revisar cambios de navegador.

BotBrowser permite usar los modos WebGPU de perfil, real o desactivado para alinear el comportamiento del adaptador con el perfil elegido, pero no garantiza que WebGPU esté disponible ni que sus capacidades sean idénticas en todos los backends y hosts.

Fuentes

Conclusión práctica

Publica cuatro resultados con dueño , modo estándar, modo reducido, alternativa estática y no disponible con guía, y haz que cada uno sea alcanzable en una prueba sin una GPU concreta. Trata la pérdida del dispositivo (motivo destroyed o unknown) como un estado recuperable que deja la vista HTML utilizable, no como un callejón sin salida.

Anota la versión del navegador, la ruta gráfica del host y el perfil con cada fila aceptada, y vuelve a medir tras cambiar el controlador, el navegador o la imagen del host. Un modo que arranca en una máquina es evidencia de esa fila, no una promesa para otro host.

#WebGPU#Adaptador#Privacidad#Capacidades#Alternativas

Este artículo forma parte de la guía: ¿Qué es la huella digital del navegador?

Ejecuta la misma comprobación en BotBrowser

Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.