Veuillez noter que cet article concerne la Console DevTools, qui est distincte de la Console Contentsquare (utilisée pour la gestion en back-office de votre/vos projet(s) Contentsquare). Pour plus d'informations sur la Console Contentsquare, consultez cet article à la place.
À propos de la Console DevTools
La Console DevTools est un outil de développement disponible sur les navigateurs web, couramment utilisé pour comprendre ce qui se passe dans le code de votre site web. Elle affiche les messages enregistrés par le navigateur, ou ajoutés par les développeurs web eux-mêmes, qui aident à identifier et résoudre les problèmes, tels que les erreurs ou les problèmes de réseau.
Dans l'Analyse d'erreurs, vous pouvez consulter les messages de console ajoutés par les développeurs, pour vous aider à trouver et résoudre plus rapidement les problèmes.
Niveaux de journalisation des messages de console
Chaque message est attribué un niveau de journalisation, pour aider à comprendre son importance. Il existe 5 niveaux de journalisation qui peuvent être suivis avec les messages de console dans Contentsquare :
- Erreur : utilisé pour enregistrer les erreurs critiques qui peuvent empêcher un site web de fonctionner comme prévu. Il est recommandé de les investiguer et de les résoudre rapidement.
- Avertissement : utilisé pour enregistrer des anomalies qui peuvent entraîner des problèmes futurs. Il est recommandé de les examiner périodiquement pour prévenir les problèmes.
- Info : utilisé pour enregistrer des informations générales sur le fonctionnement d'un site web. Ils sont utiles pour comprendre le flux normal des activités et le comportement.
- Journal : souvent utilisé pour enregistrer des informations qui ne sont pas nécessairement critiques, mais utiles pour le débogage et le suivi.
- Débogage : généralement utilisé pendant le développement à des fins de débogage. Ces journaux sont temporaires et sont censés être supprimés du code de production.
Comment trouver et analyser les messages de console sur le tableau des erreurs
Utilisez le tableau des erreurs pour localiser et prioriser les messages de console.
1. Depuis le menu principal, cliquez sur ‘Analyser > Analyse d'erreurs’.
2. En haut, définissez votre Contexte d'analyse pour affiner votre analyse par appareil, plage de dates et utilisateurs.
3. Faites défiler jusqu'au tableau des erreurs.
4. Dans le tableau des erreurs, affinez la liste des erreurs pour trouver tout message de console en utilisant le bouton ‘Filtre’ et en sélectionnant ‘Erreurs personnalisées’.
5. Les messages de console sont identifiables en tant qu'‘erreurs personnalisées’, et incluent les étiquettes suivantes :
- Une étiquette de type erreur ‘CST’ (erreur personnalisée).
- Le niveau de journalisation (Avertissement, Erreur, Débogage, Info, Journal).
- Le message de console, par exemple : “Les événements d'orientation de l'appareil sont bloqués par une politique de permissions”.
Comment afficher et agir sur les détails des messages de console depuis le panneau latéral des erreurs
Tout comme pour tous les types d'erreurs, vous pouvez trouver des détails supplémentaires et prendre des mesures supplémentaires depuis le panneau latéral des erreurs.
1. Dans le tableau des erreurs, cliquez sur l'icône de flèche ‘>’.
2. Le panneau latéral des erreurs s'ouvrira où vous pourrez voir les détails individuels de l'erreur :
- Type d'erreur et niveau de journalisation.
- ID d'erreur regroupée.
- Message de console.
À partir des détails de l'erreur, vous pouvez :
- Voir les détails généraux de l'erreur.
- Rejeter l'erreur (rôles d'Administrateur ou d'Utilisateur expert uniquement).
- Envoyer vers JIRA (utilisateurs Administrateurs uniquement) ou voir le ticket Jira s'il a déjà été créé.
- Utiliser le menu des trois points ‘...’ pour copier les détails de l'erreur ou configurer des détails supplémentaires.
- Utiliser les boutons ‘Voir les Résumés’, ‘Voir l'Impact’ et ‘Voir l'Analyse du Parcours’ pour approfondir l'impact de l'erreur.
Comment afficher et agir sur les messages de console dans le Résumé de Session
1. Accédez au panneau latéral des erreurs d'une erreur de console et cliquez sur le bouton ‘Voir les Résumés’.
2. Le résumé de session s'ouvrira et vous pourrez regarder un résumé où l'erreur s'est produite.
3. Les détails de l'erreur seront visibles dans le flux d'événements et dans l'infobulle de l'icône d'événement de la chronologie.
4. Cliquez sur l'infobulle de la chronologie et utilisez le bouton ‘Quantifier’ pour analyser davantage l'impact de l'erreur.
FAQ
Pourquoi est-ce que je vois des erreurs/avertissements provenant de l'étiquette ?
Pour suivre les arguments passés aux fonctions de console, l'étiquette de suivi doit patcher ces fonctions. Le patching est une technique connue pour étendre le code des fonctions sans altérer le code source original. Ce faisant, l'étiquette de suivi apparaîtra dans la stack trace même si elle n'est pas à l'origine de l'appel. L'étiquette de suivi n'appellera jamais la console pour enregistrer des erreurs.