Tests QA - Vérifier en pilotant réellement l'application

Que fait Tests QA - Vérifier en pilotant réellement l'application ?

Après avoir construit ou modifié une application ou un site web, ne supposez pas qu'il fonctionne. Pilotez-le et vérifiez-le.

1. Le réseau est requis - vérifiez-le d'abord

L'installation de ces outils et le chargement de pages nécessitent un réseau sortant, que les sandbox peuvent bloquer. Vérifiez avant toute chose :

curl -fsI https://github.com >/dev/null 2>&1 && echo "network ok" || echo "network blocked"

Si le message network blocked s'affiche, arrêtez-vous et dites à l'utilisateur :

J'ai besoin d'un accès réseau pour installer et exécuter les outils de test. Exécutez /permissions et choisissez un niveau d'accès qui permet le réseau, puis demandez-moi à nouveau.

2. Applications et sites web - agent-browser

Sous macOS/Linux, privilégiez le binaire précompilé directement :

if ! command -v agent-browser >/dev/null; then
  os=$(uname -s | tr '[:upper:]' '[:lower:]'); m=$(uname -m)
  case "$os/$m" in
    darwin/arm64)              asset=agent-browser-darwin-arm64 ;;
    darwin/x86_64)             asset=agent-browser-darwin-x64 ;;
    linux/aarch64|linux/arm64) asset=agent-browser-linux-arm64 ;;
    linux/x86_64)              asset=agent-browser-linux-x64 ;;
  esac
  mkdir -p ~/.local/bin
  curl -fL "https://github.com/vercel-labs/agent-browser/releases/latest/download/$asset" -o ~/.local/bin/agent-browser
  chmod +x ~/.local/bin/agent-browser
fi
agent-browser install
agent-browser skills get core

Sous Windows, utilisez le gestionnaire de paquets car il télécharge le binaire natif correspondant :

if (-not (Get-Command agent-browser -ErrorAction SilentlyContinue)) {
  npm install -g agent-browser
  $env:Path = "$env:APPDATA\npm;$env:Path"
}
agent-browser install
agent-browser skills get core

Utilisez ensuite le guide maintenu de l'outil : agent-browser open <url>, prenez une capture, agissez sur les références des éléments, puis capturez à nouveau.

3. Applications de bureau natives - cua-driver

macOS/Linux :

command -v cua-driver >/dev/null || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)"
cua-driver list-tools

Windows PowerShell :

if (-not (Get-Command cua-driver -ErrorAction SilentlyContinue)) {
  irm https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.ps1 | iex
  $env:Path = [Environment]::GetEnvironmentVariable('Path', 'User') + ';' + [Environment]::GetEnvironmentVariable('Path', 'Machine')
}
cua-driver list-tools

Pour les applications natives, vérifiez un changement d'état réel après l'action. Une commande de clic qui signale un succès n'est pas suffisante en elle-même. Capturez un état initial, agissez, puis capturez un état post-action et comparez le texte visible, les compteurs, les étiquettes de statut, l'état sélectionné, les valeurs de saisie ou les preuves par capture d'écran.

Hygiène des commandes Windows PowerShell

De nombreux hôtes Windows utilisent encore Windows PowerShell 5.1, où && n'est pas un séparateur d'instructions valide. Utilisez des commandes séparées, des points-virgules ou des vérifications explicites if ($LASTEXITCODE -eq 0) { ... } à la place. Entourez les arguments des outils qui commencent par @ de guillemets, en particulier les références agent-browser.

Principes

• Vérifiez d'abord le réseau.
• Utilisez command -v avant d'installer.
• Privilégiez les binaires directs sur macOS/Linux lorsqu'ils sont disponibles.
• Référez-vous à la documentation de chaque outil : agent-browser skills get core et cua-driver list-tools.
• Capturez, agissez, et recapturez pour confirmer chaque étape.
• Confirmez avant les actions conséquentes telles que les achats, les messages, les soumissions de formulaires ou les suppressions.