Dokumentacja interfejsu API konsoli

Sofia Emelianova
Sofia Emelianova

Interfejs Console API służy do zapisywania komunikatów w konsoli z poziomu JavaScriptu. Interaktywne wprowadzenie do tego tematu znajdziesz w artykule Pierwsze kroki z rejestrowaniem wiadomości w konsoli.

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

Console.assert(wyrażenie; obiekt)

Poziom rejestrowania: Error

Zapisuje w konsoli błąd, gdy expression przyjmuje wartość false.

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

Wynik instrukcji Console.assert() z powyższego przykładu.

console.clear()

Czyści konsolę.

console.clear();

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

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

console.count([label])

Poziom rejestrowania: Info

Zapisuje liczbę wywołań funkcji count() w tym samym wierszu i z tym samym poleceniem label. Zadzwoń pod numer console.countReset([label]), aby zresetować licznik.

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

Wynik powyższego przykładu konsoli.count().

console.countReset([label])

Resetuje licznik.

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

console.createTask(name)

Zwraca instancję Task, która wiąże bieżący zrzut stosu z utworzonym obiektem task. Później możesz użyć tego obiektu task do uruchomienia funkcji (f w przykładzie poniżej). task.run(f) wykonuje dowolny ładunek i przekazuje zwracaną wartość z powrotem do elementu wywołującego.

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

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

Element task łączy kontekst tworzenia z kontekstem funkcji asynchronicznej. Ten link umożliwia Narzędziach deweloperskich wyświetlanie lepszych zrzutów stosu operacji asynchronicznych. Więcej informacji znajdziesz w artykule Śledzenie połączeń połączonych stosów.

Console.debug(object [, obiekt, ...])

Poziom rejestrowania: Verbose

Identyczny z console.log(object [, object, ...]), ale inny poziom logowania.

console.debug('debug');

Wynik powyższego przykładu Console.debug().

console.dir(object)

Poziom rejestrowania: Info

Wyświetla reprezentację określonego obiektu w formacie JSON.

console.dir(document.head);

Wynik podany powyżej w przykładzie konsoli.dir().

console.dirxml(node)

Poziom rejestrowania: Info

Drukuje reprezentację XML elementów podrzędnych elementu node.

console.dirxml(document);

Wynik powyższego przykładu pola Console.dirxml().

Console.error(obiekt [, obiekt, ...])

Poziom rejestrowania: Error

Powoduje wydrukowanie pliku object w konsoli, formatowanie go jako błędu i umieszczenie zrzutu stosu.

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

Wynik podany powyżej w przykładzie konsoli.error().

console.group(label)

Wizualnie grupuje wiadomości do momentu wywołania funkcji console.groupEnd(label). Użyj console.groupCollapsed(label), aby zwinąć grupę po pierwszym zalogowaniu się 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 powyższego przykładu konsoli.group().

Możesz też zagnieżdżać grupy.

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)

Tak samo jak console.group(label), z tą różnicą, że grupa jest początkowo zwinięta po zalogowaniu się w Konsoli.

console.groupEnd(label)

Zatrzymuje wizualne grupowanie wiadomości. Zobacz console.group.

Console.info(obiekt [, obiekt, ...])

Poziom rejestrowania: Info

Identyczna z wartością console.log(object [, object, ...]).

console.info('info');

Wynik powyższego przykładu konsoli.info().

Console.log(obiekt [, obiekt, ...])

Poziom rejestrowania: Info

Drukuje wiadomość do konsoli.

console.log('log');

Wynik powyższego przykładu Console.log().

Console.table(tablica [, kolumny])

Poziom rejestrowania: Info

Rejestruje tablicę obiektów jako tabelę.

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

Wynik powyższego przykładu zastosowania Console.table().

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

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

Podzbiór kolumn w tabeli zapisany w tabeli za pomocą funkcji Console.table().

console.time([label])

Uruchamia nowy minutnik. Wywołaj console.timeEnd([label]), aby zatrzymać minutnik i wydrukować w konsoli czas, który upłynął.

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

Wynik powyższego przykładu konsoli.time().

console.timeEnd([label])

Poziom rejestrowania: Info

Zatrzymuje minutnik. Zobacz console.time().

console.trace()

Poziom rejestrowania: Info

Drukuje zrzut stosu do konsoli.

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

Wynik powyższego przykładu zastosowania Console.trace().

Console.warn(obiekt [, obiekt, ...])

Poziom rejestrowania: Warning

Wyświetla ostrzeżenie w konsoli.

console.warn('warn');

Wynik powyższego przykładu zastosowania Console.warn().