Console API-Referenz

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Mit der Console API können Sie Nachrichten aus Ihrem JavaScript in die Konsole schreiben. Eine interaktive Einführung in das Thema finden Sie unter Erste Schritte mit dem Protokollieren von Nachrichten in der Console.

Wenn Sie nach den Komfortmethoden wie debug(function) oder monitorEvents(node) suchen, die nur über die Console verfügbar sind, sehen Sie sich die API-Referenz für Konsolen-Dienstprogramme an.

console.assert(expression, object)

Logebene: Error

Schreibt einen Fehler in die Konsole, wenn expression mit false ausgewertet wird.

const x = 5;
const y = 3;
const reason = 'x is expected to be less than y';
console.assert(x < y, {x, y, reason});

Das Ergebnis des Beispiels für console.assert() oben.

console.clear()

Löscht die Konsole.

console.clear();

Wenn Log beibehalten aktiviert ist, ist console.clear() deaktiviert.

Alternativ können Sie die Konsole leeren, indem Sie auf das Symbol ALT_TEXT_HERE klicken.

console.count([label])

Logebene: Info

Gibt die Anzahl der Aufrufe von count() in derselben Zeile und mit demselben label an. Rufen Sie console.countReset([label]) auf, um die Anzahl zurückzusetzen.

console.count();
console.count('coffee');
console.count();
console.count();

Das Ergebnis des Beispiels für console.count() oben.

console.countReset([label])

Setzt einen Zähler zurück.

console.countReset();
console.countReset('coffee');

console.createTask(name)

Gibt eine Task-Instanz zurück, die den aktuellen Stacktrace mit dem erstellten task-Objekt verknüpft. Sie können dieses task-Objekt später verwenden, um eine Funktion auszuführen (f im folgenden Beispiel). Mit task.run(f) wird eine beliebige Nutzlast ausgeführt und der Rückgabewert an den Aufrufer weitergeleitet.

// Task creation
const task = console.createTask(name);

// Task execution
task.run(f); // instead of f();

Die task stellt eine Verbindung zwischen dem Erstellungskontext und dem Kontext der asynchronen Funktion her. Mit diesem Link kann DevTools bessere Stacktraces für asynchrone Vorgänge anzeigen. Weitere Informationen finden Sie unter Verknüpfte Stacktraces.

console.debug(object [, object, ...])

Logebene: Verbose

Identisch mit console.log(object [, object, ...]), aber mit einer anderen Logebene.

console.debug('debug');

Das Ergebnis des Beispiels für console.debug() oben.

console.dir(object)

Logebene: Info

Gibt eine JSON-Darstellung des angegebenen Objekts aus.

console.dir(document.head);

Das Ergebnis des Beispiels für console.dir() oben.

console.dirxml(node)

Logebene: Info

Gibt eine XML-Darstellung der untergeordneten Elemente von node aus.

console.dirxml(document);

Das Ergebnis des Beispiels für console.dirxml() oben.

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

Logebene: Error

Gibt object in der Konsole aus, formatiert es als Fehler und enthält einen Stacktrace.

console.error("I'm sorry, Dave. I'm afraid I can't do that.");

Das Ergebnis des Beispiels für console.error() oben.

console.group(label)

Gruppiert Nachrichten visuell, bis console.groupEnd(label) aufgerufen wird. Verwenden Sie console.groupCollapsed(label), um die Gruppe zu minimieren, wenn sie zum ersten Mal in der Console protokolliert wird.

const label = 'Adolescent Irradiated Espionage Tortoises';
console.group(label);
console.info('Leo');
console.info('Mike');
console.info('Don');
console.info('Raph');
console.groupEnd(label);

Das Ergebnis des Beispiels für console.group() oben.

Außerdem können Sie Gruppen verschachteln.

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

Verschachtelte Gruppen.

console.groupCollapsed(label)

Wie console.group(label), nur dass die Gruppe beim Loggen in der Konsole anfangs minimiert ist.

console.groupEnd(label)

Verhindert die visuelle Gruppierung von Nachrichten. Weitere Informationen finden Sie unter console.group.

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

Logebene: Info

Identisch mit console.log(object [, object, ...]).

console.info('info');

Das Ergebnis des Beispiels für console.info() oben.

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

Logebene: Info

Gibt eine Nachricht in der Konsole aus.

console.log('log');

Das Ergebnis des console.log()-Beispiels oben.

console.table(array [, columns])

Logebene: Info

Protokolliert ein Array von Objekten als Tabelle.

var people = [
  {
    first: 'René',
    last: 'Magritte',
  },
  {
    first: 'Chaim',
    last: 'Soutine',
    birthday: '18930113',
  },
  {
    first: 'Henri',
    last: 'Matisse',
  }
];
console.table(people);

Das Ergebnis des Beispiels für console.table() oben.

Standardmäßig protokolliert console.table() alle Tabellendaten. Wenn Sie eine einzelne Spalte oder eine Teilmenge von Spalten anzeigen möchten, können Sie den zweiten optionalen Parameter verwenden und den oder die Spaltennamen als String oder Array von Strings angeben. Beispiel:

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

Eine Teilmenge von Spalten in einer Tabelle, die mit console.table() protokolliert wurde.

console.time([label])

Startet einen neuen Timer. Rufen Sie console.timeEnd([label]) auf, um den Timer zu stoppen und die verstrichene Zeit in der Console auszugeben.

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

Das Ergebnis des console.time()-Beispiels oben.

console.timeEnd([label])

Logebene: Info

Stoppt einen Timer. Weitere Informationen finden Sie unter console.time().

console.trace()

Logebene: Info

Gibt einen Stacktrace in der Console aus.

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

Das Ergebnis des Beispiels für console.trace() oben.

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

Logebene: Warning

Gibt eine Warnung in der Konsole aus.

console.warn('warn');

Das Ergebnis des Beispiels für console.warn() oben.