
Mini-leçon · Français
Comment trouver et corriger les erreurs de votre site en ligne
Reproduisez l’action visiteur défectueuse fournie, demandez une correction ciblée et vérifiez la même action après modification.
À qui s’adresse cette leçon ?
Pour les personnes souhaitant trouver et corriger les pannes rencontrées par les visiteurs. Vous utilisez une page défectueuse fournie ; un assistant modifie le code pendant que vous décrivez le problème et répétez l’action.
Avant de commencer
Le site d’exercice distinct et un assistant. Un projet Sentry d’exercice est facultatif pour la surveillance ; envoyez uniquement les erreurs fictives fournies, sans données privées des visiteurs.
Durée estimée: 19–31 min
Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. La configuration du fournisseur et l’attente de réception sont supplémentaires. Un appel de capture local ne prouve pas la réception d’une alerte.
Ce que vous apprendrez
- Reproduisez une vraie action cassée au lieu de vérifier seulement le chargement.
- Partagez assez de contexte sûr pour une correction ciblée par l’assistant.
- Vérifiez l’action réparée et l’état de surveillance pertinent.
Étape 1
Essayez l’action du visiteur
Une page peut s’ouvrir alors que sa fonction utile est cassée.
Faites servir le dossier public en HTTP et ouvrez la page. Activez « Find contact section ». La version practice-R1 cherche volontairement une cible absente ; le statut annonce donc l’échec de Contact.
Indiquez bouton exact, destination attendue et résultat visible à l’assistant. La section Contact peut exister alors que le bouton ne l’atteint pas ; le seul chargement de l’accueil manquerait ce problème.
Un exemple concret
Un symptôme utile : « J’ai pressé Find contact section dans practice-R1. J’attendais l’ouverture de Contact, mais le statut disait Contact action failed. »
Utilise l’exemple de contact cassé dans un site d’exercice distinct. Reproduis l’échec, identifie une cause ciblée et ne change que le nécessaire. Aide à répéter la même action et comparer avant/après. Si la surveillance est activée, utilise seulement des erreurs fictives et mon projet d’exercice ; n’envoie aucune donnée privée de page ou formulaire. Ne dis pas l’incident corrigé uniquement parce qu’il est marqué résolu.Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Trouvez et corrigez une erreur du site en ligne
Partez d’une action visiteur échouée, puis utilisez le rapport pour localiser sa cause.
La surveillance est utile lorsqu’elle relie un symptôme réel à du code que vous pouvez examiner. Cette page cherche volontairement un élément de contact absent ; l’action échoue donc.
Nous envoyons seulement une erreur synthétique fixe à votre propre projet Sentry. Le rapport comprend une étiquette de version et un emplacement dans la pile ; le relevé d’incident relie ces preuves à ce que le visiteur a essayé de faire.
Exemple détaillé
L’accueil charge correctement. Cliquer sur “Find contact section” (trouver la section de contact) échoue, car le script demande #contact-missing alors que le HTML définit id=contact.
Extra implementation exercise
Pourquoi un contrôle HTTP 200 de l’accueil ne détecte-t-il pas ce bogue ?
Afficher une solution détaillée
Le HTML peut charger correctement tandis qu’une action JavaScript ultérieure échoue. Répétez la tâche de contact, pas seulement la requête de page.
- Teste l’interaction touchée après le chargement de la page.
- Distingue la disponibilité du bon fonctionnement.
Erreur fréquente
Déclarer une fonction JavaScript saine parce que le serveur sert son HTML.
Étape 2
Recueillez seulement un contexte sûr et utile
Donnez des preuves à l’assistant sans données privées de visiteurs.
Donnez fichiers d’exercice, version et symptôme précédent à l’assistant. Cela suffit pour inspecter ce cas local sans envoyer de texte de formulaire ni d’informations de compte d’un vrai visiteur.
Avec le projet Sentry facultatif, configurez seulement sa valeur publique de chargement et activez la surveillance d’exercice avant de reproduire l’erreur contrôlée. Inspectez l’événement correspondant et ses données. Son apparition dans Sentry est distincte d’une alerte reçue en boîte.
Un exemple concret
L’erreur autorisée fournie est « Practice: missing contact target ». Un événement utile peut inclure version d’exercice et emplacement source sans message réel, mail ni jeton de compte.
Sentry : chargeur navigateur et initialisation personnalisée
À vous de jouer
Quel contexte partagerez-vous et quelles données privées exclurez-vous ?
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Je partagerais les fichiers practice-R1, l’action « Find contact section » et son erreur. Avec surveillance, je chercherais « Practice: missing contact target » et la version correspondante dans mon projet de test. J’exclurais mails visiteurs, formulaires et jetons ; l’alerte en boîte resterait un contrôle distinct.
- Partage l’action fictive reproductible, la version d’exercice et le contexte de fichiers pertinent.
- Exclut le contenu réel des visiteurs et distingue événements de surveillance reçus et alertes livrées.
Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Envoyez un rapport de diagnostic contrôlé
Recueillez assez d’informations pour enquêter sans envoyer de contenu utilisateur brut.
Configurez l’URL publique du chargeur selon START-HERE.txt. Le script définit sa fonction de rappel d’initialisation avant de charger le SDK, désactive les traces et la relecture et utilise une liste d’autorisation beforeSend pour cette erreur fixe.
L’événement de diagnostic renvoyé exclut les données de requête, les données utilisateur, les extras arbitraires et l’historique des actions précédant l’erreur (breadcrumbs). La partie de requête et le fragment sont retirés des noms de fichiers de la pile. Sur un véritable site, examinez chaque source de diagnostic sensible ; sendDefaultPii=false ne garantit pas à lui seul que les textes libres ou les URL ne contiennent aucune donnée personnelle.
Le filtre beforeSend est volontairement strict : seul le message synthétique exact 'Practice: missing contact target' est envoyé. Les autres sont rejetés. Si vous changez le texte de l’erreur, mettez la liste à jour délibérément, sinon l’absence d’événement est normale. Ne retirez pas le filtre juste pour remplir le tableau de bord ; examinez les données de l’événement autorisé.
Si aucun événement n’arrive, examinez d’abord le message fixe et la liste beforeSend dans app.js. Un événement non conforme affiche désormais un message local de filtrage ; il n’est pas compté comme envoyé. L’analyseur d’URL prend location.origin comme base des noms relatifs et remplace un nom impossible à analyser par redacted au lieu de transmettre un original potentiellement sensible.
L’option documentée data-lazy="no" du chargeur est définie par script.dataset.lazy="no" ; elle demande le chargement anticipé du SDK complet. Les noms de fichiers de pile ne conservent que l’origine et le chemin HTTP(S) après suppression de requête et fragment. Les protocoles non web sont expurgés plutôt que transmis tels quels.
Exemple détaillé
Un message fixe comme “Practice: missing contact target” suffit pour cet exercice. Envoyer un objet de formulaire entier ajouterait du risque sans aider à identifier la cible DOM absente.
Sentry : chargeur navigateur et initialisation personnalisée
Extra implementation exercise
Désactiver les données personnelles par défaut rendrait-il automatiquement sûrs des messages d’erreur arbitraires ?
Afficher une solution détaillée
Non. Examinez les données réelles de l’événement et limitez les envois de votre code. Des informations personnelles peuvent figurer dans messages, URL, breadcrumbs et extras même sans collecte personnelle par défaut.
- Reconnaît que les textes et URL de l’application peuvent encore contenir des données privées.
- Applique une expurgation et une liste d’autorisation explicites.
Erreur fréquente
Considérer une seule option de confidentialité comme une révision complète des données.
Étape 3
Appliquez une correction ciblée
Répétez exactement l’action ratée après modification.
Faites comparer la destination du bouton défectueux à Contact existant. worked-solution/app.js contient la petite correction ; faites-la appliquer et nommer la version corrigée practice-R2.
Ouvrez practice-R2 et réactivez le même bouton. Il doit atteindre Contact et afficher « Contact section opened. » Changer seulement la version ou marquer un problème résolu dans Sentry ne change pas le comportement du bouton.
Un exemple concret
Le script fautif cherche #contact-missing alors que HTML définit Contact en #contact. L’assistant répare la correspondance ; vous jugez en utilisant à nouveau le bouton.
À vous de jouer
Qu’est-ce qui a changé et que s’est-il passé en répétant l’action d’origine ?
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Dans la solution, l’assistant remplace la cible absente par #contact existant et nomme la révision practice-R2. Le test attendu est que le même bouton atteigne Contact et affiche « Contact section opened. » Une étiquette de surveillance résolue ne démontrerait rien sans ce test.
- Relie la petite correction de destination à la section Contact existante.
- Répète la même action sur la version actualisée et vérifie le résultat visible pour l’utilisateur.
Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Reliez le rapport, corrigez la cause et retestez
Une étiquette de problème résolu ne répare pas le code.
Activez la surveillance, déclenchez l’échec synthétique et trouvez l’événement réel dans votre compte. Comparez sa version et son emplacement aux sources fournies. Si rien n’arrive, vérifiez chargement, bloqueurs, configuration et livraison réseau avant de supposer l’absence d’erreur.
Remplacez le script par worked-solution/app.js, mettez à jour l’étiquette de version et répétez l’action de contact. Le défilement devrait faire apparaître la bonne cible. Marquer un problème comme résolu dans un tableau de bord ne remplace pas cette vérification du comportement.
Le remplacement du fichier représente une petite correction de laboratoire. Sur un site hébergé d’entraînement, enregistrez app.js et l’étiquette modifiés dans un commit, révisez et déployez cette révision, puis retestez son URL publique. Modifier seulement le statut ou l’étiquette n’applique pas la correction du sélecteur.
Exemple détaillé
R1 échoue sur #contact-missing ; R2 utilise #contact. La preuve utile du rétablissement est que l’action fonctionne sur la révision corrigée.
Extra implementation exercise
Le problème est marqué résolu, mais le script déployé cherche encore #contact-missing. Est-il réparé ?
Afficher une solution détaillée
Non. Un statut de tableau de bord ne change pas le script. Déployez la correction via la révision habituelle et vérifiez l’action sur cette version.
- Vérifie les sources et la révision réellement déployées.
- Répète l’action qui échouait.
Erreur fréquente
Changer le statut du problème au lieu de publier et vérifier une correction.
Étape 4
Terminez une note d’incident utile
Reliez symptôme, correction et vérification.
Complétez incident-record.txt avec panne initiale, petite correction et résultat de l’action répétée sur la version actualisée. Si vous publiez l’exercice, vérifiez exactement cette version publique, pas seulement le fichier local.
Séparez la surveillance facultative : événement initial reçu dans Sentry, règle d’alerte configurée et notification réellement arrivée. Le relevé doit expliquer cette tâche réparée et les limites restantes, pas annoncer un site entièrement sans erreur.
Un exemple concret
Une note concise relie Contact échoué dans practice-R1 à la correction de cible et au test réussi dans practice-R2. « Problème résolu » seul omet le résultat du visiteur.
À vous de jouer
Pour commencer
Les fichiers et contenus d’essai sont fournis. La vérification réelle exige votre propre compte, boîte de réception ou domaine, selon les prérequis. L’inspection locale reste possible ; notez les étapes réelles non exécutées comme non testées.
Fournissez la note d’incident et le vrai contrôle de l’action réparée.
Travail à rendre Un bref relevé avec symptôme reproduit, changement limité et véritable retest réussi.
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Exemple d’incident : Contact de practice-R1 signalait un échec ; l’assistant a corrigé la cible absente ; sur practice-R2, le même bouton a atteint Contact avec son message de réussite. L’événement fictif a été vérifié séparément dans le projet de surveillance de test. Aucune règle d’alerte n’a été configurée : la livraison reste non testée. Cela couvre ce défaut Contact, pas toutes les erreurs futures du site.
- Relie symptôme initial, modification ciblée et véritable répétition de la même action sur la version identifiée.
- Sépare les observations d’événement/alerte et nomme tout périmètre encore non testé.
Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Votre devoir : rédiger une note d’incident utile
Permettez à la prochaine personne de comprendre la cause et les preuves.
Complétez le relevé avec une référence d’événement expurgée, l’action touchée, l’emplacement source, la cause et le nouveau test réussi. Si vous configurez une alerte, vérifiez sa notification réelle séparément de la réception de l’événement.
Ajoutez une deuxième erreur synthétique dans votre copie et répétez la boucle. Gardez les messages fixes et mettez la liste à jour délibérément ; n’élargissez pas la surveillance en envoyant des données arbitraires de page ou formulaire.
Exemple détaillé
« Sélecteur absent corrigé de #contact-missing à #contact ; nouveau test R2 réussi » permet d’agir. « Sentry avait une erreur ; résolu » laisse la cause et la vérification inconnues.
Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.
Extra implementation exercise
Produisez une note d’incident et prouvez que l’action corrigée fonctionne.
Afficher une solution détaillée
Activez le chargeur d’entraînement configuré et déclenchez l’erreur synthétique exacte. Si vous changez le texte, adaptez volontairement la liste stricte ; un message non autorisé rejeté est normal. Examinez l’événement réellement reçu, sa version, son emplacement et les données indésirables.
Appliquez le script corrigé à public/app.js et passez RELEASE à practice-R2. Publiez cette révision selon le processus révisé, puis répétez Find contact section sur la véritable URL déployée. Changer seulement l’étiquette ou le statut ne répare pas le sélecteur.
Consignez la réception du problème séparément de la livraison de l’alerte. L’événement peut être visible avant l’arrivée d’une alerte configurée ; gardez chaque observation en attente jusqu’à vérification. La note de référence relie échec, emplacement, changement de sélecteur et nouveau test visible.
- Relie symptôme, version et cause dans les sources.
- Vérifie le comportement et distingue la livraison d’événement de celle de notification.
Erreur fréquente
Supposer qu’un tableau de bord vide prouve l’absence d’erreurs pour les utilisateurs.
Cette leçon vous a-t-elle été utile ?
Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.
Poursuivre votre apprentissage
- Comment créer votre premier site personnel
- Comment publier votre site depuis GitHub
- Comment relier un domaine personnalisé à votre site
- Comment configurer une messagerie sur votre domaine
- Comment rendre votre site utilisable sur téléphone
- Comment accélérer le chargement des images de votre site
- Comment recevoir les commentaires de votre site dans votre boîte mail
- Comment ajouter des abonnements par e-mail à votre site
- Comment envoyer des e-mails automatiques depuis votre site
- Comment enregistrer les formulaires dans une base de données
- Comment permettre aux utilisateurs de se connecter à votre site
- Comment garder une page privée
- Comment permettre aux utilisateurs de modifier leur profil
- Comment permettre aux utilisateurs de téléverser des images
- Comment garder les clés d’API hors de votre interface web
- Comment afficher les données d’une API externe sur votre site
- Comment ajouter un chatbot d’IA à votre site
- Comment faire répondre un chatbot à partir de votre contenu
- Comment ajouter un blog à votre site
- Comment ajouter une recherche à votre site
- Comment ajouter une autre langue à votre site
- Comment aider Google à trouver votre site
- Comment corriger l’aperçu de votre site lors du partage d’un lien
- Comment mesurer les visites et les actions utiles sur votre site
- Comment permettre aux visiteurs de prendre rendez-vous
- Comment accepter un paiement sur votre site
- Comment prévisualiser les changements du site avant publication
- Comment annuler un déploiement défectueux de votre site
- Comment sauvegarder et restaurer les données de votre site