Volver al Centro de conocimiento
Plataforma

Web Platform Tests y confianza en funciones del navegador

Combina Web Platform Tests, comprobaciones en tiempo de ejecución y aserciones de aplicación para evaluar funciones del navegador.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Plataforma?

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.

Una prueba web conduce a una comprobación de capacidad y a un resultado de aplicación

Web Platform Tests aporta evidencia de conformidad bajo condiciones declaradas, pero no garantiza que todo recorrido de una aplicación funcione. Combina la especificación, la prueba compartida, la comprobación local y la señal visible de la aplicación. No deduzcas identidad ni dispositivo de una capacidad. BotBrowser puede ofrecer un perfil controlado para ejecutar comprobaciones de capacidades; no puede cambiar cómo define un estándar una capacidad ni cómo la implementa otro navegador.

Resumen

  • Una prueba WPT que pasa demuestra un algoritmo bajo el origen, el harness y el momento declarados, no que un recorrido de producto termine.
  • Lee primero los metadatos: una entrada tentativa, inestable o marcada como fallo esperado es una pregunta sobre cobertura, y una prueba omitida por un origen inseguro o por falta de gesto del usuario no se convierte en una celda verde.
  • Mantén separados los cinco estados, missing, available, denied, failed y completed, porque un método presente no dice nada sobre un permiso concedido ni sobre un registro guardado en el servidor.
  • Prueba la mitad de la aplicación aparte: una respuesta 201 con cabecera Location, un anuncio dentro de un elemento con role="status" y aria-live="polite", y un control alternativo alcanzable por teclado.
  • Guarda en un mismo registro la ruta WPT, la sección de la especificación, la compilación del navegador, la versión del harness, la revisión del fixture y la fecha del resultado, y repite el subconjunto cuando cambie cualquiera de ellos.

Contenido

Elegir evidencia WPT

Consulta el repositorio WPT y la API testharness. Registra ruta, especificación, versión del navegador, origen, permisos y fecha. Una prueba omitida, tentativa o marcada como fallo esperado necesita una alternativa y una explicación.

Lee los metadatos junto al resultado. Una prueba local puede no representar un origen seguro, un gesto del usuario o una política de permisos. No copies fixtures sin revisar licencia, dependencias y limpieza. Superar la conformidad tampoco demuestra facilidad de uso; la guía sobre soporte de funciones frente a calidad trata esa evaluación de producto por separado.

Comprobación de capacidad

Comprueba el método que la operación necesita justo antes de usarlo. Separa ausente, disponible, denegado, fallido y completado. La presencia de una propiedad no demuestra permiso, servicio disponible ni escritura en servidor.

Conserva los datos introducidos y ofrece una operación alternativa accesible. Registra origen, contexto seguro, versión, estado detectado, alternativa y resultado visible sin recopilar propiedades ajenas.

Tabla de decisión

ObservaciónDecisiónResultado visibleLímite
WPT pasa en la matriz declaradaincluir candidatointentar tras detectar capacidadconformidad declarada
WPT omitida o tentativarevisar metadatosmantener alternativacobertura de pruebas
Método ausente o contexto bloqueadousar alternativaconservar tareacapacidad de la página
Llamada rechazadaclasificar una vezmostrar recuperacióncomportamiento del navegador
Llamada resueltaverificar aplicaciónconfirmar señal visiblenavegador y aplicación

Fixture de fallo

El fixture debe crear sus controles, simular solo la API propia, comprobar texto visible y eliminar nodos en todos los caminos. No modifiques una huella ni envíes credenciales.

async function probar() {
  const host = document.createElement('div');
  host.innerHTML = '<p id="estado"></p><button id="alternativa" hidden>Usar alternativa</button>';
  document.body.append(host);
  const estado = host.querySelector('#estado');
  const alternativa = host.querySelector('#alternativa');
  try {
    const disponible = typeof navigator.share === 'function';
    const resultado = disponible
      ? await navigator
          .share({ title: 'Elemento sintético', url: '/fixture' })
          .then(() => 'completado')
          .catch(() => 'fallido')
      : 'ausente';
    estado.textContent = resultado === 'completado' ? 'Completado' : 'Usa la alternativa';
    if (resultado !== 'completado') alternativa.hidden = false;
    console.assert(estado.textContent && (resultado === 'completado' || !alternativa.hidden));
    return { state: resultado, visible: estado.textContent };
  } finally {
    host.remove();
  }
}

Verificación de aplicación

Después de la llamada verifica el mensaje, el control actualizado o el registro que pertenece a la aplicación. Una promesa resuelta no prueba que el servidor haya guardado un registro. Separa ambos resultados y prueba foco, teclado, etiquetas y recuperación.

Repite la matriz cuando cambien navegador, especificación, contexto seguro, permisos o harness. Conserva ruta WPT, revisión, estado local, alternativa y fecha de revisión, sin contenido personal.

BotBrowser: alcance

BotBrowser puede ofrecer contextos controlados para recorridos autorizados inspirados en WPT y comprobaciones repetibles. Un contexto aislado separa almacenamiento mutable y permite comparar estados visibles en una versión declarada.

No certifica la suite WPT, concede permisos, vuelve seguro un origen, sustituye infraestructura de conformidad ni prueba una transacción de servidor. La documentación de aislamiento de BotBrowser demuestra repetibilidad, no compatibilidad universal.

Consulta también la guía de compatibilidad y alternativas de APIs y la guía de eventos WebDriver BiDi.

BotBrowser puede ejecutar comprobaciones repetibles en contextos autorizados inspirados en WPT, pero no garantiza la conformidad, no concede permisos ni sustituye una prueba de transacción. Mantén ambas afirmaciones en el registro.

La confianza mejora cuando cada capa tiene un responsable: especificación, prueba WPT, matriz de navegadores, aplicación y fixture. Registra ruta, versión, origen, estado, alternativa y resultado visible.

Usa evidencia negativa con honestidad. Un test omitido, un rechazo o un tiempo de espera necesita clasificación y no debe convertirse en un aprobado oculto. Conserva la alternativa hasta que la evidencia de la aplicación permita retirarla.

Conserva una ficha breve con ruta WPT, versión, contexto, estado, aserción visible y alternativa.

Compara la versión candidata con la anterior usando el mismo fixture y conserva el primer fallo significativo.

Indica responsable y fecha de revisión para cada excepción.

Nombra la alternativa visible para que soporte reproduzca el resultado.

Haz que el registro sea legible para quien no ejecutó el navegador y describe límite, resultado y siguiente acción.

La explicación evita convertir una prueba estrecha en una promesa universal.

Registra también la fecha y la persona responsable del siguiente control.

Ese traspaso mantiene actualizada la confianza del navegador.

El resultado debe conservar el límite entre conformidad y comportamiento de la aplicación.

No presentes un contexto controlado como garantía universal.

Fuentes

Conclusión práctica

Haz una pregunta por capa y anótala: qué algoritmo ejercita el archivo WPT, qué método alcanzó realmente la página, qué estado devolvió la comprobación de capacidad y qué resultado visible confirmó la aplicación. Cuando una fila de la tabla de decisión tiene respuesta en todas las capas, la nota de versión se sostiene; cuando falta una capa, la entrada honesta es no probado y no aprobado.

Ejecuta primero el fixture en una página sintética, con navigator.share simulado y un botón #fallback oculto, y conserva los console.assert que comprueban el texto visible y la alternativa a la vez. Después repite el mismo recorrido en el contexto controlado que acompaña a wpt run --channel dev --log-wptreport wptreport.json, para que la compilación del navegador quede junto a los recuentos de pass, skip y fail en lugar de una tabla copiada a mano.

Antes de la siguiente versión del navegador, repite el subconjunto declarado y compara los dos registros entrada por entrada. Cambia la entrada de un navegador solo cuando el responsable del recorrido afectado haya leído la diferencia, y mantén la alternativa hasta que la evidencia de la aplicación muestre que la ruta opcional funciona sin ella.

#Web Platform Tests#Compatibilidad#Conformidad#Detección#Pruebas

Este artículo forma parte de la guía: Superficies de la plataforma web: mapa de revisión

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.