السجل

هذا هو سجل خفيف لـ Node.JS. يمكنه إخراج السجلات في مستويات مختلفة، ويمكنك تخصيص النطاق والمعرف والمنطقة الزمنية.

التثبيت

npm i @sumor/logger --save

الشروط المسبقة

نسخة Node.JS

تتطلب نسخة Node.JS 16.x أو أعلى

تتطلب وحدة ES Node.JS

نظرًا لأن هذه الحزمة مكتوبة بوحدة ES، يرجى تغيير الكود التالي في ملف package.json الخاص بك:

{
  "type": "module"
}

الاستخدام

الاستخدام العام

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

logger.trace('مرحباً بالعالم!')
// سترى الناتج التالي:
// 2020-01-01 00:00:00.000 TRACE MAIN - مرحباً بالعالم!

تغيير النطاق

في بعض الحالات، نحتاج إلى تصنيف السجلات. يُستخدم النطاق لهذا الغرض.

import Logger from '@sumor/logger'
const logger = new Logger({
  scope: 'DEMO'
})
logger.trace('مرحباً بالعالم!')
// سترى الناتج التالي:
// 2020-01-01 00:00:00.000 TRACE DEMO - مرحباً بالعالم!

تعيين معرف المستخدم

في بعض الحالات، نحتاج إلى تعيين معرف المستخدم. يُستخدم المعرف لهذا الغرض.

import Logger from '@sumor/logger'
const logger = new Logger({
  id: 'USER001'
})
logger.trace('مرحباً بالعالم!')
// سترى الناتج التالي:
// 2020-01-01 00:00:00.000 TRACE MAIN USER001 - مرحباً بالعالم!

تغيير المستوى

في معظم الأوقات، نحن بحاجة فقط لإخراج السجلات من مستوى معين. ثم يمكننا أن نقرر ما إذا كان يجب تخزينها وعرضها أم لا.

import Logger from '@sumor/logger'
const logger = new Logger()
logger.trace('مرحباً بالعالم!') // trace هو المستوى الأدنى، سيتم إخراج كل السجلات
logger.debug('مرحباً بالعالم!')
logger.info('مرحباً بالعالم!')
logger.warn('مرحباً بالعالم!')
logger.error('مرحباً بالعالم!')
logger.fatal('مرحباً بالعالم!') // fatal هو المستوى الأعلى، ستتم إخراج أخطاء الأمان الحرجة فقط

تغيير المنطقة الزمنية

import Logger from '@sumor/logger'
const logger1 = new Logger({
  offset: 2 * 60 // متأخر UTC+2 بـ 2 ساعة
})
logger1.info('مرحباً بالعالم!')
// سترى الناتج التالي:
// 2020-01-01 02:00:00.000 INFO MAIN - مرحباً بالعالم!

const logger2 = new Logger({
  offset: 8 * 60 // متأخر UTC+8 بـ 8 ساعات
})
logger2.info('مرحباً بالعالم!')
// سترى الناتج التالي:
// 2020-01-01 08:00:00.000 INFO MAIN - مرحباً بالعالم!