Exécuter JavaScript dans la console

Ce tutoriel interactif vous montre comment exécuter JavaScript dans la console Outils pour les développeurs Chrome. 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 avez plus de chances 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 le 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. Après l'évaluation de votre code, 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;
    }
    

    Si vous ne connaissez pas la syntaxe b=20, consultez la section Définir des valeurs par défaut pour les arguments de fonction.

  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) prend la valeur 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 pas exécuter de code dans cette session de console tant que la fonction n'aura pas été renvoyée. Si cela prend trop de temps, vous pouvez utiliser le gestionnaire de tâches pour annuler le calcul fastidieux. Toutefois, cela entraînera également l'échec de la page actuelle et toutes les données saisies seront perdues.

Étapes suivantes

Consultez la section Exécuter JavaScript pour découvrir d'autres fonctionnalités liées à l'exécution de 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 de créer un workflow de débogage efficace. Pour obtenir 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 jQuery. Il s'agit simplement d'un alias de 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.