Console API-Referenz

Sofia Emelianova
Sofia Emelianova

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

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

console.assert(expression, Objekt)

Logebene: 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()

Löscht die Konsole.

console.clear();

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

Alternativ können Sie auch 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. Rufe console.countReset([label]) auf, um den Zähler zurückzusetzen.

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

Das Ergebnis des obigen Beispiels 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. 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 an den Aufrufer zurück.

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

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

task stellt eine Verknüpfung zwischen dem Erstellungskontext und dem Kontext der asynchronen Funktion dar. Über diesen Link können in den Entwicklertools bessere Stacktraces für asynchrone Vorgänge angezeigt werden. 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 Beispiels „console.debug()“ oben.

console.dir(object)

Logebene: Info

Gibt eine JSON-Darstellung des angegebenen Objekts aus.

console.dir(document.head);

Das Ergebnis des obigen Beispiels console.dir().

console.dirxml(node)

Logebene: Info

Gibt eine XML-Darstellung der Nachfolgerelemente von node aus.

console.dirxml(document);

Das Ergebnis des obigen Beispiels console.dirxml().

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

Logebene: 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. Minimieren Sie die Gruppe mit console.groupCollapsed(label), wenn sie zum ersten Mal in der Console protokolliert wird.

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)

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

console.groupEnd(label)

Stoppt die visuelle Gruppierung von Nachrichten. 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 Beispiels console.info().

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

Logebene: Info

Gibt eine Nachricht an die Console aus.

console.log('log');

Das Ergebnis des obigen Beispiels console.log().

console.table(Array [, Spalten])

Logebene: Info

Protokolliert ein Objektarray 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. Um eine einzelne Spalte oder eine Teilmenge von Spalten anzuzeigen, können Sie den zweiten optionalen Parameter verwenden und 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 wird.

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()

Logebene: Info

Übergibt einen Stacktrace an die Console.

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, ...])

Logebene: Warning

Gibt eine Warnung an die Console aus.

console.warn('warn');

Das Ergebnis des obigen Beispiels console.warn().