Dokumentacja interfejsu API konsoli

Sofia Emelianova
Sofia Emelianova

Używaj interfejsu Console API, aby wysyłać do Konsoli wiadomości z JavaScriptu. Aby zapoznać się z tym tematem w sposób interaktywny, przeczytaj artykuł Zaczynanie korzystać z logowania wiadomości w Konsoli.

Jeśli szukasz wygodnych metod, takich jak debug(function) lub monitorEvents(node), które są dostępne tylko w Konsoli, zapoznaj się z dokumentacją interfejsu API narzędzi Konsoli.

console.assert(expression, object)

Poziom logowania: Error

W przypadku wartości expression równej false do konsoli zostanie zapisany błąd.

const x = 5;
const y = 3;
const reason = 'x is expected to be less than y';
console.assert(x < y, {x, y, reason});

Wynik przykładu console.assert() powyżej.

console.clear()

Czyści konsolę.

console.clear();

Jeśli opcja Zachowaj dziennik jest włączona, opcja console.clear() jest wyłączona.

Możesz też wyczyścić konsolę, klikając ikonę ALT_TEXT_HERE.

console.count([label])

Poziom logowania: Info

Zapisuje liczbę wywołań funkcji count() na tym samym wierszu i z tym samym argumentem label. Aby zresetować licznik, zadzwoń pod numer console.countReset([label]).

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

Wynik przykładu console.count() powyżej.

console.countReset([label])

Resetuje licznik.

console.countReset();
console.countReset('coffee');

console.createTask(name)

Zwraca instancję Task, która łączy bieżący zrzut stosu z utworzonym obiektem task. Możesz później użyć obiektu task do uruchomienia funkcji (f w następnym przykładzie). Funkcja task.run(f) wykonuje dowolny ładunek i przekazuje zwracaną wartość do wywołującego.

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

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

Element task tworzy połączenie między kontekstem utworzenia a kontekstem funkcji asynchronicznej. Ten link umożliwia przeglądarce DevTools wyświetlanie lepszych ścieżek wywołań w przypadku operacji asynchronicznych. Więcej informacji znajdziesz w artykule Połączone ścieżki z wykrywania.

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

Poziom logowania: Verbose

Podobnie jak w przypadku console.log(object [, object, ...]), ale z innym poziomem logowania.

console.debug('debug');

Wynik wywołania funkcji console.debug() w przykładzie powyżej.

console.dir(object)

Poziom logowania: Info

Wypisuje reprezentacje JSON określonego obiektu.

console.dir(document.head);

Wynik wywołania console.dir() w powyższym przykładzie.

console.dirxml(node)

Poziom logowania: Info

Wyświetla reprezentację XML potomków elementu node.

console.dirxml(document);

Wynik wywołania console.dirxml() w przykładzie powyżej.

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

Poziom logowania: Error

Wypisuje object w konsoli, formatuje go jako błąd i zawiera zrzut stosu.

console.error("I'm sorry, Dave. I'm afraid I can't do that.");

Wynik przykładu console.error() powyżej.

console.group(label)

wizualnie grupuje wiadomości, dopóki nie zostanie wywołana funkcja console.groupEnd(label). Użyj opcji console.groupCollapsed(label), aby złożyć grupę, gdy zostanie ona początkowo zapisana w konsoli.

const label = 'Adolescent Irradiated Espionage Tortoises';
console.group(label);
console.info('Leo');
console.info('Mike');
console.info('Don');
console.info('Raph');
console.groupEnd(label);

Wynik wywołania console.group() w przykładzie powyżej.

Możesz też tworzyć grupy zagnieżdżone.

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

Zagnieżdżone grupy.

console.groupCollapsed(label)

To samo co console.group(label), z tą różnicą, że grupa jest początkowo zwinięta, gdy jest zapisana w Konsoli.

console.groupEnd(label)

przestaje grupować wiadomości wizualnie. Zobacz console.group.

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

Poziom logowania: Info

Jest identyczne z console.log(object [, object, ...]).

console.info('info');

Wynik wywołania funkcji console.info() w przykładzie powyżej.

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

Poziom logowania: Info

Wypisuje komunikat w konsoli.

console.log('log');

Wynik przykładu console.log() powyżej.

console.table(array [, columns])

Poziom logowania: Info

Rejestruje tablicę obiektów jako tablicę.

var people = [
  {
    first: 'René',
    last: 'Magritte',
  },
  {
    first: 'Chaim',
    last: 'Soutine',
    birthday: '18930113',
  },
  {
    first: 'Henri',
    last: 'Matisse',
  }
];
console.table(people);

Wynik przykładu console.table() powyżej.

Domyślnie console.table() rejestruje wszystkie dane w tabeli. Aby wyświetlić pojedynczą kolumnę lub podzbiór kolumn, możesz użyć drugiego parametru opcjonalnego i podać nazwę lub nazwy kolumn jako ciąg znaków lub tablicę ciągów znaków. Na przykład:

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

Podzbiór kolumn w tabeli zarejestrowany za pomocą funkcji console.table().

console.time([label])

Uruchamia nowy minutnik. Wywołaj console.timeEnd([label]), aby zatrzymać minutnik i wydrukować upłynięty czas w Konsoli.

console.time();
for (var i = 0; i < 100000; i++) {
  let square = i ** 2;
}
console.timeEnd();

Wynik wywołania funkcji console.time() w przykładzie powyżej.

console.timeEnd([label])

Poziom logowania: Info

Zatrzymuje minutnik. Zobacz console.time().

console.trace()

Poziom logowania: Info

wypisuje ścieżkę śledzenia do konsoli;

const first = () => { second(); };
const second = () => { third(); };
const third = () => { fourth(); };
const fourth = () => { console.trace(); };
first();

Wynik wywołania console.trace() w przykładzie powyżej.

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

Poziom logowania: Warning

Wypisuje ostrzeżenie w Konsoli.

console.warn('warn');

Wynik wywołania console.warn() w przykładzie powyżej.