Console API-Referenz

Kayce Basken
Kayce Basken
Sofia Emelianova
Sofia Emelianova

Verwenden Sie die Console API, um Nachrichten aus Ihrem JavaScript in die Console zu schreiben. Unter Erste Schritte mit dem Logging von Nachrichten in der Console finden Sie eine interaktive Einführung in das Thema.

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

console.assert(Ausdruck, Objekt)

Logebene: Error

Schreibt einen Fehler in die Konsole, wenn expression false ergibt.

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 console.assert()-Beispiels.

console.clear()

Löscht die Konsole.

console.clear();

Wenn Preserve Log 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 den Zähler zurückzusetzen.

console.count();
console.count('coffee');
console.count();
console.count();

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

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. 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 zurück an den Aufrufer.

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

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

Das task stellt eine Verbindung zwischen dem Erstellungskontext und dem Kontext der asynchronen Funktion her. Über diesen Link können die Entwicklertools bessere Stacktraces für asynchrone Vorgänge anzeigen. Weitere Informationen finden Sie unter Verknüpfte Stacktraces.

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

Logebene: Verbose

Identisch mit console.log(object [, object, ...]), mit Ausnahme einer anderen Logebene.

console.debug('debug');

Das Ergebnis des obigen Beispiels console.debug()

console.dir(object)

Logebene: Info

Gibt eine JSON-Darstellung des angegebenen Objekts aus.

console.dir(document.head);

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

console.dirxml(node)

Logebene: Info

Gibt eine XML-Darstellung der Nachfolger von node aus.

console.dirxml(document);

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

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

Logebene: Error

Gibt object in der Console aus, formatiert den Fehler 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 console.error()-Beispiels.

console.group(label)

Gruppieren Sie Nachrichten visuell, bis console.groupEnd(label) aufgerufen wird. Mit console.groupCollapsed(label) können Sie die Gruppe minimieren, wenn sie erstmals in der Console protokolliert wurde.

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 obigen Beispiels console.group()

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)

Wie console.group(label), mit dem Unterschied, dass die Gruppe anfangs minimiert ist, wenn sie in der Console protokolliert wird.

console.groupEnd(label)

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

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

Logebene: Info

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

console.info('info');

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

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

Logebene: Info

Gibt eine Nachricht in der Konsole aus.

console.log('log');

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

console.table(array [, columns])

Logebene: 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 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 bzw. die Spaltennamen als String oder String-Array angeben. Beispiel:

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

Eine Teilmenge von 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 in der Console 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()

Logebene: 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 obigen console.trace()-Beispiels.

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

Logebene: Warning

Gibt eine Warnung in der Console aus.

console.warn('warn');

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