npm が使用するロガー ユーティリティ。
このロガーは非常に基本的なものです。 npm のログを記録します。カスタム レベルとカラー出力をサポートします。
デフォルトでは、ログは stderr に書き込まれます。ストリーム以外の出力にログ メッセージを送信したい場合は、 log.stream
メンバーを変更することも、それが発行するイベントをリッスンするだけで、そのイベントに対して必要な操作を行うこともできます。
npm install npmlog --save
var log = require ( 'npmlog' )
// additional stuff ---------------------------+
// message ----------+ |
// prefix ----+ | |
// level -+ | | |
// v v v v
log . info ( 'fyi' , 'I have a kitty cat: %j' , myKittyCat )
ログを表示するレベル。このレベル以上のログがすべて表示されます。特別なレベルのsilent
、何も表示されなくなります。
入力されたすべてのログ メッセージの配列。
保持するレコードの最大数。 log.record がこの値を 10% 超えて大きくなると、この値の 90% までスライスされます。
10% のウィンドウを設定する理由は、ログ エントリごとに大きな配列のサイズを変更する必要がないようにするためです。
プレフィックスのスタイルを指定するスタイル オブジェクト。 (以下を参照してください)
見出しのスタイルを指定するスタイル オブジェクト。 (以下を参照してください)
設定されている場合、各行の先頭に印刷される見出し。
process.stderr
出力が書き込まれるストリーム。
出力ストリームに関係なく、すべてのメッセージで強制的に色が使用されます。
すべてのメッセージの色を無効にします。
ログ アクティビティ スピナーと進行状況バーの表示を有効にする
プログレスバーの表示を無効にする
進行状況バーに Unicode テーマを強制的に使用します。
プログレスバーでの Unicode の使用を無効にします。
プログレスバーを出力するためのテンプレートを設定します。詳細については、ゲージのドキュメントを参照してください。
進行状況バーのテーマを選択するテーマセットを選択します。詳細については、ゲージのドキュメントを参照してください。
ストリームへのメッセージの送信を停止しますが、メッセージをドロップしないでください。
一時停止中に書き込まれたバッファリングされたメッセージをすべて出力します。
level
{String} メッセージを発行するレベルprefix
{String} 文字列の接頭辞。スキップするには「」に設定します。message...
util.format
の引数指定されたレベルでログ メッセージを出力します。
例えば、
log.log(level, prefix, message, ...)
のように。このようにして、各レベルに短縮表現が与えられるため、 log.info(prefix, message)
実行できます。
level
{String} レベルインジケーターn
{Number} 数値レベルstyle
{Object} fg、bg、inverse などのオブジェクト。disp
{String} 出力内のlevel
のオプションの置換。短縮関数などを使用して新しいレベルを設定します。
数値がInfinity
の場合、レベルをその値に設定すると、すべてのログ メッセージが抑制されることに注意してください。数値が-Infinity
の場合、それを表示する唯一の方法は、すべてのログ メッセージを有効にすることです。
name
{文字列} オプション。進行状況の項目名。todo
{数値} オプション。実行する作業の合計量。デフォルトは 0。weight
{数値} オプション。他のアイテムと比較したこのアイテムの重量。デフォルトは 1。これにより、新しいare-we-there-yet
項目トラッカーが進行状況トラッカーに追加されます。返されるオブジェクトにはlog[level]
メソッドがありますが、それ以外はare-we-there-yet
Tracker
オブジェクトです。
これにより、新しいare-we-there-yet
ストリーム トラッカーが進行状況トラッカーに追加されます。返されるオブジェクトにはlog[level]
メソッドが含まれていますが、それ以外の点ではare-we-there-yet
TrackerStream
オブジェクトです。
これにより、新しいare-we-there-yet
トラッカー グループが進行状況トラッカーに追加されます。返されたオブジェクトにはlog[level]
メソッドが含まれていますが、それ以外の点ではare-we-there-yet
TrackerGroup
オブジェクトです。
イベントはすべてメッセージ オブジェクトとともに発行されます。
log
が出力されるlog.
レベルのすべてのメッセージに対して発行されます。
プレフィックス付きのメッセージも、そのプレフィックスをイベントとして出力します。スタイル オブジェクトには次のフィールドを含めることができます。
fg
{String} 前景テキストの色bg
{String} 背景の色bold
、 inverse
、 underline
{Boolean} 関連付けられたプロパティを設定しますbell
{Boolean} 音を立てる(これはおそらくかなり迷惑です。)すべてのログ イベントはメッセージ オブジェクトとともに出力され、 log.record
リストには作成されたすべてのログ イベントが含まれます。次のフィールドがあります。
id
{番号}level
{文字列}prefix
{文字列}message
{String} util.format()
の結果messageRaw
{Array} util.format()
の引数それらが tty であり、setBlocking 呼び出しがある場合、 set-blocking
使用して stderr および stdout のブロッキングを設定します。これは、OSX 上で stderr と stdout をノンブロッキングにする Node.js 6.x の初期バージョンの問題の回避策です。 (これらは常に Windows をブロックしており、Linux では決してブロックしませんでした。) npmlog
stdout と stderr への出力をインターレースできるようにするために、それらをブロックする必要があります。