Console API-Referenz

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

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

Wenn Sie nach praktischen Methoden wie debug(function) oder monitorEvents(node) suchen, die nur in der Console verfügbar sind, finden Sie weitere Informationen in der Console Utilities API-Referenz.

console.assert(expression, object)

Protokollebene: Error

Schreibt einen Fehler in die Console, wenn expression zu 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 Console.

console.clear();

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

Alternativ können Sie die Console löschen, indem Sie auf das Symbol ALT_TEXT_HERE klicken.

console.count([label])

Protokollebene: Info

Schreibt die Anzahl der Aufrufe von count() in derselben Zeile und mit demselben label. 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 eine Anzahl 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). task.run(f) führt eine beliebige Nutzlast aus und leitet den Rückgabewert an den Aufrufer weiter.

// 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 dieser Verbindung können in DevTools bessere Stacktraces für asynchrone Vorgänge angezeigt werden. Weitere Informationen finden Sie unter Verknüpfte Stacktraces.

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

Protokollebene: Verbose

Identisch mit console.log(object [, object, ...]), nur mit einer anderen Protokollebene.

console.debug('debug');

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

console.dir(object)

Protokollebene: 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)

Protokollebene: Info

Gibt eine XML-Darstellung der Nachfolger von node aus.

console.dirxml(document);

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

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

Protokollebene: Error

Gibt object in der Console aus, formatiert es als Fehler und fügt einen Stacktrace hinzu.

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)

Entspricht console.group(label), mit dem Unterschied, dass die Gruppe minimiert wird, wenn sie zum ersten Mal in der Console protokolliert wird.

console.groupEnd(label)

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

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

Protokollebene: Info

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

console.info('info');

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

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

Protokollebene: Info

Gibt eine Nachricht in der Console aus.

console.log('log');

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

console.table(array [, columns])

Protokollebene: 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 obigen Beispiels für console.table().

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 der Spalten in einer Tabelle, die mit console.table() protokolliert wurde.

Wenn Sie eine protokollierte Tabelle als formatierte Markdown-Tabelle oder CSV-Daten in die Zwischenablage kopieren möchten, rechtsklicken Sie in der Console auf die Tabelle und wählen Sie im Kontextmenü die entsprechende Kopieroption aus.

console.time([label])

Startet einen neuen Timer. Rufen Sie console.timeEnd([label]) auf, um den Timer zu beenden 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 Beispiels für console.time() oben.

console.timeEnd([label])

Protokollebene: Info

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

console.trace()

Protokollebene: 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, ...])

Protokollebene: Warning

Gibt eine Warnung in der Console aus.

console.warn('warn');

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