debug-package について
`debug`パッケージの利用ガイドです。ログの名前空間、書式指定子、ブラウザー・Node.js・Electronでのデバッグ出力の有効化方法を説明します。
主な機能
- 01領域別の名前空間規則
- 02オブジェクト・文字列・数値の書式指定子
- 03ブラウザーでのデバッグ出力有効化
- 04Node.jsとElectronでのデバッグ出力有効化
活用シーン
- 01サーバーコードに名前空間付きログを追加
- 02デバッグ出力でオブジェクト値を確認
- 03ブラウザー開発時にログを有効化
- 04Node.jsやElectronでデバッグを有効化
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lobehub/ lobehub --skill debug-packageインストール後、Claude Code で/debug-packageを入力して読み込まれたか確認します。
詳細
Debug パッケージの使用ガイド
基本的な使い方
import debug from 'debug';
// Format: lobe-[module]:[submodule]
const log = debug('lobe-server:market');
log('Simple message');
log('With variable: %O', object);
log('Formatted number: %d', number);
名前空間の規則
- デスクトップ:
lobe-desktop:[module] - サーバー:
lobe-server:[module] - クライアント:
lobe-client:[module] - ルーター:
lobe-[type]-router:[module]
書式指定子
%O- 展開されたオブジェクト(複雑なオブジェクトに推奨)%o- オブジェクト%s- 文字列%d- 数値
デバッグ出力を有効にする
ブラウザー
localStorage.debug = 'lobe-*';
Node.js
DEBUG=lobe-* bun run dev
DEBUG=lobe-* pnpm dev
Electron
process.env.DEBUG = 'lobe-*';
例
// apps/server/src/routers/lambda/agentEval.ts
import debug from 'debug';
const log = debug('lobe-lambda-router:agent-eval');
log('getAgent input: %O', input);
コメント
Markdown 対応