Informacje o funkcjach konsoli

Ta strona zawiera informacje o funkcjach związanych z konsolą Narzędzi deweloperskich w Chrome. Zakładamy, że wiesz już, jak wyświetlać zapisane wiadomości i uruchamiać skrypty JavaScript w konsoli. Jeśli nie, zapoznaj się z artykułem Rozpoczynanie.

Jeśli szukasz informacji o interfejsie API dotyczących funkcji takich jak console.log(), zapoznaj się z dokumentacją interfejsu Console API. Informacje o funkcjach takich jak monitorEvents() znajdziesz w dokumentacji interfejsu API Console Utilities.

Otwórz konsolę

Konsolę możesz otworzyć jako panel lub jako kartę w panelu bocznym.

Otwieranie panelu Konsoli

Naciśnij Control + Shift + J lub Command + Option + J (Mac).

Aby otworzyć konsolę z menu poleceń, zacznij wpisywać Console, a potem uruchom polecenie Pokaż konsolę, obok którego znajduje się plakietka Panel.

Otwórz konsolę w panelu

Naciśnij Escape lub kliknij Dostosowywanie i sterowanie narzędziami dla programistów , a następnie wybierz Pokaż panel konsoli.

U dołu okna DevTools pojawi się panel z otwartą kartą Konsola.

Aby otworzyć kartę Konsola z menu poleceń, zacznij wpisywać Console, a następnie uruchom polecenie Pokaż konsolę z plakietką Panel.

Otwórz ustawienia konsoli.

W prawym górnym rogu Konsoli kliknij  Ustawienia konsoli.

Linki poniżej zawierają opisy poszczególnych ustawień:

• Ukryj sieć
• Zachowaj dziennik
• Tylko wybrany kontekst
• Grupuj podobne wiadomości w konsoli
• Pokaż błędy CORS w konsoli
• Rejestruj żądania XMLHttpRequest
• Wartościowanie zachłanne
• Autouzupełnianie z historii

Otwieranie paska bocznego w Konsoli

Kliknij Pokaż pasek boczny konsoli , aby wyświetlić pasek boczny, który jest przydatny przy filtrowaniu.

Wyświetl wiadomości

Ta sekcja zawiera funkcje, które zmieniają sposób wyświetlania wiadomości w Konsoli. Aby zapoznać się z praktycznymi wskazówkami, przeczytaj artykuł Wyświetlanie wiadomości.

Wyłącz grupowanie wiadomości

Otwórz Ustawienia konsoli i wyłącz Grupuj podobne, aby wyłączyć domyślne grupowanie wiadomości w konsoli. Przykład znajdziesz w sekcji Rejestrowanie żądań XHR i Fetch.

Wyświetl komunikaty z punktów przerwania

Konsola oznacza wiadomości wywoływane przez punkty przerwania w ten sposób:

• console.* wywołania w warunkowych punktach przerwania z pomarańczowym znakiem zapytania ?
• Komunikaty punktów logowania z różowymi 2 kropkami ..

Aby przejść do wbudowanego edytora punktów kontrolnych w panelu Źródła, kliknij link kotwicy obok komunikatu o punkcie kontrolnym.

Wyświetlanie zrzutów stosu

Konsola automatycznie rejestruje zrzuty stosu w poszukiwaniu błędów i ostrzeżeń. Zrzut stosu to historia wywołań funkcji (ramek), które doprowadziły do błędu lub ostrzeżenia. Konsola wyświetla je w odwrotnej kolejności: najnowsza klatka jest na górze.

Aby wyświetlić zrzut stosu, kliknij ikonę rozwijania obok błędu lub ostrzeżenia.

Wyświetlanie przyczyn błędów w zrzutach stosu

Konsola może wyświetlić w zrzucie stosu łańcuchy przyczyn błędów (jeśli występują).

Aby ułatwić debugowanie, podczas przechwytywania i ponownie zgłaszania błędów możesz określić przyczyny błędów. Gdy Console przechodzi w górę łańcucha przyczyn, wypisuje każdy stos błędów z prefiksem Caused by:, aby można było znaleźć pierwotny błąd.

Wyświetlanie asynchronicznych zrzutów stosu

Jeśli używana przez Ciebie platforma obsługuje tę funkcję lub jeśli używasz bezpośrednio prymitywnych funkcji planowania w przeglądarce, takich jak setTimeout, DevTools może śledzić operacje asynchroniczne, łącząc ze sobą obie części kodu asynchronicznego.

W tym przypadku zrzut stosu pokazuje „pełną historię” operacji asynchronicznej.

wyświetlanie znanych ramek innych firm w śladach stosu,

Gdy mapy źródeł zawierają pole ignoreList, Console domyślnie ukrywa w śladach stosu ramki innych firm ze źródeł wygenerowanych przez narzędzia do tworzenia pakietów (np. webpack) lub frameworki (np. Angular).

Aby wyświetlić pełny ślad pakietu, w tym ramki kodu innych firm, u dołu ścieżki pakietu kliknij Pokaż N dodatkowych ramek.

Aby zawsze wyświetlać pełny zrzut stosu, wyłącz ustawienie Ustawienia > Lista ignorowanych > Automatycznie dodawaj znane skrypty innych firm do listy ignorowanych.

Rejestrowanie żądań XHR i pobierania

Otwórz Ustawienia konsoli i włącz opcję Rejestruj żądania XMLHttpRequest, aby rejestrować w konsoli wszystkie żądania XMLHttpRequest i Fetch w miarę ich pojawiania się.

Górny komunikat w przykładzie powyżej pokazuje domyślne zachowanie konsoli podczas grupowania. Poniższy przykład pokazuje, jak wygląda ten sam dziennik po wyłączeniu grupowania wiadomości.

zachowywać wiadomości po wczytaniu stron;

Domyślnie Konsola jest czyszczona po załadowaniu nowej strony. Aby wiadomości były dostępne podczas wczytywania strony, otwórz Ustawienia konsoli i odznacz pole wyboru Zachowaj dziennik.

Ukrywanie komunikatów sieciowych

Domyślnie przeglądarka rejestruje wiadomości sieciowe w konsoli. Na przykład pierwsza wiadomość w tym przykładzie to błąd 404.

Aby ukryć komunikaty o sieci:

1. Otwórz ustawienia konsoli.
2. Zaznacz pole wyboru Ukryj sieć.

Wyświetlanie i ukrywanie błędów CORS

Konsola może wyświetlać błędy CORS, jeśli żądania sieciowe nie powiedzie się z powodu współdzielenia zasobów między serwerami z różnych domen (CORS).

Aby wyświetlić lub ukryć błędy CORS:

1. Otwórz ustawienia konsoli.
2. Zaznacz lub odznacz pole wyboru Pokaż błędy CORS w konsoli.

Jeśli konsola jest skonfigurowana tak, aby wyświetlać błędy CORS, możesz kliknąć obok nich te przyciski:

• , aby otworzyć żądanie z TypeError związanym z CORS w panelu Sieć.
• , aby uzyskać potencjalne rozwiązanie na karcie Problemy.

Filtruj wiadomości

Wiadomości w konsoli można filtrować na wiele sposobów.

Filtrowanie komunikatów przeglądarki

Otwórz pasek boczny konsoli i kliknij Komunikaty dla użytkownika, aby wyświetlić tylko komunikaty pochodzące z kodu JavaScript strony.

Filtruj według poziomu logu

Narzędzia deweloperskie przypisują poziomy ważności do większości metod console.*.

Dostępne są 4 poziomy:

• Verbose
• Info
• Warning
• Error

Na przykład console.log() należy do grupy Info, a console.error() do grupy Error. W przewodniku po interfejsie API Konsoli znajdziesz informacje o poważnym poziomie każdej metody.

Każdy komunikat, który przeglądarka rejestruje w konsoli, ma też poziom ważności. Możesz ukryć dowolny poziom wiadomości, który Cię nie interesuje. Jeśli na przykład interesują Cię tylko wiadomości Error, możesz ukryć pozostałe 3 grupy.

Kliknij menu Poziomy dziennika, aby włączyć lub wyłączyć wiadomości Verbose, Info, Warning lub Error.

Możesz też filtrować według poziomu logowania. Aby to zrobić, otwórz pasek boczny Konsoli, a potem kliknij Błędy, Ostrzeżenia, Informacje lub Szczegóły.

Filtrowanie wiadomości według adresu URL

Aby wyświetlić tylko wiadomości pochodzące z tego adresu URL, wpisz url:, a następnie adres URL. Po wpisaniu url: DevTools wyświetla wszystkie odpowiednie adresy URL.

Domeny też działają. Jeśli na przykład skrypty https://example.com/a.js i https://example.com/b.js rejestrują wiadomości, możesz użyć opcji url:https://example.com, aby skupić się na wiadomościach z tych 2 skryptów.

Aby ukryć wszystkie wiadomości z określonego adresu URL, wpisz -url:, a następnie adres URL, na przykład https://b.wal.co. To jest filtr wykluczającego adresu URL.

Aby wyświetlić wiadomości z jednego adresu URL, otwórz pasek boczny konsoli, rozwiń sekcję Wiadomości użytkowników i kliknij adres URL skryptu zawierającego wiadomości, na których chcesz się skupić.

Filtrowanie wiadomości z różnych kontekstów

Załóżmy, że na Twojej stronie znajduje się reklama. Reklama jest umieszczona w <iframe> i generuje w konsoli wiele komunikatów. Ta reklama znajduje się w innym kontekście JavaScriptu, więc aby ukryć jej komunikaty, możesz otworzyć Ustawienia konsoli i odznaczyć pole wyboru Tylko wybrany kontekst.

odfiltrowywać wiadomości, które nie pasują do wyrażenia regularnego;

Aby odfiltrować wiadomości, które nie pasują do tego wzorca, wpisz wyrażenie regularne, np. /[foo]\s[bar]/, w polu tekstowym Filtr. Spacje nie są obsługiwane. Zamiast nich użyj \s. Narzędzia deweloperskie sprawdzają, czy wzorzec znajduje się w tekście wiadomości lub skrypcie, który spowodował logowanie wiadomości.

Na przykład ten filtr odfiltrowuje wszystkie wiadomości, które nie pasują do /[gm][ta][mi]/.

Wyszukiwanie tekstu w logach

Aby wyszukać tekst w wiadomościach z logu:

1. Aby otworzyć wbudowany pasek wyszukiwania, naciśnij Command + F (Mac) lub Ctrl + F (Windows, Linux).
2. Na pasku wpisz zapytanie. W tym przykładzie zapytanie to legacy. Opcjonalnie możesz:
   • Aby zapytanie uwzględniało wielkość liter, kliknij Zgodność wielkości liter.
   • Aby wyszukać za pomocą wyrażenia regularnego, kliknij  Użyj wyrażenia regularnego.
3. Naciśnij Enter. Aby przejść do poprzedniego lub następnego wyniku wyszukiwania, naciśnij przycisk w górę lub w dół.

Uruchom kod JavaScript

Ta sekcja zawiera funkcje związane z uruchamianiem JavaScriptu w konsoli. Praktyczny przewodnik znajdziesz w sekcji Uruchamianie JavaScriptu.

Opcje kopiowania tekstu

Domyślnie konsola generuje ciągi znaków jako prawidłowe literały JavaScript. Kliknij dane wyjściowe prawym przyciskiem myszy i wybierz jedną z 3 opcji kopiowania:

• Kopiuj jako literał JavaScript. Zmienia znaczenie odpowiednich znaków specjalnych i okala ciąg znaków w cudzysłowie pojedynczym, podwójnym lub odwróconym w zależności od treści.
• Kopiuj zawartość ciągu znaków. Kopiuje do schowka dokładnie ten nieprzetworzony ciąg znaków, w tym nowe wiersze i inne znaki specjalne.
• Kopiuj jako literał JSON. Formatuje ciąg na prawidłowy kod JSON.

Ponowne wykonywanie wyrażeń z historii

Aby przewijać historię wyrażeń JavaScript, które zostały wcześniej wykonane w Konsoli, naciskaj klawisz strzałka w górę. Aby ponownie uruchomić wyrażenie, naciśnij Enter.

Sprawdzanie wartości wyrażenia w czasie rzeczywistym za pomocą funkcji Live Expressions

Jeśli w Konsoli wielokrotnie wpisujesz ten sam wyrażenie JavaScriptu, łatwiej Ci będzie utworzyć wyrażenie na żywo. Dzięki wyrażeniom na żywo wpisujesz wyrażenie raz, a potem przypinasz je u góry konsoli. Wartość wyrażenia jest aktualizowana niemal w czasie rzeczywistym. Zobacz wartości wyrażeń JavaScript w czasie rzeczywistym za pomocą wyrażeń na żywo.

Wyłącz ocenę gotowości

Gdy będziesz wpisywać wyrażenia JavaScript w konsoli, funkcja Eager Evaluation wyświetli podgląd zwracanej wartości tego wyrażenia. Otwórz Ustawienia konsoli i odznacz pole wyboru Szybka ocena, aby wyłączyć podgląd wartości zwracanej.

Aktywacja użytkownika za pomocą oceny

Aktywacja użytkownika to stan sesji przeglądania, który zależy od działań użytkownika. Stan „aktywny” oznacza, że użytkownik obecnie wchodzi w interakcję ze stroną lub wszedł w nią od momentu jej wczytania.

Aby aktywować użytkownika za pomocą dowolnej oceny, otwórz Ustawienia konsoli i zaznacz Treści Traktuj ocenę kodu jako działanie użytkownika.

Wyłączanie autouzupełniania z historii

Gdy wpisujesz wyrażenie, wyskakujące okienko autouzupełniania w Konsoli wyświetla wyrażenia, które zostały wcześniej wykonane. Te wyrażenia są poprzedzone znakiem >. W tym przykładzie DevTools wcześniej oceniły document.querySelector('a') i document.querySelector('img').

Otwórz ustawienia konsoli i wyłącz pole wyboru Autouzupełnianie z historii, aby nie wyświetlały się wyrażenia z historii.

Wybieranie kontekstu JavaScript

Domyślnie menu Kontekst JavaScript ma wartość top, która reprezentuje kontekst przeglądania głównego dokumentu.

Załóżmy, że na stronie masz reklamę umieszczoną w elementach <iframe>. Chcesz uruchomić JavaScript, aby dostosować DOM reklamy. Aby to zrobić, musisz najpierw wybrać kontekst przeglądania reklamy w menu Kontekst JavaScriptu.

Sprawdzanie właściwości obiektu

Konsola może wyświetlać interaktywną listę właściwości wybranego obiektu JavaScript.

Aby przejrzeć listę, wpisz nazwę obiektu w Konsoli i naciśnij Enter.

Aby sprawdzić właściwości obiektów DOM, wykonaj czynności opisane w artykule Wyświetlanie właściwości obiektów DOM.

rozpoznawać właściwości własne i odziedziczone;

Konsola sortuje właściwości własnych obiektów na pierwszym miejscu i wyróżnia je pogrubioną czcionką.

Właściwości odziedziczone z łańcucha prototypów są zapisywane zwykłą czcionką. Konsola wyświetla je w obiekcie, oceniając odpowiednie natywne metody dostępu do wbudowanych obiektów.

Ocena akcesoriów niestandardowych

Domyślnie Narzędzia dewelopera nie oceniają utworzonych przez Ciebie funkcji dostępu. Aby ocenić niestandardowy interfejs dostępu obiektu, kliknij (...).

Właściwości zliczalne i niewyliczalne

Właściwości zliczalne mają jaskrawy kolor. Właściwości niewyliczalne są wyciszone. Właściwości z metodą pętli for … in lub metodą Object.keys() mogą być przetwarzane.

sprawdzać prywatne właściwości instancji klasy;

Konsola oznacza właściwości prywatne wystąpień klasy z prefiksem #.

Konsola może też automatycznie wypełniać właściwości prywatne, nawet jeśli oceniasz je poza zakresem klasy.

Sprawdzanie wewnętrznych właściwości JavaScriptu

Korzystając z notacji ECMAScript, Konsola umieszcza niektóre właściwości wewnętrzne w JavaScript w podwójnych nawiasach kwadratowych. Nie możesz wchodzić w interakcję z tymi usługami w kodze. Warto jednak je sprawdzić.

W różnych obiektach możesz zobaczyć te wewnętrzne właściwości:

• Każdy obiekt ma [[Prototype]].
• Opakowania prymitywne mają właściwość [[PrimitiveValue]].
• Obiekty ArrayBuffer mają te właściwości:
  • [[Int8Array]], [[Uint8Array]], [[Int16Array]], [[Int32Array]]
  • [[ArrayBufferByteLength]], [[ArrayBufferData]]
• Oprócz właściwości ArrayBuffer obiekty WebAssembly.Memory mają też właściwość [[WebAssemblyMemory]].
• Kolekcje z kluczami (mapy i zbiory) mają właściwość [[Entries]], która zawiera ich kluczowe wpisy.
• Obiekty Promise mają te właściwości:
  • [[PromiseState]]: oczekująca, zrealizowana lub odrzucona
  • [[PromiseResult]]: undefined, jeśli jest oczekująca, <value>, jeśli jest zrealizowana, <reason>, jeśli została odrzucona.
• obiekty Proxy mają te właściwości: obiekt [[Handler]], obiekt [[Target]] i obiekt [[isRevoked]] (wyłączony lub nie).

Sprawdzanie funkcji

W JavaScriptie funkcje są też obiektami z właściwościami. Jeśli jednak wpiszesz nazwę funkcji w konsoli, DevTools ją wywoła, zamiast wyświetlać jej właściwości.

Aby wyświetlić właściwości funkcji wewnętrzne w języku JavaScript, użyj polecenia console.dir().

Funkcje mają te właściwości:

• [[FunctionLocation]]. Link do wiersza z definicją funkcji w pliku źródłowym.
• [[Scopes]]. Zawiera listę wartości i wyrażeń, do których funkcja ma dostęp. Aby sprawdzić zakresy funkcji podczas debugowania, zapoznaj się z artykułem Wyświetlanie i edytowanie właściwości lokalnych, zamkniętych i globalnych.
• Funkcje związane mają te właściwości:
  • [[TargetFunction]]. Docelowy element bind().
  • [[BoundThis]]. Wartość this.
  • [[BoundArgs]]. Tablica argumentów funkcji.
• Funkcje generatora są oznaczone właściwością [[IsGenerator]]: true.
• Generatory zwracają obiekty iteracyjne, które mają te właściwości:
  • [[GeneratorLocation]]. Link do wiersza z definicją generatora w pliku źródłowym.
  • [[GeneratorState]]: suspended, closed lub running.
  • [[GeneratorFunction]]. Generator, który zwrócił obiekt.
  • [[GeneratorReceiver]]. Obiekt, który odbiera wartość.

Wyczyszczenie konsoli

Aby wyczyścić konsolę, możesz użyć dowolnego z tych procesów:

• Kliknij Wyczyść konsolę.
• Kliknij wiadomość prawym przyciskiem myszy i wybierz Wyczyść konsolę.
• Wpisz clear() w Konsoli i naciśnij Enter.
• Wywołaj funkcję console.clear() z JavaScriptu strony internetowej.
• Naciśnij Control + L, gdy Konsola jest aktywna.