Dokumentacja interfejsu API konsoli

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Użyj interfejsu Console API, aby zapisywać wiadomości w konsoli z poziomu JavaScriptu. Interaktywne wprowadzenie do tego tematu znajdziesz w artykule Zacznij rejestrować komunikaty logu 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(expression, object)

Poziom logowania: Error

Zapisuje błąd w konsoli, 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 działania powyższego przykładu console.assert().

console.clear()

Czyści konsolę.

console.clear();

Jeśli włączona jest opcja Zachowaj logi, 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() w tym samym wierszu i z tą samą etykietą label. Aby zresetować liczbę, wywołaj funkcję console.countReset([label]).

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

Wynik działania powyższego przykładu console.count().

console.countReset([label])

Resetuje liczbę.

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

console.createTask(name)

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

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

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

Obiekt task tworzy połączenie między kontekstem tworzenia a kontekstem funkcji asynchronicznej. To połączenie umożliwia Narzędziom deweloperskim wyświetlanie lepszych zrzutów stosu w przypadku operacji asynchronicznych. Więcej informacji znajdziesz w sekcji Połączone zrzuty stosu.

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

Poziom logowania: Verbose

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

console.debug('debug');

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

console.dir(object)

Poziom logowania: Info

Wyświetla reprezentację JSON określonego obiektu.

console.dir(document.head);

Wynik powyższego przykładu console.dir().

console.dirxml(node)

Poziom logowania: Info

Wyświetla reprezentację XML elementów podrzędnych node.

console.dirxml(document);

Wynik działania powyższego przykładu console.dirxml().

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

Poziom logowania: Error

Wyświetla 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 powyższego przykładu console.error().

console.group(label)

Wizualnie grupuje wiadomości do momentu wywołania funkcji console.groupEnd(label). Użyj funkcji console.groupCollapsed(label), aby zwinąć grupę, gdy jest ona początkowo rejestrowana 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 działania funkcji console.group() z przykładu powyżej.

Dodatkowo możesz 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, gdy jest rejestrowana w konsoli.

console.groupEnd(label)

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

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

Poziom logowania: Info

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

console.info('info');

Wynik działania powyższego przykładu console.info().

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

Poziom logowania: Info

Wyświetla wiadomość w konsoli.

console.log('log');

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

console.table(array [, columns])

Poziom logowania: 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 przykładu console.table() powyżej.

Domyślnie funkcja console.table() rejestruje wszystkie dane tabeli. Aby wyświetlić jedną kolumnę lub podzbiór kolumn, możesz użyć drugiego opcjonalnego parametru i określić 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 zarejestrowanej za pomocą funkcji console.table().

Aby skopiować zarejestrowaną tabelę do schowka jako sformatowaną tabelę Markdown lub dane CSV, kliknij prawym przyciskiem myszy tabelę w konsoli i wybierz odpowiednią opcję kopiowania z menu kontekstowego.

console.time([label])

Uruchamia nowy minutnik. Aby zatrzymać minutnik i wyświetlić czas, który upłynął, w konsoli, wywołaj funkcję console.timeEnd([label]).

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

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

console.timeEnd([label])

Poziom logowania: Info

Zatrzymuje minutnik. Zobacz console.time().

console.trace()

Poziom logowania: Info

Wyświetla zrzut stosu w konsoli.

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

Wynik powyższego przykładu console.trace().

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

Poziom logowania: Warning

Wyświetla ostrzeżenie w konsoli.

console.warn('warn');

Wynik działania powyższego przykładu console.warn().