Calidad de la evidencia y los informes de pruebas del navegador
Escribe informes de pruebas del navegador que separen el comportamiento esperado, la evidencia observada, la incertidumbre, los límites de privacidad y la acción del producto.
BotBrowser Team
Quieres la documentación estructurada de Primeros pasos?
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.
La evidencia de una prueba del navegador es útil cuando otra persona puede entender qué se esperaba, qué ocurrió y qué decisión sigue. El informe debe describir un contexto declarado de la aplicación, no sugerir que una ejecución explica todos los navegadores o usuarios. BotBrowser puede repetir una observación autorizada en una versión, un perfil y una ruta declarados; por sí solo no demuestra compatibilidad universal, privacidad, seguridad ni causa raíz.
Empieza con una pregunta
Declara la pregunta visible para el usuario antes de recopilar evidencia. “¿La página de ajustes propia muestra una acción de recuperación después de denegar un permiso?” es más concreta que “¿el navegador admite permisos?”. Escribe el resultado esperado con términos observables y registra el resultado real con los mismos términos. Mantén un informe centrado en una decisión.
Las guías de Chromium para informar errores recomiendan pasos claros, comportamiento esperado y real, y el contexto suficiente para reproducir un problema. No exigen credenciales, historial de cuentas ni un volcado completo del navegador. Usa una ruta controlada y datos sintéticos cuando no sea necesario un ejemplo público.
Registra un contexto proporcional
Incluye solo condiciones que puedan cambiar el resultado: familia y versión del navegador, clase de plataforma, versión de la aplicación, ruta, ventana, idioma, modalidad de entrada, perfil o permisos y un número de ejecuciones acotado. Separa las versiones de aplicación, navegador y perfil. Si cambiaron varias a la vez, marca la causa como desconocida.
Los contextos controlados de BotBrowser pueden repetir la misma aserción autorizada con una versión Chromium, perfil, ruta, ventana y estado sintético declarados. Esto permite comparar una configuración identificada, no encuestar visitantes ni certificar un navegador. BotBrowser no demuestra que el resultado se aplique a todos los navegadores, sitios de terceros, usuarios o condiciones de seguridad; la decisión corresponde al responsable de la aplicación y al revisor. Esta capacidad de repetir una rama visible no sustituye una revisión de privacidad ni una investigación de causa.
Separa la observación de la interpretación
| Campo del informe | Puede respaldar | No establece |
|---|---|---|
| Requisito público | Significado y comportamiento permitido | Despliegue en todos los navegadores |
| Rama esperada | Contrato del producto bajo prueba | Implementación en todas partes |
| Rama observada | Resultado en el contexto declarado | Causa raíz sin comparación |
| Ejecuciones y condiciones | Reproducibilidad o intermitencia | Identidad, anonimato o calidad universal |
| Acción del producto | Un siguiente paso acotado | Una garantía sobre sitios de terceros |
Escribe “observado después del cambio de versión; causa desconocida” cuando eso sea lo que muestran los datos. No conviertas un valor repetido en una afirmación de identidad ni un valor ausente en una afirmación de anonimato. Las consideraciones de privacidad de RFC 6973 recuerdan minimizar los datos y considerar observadores, retención y divulgación.
Plantilla de informe de evidencia
Pregunta: ¿Qué comportamiento visible se comprueba?
Esperado: La rama de éxito, denegación, error o alternativa declarada.
Real: La rama observada, el resultado visible y el número de ejecuciones.
Contexto: Versión, plataforma, aplicación, ruta, idioma, perfil y ventana.
Incertidumbre: Condiciones no controladas y causas no establecidas.
Límite de privacidad: Datos sintéticos, redacciones, orígenes y registros excluidos.
Acción: Activar, usar alternativa, investigar, añadir regresión o pedir un dato.
Conserva el primer paso fallido y la recuperación. Adjunta únicamente la captura, el fragmento de consola o el trace mínimo que cambie la reproducción, siempre redactado. Elimina credenciales, cookies, cabeceras de autorización, URL privadas, identificadores de clientes y pestañas ajenas.
Revisa la incertidumbre y sigue
Si no se reproduce, pide una condición ausente cada vez: versión fija, fixture limpio, estado de permiso o ventana. Para un fallo intermitente registra numerador, denominador y ventana temporal. Al comparar versiones, mantén constantes aplicación, perfil, ruta y datos y cambia una sola dimensión. Una comparación señala un límite que investigar; no demuestra causalidad sin controlar alternativas.
La acción debe decir qué ocurre después: publicar, usar una alternativa, añadir una regresión, pausar una ruta o recopilar un dato acotado. Una observación del navegador es evidencia para esa acción, no la acción misma. La documentación Web de MDN explica cómo se expone una superficie; el responsable decide qué rama necesita y qué datos conserva.
Mantén explícito el límite de privacidad
Excluye orígenes no relacionados, correlación de cuentas, observaciones de red privadas y volcados completos de perfiles. Marca como “no probado” el comportamiento universal, los sitios de terceros, la inferencia de identidad y la certificación de seguridad. Esto mantiene honesto el informe y permite diseñar una prueba posterior más pequeña.
BotBrowser ayuda a repetir una aserción autorizada entre perfiles, versiones y rutas declarados. No sustituye las normas públicas, la propiedad de la aplicación, la revisión de privacidad ni la investigación de causa raíz. Consulta validación de interacciones del navegador y validación de versiones del navegador para temas vecinos.
Un informe accionable debe responder en la primera pantalla qué ruta se probó, qué debía ver el usuario, qué mostró el navegador, qué condiciones se fijaron y qué acción se solicita. Nombra al propietario de la ruta, de la versión o de la privacidad según la decisión. Mantén los trazos largos detrás de la descripción y vincula cada adjunto a una frase concreta. El objetivo es permitir otra ejecución con datos sintéticos y sin convertir una observación en un diagnóstico.
Fuentes
- Guías de Chromium para informar errores
- RFC 6973: Consideraciones de privacidad
- Documentación Web de MDN
- Funciones avanzadas de BotBrowser
Revisa las fuentes, la versión, el alcance del fixture, el límite de privacidad y la decisión cuando cambie cualquiera de esas entradas.
Artículos Relacionados
Lleva BotBrowser de la investigación a producción
Usa estas guías para entender el modelo y después avanzar hacia validación multiplataforma, contextos aislados y despliegue de navegador preparado para escalar.