logger

Un outil Sumor Cloud.
Plus de documentation

Il s'agit d'un logger léger pour Node.JS. Il peut afficher des logs à différents niveaux, et vous pouvez personnaliser la portée, l'ID et le fuseau horaire.

CI Test Couverture Audit

Installation

npm i @sumor/logger --save

Prérequis

Version Node.JS

Nécessite Node.JS version 16.x ou supérieure

Nécessite un module ES Node.JS

Comme ce package est écrit en module ES, veuillez modifier le code suivant dans votre fichier package.json :

{
  "type": "module"
}

Utilisation

Utilisation Générale

import Logger from '@sumor/logger'
const logger = new Logger()

logger.trace('Bonjour le monde!')
// Vous verrez la sortie suivante :
// 2020-01-01 00:00:00.000 TRACE MAIN - Bonjour le monde!

Changer la Portée

Dans quelques cas, nous devons catégoriser les logs. scope est utilisé à cette fin.

import Logger from '@sumor/logger'
const logger = new Logger({
  scope: 'DEMO'
})
logger.trace('Bonjour le monde!')
// Vous verrez la sortie suivante :
// 2020-01-01 00:00:00.000 TRACE DEMO - Bonjour le monde!

Identifier un Utilisateur

Dans quelques cas, nous devons identifier un utilisateur. id est utilisé à cette fin.

import Logger from '@sumor/logger'
const logger = new Logger({
  id: 'USER001'
})
logger.trace('Bonjour le monde!')
// Vous verrez la sortie suivante :
// 2020-01-01 00:00:00.000 TRACE MAIN USER001 - Bonjour le monde!

Changer le Niveau

La plupart du temps, nous devons uniquement afficher des logs à un certain niveau. Ensuite, nous pouvons décider de les stocker et de les afficher ou non.

import Logger from '@sumor/logger'
const logger = new Logger()
logger.trace('Bonjour le monde!') // trace est le niveau le plus bas, tous les logs seront affichés
logger.debug('Bonjour le monde!')
logger.info('Bonjour le monde!')
logger.warn('Bonjour le monde!')
logger.error('Bonjour le monde!')
logger.fatal('Bonjour le monde!') // fatal est le niveau le plus haut, seules les erreurs critiques seront affichées

Changer le Fuseau Horaire

import Logger from '@sumor/logger'
const logger1 = new Logger({
  offset: 2 * 60 // Le décalage UTC+2 est de 2 heures
})
logger1.info('Bonjour le monde!')
// Vous verrez la sortie suivante :
// 2020-01-01 02:00:00.000 INFO MAIN - Bonjour le monde!

const logger2 = new Logger({
  offset: 8 * 60 // Le décalage UTC+8 est de 8 heures
})
logger2.info('Bonjour le monde!')
// Vous verrez la sortie suivante :
// 2020-01-01 08:00:00.000 INFO MAIN - Bonjour le monde!