fullstack-build/tslog

어떤 프로젝트인가요?

핵심 기능

• 01Node.js, 브라우저, Deno, Bun, workers, React Native에서 동일한 API 사용
• 02터미널에서는 색상을 입힌 보기 좋은 출력을, 파이프로 전달할 때는 일반 텍스트를 출력하며 JSON도 선택적으로 지원
• 03키 이름, JSON 경로, 정규식 또는 해시된 플레이스홀더를 기준으로 비밀 정보 마스킹
• 04설정과 바인딩된 필드를 상속하는 자식 로거
• 05파일, HTTP, 링 버퍼, worker threads를 위한 플러그형 transport
• 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에서 업그레이드하려면 코드를 변경해야 합니다.

토픽

자주 묻는 질문

tslog은(는) 무엇인가요?

터미널에서 보기 좋은 출력을 제공하고, 필드 우선 구조의 JSON과 비밀 정보 마스킹을 지원하며 런타임 의존성이 없는 범용 TypeScript 및 JavaScript 로거입니다. tslog는 TypeScript와 JavaScript용 로깅 라이브러리로, Node.js, 브라우저, Deno, Bun, workers, React Native에서 하나의 API로 사용할 수 있습니다. 기본적으로 인터랙티브 터미널에서는 색상이 적용된 읽기 쉬운 출력을, 출력이 파이프로 전달되거나 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