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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  
  ⚠ 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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

Informacja

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

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

  ℹ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  
  ⚠ 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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

Deprecated

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

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

  ✖ This is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  

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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  
  > 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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  
  > 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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  
    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 is the message of the diagnostic. It will appear in different colours based on the severity of the diagnostic.
  
  ✖ This log is an error.
  
  ℹ This log is a warning
  
  ℹ This log is an information
  
  This log doesn't have any category. Below, you'll have a command
  
  $ biome command
  
  Below, a group.
  
  I am a group
  
    ℹ First message of a group.
    
    ℹ Second message of a group.
    
  Below, a list.
  
  - First item
  - Second item
  
  Below, a diff.
  
  - Old·code
  + New·code
  
  Below, a code frame.
  
  > 1 │ Lorem
      │ ^^^
    2 │ Ipsum