Documentation de référence de l'API de la console

Kayce basque
Kayce basque
Sofia Emelianova
Sofia Emelianova

Utilisez l'API Console pour écrire des messages dans la console à partir de votre code JavaScript. Pour obtenir une présentation interactive de ce sujet, consultez la section Premiers pas avec la journalisation des messages dans la console.

Consultez la documentation de référence de l'API des utilitaires de la console si vous recherchez des méthodes pratiques telles que debug(function) ou monitorEvents(node), qui ne sont disponibles que dans 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});

Résultat de l&#39;exemple console.assert() ci-dessus.

console.clear()

Efface la console.

console.clear();

Si l'option Conserver le journal est activée, console.clear() est désactivé.

Vous pouvez également Vider la console en cliquant sur l'icône ALT_TEXT_HERE.

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();

Résultat de l&#39;exemple console.count() ci-dessus.

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 [, objet, ...])

Niveau de journalisation: Verbose

Identique à console.log(object [, object, ...]), mais niveau de journalisation différent.

console.debug('debug');

Résultat de l&#39;exemple console.debug() ci-dessus.

console.dir(object)

Niveau de journalisation: Info

Affiche une représentation JSON de l'objet spécifié.

console.dir(document.head);

Résultat de l&#39;exemple console.dir() ci-dessus.

console.dirxml(node)

Niveau de journalisation: Info

Affiche une représentation XML des descendants de node.

console.dirxml(document);

Résultat de l&#39;exemple console.dirxml() ci-dessus.

console.error(objet [, objet, ...])

Niveau de journalisation: Error

Affiche object dans la console, le formate 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.");

Résultat de l&#39;exemple console.error() ci-dessus.

console.group(label)

Regroupez 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 journalisation 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);

Résultat de l&#39;exemple console.group() ci-dessus.

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);

Groupes imbriqués

console.groupCollapsed(label)

Identique à console.group(label), sauf que le groupe est initialement réduit lors de sa journalisation dans la console.

console.groupEnd(label)

Arrête de regrouper visuellement les messages. Voir console.group.

console.info(objet [, objet, ...])

Niveau de journalisation: Info

Identique à console.log(object [, object, ...]).

console.info('info');

Résultat de l&#39;exemple console.info() ci-dessus.

console.log(objet [, objet, ...])

Niveau de journalisation: Info

Affiche un message dans la console.

console.log('log');

Résultat de l&#39;exemple console.log() ci-dessus.

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);

Résultat de l&#39;exemple console.table() ci-dessus.

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 de colonne sous forme de chaîne ou un tableau de chaînes. Exemple :

console.table(people, ['last', 'birthday']);

Sous-ensemble de colonnes d&#39;une table enregistré avec console.table().

console.time([label])

Démarre un nouveau minuteur. Appelez console.timeEnd([label]) pour arrêter le minuteur et afficher le temps écoulé dans la console.

console.time();
for (var i = 0; i < 100000; i++) {
  let square = i ** 2;
}
console.timeEnd();

Résultat de l&#39;exemple console.time() ci-dessus.

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 dans la console.

const first = () => { second(); };
const second = () => { third(); };
const third = () => { fourth(); };
const fourth = () => { console.trace(); };
first();

Résultat de l&#39;exemple console.trace() ci-dessus.

console.warn(objet [, objet, ...])

Niveau de journalisation: Warning

Affiche un avertissement dans la console.

console.warn('warn');

Résultat de l&#39;exemple console.warn() ci-dessus.