logger

Ein Sumor Cloud-Tool.
Weitere Dokumentation

Dies ist ein leichtgewichtiger Logger für Node.JS. Er kann Logs in verschiedenen Ebenen ausgeben, und Sie können den Bereich, die ID und die Zeitzone anpassen.

CI Test Coverage Audit

Installation

npm i @sumor/logger --save

Voraussetzungen

Node.JS-Version

Benötigt Node.JS-Version 16.x oder höher

Erforderliches Node.JS ES-Modul

Da dieses Paket in ES-Modul geschrieben ist, ändern Sie bitte den folgenden Code in Ihrer package.json-Datei:

{
  "type": "module"
}

Verwendung

Allgemeine Verwendung

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

logger.trace('Hallo Welt!')
// Sie werden die folgende Ausgabe sehen:
// 2020-01-01 00:00:00.000 TRACE MAIN - Hallo Welt!

Bereich ändern

In einigen Fällen müssen wir Logs kategorisieren. scope wird dafür verwendet.

import Logger from '@sumor/logger'
const logger = new Logger({
  scope: 'DEMO'
})
logger.trace('Hallo Welt!')
// Sie werden die folgende Ausgabe sehen:
// 2020-01-01 00:00:00.000 TRACE DEMO - Hallo Welt!

Benutzerkennung ändern

In einigen Fällen benötigen wir eine Benutzerkennung. id wird dafür verwendet.

import Logger from '@sumor/logger'
const logger = new Logger({
  id: 'USER001'
})
logger.trace('Hallo Welt!')
// Sie werden die folgende Ausgabe sehen:
// 2020-01-01 00:00:00.000 TRACE MAIN USER001 - Hallo Welt!

Ebene ändern

Meistens müssen wir nur Logs einer bestimmten Ebene ausgeben. Dann können wir entscheiden, ob wir sie speichern und anzeigen oder nicht.

import Logger from '@sumor/logger'
const logger = new Logger()
logger.trace('Hello World!') // trace ist die niedrigste Ebene, alle Logs werden ausgegeben
logger.debug('Hello World!')
logger.info('Hello World!')
logger.warn('Hello World!')
logger.error('Hello World!')
logger.fatal('Hello World!') // fatal ist die höchste Ebene, nur kritische Fehler werden ausgegeben

Zeitzone ändern

import Logger from '@sumor/logger'
const logger1 = new Logger({
  offset: 2 * 60 // Offset UTC+2 sind 2 Stunden
})
logger1.info('Hallo Welt!')
// Sie werden die folgende Ausgabe sehen:
// 2020-01-01 02:00:00.000 INFO MAIN - Hallo Welt!

const logger2 = new Logger({
  offset: 8 * 60 // Offset UTC+8 sind 8 Stunden
})
logger2.info('Hallo Welt!')
// Sie werden die folgende Ausgabe sehen:
// 2020-01-01 08:00:00.000 INFO MAIN - Hallo Welt!