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.

In der API-Referenz für Console-Dienstprogramme finden Sie Informationen zu den praktischen Methoden wie debug(function) oder monitorEvents(node), die nur in der Console verfügbar sind.

console.assert(expression, object)

Protokollebene: Error

Schreibt einen Fehler in die Konsole, 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 obigen Beispiels für 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])

Protokollebene: Info

Schreibt die Anzahl der Aufrufe von count() in derselben Zeile und mit demselben label auf. 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 Stack-Trace 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 weiter.

// 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 Stack-Traces.

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

Protokollebene: Verbose

Identisch mit console.log(object [, object, ...]), mit Ausnahme der Protokollebene.

console.debug('debug');

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

console.dir(object)

Protokollebene: Info

Damit wird eine JSON-Darstellung des angegebenen Objekts ausgegeben.

console.dir(document.head);

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

console.dirxml(node)

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

console.group(label)

Nachrichten werden visuell gruppiert, 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(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 Konsole 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. Drücken Sie console.timeEnd([label]), 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 Beispiels für console.time() oben.

console.timeEnd([label])

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

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

Protokollebene: Warning

Eine Warnung wird in der Console ausgegeben.

console.warn('warn');

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