Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Recommandations pour l'écriture d'un bug

 

Si vous avez besoin d'aide concernant les logiciels Mozilla (par exemple avec Firefox ou Thunderbird), utilisez l'une des options de support disponibles. Ne modifiez pas cette page.

Si vous débutez dans l'Assurance qualité de Mozilla, vous pouvez essayer d'obtenir de l'aide de contributeurs plus expérimentés. Consultez la section Communauté de la page Assurance qualité pour des indications. Si vous désirez rapporter un bug dans Firefox, vous pourrez également obtenir de l'assistance dans le canal <tt>#firefox (en)</tt> sur irc.mozilla.org.

Principes de base

Un rapport de bug rédigé de manière efficace est plus susceptible d'être corrigé. Ce guide explique comment procéder.

  • Soyez précis
  • Soyez clairs - donnez des explications claires de façon à ce que d'autres puissent reproduire le bug.
  • Un seul bug par rapport
  • Même le bug le plus insignifiant doit être rapporté - de petits problèmes peuvent en masquer de plus importants.
  • Séparez clairement les faits des suppositions.

Introduction

  1. Reproduisez votre bug en utilisant un build récent de l'application, afin de vous assurer qu'il n'a pas déjà été corrigé.

Ajouter un lien vers FAQ sur "recent build"

  1. Faites une recherche dans Bugzilla pour vérifier que votre bug n'a pas déjà été rapporté.

(Tutoriel en anglais : tutorial).

Rapporter un nouveau bug

ATTENTION : la langue utilisée dans Bugzilla est uniquement l'anglais. Les exemples sont donnés en français à titre indicatif pour une meilleure clarté des instuctions

Si vous avez reproduit l'anomalie sur un build récent et que personne ne semble l'avoir déjà rapportée, alors :

  1. Choisissez "Enter a new bug" (le formulaire est en anglais)
  2. Sélectionnez le produit dans lequel vous avez trouvé le bug
  3. Remplissez le formulaire. Voici quelques éléments d'aide :

Component : (composant) La partie du logiciel dans laquelle apparaît le bug.

Ce champ est obligatoire. Cliquez sur le mot "Component" pour obtenir une description de chaque composant. Si aucun ne vous semble approprié, choisissez un composant général ("General").

OS : Sur quel Système d'Exploitation l'avez-vous trouvé? (par exemple Linux, Windows XP, Mac OS X.)

Si le bug se produit sur plusieurs Systèmes d'Exploitation, sélectionnez "All" (Tous). Si votre Système d'Exploitation n'apparaît pas dans la liste, choisissez "Other" (Autre).

Summary : (Résumé) Comment décririez-vous le bug, en 60 caractères maximum ?

Un bon résumé doit permettre une identification rapide et exhaustive du rapport d'anomalie. Il doit décrire le problème rencontré et non la solution que vous préconiseriez.

  • Bon : "Cancelling a File Copy dialog crashes File Manager" (Annuler une boîte de dialogue de copie d'un fichier fait planter le Gestionnaire de Fichiers)
  • Mauvais : "Software crashes" (Le programme plante)
  • Mauvais : "Browser should work with my web site" (le navigateur devrait fonctionner avec mon site web)

Description : Les détails de votre rapport de bug, qui incluent :

Overview : (vue d'ensemble) Une version plus détaillée de votre résumé.

Drag-selecting any page crashes Mac builds in the NSGetFactory function. (La sélection à l'intérieur d'une page plante les builds MAC dans la fonction NSGetFactory)

Steps to Reproduce : (Etapes permettant la reproduction) Les actions réduites à leur plus simple expression permettant de reproduire le bug. Préciser les éléments de configuration si nécessaire.

1) Ouvrir une page Web (J'ai utilisé la page d'exemple : resource:/res/samples/test0.html)

2) Faire une sélection dans la page (Placer le pointeur de la souris n'importe où dans la page, appuyer sur le bouton droit et le maintenir appuyé, puis déplacer le pointeur vers le bas de la page).

Actual Results : (Résultats actuels) Ce qui est arrivé après les étapes décrites ci-dessus.

L'application a planté.

Expected Results : (Résultat attendu) Ce qui aurait dû arriver en l'absence de . bug.

La fenêtre devrait défiler vers le bas. Le texte devrait être sélectionné. 
(Ou, au moins, l'application ne devrait pas planter)

Build Date & Platform : (Date du build et plateforme) La date et la plateforme du build dans lequel le bug a été rencontré pour la première fois.

Build 2006-08-10 sur Mac OS 10.4.3

Additional Builds and Platforms : (Builds et plateformes additionnels) Indiquer ici si le bug apparaît sur d'autres plateformes (ou navigateurs, si applicables).

N'apparaît pas sur Build 2006-08-10 sur Windows XP Home (Service Pack 2)

Additional Information : (Information complémentaire) Toute autre information utile.

Pour les bugs engendrant un crash:

  • Win32 : Si vous rencontrez une erreur Dr. Watson, veuillez noter le type d'erreur et le module ayant planté l'application (par exemple "Violation d'accès dans mozilla.exe").
  • Mac OS X : Quand l'application plante, cliquez sur le bouton "Report" (ou "Rapport d'erreur") dans la fenêtre qui s'affiche alors, puis copiez l'ensemble du texte contenu dans la zone de texte sous le message "Problem and system information" (ou "Information sur l'erreur rencontrée et le système"). Insérez-le dans votre rapport de bug. Il n'est pas nécessaire d'envoyer le rapport d'erreur à Apple. Fermez simplement la fenêtre une fois son texte copié.
  • Unix: Veuillez fournir une stack trace simplifiée, qui peut être générée en tapant l'instruction <tt>gdb mozilla core </tt> dans une fenêtre Shell.
Date/Time:      2006-12-26 12:15:20.089 -0500
OS Version:     10.4.8 (Build 8L2127)
Report Version: 4

Command: firefox-bin
Path:    /Applications/Firefox.app/Contents/MacOS/firefox-bin
Parent:  WindowServer [71]

Version: 2.0.0.1 (2.0.0.1)

PID:    114
Thread: 0

Exception:  EXC_BAD_ACCESS (0x0001)
Codes:      KERN_PROTECTION_FAILURE (0x0002) at 0x000000ca

Thread 0 Crashed:
0   libxpcom_core.dylib 	0x0186329b AppendUTF8toUTF16(char const*, nsAString_internal&) + 31
1   libxpcom_core.dylib 	0x01822916 nsTextFormatter::smprintf_free(unsigned short*) + 3248
... (many many more lines like this) ...

Add an attachment : (Attacher un fichier) Vous pouvez attacher des fichiers utiles à votre rapport de bug. Les informations de plus de 20 lignes doivent être fournies par ce biais. De même, si vous possédez un fichier HTML démontrant le bug, vous devriez l'attacher. Il n'est possible d'attacher qu'un seul fichier lors de la soumission du rapport d'anomalie, donc si votre démonstration en nécessite plusieurs, ouvrez à nouveau le rapport que vous venez de créer pour y ajouter des fichiers attachés supplémentaires. Dans ce cas attachez tout fichier complémentaire (par exemple des images ou copies d'écran) en premier, puis, avant de le télécharger, modifiez dans le fichier HTML les adresses URL des fichiers précédemment attachés afin que votre démonstration fonctionne de manière automatique. Il est nécessaire de demander une autorisation si vous souhaitez attacher plus de 5 fichiers.

Relisez minutieusement votre rapport d'anomalie pour en exclure toute erreur ou omission, puis cliquer sur le bouton "Commit" (valider). Votre rapport d'anomalie figurera désormais dans la base de données Bugzilla.

  • Auteur(s) : Gervase Markham, basé sur un original d'Eli Goldberg
  • Autres contributeurs : Claudius Gayle, Jan Leger, Felix Miata, Peter Mock, Chris Pratt, Chris Yeh et d'autres.

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : tregagnon, Kohei, Valacar, BenoitL, Prenon
 Dernière mise à jour par : tregagnon,