Un enregistrement de rapport de bug doit montrer une séquence ininterrompue depuis la première action jusqu'à l'échec, avec le numéro de version, le curseur et le texte exact de l'erreur tous visibles à l'écran. Enregistrez-le dans un onglet de navigateur, gardez le clip sous une minute, et n'envoyez pas un écran interne à un service d'enregistrement tiers.
Le clip est une preuve, pas une démo, il n'a donc besoin d'être que suffisamment long pour prouver que la faute existe et permettre à quelqu'un d'autre de la reproduire. C'est généralement 20 à 45 secondes : ouvrez l'écran, cliquez à travers les deux ou trois étapes qui déclenchent le problème, puis restez un instant sur l'erreur. Laissez le microphone activé et racontez ce que vous faites, car une voix disant que le bouton aurait dû fermer la boîte de dialogue supprime les conjectures qu'un clip silencieux laisse derrière lui. Une fois enregistré, rognez les temps morts aux deux extrémités et compressez le fichier avant de le joindre au ticket.
Une vidéo de rapport de bug a deux publics qui tirent en sens opposés. Le développeur veut chaque détail qui prouve la faute, et la personne qui approuve le téléversement ne veut aucune des données clients qui se trouvent par hasard sur le même écran. Un bon clip satisfait les deux, et il faut environ trente secondes de préparation.
Enregistreur d'écran
Enregistrez un écran, une fenêtre ou un onglet de navigateur avec votre microphone, entièrement dans l'onglet du navigateur. Rien n'est téléversé, et le fichier atterrit directement dans votre dossier de téléchargements.
Ce que contient une vidéo de reproduction de bug utilisable
Un clip qui fait corriger un bug doit répondre à quatre questions sans message de suivi : ce que vous avez fait, ce que vous attendiez, ce qui s'est réellement produit, et sur quelle version vous étiez. Une capture silencieuse de tout le bureau n'en répond aucune, car la personne qui regarde doit deviner où regarder.
| Élément | Pourquoi cela appartient au clip |
|---|---|
| La séquence complète de clics | Montre la cause, pas seulement le symptôme |
| Numéro de build ou version | Relie la correction à une version |
| Le texte exact de l'erreur | Peut être recherché ; une paraphrase non |
| L'URL ou le chemin de fichier | Indique quel environnement et quelles données |
| Un curseur visible | Prouve où le clic a réellement atterri |
Une séquence continue, dans l'ordre
Enregistrez la reproduction dès le premier clic, pas à partir du moment où ça casse. La cause se situe généralement deux ou trois étapes avant le symptôme, donc un clip qui commence à l'écran d'erreur laisse le développeur demander la partie manquante. Un seul fichier qui va de la première action à l'échec est plus convaincant que trois clips qui commencent chacun au milieu du flux.
La version et l'environnement, à l'écran
Ouvrez la boîte À propos, le pied de page ou la barre d'état qui affiche le numéro de build avant de commencer, et laissez-la dans le cadre. "Ça a cassé sur ma machine" n'est pas exploitable ; "ça a cassé sur 4.11.2, Windows 11, Chrome 140" l'est. S'il y a une incrustation de débogage ou un badge d'environnement, gardez-le visible pendant tout le clip.
Le texte exact de l'erreur, pas votre résumé
Gardez la console, le toast ou le message d'erreur en ligne à l'écran et restez immobile une seconde. Un développeur peut rechercher une trace de pile, mais pas "il a dit quelque chose à propos d'un null". Si le message est dans une console de développement, ouvrez cette console avant l'étape finale, pour que le texte arrive à l'écran, et faites-le défiler dans la vue lentement.
Retour du curseur et des clics
Déplacez le pointeur délibérément et marquez une légère pause avant chaque clic. Un enregistrement d'écran ne porte aucun retour de clic qu'un partage d'écran en direct vous donne, donc un mouvement lent et visible est le seul indice de l'endroit où l'action a atterri. Un rythme calme rend aussi le clip plus facile à rogner.
Avant d'appuyer sur enregistrer
La plupart de la qualité d'un clip de bug se décide dans les trente secondes avant le début de l'enregistrement. Deux des vérifications ci-dessous concernent la lisibilité et deux concernent le fait de ne rien publier que vous ne vouliez pas publier.
Fermez les fenêtres sans rapport et mettez les notifications en silencieux
Activez Ne pas déranger, quittez le client de chat et fermez les onglets qui ne font pas partie de la reproduction. Une bannière de notification glissant sur le message d'erreur peut cacher l'unique image dont le développeur avait besoin, et c'est la raison la plus courante pour laquelle un clip doit être réenregistré. Une invite de mise à jour fait de même.
Décidez ce qui ne doit pas être dans le cadre
Regardez tout l'écran comme le ferait un inconnu : barres de favoris, un second moniteur, un e-mail ouvert, la ligne d'un autre client dans le même tableau. Si la faute ne se reproduit qu'avec de vraies données clients, utilisez le plus petit enregistrement qui montre encore le problème, ou un compte de test. Masquer une vidéo après coup est bien plus de travail que de choisir une fenêtre propre.
Dimensionnez la fenêtre avant de la capturer
Redimensionnez le navigateur ou l'application à une fenêtre normale plutôt que de capturer tout l'écran sur un grand moniteur. Une capture de 2560 pixels de large réduit le texte au-delà de la lisibilité une fois que le lecteur de tickets le met à l'échelle, tandis qu'une fenêtre de 1280 pixels reste lisible dans le lecteur en ligne. Cela garde aussi le fichier brut plus petit.
Comment enregistrer la reproduction
- Ouvrez l'enregistreur et choisissez quoi partager. Choisissez l'onglet du navigateur ou la fenêtre unique plutôt que l'écran entier lorsque la faute se trouve à un seul endroit, car le navigateur ne remet alors que cette surface. Laissez l'option "Inclure le microphone" activée pour que votre narration soit capturée avec la vidéo.
- Parcourez la reproduction une fois, lentement, à voix haute. Indiquez la version sur laquelle vous êtes, dites ce que vous attendez avant le clic final, puis dites ce qui s'est produit à la place. Marquez une pause sur l'erreur pour qu'une image puisse être citée, et arrêtez avec le bouton Arrêter.
- Regardez l'aperçu avant de télécharger. L'enregistreur affiche le clip fini et sa taille dès que vous arrêtez, vérifiez donc que le message d'erreur est réellement lisible avant de l'enregistrer. Si une notification a gâché la prise, refaites l'enregistrement ; une seconde tentative est moins coûteuse qu'un aller-retour de ticket.
Vous pouvez aussi mettre en pause et reprendre en cours d'enregistrement si une étape nécessite un moment de configuration qui n'appartient pas à la preuve. L'enregistrement est écrit sous forme d'un seul fichier dans les deux cas, et le navigateur l'arrête automatiquement si vous mettez fin au partage d'écran depuis la barre de partage.
Le microphone est le seul audio que vous obtenez
Cet enregistreur capture la vidéo depuis l'écran et, si vous laissez l'option activée, mixe votre microphone via une invite d'autorisation distincte. Il ne capture pas l'audio du système : aucun son d'application, aucun audio d'onglet, aucun des carillons que fait le système d'exploitation. Pour un rapport de bug, c'est généralement la bonne valeur par défaut, car l'audio qui aide un développeur est votre description du comportement attendu, pas le bruit que fait l'application.
Quoi dire à voix haute
- Nommez la version et l'environnement au début, même si le numéro de build est aussi à l'écran.
- Dites ce que vous attendez avant le clic décisif : "ceci devrait enregistrer et fermer la boîte de dialogue".
- Dites ce qui s'est réellement produit juste après : "il est resté ouvert et le cercle de chargement ne s'est jamais arrêté".
- Mentionnez la fréquence d'apparition : toujours, ou une fois sur cinq.
Gardez la narration courte et factuelle. Un développeur qui regarde en accéléré doit suivre le clip avec le son coupé et tout de même comprendre la séquence, la voix ne faisant que confirmer l'intention derrière chaque clic.
Rognez et compressez avant de le joindre
Une capture brute est presque toujours plus longue et plus volumineuse que ce dont le ticket a besoin. Les deux premières secondes montrent généralement que vous changez de fenêtre pour atteindre l'enregistreur, et les dernières que vous tendez la main vers le bouton arrêter. Rogner les deux extrémités ne coûte rien.
Utilisez le rogneur vidéo pour la coupe. Son mode rapide copie les flux d'origine sans réencoder, donc la coupe est rapide et la qualité n'est pas touchée, bien que le nouveau point de départ s'aligne sur l'image-clé la plus proche. Le mode précis réencode pour que la coupe tombe exactement sur l'image que vous avez choisie, ce qui vaut la peine lorsque le premier clic se produit dans la seconde suivant le début.
Faites ensuite passer le résultat par le compresseur vidéo si le fichier est encore lourd pour une pièce jointe de ticket. Faire passer une capture 1080p à 720p à 30 fps réduit généralement la taille de 60 à 80 pour cent, et le texte à l'écran reste lisible à cette résolution, ce qui est la seule chose qu'un clip de bug doit vraiment préserver.
Rogneur vidéo
Coupez les temps morts aux deux extrémités. Le mode rapide copie les flux donc la qualité n'est pas touchée ; le mode précis coupe exactement là où vous avez marqué.
Ce que cet enregistreur ne fait pas
Bon à savoir avant de commencer, car ce sont les cas où une approche différente est la bonne réponse.
- Pas d'audio du système ni de l'onglet. Le flux d'écran est capturé en vidéo uniquement, et votre microphone est mixé séparément. L'outil ne peut pas enregistrer le son qu'une application ou un onglet de navigateur joue.
- La sortie est en WebM. Les navigateurs encodent le WebM nativement, c'est donc ce que vous obtenez. Le bouton "Convertir en MP4" ouvre le convertisseur vidéo, le chemin vers un MP4 pour les gestionnaires de tickets qui n'affichent pas les WebM.
- Aucune annotation, flou ou surbrillance du curseur. Vous ne pouvez pas dessiner sur l'image ni masquer une région après coup, enregistrez donc une version propre si une image doit être couverte.
- Rien n'est monté à l'intérieur de l'enregistreur. Pause et reprise sont les seules commandes en cours d'enregistrement. Le rognage et la compression se font ensuite dans les outils ci-dessus.
- L'enregistrement vit en mémoire jusqu'à ce que vous arrêtiez. Une longue capture en haute résolution remplit la mémoire de la page, gardez donc les clips de reproduction courts et ne laissez l'onglet se fermer qu'après avoir enregistré le fichier.
- Aucune incrustation de webcam. Il n'y a pas d'incrustation en picture-in-picture pour votre visage. Si vous voulez une prise de caméra à côté de l'écran, enregistrez-la séparément avec le enregistreur de webcam.
Pourquoi une reproduction de bug ne devrait pas passer par un enregistreur tiers
Le raccourci évident est un enregistreur cloud : appuyez sur enregistrer, obtenez un lien partageable, collez-le dans le ticket. Ce lien a la mauvaise forme pour un rapport de bug, car à l'autre bout il y a un écran d'administration interne, une liste de clients, une URL de staging ou une fonctionnalité non publiée. Un enregistreur hébergé stocke cela sur le disque de quelqu'un d'autre, sous une politique de conservation que vous ne contrôlez pas.
| Aihangsoft | Enregistreur cloud | |
|---|---|---|
| Où va la vidéo | Reste dans l'onglet du navigateur | Téléversé vers leurs serveurs |
| Qui peut le regarder | Uniquement les personnes à qui vous envoyez le fichier | Toute personne ayant le lien, jusqu'à son expiration |
| Conservation | Aucune, c'est un fichier sur votre disque | Leur politique, que vous ne pouvez pas auditer |
| Compte | Non nécessaire | Généralement requis pour garder le lien actif |
| Rognage et compression | Des outils locaux distincts, sans téléversement | Parfois derrière une formule payante |
Vous n'êtes pas obligé de prendre l'affirmation de confidentialité pour argent comptant. Ouvrez les outils de développement de votre navigateur, passez au panneau réseau et enregistrez un court clip en observant la liste des requêtes. Aucune requête ne transporte la vidéo, car l'encodage se fait dans la page ; le seul trafic est le code de l'enregistreur lui-même, récupéré une fois.