Repolode
投稿する
fullstack-build

fullstack-build/tslog

見やすいターミナル出力、フィールド優先の構造化JSON、秘密情報のマスキングに対応した、ランタイム依存ゼロのTypeScript・JavaScript向け汎用ロガー。

GitHub で見る公式サイト
スター
1,750
フォーク
74
未解決の Issue
2
最終コミット
15 時間前

これは何？

tslogは、Node.js、ブラウザー、Deno、Bun、workers、React Nativeで同じAPIを使えるTypeScript・JavaScript向けロギングライブラリです。デフォルトでは、対話型ターミナルでは色付きの読みやすい形式で、出力をパイプした場合やCIで実行した場合はプレーンテキストでログを出力します。また、本番環境のログパイプライン向けに、フラットなフィールド優先のJSON形式を有効にできます。

カスタムレベルに対応したログレベル、設定とバインド済みフィールドを引き継ぐ子ロガー、ログ出力に秘密情報が含まれないようにするキー・パス・正規表現マッチのマスキングなど、一般的なニーズをカバーしています。エラーとスタックトレースは整形・シリアライズされ、Node、Bun、Denoではソースマップによって位置を元のTypeScriptファイルに対応付けられます。

出力先の振り分けには、ファイル、HTTPエンドポイント、メモリー内リングバッファー、worker threads向けのトランスポートを利用できます。また、pino互換またはOpenTelemetry OTLP/JSON形式で出力するプリセットも用意されています。コアパッケージにはランタイム依存関係がなく、サイズを重視するブラウザーバンドル向けに軽量なサブパスも利用できます。

主な機能

  • 01Node.js、ブラウザー、Deno、Bun、workers、React Nativeで共通のAPI
  • 02ターミナルでは色付きの見やすい出力、パイプ時はプレーンテキストで出力し、JSON形式にも対応
  • 03キー名、JSONパス、正規表現、ハッシュ化プレースホルダーによる秘密情報のマスキング
  • 04設定とバインド済みフィールドを引き継ぐ子ロガー
  • 05ファイル、HTTP、リングバッファー、worker threads向けのプラuggableなトランスポート
  • 06ランタイム依存関係ゼロで、TypeScriptの型定義を提供

ユースケース

  • 本番環境ではJSON形式で出力する、Node.jsサービスへの一貫したロギングの導入
  • ブラウザーとサーバーの両方で動作する共有モジュールからのログ出力
  • ログがプロセス外に送られる前にパスワードやトークンをマスキング
  • ファイル、HTTPコレクター、OpenTelemetryエンドポイントへのログ送信

クイックスタート

  1. 1

    npmからtslogをインストールする

    npm install tslog
  2. 2

    Loggerをインポートしてメッセージをログに出力する

使う前に知っておきたいこと

  • Node.js 22以降が必要です。ESM専用のため、CommonJSのrequire()には対応していません。
  • バージョン5は後方互換性のない再設計のため、v4からアップグレードするにはコードの変更が必要です。

トピック

#logging#typescript#javascript#logger#structured-logging#json#observability#error-handling#exceptions#json-api

よくある質問

tslog とは？
見やすいターミナル出力、フィールド優先の構造化JSON、秘密情報のマスキングに対応した、ランタイム依存ゼロのTypeScript・JavaScript向け汎用ロガー。 tslogは、Node.js、ブラウザー、Deno、Bun、workers、React Nativeで同じAPIを使えるTypeScript・JavaScript向けロギングライブラリです。デフォルトでは、対話型ターミナルでは色付きの読みやすい形式で、出力をパイプした場合やCIで実行した場合はプレーンテキストでログを出力します。また、本番環境のログパイプライン向けに、フラットなフィールド優先のJSON形式を有効にできます。
tslog は無料で使えますか？ライセンスは？
tslog は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
tslog は今もメンテナンスされていますか？
活発にメンテナンス中。tslog の最終コミットは 2026年10月20日 です。
tslog は何に使えますか？
本番環境ではJSON形式で出力する、Node.jsサービスへの一貫したロギングの導入 ブラウザーとサーバーの両方で動作する共有モジュールからのログ出力 ログがプロセス外に送られる前にパスワードやトークンをマスキング ファイル、HTTPコレクター、OpenTelemetryエンドポイントへのログ送信
tslog のインストール方法は？
npmからtslogをインストールする: npm install tslog Loggerをインポートしてメッセージをログに出力する
tslog はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/fullstack-build/tslog

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト