ProofShot — Flujo de Trabajo de Verificación Visual
Cuándo usar
Use ProofShot después de:
- Construir una nueva característica o página de UI
- Modificar componentes de UI existentes
- Corregir un error visual
- Cualquier cambio que afecte lo que el usuario ve
El flujo de trabajo (siempre siga estos 3 pasos)
Paso 1: Iniciar la sesión
proofshot start --description "lo que va a verificar"
Esto inicia el servidor de desarrollo, abre un navegador sin cabeza y comienza la grabación. La descripción aparece en el informe de prueba para el humano.
Paso 2: Manejar el navegador y probar
Use proofshot exec para navegar, interactuar y verificar:
proofshot exec snapshot -i # Ver elementos interactivos
proofshot exec open http://localhost:PORT/page # Navegar a una página
proofshot exec click @e3 # Hacer clic en un botón
proofshot exec fill @e2 "[email protected]" # Llenar un campo de formulario
proofshot exec screenshot paso-NOMBRE.png # Capturar momentos clave
Tome capturas de pantalla en momentos importantes — estas se convierten en la prueba visual. Verifique lo que espera ver leyendo la salida del snapshot.
Paso 3: Detener y agrupar la prueba
proofshot stop
Esto detiene la grabación, recopila errores de consola + servidor y genera un SUMMARY.md con video, capturas de pantalla e informe de errores.
Paso 4 (opcional): Publicar la prueba en el PR
proofshot pr # Detectar PR automáticamente desde la rama actual
proofshot pr 42 # Apuntar a un número de PR específico
Esto sube capturas de pantalla y video a GitHub y publica un comentario formateado en el PR. Por defecto, usa la API oficial de contenidos de GitHub en una rama proofshot-artifacts. Use --upload-provider github-web-attachments si desea específicamente URLs de adjuntos de GitHub.
Consejos
- Siempre incluya una --description significativa para que el humano sepa qué se probó
- Tome capturas de pantalla ANTES Y DESPUÉS de acciones clave (por ejemplo, antes de enviar un formulario, después de la redirección)
- Si encuentra errores durante la verificación, corríjalos y vuelva a ejecutar el flujo de trabajo
- Use
proofshot prdespués de detener para adjuntar la prueba directamente al pull request