console : méthode statique timeLog()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note : Cette fonctionnalité est disponible via les Web Workers.

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

Syntaxe

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

Paramètres

libelle Facultatif

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é.

valN Facultatif

Des valeurs additionnelles à afficher dans la console après la mesure temporelle.

Valeur de retour

Aucune (undefined).

Description

La méthode console.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 :

js
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é :

js
console.time();
reticulerLesSpleens();
console.timeLog();
// default : 780ms
js
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 :

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

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

Exemples

js
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 ms
ma 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 appelle timeEnd(), on a en plus le message « chronomètre arrêté » qui précise que le chronomètre est terminé.

Spécifications

Specification
Console Standard
# timelog

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi