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});
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 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();
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');
console.dir(object)
Logebene: Info
Damit wird eine JSON-Darstellung des angegebenen Objekts ausgegeben.
console.dir(document.head);
console.dirxml(node)
Logebene: Info
Druckt eine XML-Darstellung der Nachkommen von node
aus.
console.dirxml(document);
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.");
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);
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);
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');
console.log(Objekt [, Objekt, ...])
Protokollebene: Info
Gibt eine Nachricht an die Console aus.
console.log('log');
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);
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']);
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();
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();
console.warn(Objekt [, Objekt, ...])
Protokollebene: Warning
Gibt eine Warnung an die Console aus.
console.warn('warn');