Dokumentacja interfejsu API konsoli

Kayce Basques
Kayce Basques
Sofia Emelianowa
Sofia Emelianova

Używaj interfejsu Console API, aby zapisywać komunikaty w konsoli ze swojego kodu JavaScript. Interaktywne wprowadzenie do tego tematu zawiera artykuł Pierwsze kroki z rejestrowaniem wiadomości w konsoli.

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

Console.assert(wyrażenie; obiekt)

Poziom logu: Error

Zapisuje błąd w konsoli, gdy expression zwraca 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 działania konsoli.assert() opisanego powyżej 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 logu: Info

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

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

Wynik zastosowania funkcji setup.count() powyżej.

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. Możesz później użyć tego obiektu task do uruchomienia funkcji (f w poniższym przykładzie). task.run(f) wykonuje dowolny ładunek i przekierowuje wartość zwrotną z powrotem do elementu wywołującego.

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

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

task tworzy link między kontekstem tworzenia a kontekstem funkcji asynchronicznej. Ten link pozwala narzędziom deweloperskim wyświetlać lepsze zrzuty stosu w przypadku operacji asynchronicznych. Więcej informacji znajdziesz w artykule Połączone zrzuty stosu.

konsoli.debug(obiekt [, obiekt, ...])

Poziom logu: Verbose

Identyczna z wartością console.log(object [, object, ...]), ale z wyjątkiem innego poziomu logowania.

console.debug('debug');

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

console.dir(object)

Poziom logu: Info

Drukuje reprezentację określonego obiektu w formacie JSON.

console.dir(document.head);

Wynik zastosowania metody setup.dir() powyżej.

console.dirxml(node)

Poziom logu: Info

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

console.dirxml(document);

Wynik zastosowania metody setup.dirxml() powyżej.

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

Poziom logu: Error

Drukuje plik 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 zastosowanej wyżej metody konsoli.error().

console.group(label)

Graficznie grupuje wiadomości do momentu wywołania usługi 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 korzystania z przykładu konsoli.group() powyżej.

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 w przypadku 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.

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

Poziom logu: Info

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

console.info('info');

Wynik zastosowania metody setup.info() powyżej.

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

Poziom logu: Info

Drukuje wiadomość w konsoli.

console.log('log');

Wynik działania konsoli.log() powyżej.

konsoli.table(tablica [, kolumny])

Poziom logu: 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);

Rezultat wykonania podanego wyżej przykładu konsoli.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 w postaci ciągu znaków lub tablicy ciągów znaków. Na przykład:

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

Podzbiór kolumn w tabeli zarejestrowanej za pomocą konsoli.table().

console.time([label])

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

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 logu: Info

Zatrzymuje minutnik. Zobacz console.time().

console.trace()

Poziom logu: Info

Drukuje zrzut stosu w konsoli.

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

Wynik wykonania powyższego przykładu konsoli.trace().

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

Poziom logu: Warning

Drukuje ostrzeżenie w konsoli.

console.warn('warn');

Wynik zastosowanej wyżej metody konsoli.warn().