Utilisez l'API Console pour écrire des messages dans la console à partir de votre code JavaScript. Consultez la section Premiers pas avec de journalisation dans la console pour une présentation interactive du sujet.
Consultez la documentation de référence de l'API Console utilitaire si vous recherchez des méthodes pratiques comme debug(function)
ou
monitorEvents(node)
, qui ne sont disponibles que depuis la console.
console.assert(expression, objet)
Niveau de journalisation: Error
Écrit une erreur dans la console lorsque expression
prend la valeur false
.
const x = 5;
const y = 3;
const reason = 'x is expected to be less than y';
console.assert(x < y, {x, y, reason});
console.clear()
Efface la console.
console.clear();
Si l'option Conserver le journal est activée, console.clear()
est désactivé.
Vous pouvez également effacer la console en cliquant sur l'icône .
console.count([label])
Niveau de journalisation: Info
Écrit le nombre de fois où count()
a été appelé sur la même ligne et avec le même
label
Appelez console.countReset([label])
pour réinitialiser le décompte.
console.count();
console.count('coffee');
console.count();
console.count();
console.countReset([label])
Réinitialise un décompte.
console.countReset();
console.countReset('coffee');
console.createTask(name)
Renvoie une instance Task
qui associe la trace de la pile actuelle à l'objet task
créé. Vous pouvez ensuite utiliser cet objet task
pour exécuter une fonction (f
dans l'exemple suivant). task.run(f)
exécute une charge utile arbitraire et renvoie la valeur renvoyée à l'appelant.
// Task creation
const task = console.createTask(name);
// Task execution
task.run(f); // instead of f();
task
constitue un lien entre le contexte de création et le contexte de la fonction asynchrone. Ce lien permet aux outils de développement d'afficher de meilleures traces de pile pour les opérations asynchrones. Pour en savoir plus, consultez Traces de pile associées.
console.debug(object [, object, ...]) (Objet [, objet, ...])
Niveau de journalisation: Verbose
Identique à console.log(object [, object, ...])
, mais avec un niveau de journalisation différent.
console.debug('debug');
console.dir(object)
Niveau de journalisation: Info
Affiche une représentation JSON de l'objet spécifié.
console.dir(document.head);
console.dirxml(node)
Niveau de journalisation: Info
Affiche une représentation XML des descendants de node
.
console.dirxml(document);
console.error(objet [, objet, ...])
Niveau de journalisation: Error
Imprime object
dans la console, le met en forme en tant qu'erreur et inclut une trace de la pile.
console.error("I'm sorry, Dave. I'm afraid I can't do that.");
console.group(label)
Regroupe visuellement les messages jusqu'à ce que console.groupEnd(label)
soit appelé. Utilisez
console.groupCollapsed(label)
pour réduire le groupe lors de sa première consignation dans la console.
const label = 'Adolescent Irradiated Espionage Tortoises';
console.group(label);
console.info('Leo');
console.info('Mike');
console.info('Don');
console.info('Raph');
console.groupEnd(label);
Vous pouvez également imbriquer des groupes.
const timeline1 = 'New York 2012';
const timeline2 = 'Camp Lehigh 1970';
console.group(timeline1);
console.info('Mind');
console.info('Time');
console.group(timeline2);
console.info('Space');
console.info('Extra Pym Particles');
console.groupEnd(timeline2);
console.groupEnd(timeline1);
console.groupCollapsed(label)
Identique à console.group(label)
, sauf que le groupe est initialement réduit lorsqu'il est connecté à
la console.
console.groupEnd(label)
Arrête le regroupement visuel des messages. Voir console.group
.
console.info(objet [, objet, ...])
Niveau de journalisation: Info
Identique à console.log(object [, object, ...])
.
console.info('info');
console.log(objet [, objet, ...])
Niveau de journalisation: Info
Affiche un message sur la console.
console.log('log');
console.table(tableau [, colonnes])
Niveau de journalisation: Info
Consigne un tableau d'objets sous forme de table.
var people = [
{
first: 'René',
last: 'Magritte',
},
{
first: 'Chaim',
last: 'Soutine',
birthday: '18930113',
},
{
first: 'Henri',
last: 'Matisse',
}
];
console.table(people);
Par défaut, console.table()
consigne toutes les données de la table. Pour afficher une seule colonne ou un sous-ensemble de colonnes, vous pouvez utiliser le deuxième paramètre facultatif et spécifier le ou les noms des colonnes sous forme de chaîne ou de tableau de chaînes. Exemple :
console.table(people, ['last', 'birthday']);
console.time([label])
Démarre un nouveau minuteur. Appelez console.timeEnd([label])
pour arrêter le minuteur et imprimer le temps écoulé sur
la console.
console.time();
for (var i = 0; i < 100000; i++) {
let square = i ** 2;
}
console.timeEnd();
console.timeEnd([label])
Niveau de journalisation: Info
Arrête un minuteur. Voir console.time()
.
console.trace()
Niveau de journalisation: Info
Imprime une trace de la pile sur la console.
const first = () => { second(); };
const second = () => { third(); };
const third = () => { fourth(); };
const fourth = () => { console.trace(); };
first();
console.warn(objet [, objet, ...])
Niveau de journalisation: Warning
Affiche un avertissement dans la console.
console.warn('warn');