Console API-Referenz

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.

Unter Referenz zur Console Utilities API finden Sie praktische Methoden wie debug(function) oder monitorEvents(node), die nur in der Console verfügbar sind.

console.assert(expression, Objekt)

Protokollebene: Error

Schreibt einen error in die Konsole, wenn expression als 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 obigen Beispiels console.assert().

console.clear()

Die Konsole wird gelöscht.

console.clear();

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

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

console.count([label])

Logebene: Info

Schreibt, wie oft count() in derselben Zeile und mit demselben label aufgerufen wurde. Rufen Sie console.countReset([label]) auf, um die Zählung 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. Dieses task-Objekt kann später verwendet werden, 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 zurück.

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

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

Das task bildet eine Verknüpfung zwischen dem Erstellungskontext und dem Kontext der asynchronen Funktion. Über diesen Link können in DevTools bessere Stack-Traces 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, ...]), mit Ausnahme einer anderen Logebene.

console.debug('debug');

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

console.dir(object)

Logebene: Info

Damit wird eine JSON-Darstellung des angegebenen Objekts ausgegeben.

console.dir(document.head);

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

console.dirxml(node)

Logebene: Info

Druckt eine XML-Darstellung der Nachkommen von node aus.

console.dirxml(document);

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

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

Protokollebene: Error

Gibt object an die Console aus, formatiert das Ergebnis als Fehler und fügt einen Stacktrace ein.

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

Das Ergebnis des obigen Beispiels console.error().

console.group(label)

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

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 beim Anmelden in der Console zuerst minimiert ist.

console.groupEnd(label)

Nachrichten werden nicht mehr optisch gruppiert. Weitere Informationen finden Sie unter console.group.

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

Protokollebene: Info

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

console.info('info');

Das Ergebnis des obigen Beispiels console.info().

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

Protokollebene: Info

Gibt eine Nachricht an die Console aus.

console.log('log');

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

console.table(array [, columns])

Protokollebene: Info

Hiermit wird ein Array von Objekten als Tabelle protokolliert.

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 werden alle Tabellendaten in console.table() protokolliert. Wenn Sie eine einzelne Spalte oder eine Teilmenge von Spalten anzeigen möchten, können Sie den zweiten optionalen Parameter verwenden und den Spaltennamen als String oder ein String-Array angeben. Beispiel:

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

Eine Teilmenge der 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 an die Konsole auszugeben.

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

Das Ergebnis des obigen Beispiels console.time().

console.timeEnd([label])

Logebene: Info

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

console.trace()

Protokollebene: Info

Druckt einen Stack-Trace in die Console aus.

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

Das Ergebnis des obigen Beispiels console.trace().

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

Protokollebene: Warning

Gibt eine Warnung an die Console aus.

console.warn('warn');

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