console : méthode statique timeLog()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.

Note : Cette fonctionnalité est disponible via lesWeb Workers.

La méthodeconsole.timeLog() affiche la valeur courante du chronomètre précédemment démarré par un appel àconsole.time().

Syntaxe

timeLog()timeLog(libelle)timeLog(libelle, val1)timeLog(libelle, val1, /* …, */ valN)

Paramètres

libelleFacultatif: Le nom du chronomètre dont on souhaite afficher la mesure dans la console. Si cet argument est absent, c'est le libellé"default" qui est utilisé.
valNFacultatif: Des valeurs additionnelles à afficher dans la console après la mesure temporelle.

Description

La méthodeconsole.timeLog() affiche la durée mesurée jusqu'à présent pour un chronomètre.

On peut passer un nom comme argument à cette méthode, ce sera alors la durée du chronomètre (précédemment créé avec un appel àconsole.time()) avec ce nom qui sera affichée :

console.time("réticulateur de spleens");reticulerLesSpleens();console.timeLog("réticulateur de spleens");// réticulateur de spleens : 650ms

Si le nom n'est pas fourni, ce sera la durée du chronomètre par défaut qui sera affiché :

console.time();reticulerLesSpleens();console.timeLog();// default : 780ms

console.time("default");reticulerLesSpleens();console.timeLog();// default : 780ms

S'il n'y a pas de chronomètre associé existant,timeLog() affichera un avertissement :

Le minuteur « nom du chronomètre » n'existe pas.

On peut aussi fournir des valeurs supplémentaires, à afficher après la durée :

console.time();reticulerLesSpleens();console.timeLog("default", "Coucou", "monde");// default : 780ms Coucou monde

Voirla section sur les chronomètres de la documentation deconsole pour plus de détails et d'exemples.

Exemples

console.time("ma mesure de temps");alert("Cliquez pour continuer");console.timeLog("ma mesure de temps");alert("Faire d'autres trucs…");console.timeEnd("ma mesure de temps");

Avec le fragment de code ci-avant, on affichera le temps écoulé après que la personne a fermé la première fenêtre modale, puis le temps total pris pour fermer les deux fenêtres :

ma mesure de temps : 1287 msma mesure de temps : 2808 ms - chronomètre arrêté

On notera que le nom du chronomètre est affiché avec la durée lors de l'appel àtimeLog(), puis lors de l'arrêt. Quand on appelletimeEnd(), on a en plus le message « chronomètre arrêté » qui précise que le chronomètre est terminé.