debug-js/debug

어떤 프로젝트인가요?

핵심 기능

• 01DEBUG 환경 변수로 켜고 끌 수 있는 네임스페이스별 디버그 함수.
• 02출력을 필터링하는 와일드카드 및 제외 패턴.
• 03Node.js와 웹 브라우저에서 작동하며, 지원되는 환경에서는 색상을 사용합니다.
• 04호출 사이의 시간 차이를 밀리초 단위로 표시하며, 출력이 TTY가 아니면 ISO 타임스탬프를 표시합니다.
• 05사용자 지정 포맷터를 지원하는 printf 스타일 포맷터.
• 06런타임에 출력을 켜고 끄거나 네임스페이스를 확장하는 API.

활용 사례

• 기본적으로 불필요한 로그를 내보내지 않으면서 Node.js 라이브러리나 애플리케이션에 필요할 때 켤 수 있는 디버그 로그를 추가합니다.
• 서버 프로세스에서 네임스페이스별로 요청 처리나 워커 활동을 추적합니다.
• localStorage.debug를 설정해 브라우저에서 프런트엔드 코드를 디버깅합니다.

빠른 시작

1. 1

   npm으로 패키지를 설치합니다

   npm install debug
2. 2

   코드에서 네임스페이스를 지정해 debug 인스턴스를 만들고, DEBUG를 활성화한 상태로 앱을 실행합니다(macOS/Linux)

   DEBUG=* node app.js

사용 전 알아둘 점

• !DEBUG 환경 변수 또는 localStorage.debug를 통해 활성화한 네임스페이스의 Debug 출력만 표시됩니다.
• !Node.js에서 전체 색상 팔레트를 사용하려면 선택 사항인 supports-color 모듈이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

debug은(는) 무엇인가요?

DEBUG 환경 변수로 켜고 끌 수 있으며, Node.js와 웹 브라우저에서 네임스페이스별 디버그 출력을 보여 주는 작은 JavaScript 유틸리티입니다. debug는 Node.js 코어에서 사용하는 디버깅 기법을 본뜬 JavaScript용 소형 로깅 유틸리티입니다. 'http'나 'worker:a' 같은 네임스페이스를 지정해 이름이 있는 debug 함수를 만들며, 해당 네임스페이스를 DEBUG 환경 변수로 활성화했을 때만 출력됩니다. DEBUG=connect:*나 DEBUG=*,-connect:* 같은 와일드카드와 제외 패턴을 사용하면 애플리케이션의 특정 부분만 골라 출력할 수 있습니다.

debug은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

debug은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

debug은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. debug의 마지막 커밋은 2026년 10월 14일입니다.

debug은(는) 어디에 사용할 수 있나요?

기본적으로 불필요한 로그를 내보내지 않으면서 Node.js 라이브러리나 애플리케이션에 필요할 때 켤 수 있는 디버그 로그를 추가합니다. 서버 프로세스에서 네임스페이스별로 요청 처리나 워커 활동을 추적합니다. localStorage.debug를 설정해 브라우저에서 프런트엔드 코드를 디버깅합니다.

debug는 어떻게 설치하나요?

npm으로 패키지를 설치합니다: npm install debug 코드에서 네임스페이스를 지정해 debug 인스턴스를 만들고, DEBUG를 활성화한 상태로 앱을 실행합니다(macOS/Linux): DEBUG=* node app.js

debug은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/debug-js/debug