Signaler aux fournisseurs de navigateurs les problèmes que vous rencontrez dans leur navigateur est essentiel pour améliorer la plate-forme Web.
Signaler un bug de manière efficace demande un peu de travail. Votre objectif doit être de permettre aux ingénieurs de navigateur de trouver aussi facilement que possible ce qui ne fonctionne pas, d'en identifier la cause principale et, surtout, de trouver un moyen de résoudre le problème. Les bugs qui sont résolus rapidement sont généralement faciles à reproduire et ont un comportement attendu clair.
Vérifier qu'il s'agit d'un bug
La première étape consiste à déterminer quel devrait être le comportement "correct".
Quel est le comportement attendu ?
Consultez la documentation de l'API concernée sur MDN ou essayez de trouver les spécifications associées. Ces informations peuvent vous aider à déterminer quelle API est réellement défaillante, où elle l'est et quel est le comportement attendu.
Est-ce que cela fonctionne dans un autre navigateur ?
Les comportements qui diffèrent d'un navigateur à l'autre sont généralement considérés comme des problèmes d'interopérabilité prioritaires, en particulier lorsque le navigateur contenant le bug est le seul à présenter ce comportement. Essayez de tester les dernières versions de Chrome, Firefox, Safari et Edge, éventuellement à l'aide d'un outil tel que BrowserStack.
Si possible, vérifiez que la page ne se comporte pas intentionnellement différemment en raison de la détection de l'user-agent. Dans les outils pour les développeurs Chrome, essayez de définir la chaîne User-Agent sur un autre navigateur.
Est-ce qu'il a cessé de fonctionner dans une version récente ?
Est-ce que cela fonctionnait comme prévu auparavant, mais que cela ne fonctionne plus depuis une mise à jour récente du navigateur ? Ces régressions peuvent être traitées beaucoup plus rapidement, en particulier si vous fournissez un numéro de version où cela a fonctionné et une version où cela a échoué. Vous pouvez utiliser des outils tels que BrowserStack pour vérifier les anciennes versions de navigateur. Utilisez des outils tels que l'outil bisect-builds (pour Chromium) pour rechercher la modification.
Si un problème est une régression et peut être reproduit, la cause principale peut généralement être trouvée et corrigée rapidement.
D'autres personnes rencontrent-elles le même problème ?
Si vous rencontrez des problèmes, il est fort probable que d'autres développeurs en rencontrent également. Tout d'abord, essayez de rechercher le bug sur Stack Overflow. Cela peut vous aider à traduire un problème abstrait en une API défectueuse spécifique et à trouver une solution de contournement à court terme jusqu'à ce que le bug soit corrigé.
A-t-il déjà été signalé ?
Une fois que vous avez une idée de ce qu'est le bug, vérifiez s'il a déjà été signalé en effectuant une recherche dans la base de données des bugs du navigateur.
- Navigateurs basés sur Chromium : https://crbug.com
- Firefox : https://bugzilla.mozilla.org/
- Navigateurs basés sur Safari et WebKit : https://bugs.webkit.org/
Si vous trouvez un bug existant qui décrit le problème, ajoutez votre soutien en l'ajoutant à vos favoris ou en le commentant. Sur de nombreux sites, vous pouvez également vous ajouter à la liste des destinataires en copie pour recevoir des notifications lorsque le bug est modifié.
Si vous décidez de commenter le bug, indiquez comment il affecte votre site Web. Évitez d'ajouter des commentaires de type "+1", car les outils de suivi des bugs envoient généralement des e-mails pour chaque commentaire.
Signaler le bug
Si le bug n'a pas encore été signalé, il est temps d'en informer le fournisseur du navigateur.
Créer un scénario de test minimal
Mozilla propose un excellent article sur la création d'un scénario de test réduit. Pour faire court, même si une description du problème est un bon début, rien ne vaut une démonstration liée dans le bug qui montre le problème. Pour maximiser les chances de progresser rapidement, l'exemple doit contenir le minimum de code possible nécessaire pour illustrer le problème. Un exemple de code minimal est la meilleure chose que vous puissiez faire pour augmenter les chances que votre bug soit corrigé.
Voici quelques conseils pour réduire un scénario de test :
- Téléchargez la page Web, ajoutez
<base href="https://original.url">et vérifiez que le bug existe localement. Cela peut nécessiter un serveur HTTPS actif si l'URL utilise HTTPS. - Testez les fichiers locaux sur les dernières versions d'un maximum de navigateurs.
- Essayez de tout condenser dans un seul fichier.
- Supprimez du code (en commençant par les éléments que vous savez inutiles) jusqu'à ce que le bug disparaisse.
- Utilisez le contrôle des versions pour enregistrer votre travail et annuler les erreurs.
Héberger un scénario de test minimisé
Si vous cherchez un bon endroit pour héberger votre scénario de test minimisé, plusieurs options s'offrent à vous :
Sachez que plusieurs de ces sites affichent du contenu dans un iFrame, ce qui peut entraîner un comportement différent des fonctionnalités ou des bugs.
Signaler votre problème
Une fois que vous avez obtenu votre scénario de test réduit, vous pouvez signaler le bug. Accédez au site de suivi des bugs approprié, puis créez un problème.
- Navigateurs basés sur Chromium : https://crbug.com/new
- Firefox : https://bugzilla.mozilla.org/
- Navigateurs basés sur Safari et WebKit : https://bugs.webkit.org/
Ajoutez des descriptions claires et les étapes à suivre pour reproduire le problème.
Tout d'abord, fournissez une description claire pour aider les ingénieurs à comprendre rapidement le problème et à le trier.
When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.
Ensuite, indiquez les étapes détaillées requises pour reproduire le problème, puis décrivez le résultat attendu et le résultat réel.
What is the expected result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
(logged when beforeinstallprompt.prompt()` resolves)
2. INSTALL: Success (logged when `appinstalled` event fired)
What is the actual result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL: Success (logged when `appinstalled` event fired)
2. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
(logged when beforeinstallprompt.prompt()` resolves)
Pour en savoir plus, consultez les consignes de rédaction des rapports de bug sur MDN.
Bonus : Ajoutez une capture d'écran ou un enregistrement d'écran du problème
Bien que cela ne soit pas obligatoire, il est souvent utile d'ajouter une capture d'écran ou un enregistrement d'écran du problème. Cela est particulièrement utile lorsque des bugs se produisent après plusieurs étapes ou une activité inhabituelle. Les enregistrements et les captures d'écran permettent souvent de mieux montrer aux ingénieurs du navigateur ce qui s'est passé.
Incluez des détails sur l'environnement
Certains bugs ne sont reproductibles que sur certains systèmes d'exploitation ou sur certains types d'écrans (par exemple, à faible ou haute résolution). Veillez à inclure les détails des environnements de test que vous avez utilisés.
Signaler le bug
Enfin, envoyez le bug. Surveillez votre boîte de réception pour voir les réponses au bug. En général, les ingénieurs peuvent avoir des questions supplémentaires pendant l'investigation. S'ils ont des difficultés à reproduire le problème, ils pourront vous contacter.