Diagnostyki

Diagnostyki Biome są pełne informacji i zazwyczaj dostarczają wszystkich informacji potrzebnych do zrozumienia błędów i ich naprawy.

Diagnostyki nie są używane tylko do błędów, ale również do dostarczania ustrukturyzowanych informacji, ostrzeżeń i wskazówek.

Ta strona zawiera podział wszystkich informacji, które diagnostyka może zawierać. Poznanie wszystkich różnych części diagnostyki może pomóc ci zidentyfikować ważne części i niektóre “sekrety” za nimi.

Ważność diagnostyki

Ważność diagnostyki może wpływać na CLI. Na przykład diagnostyki błędów zmuszą CLI do zakończenia z kodem błędu.

Fatal

Diagnostyki błędów mają czerwony tekst. Diagnostyki fatalne są zazwyczaj emitowane, gdy wystąpił nieoczekiwany błąd wewnątrz Biome. W porównaniu do błędów, mają tag fatal.

 FATAL  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  
  ⚠ Biome exited as this error could not be handled and resulted in a fatal error. Please report it if necessary.
  

Błąd

Diagnostyki błędów mają czerwony tekst. Zazwyczaj powinny być rozwiązane, ponieważ będą emitować kod błędu, gdy napotkane przez CLI.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  

Ostrzeżenie

Diagnostyki ostrzeżeń mają żółty tekst. Zazwyczaj powinny być rozwiązane. Ostrzeżenia nie są blokerami i nie zatrzymają działania CLI.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ⚠ This diagnostic message is displayed in a color that reflects its severity.
  

Informacja

Diagnostyki informacyjne mają zielony tekst. Dostarczają użytecznych informacji i nie są przeznaczone do blokowania CLI.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ This diagnostic message is displayed in a color that reflects its severity.
  

Tagi diagnostyki

Tagi można postrzegać jako metadane dołączone do diagnostyki i mogą wpływać na klientów w różny sposób.

Verbose

Diagnostyki verbose są zazwyczaj ukryte. Przez CLI możesz pokazać te diagnostyki używając opcji --verbose.

 VERBOSE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  

Internal

Diagnostyki wewnętrzne są emitowane, gdy wystąpił błąd wewnętrzny. Użytkownicy są zazwyczaj zachęcani do zgłoszenia błędu, gdy je zobaczą.

 INTERNAL  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  
  ⚠ This diagnostic was derived from an internal Biome error. Potential bug, please report it if necessary.
  

Fixable

Diagnostyki naprawialne są emitowane dla tych szczególnych sytuacji, które mogą być naprawione przez użytkownika. Są zazwyczaj używane dla diagnostyk lint, które mają akcję kodu.

 FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  

Deprecated

Diagnostyki, które zawierają kod, który jest przestarzały

 DEPRECATED  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  

Kategoria diagnostyki

Kategoria służy do grupowania diagnostyk. Opcjonalnie, kategoria może mieć link, na przykład dla kategorii należących do reguł lint, jak w przykładzie poniżej.

Prosta kategoria

Ta diagnostyka należy do kategorii “check”, co oznacza, że jest emitowana podczas wykonywania polecenia check:

check ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  

Kategoria z linkiem

Ta diagnostyka należy do kategorii "lint/a11y/noAccessKey". Link przenosi użytkownika na stronę internetową reguły lint noAccessKey.

lint/a11y/noAccessKey ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  

Lokalizacja diagnostyki

Diagnostyki mogą mieć “lokalizację”. Lokalizacja składa się z trzech, opcjonalnych, części:

• zasób, który jest źródłem, które wyemitowało diagnostykę;
• kod źródłowy pliku;
• zakres (lub zakres tekstu), zazwyczaj linia i kolumna wewnątrz pliku.

Ścieżka pliku diagnostyki

Ścieżka pliku jest zazwyczaj pierwszą informacją, którą widzisz, w lewym górnym rogu diagnostyki.

path/to/file.js ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  

Kod źródłowy diagnostyki

To pokazuje, jak kod źródłowy powiązany z plikiem jest wyświetlany. Zauważ, że linia i kolumny nie są pokazane.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  
  > 1 │ Some source code
      │      ^^^^^
  

Linia i kolumna diagnostyki

Linia i kolumna są zazwyczaj drukowane obok ścieżki pliku i są pokazywane tylko wtedy, gdy jest jakiś kod źródłowy powiązany z nią.

path/to/file.txt:1:6 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  
  > 1 │ Some source code
      │      ^^^^^^
  

Gdy diagnostyki są drukowane wewnątrz terminala IDE, możesz kliknąć path/to/file.js:2:2, a IDE otworzy odpowiedni plik i umieści kursor na początku zakresu.

path/to/file.js:2:2 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  
    1 │ function name() {
  > 2 │ 	return 'lorem'
      │ 	^^^^^^^^^^^^^^
    3 │ }
  

Porady diagnostyki

Dodatkowo, nasze diagnostyki mogą przechowywać porady. Porady są dodatkowymi wiadomościami, które mogą być dołączone po oryginalnej wiadomości.

Te porady przychodzą w różnych rodzajach i kształtach. Zazwyczaj porady są zawsze drukowane, chyba że są to porady verbose.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ This diagnostic message is displayed in a color that reflects its severity.
  
  ✖ An error message.
  
  ⚠ A warning message.
  
  ℹ An informational message.
  
  An unstyled message can introduce a command:
  
  $ biome command
  
  Messages can be grouped under a heading:
  
  Related information
  
    ℹ First message of a group.
    
    ℹ Second message of a group.
    
  Messages can also be displayed as a list:
  
  - First item
  - Second item
  
  A diff can show a suggested change:
  
  - Old·code
  + New·code
  
  A code frame can highlight a source range:
  
  > 1 │ Lorem
      │ ^^^
    2 │ Ipsum