debug

Debug package usage guide. Use when adding debug logging, understanding log namespaces, or implementing debugging features. Triggers on debug logging requests or logging implementation.

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.