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