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
출력이 기록되는 스트림입니다.
출력 스트림에 관계없이 모든 메시지에 색상을 강제로 사용합니다.
모든 메시지의 색상을 비활성화합니다.
로그 활동 스피너 및 진행률 표시줄 표시를 활성화합니다.
진행률 표시줄 표시 비활성화
진행률 표시줄에 유니코드 테마를 강제로 사용합니다.
진행률 표시줄에서 유니코드 사용을 비활성화합니다.
진행 표시줄을 출력하기 위한 템플릿을 설정합니다. 자세한 내용은 게이지 문서를 참고하세요.
진행률 표시줄에 대한 테마를 선택할 테마 세트를 선택하세요. 자세한 내용은 게이지 문서를 참고하세요.
메시지를 스트림으로 내보내는 것을 중지하되 삭제하지는 마세요.
일시 중지된 동안 기록된 버퍼링된 모든 메시지를 내보냅니다.
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
{String} 선택사항; 진행 항목 이름.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()
에 대한 인수 stderr 및 stdout이 tty이고 setBlocking 호출이 있는 경우 차단을 설정하기 위해 set-blocking
사용합니다. 이는 OSX에서 stderr 및 stdout을 비차단으로 만드는 Node.js 6.x 초기 버전의 문제에 대한 해결 방법입니다. (항상 Windows를 차단하고 Linux에서는 차단하지 않았습니다.) npmlog
stdout 및 stderr에 대한 출력이 인터레이스될 수 있도록 차단해야 합니다.