debug

Skill do obsługi pakietu debug w projektach Lobe. Ułatwia dodawanie logów diagnostycznych, zarządzanie namespace'ami (desktop, server, client, router) i formatowanie danych w konsoli. Używaj go, gdy implementujesz funkcje debugowania lub chcesz zrozumieć strukturę logowania w kodzie. Wspiera Node.js, przeglądarki i Electron.

1. Zaimportuj pakiet debug na początku pliku, w którym chcesz dodać logi: import debug from 'debug';. Następnie utwórz instancję loggera z odpowiednią nazwą namespace'u — format to lobe-[środowisko]:[moduł], na przykład lobe-server:market dla serwera lub lobe-desktop:auth dla aplikacji desktopowej.

2. Używaj loggera do wypisywania wiadomości debugowania. Dla prostych tekstów wpisz log('Wiadomość'), a dla zmiennych stosuj formatery: %O dla rozwinięcia obiektu (najczęściej używany), %o dla obiektu zwartego, %s dla tekstu, %d dla liczb. Przykład: log('Dane użytkownika: %O', userData).

3. Włącz wyświetlanie logów w zależności od środowiska. W przeglądarce otwórz konsolę i wpisz localStorage.debug = 'lobe-*', aby zobaczyć wszystkie logi z namespace'ami zaczynającymi się na lobe-. W Node.js uruchom aplikację z zmienną środowiskową: DEBUG=lobe-* npm run dev lub DEBUG=lobe-* pnpm dev. W Electron ustaw process.env.DEBUG = 'lobe-*' w kodzie inicjalizacji.

4. Jeśli chcesz logować tylko określony moduł, zawęź namespace — zamiast lobe-* użyj lobe-server:market, aby zobaczyć tylko logi z tego konkretnego modułu.

5. Sprawdź logi w konsoli lub DevTools — powinny pojawić się z kolorowym prefixem namespace'u, co ułatwia śledzenie źródła każdej wiadomości.