Exécuter JavaScript dans la console

Ce tutoriel interactif vous explique comment exécuter du code JavaScript dans la console Chrome DevTools. Consultez la section Premiers pas avec la journalisation des messages pour découvrir comment journaliser des messages dans la console. Consultez Premiers pas avec le débogage JavaScript pour découvrir comment mettre en pause le code JavaScript et l'examiner ligne par ligne.

Console

Figure 1 : La console

Présentation

La console est un REPL (Read, Evaluate, Print, Loop), c'est-à-dire une interface système de lecture, d'évaluation, d'impression et de boucle. Il lit le code JavaScript que vous saisissez, évalue votre code, imprime le résultat de votre expression, puis revient à la première étape.

Configurer les outils de développement

Ce tutoriel est conçu pour que vous puissiez ouvrir la démonstration et essayer vous-même tous les workflows. Lorsque vous suivez physiquement, vous êtes plus susceptible de vous souvenir des workflows plus tard.

  1. Appuyez sur Cmd+Option+J (Mac) ou Ctrl+Maj+J (Windows, Linux, ChromeOS) pour ouvrir la console, directement sur cette page.

    Ce tutoriel à gauche et les outils de développement à droite.

    Figure 2 : Ce tutoriel à gauche et les outils de développement à droite.

Afficher et modifier le code JavaScript ou DOM de la page

Lorsque vous créez ou déboguez une page, il est souvent utile d'exécuter des instructions dans la console afin de modifier l'apparence ou l'exécution de la page.

  1. Notez le texte du bouton ci-dessous.

  2. Saisissez document.getElementById('hello').textContent = 'Hello, Console!' dans la console, puis appuyez sur Entrée pour évaluer l'expression. Notez que le texte du bouton change.

    Aperçu de la console après l'évaluation de l'expression ci-dessus.

    Figure 3. Aperçu de la console après l'évaluation de l'expression ci-dessus.

    Sous le code que vous avez évalué, vous voyez "Hello, Console!". Rappelez-vous les quatre étapes de REPL: lecture, évaluation, impression, boucle. Une fois votre code évalué, un REPL imprime le résultat de l'expression. "Hello, Console!" doit donc être le résultat de l'évaluation de document.getElementById('hello').textContent = 'Hello, Console!'.

Exécuter du code JavaScript arbitraire sans rapport avec la page

Parfois, vous souhaitez simplement un espace de jeu où vous pouvez tester du code ou essayer de nouvelles fonctionnalités JavaScript que vous ne connaissez pas. La console est l'outil idéal pour ce type de test.

  1. Saisissez 5 + 15 dans la console. Le résultat 20 s'affiche sous votre expression (sauf si l'évaluation de votre expression prend trop de temps).
  2. Appuyez sur Enter pour évaluer l'expression. La console affiche le résultat de l'expression sous votre code. La figure 4 ci-dessous montre à quoi doit ressembler votre console après l'évaluation de cette expression.
  3. Saisissez le code suivant dans la console. Essayez de la saisir, caractère par caractère, plutôt que de la copier-coller.

    function add(a, b=20) {
      return a + b;
    }
    

    Consultez Définir des valeurs par défaut pour les arguments de fonction si vous ne connaissez pas la syntaxe b=20.

  4. Appelez maintenant la fonction que vous venez de définir.

    add(25);
    

    Aperçu de la console après l'évaluation des expressions ci-dessus.

    Figure 4. Aperçu de la console après l'évaluation des expressions ci-dessus.

    add(25) renvoie 45, car lorsque la fonction add est appelée sans deuxième argument, b est défini par défaut sur 20.

Vous ne pourrez exécuter aucun code dans cette session de console tant que votre fonction n'aura pas renvoyé de valeur. Si cela prend trop de temps, vous pouvez utiliser le gestionnaire des tâches pour annuler le calcul long. Toutefois, la page actuelle échouera et toutes les données que vous avez saisies seront perdues.

Étapes suivantes

Consultez Exécuter du code JavaScript pour découvrir d'autres fonctionnalités liées à l'exécution de code JavaScript dans la console.

DevTools vous permet de suspendre un script en plein milieu de son exécution. Lorsque vous êtes en pause, vous pouvez utiliser la console pour afficher et modifier le window ou le DOM de la page à ce moment-là. Cela permet d'obtenir un workflow de débogage efficace. Pour un tutoriel interactif, consultez Premiers pas avec le débogage JavaScript.

La console accepte également un ensemble de spécificateurs de format. Consultez Mettre en forme et styliser les messages dans la console pour découvrir toutes les méthodes de mise en forme et de stylisation des messages de la console.

En outre, la console propose un ensemble de fonctions pratiques qui facilitent l'interaction avec une page. Exemple :

  • Au lieu de saisir document.querySelector() pour sélectionner un élément, vous pouvez saisir $(). Cette syntaxe est inspirée de jQuery, mais ce n'est pas réellement jQuery. Il s'agit simplement d'un alias pour document.querySelector().
  • debug(function) définit effectivement un point d'arrêt sur la première ligne de cette fonction.
  • keys(object) renvoie un tableau contenant les clés de l'objet spécifié.

Consultez la documentation de référence de l'API Console Utilities pour découvrir toutes les fonctions pratiques.