Comment résoudre les erreurs inconnues

Tu essaies d'enregistrer un kahoot et tu vois apparaître un message d'erreur « Oups ! » ? Ou tu as essayé d'inviter une personne à rejoindre ton espace d'organisation et un message d'erreur s'affiche ? Quand tu vois un message d'erreur ou qu'un bouton/lien ne fonctionne pas, va voir la console de ton navigateur, elle te fournira très probablement des détails utiles sur la cause du problème. De plus, il est souvent possible de télécharger un fichier HAR depuis le navigateur qui peut être analysé pour obtenir plus de détails sur les erreurs.

Raccourcis

• Comment vérifier la console de ton navigateur
• Comment télécharger et analyser un fichier HAR

Comment vérifier la console du navigateur

Tu peux effectuer une recherche rapide sur Internet et trouver les étapes à suivre pour ouvrir la console du navigateur que tu utilises. Retrouve ci-dessous les raccourcis clavier pour les principaux navigateurs :

• Chrome : Mac = Cmd + Option + J | Windows = Ctrl + Shift+ J
• Firefox : Mac = Cmd + Option + K | Windows = Ctrl + Shift+ J
• Edge : Windows = Ctrl + Shift+ I
• Safari : Mac = Vous devez d'abord choisir Safari > Préférences > Avancées puis sélectionner Afficher le menu Développement dans la barre des menus. Ensuite, tu pourras utiliser Cmd + Option + C.

À quoi ressemble une console ?

La console est une liste des messages de nos serveurs. La plupart sont de simples confirmations que les données demandées ont bien été reçues, mais d'autres peuvent être des avertissements (en jaune) et des erreurs (en rouge).

Ce qu'il faut chercher dans la console

Les avertissements ne posent généralement pas de problème. Il se peut que quelque chose ne soit pas tout à fait exact, mais la page Web devrait fonctionner correctement. Le plus préoccupant, ce sont les erreurs. Elles indiquent en effet qu'une fonction spécifique a échoué.

Souvent, les erreurs qui apparaissent dans la console sont composées d'énoncés génériques et scriptés, accompagnés de quelques détails cryptiques. Si l'erreur que tu vois ne t'indique pas clairement la cause première, fais une capture d'écran de ta console et une autre de l'erreur que tu as vu sur notre plateforme, puis télécharge un fichier HAR. Tu peux envoyer tout cela à notre équipe en décrivant ce que tu essayais de faire, les étapes que tu as suivies pour y parvenir et le résultat ou l'erreur que tu as rencontré(e).

Fichiers HAR

HAR signifie : HttpARchive (archive HTTP). Un fichier HAR est un journal d'activité entre un navigateur internet et un site web, qui comprend notamment les ressources Web que ton navigateur a tenté d'accéder et les résultats de ces tentatives. Ces ressources peuvent être particulièrement utiles lorsque tu essaies de visualiser, ajouter ou modifier quelque chose et qu'à la place, tu reçois un message d'erreur.

Comment télécharger un fichier HAR

Google met à disposition un outil gratuit pour analyser les fichiers HAR. Tu y retrouveras aussi les étapes à suivre pour télécharger des fichiers HAR sur les navigateurs Edge, Firefox, and Chrome. Si tu utilises un autre navigateur, tu devras probablement effectuer une recherche en ligne pour retrouver les étapes. Mais en général, la plupart des navigateurs suivent les étapes suivantes : 

1. Ouvre la console de ton navigateur
2. Va dans l'onglet « Réseau »
3. Assure-toi que l'option "Conserver les journaux" en haut de l'écran est sélectionnée.
4. Reproduis le problème*
5. Sélectionne « Exporter en tant que fichier HAR » (ou similaire)

Comment analyser un fichier HAR

Google met à disposition un outil gratuit pour analyser les fichiers HAR. Il te suffit de cliquer sur le bouton « choisir un fichier » et de sélectionner le fichier .har que tu as téléchargé précédemment. Il peut être utile d'exclure les codes de statut HTTP « 2xx » et « 3xx » et de cocher « Toutes les entrées », comme ça tu verras une liste épurée des erreurs.

Tu peux cliquer sur la valeur temporelle d'un événement pour voir plus de détails. Sélectionne l'onglet « Contenu de la réponse », car il contient des informations sur la raison pour laquelle un serveur a rejeté une demande.

Notre équipe se fera un plaisir de t'aider à déchiffrer les erreurs enregistrées dans les fichiers HAR. Tu peux envoyer toutes les infos à notre équipe en précisant ce que tu essayais de faire, les étapes que tu as suivies pour y parvenir et le résultat ou l'erreur que tu as rencontré(e). Pense à inclure toutes les captures d'écran que tu as de l'erreur.