npmlog
v7.0.1
أداة المسجل التي يستخدمها npm.
هذا المسجل أساسي للغاية. يقوم بالتسجيل لـ npm. وهو يدعم المستويات المخصصة والمخرجات الملونة.
بشكل افتراضي، تتم كتابة السجلات إلى stderr. إذا كنت تريد إرسال رسائل السجل إلى مخرجات أخرى غير التدفقات، فيمكنك تغيير عضو log.stream ، أو يمكنك فقط الاستماع إلى الأحداث التي يصدرها، وتفعل ما تريد بها.
npm install npmlog --save var log = require ( 'npmlog' )
// additional stuff ---------------------------+
// message ----------+ |
// prefix ----+ | |
// level -+ | | |
// v v v v
log . info ( 'fyi' , 'I have a kitty cat: %j' , myKittyCat ) المستوى الذي سيتم عرض السجلات فيه. سيتم عرض أي سجلات عند هذا المستوى أو أعلى منه. المستوى الخاص silent سيمنع عرض أي شيء على الإطلاق.
مصفوفة بجميع رسائل السجل التي تم إدخالها.
الحد الأقصى لعدد السجلات التي يجب الاحتفاظ بها. إذا أصبح log.record أكبر من 10% فوق هذه القيمة، فسيتم تقسيمه إلى 90% من هذه القيمة.
السبب وراء إنشاء نافذة 10% هو أنه لا يلزم تغيير حجم مصفوفة كبيرة عند كل إدخال سجل.
كائن نمط يحدد كيفية تصميم البادئات. (انظر أدناه)
كائن نمط يحدد كيفية تصميم العنوان. (انظر أدناه)
إذا تم تعيينه، فسيتم طباعة عنوان في بداية كل سطر.
process.stderrالدفق حيث يتم كتابة الإخراج.
فرض استخدام الألوان على كافة الرسائل، بغض النظر عن تدفق الإخراج.
تعطيل الألوان في كافة الرسائل.
تمكين عرض القرص الدوار لنشاط السجل وشريط التقدم
تعطيل عرض شريط التقدم
فرض استخدام سمة Unicode في شريط التقدم.
قم بتعطيل استخدام Unicode في شريط التقدم.
قم بتعيين قالب لإخراج شريط التقدم. راجع وثائق المقياس للحصول على التفاصيل.
حدد مجموعة سمات لاختيار السمات منها لشريط التقدم. راجع وثائق المقياس للحصول على التفاصيل.
توقف عن إرسال الرسائل إلى الدفق، ولكن لا تسقطها.
قم بإصدار كافة الرسائل المخزنة مؤقتًا التي تمت كتابتها أثناء الإيقاف المؤقت.
level {String} المستوى الذي سيتم إرسال الرسالة إليهprefix {سلسلة} بادئة سلسلة. اضبط على "" للتخطي.message... وسيطات ل util.formatإرسال رسالة سجل على المستوى المحدد.
على سبيل المثال،
مثل log.log(level, prefix, message, ...) . بهذه الطريقة، يتم إعطاء كل مستوى اختصارًا، حتى تتمكن من تنفيذ log.info(prefix, message) .
level {سلسلة} مؤشر المستوىn {رقم} المستوى الرقميstyle {Object} كائن به fg وbg وinverse وما إلى ذلك.disp {String} بديل اختياري level في الإخراج.يقوم بإعداد مستوى جديد باستخدام وظيفة الاختزال وما إلى ذلك.
لاحظ أنه إذا كان الرقم هو Infinity ، فإن ضبط المستوى على ذلك سيؤدي إلى منع جميع رسائل السجل. إذا كان الرقم هو -Infinity ، فإن الطريقة الوحيدة لإظهاره هي تمكين جميع رسائل السجل.
name {سلسلة} اختياري؛ اسم عنصر التقدمtodo {رقم} اختياري؛ المبلغ الإجمالي للعمل الذي يتعين القيام به. الافتراضي 0.weight {الرقم} اختياري؛ وزن هذا العنصر بالنسبة للآخرين. الافتراضي 1. يؤدي ذلك إلى إضافة أداة تعقب العناصر الجديدة are-we-there-yet إلى أداة تعقب التقدم. يحتوي الكائن الذي تم إرجاعه على أساليب log[level] ولكنه بخلاف ذلك كائن Tracker are-we-there-yet .
يؤدي ذلك إلى إضافة أداة تعقب البث الجديدة are-we-there-yet إلى أداة تعقب التقدم. يحتوي الكائن الذي تم إرجاعه على أساليب log[level] ولكنه بخلاف ذلك كائن are-we-there-yet TrackerStream .
يؤدي ذلك إلى إضافة مجموعة تعقب جديدة are-we-there-yet إلى أداة تعقب التقدم. يحتوي الكائن الذي تم إرجاعه على أساليب log[level] ولكنه بخلاف ذلك كائن are-we-there-yet TrackerGroup .
يتم إطلاق كافة الأحداث مع كائن الرسالة.
log المنبعثة لجميع الرسائلlog. ينبعث لجميع الرسائل ذات المستوى يمكن أن تحتوي كائنات النمط على الحقول التالية:
fg {String} لون النص الأماميbg {String} لون الخلفيةbold ، inverse ، underline {منطقي} قم بتعيين الخاصية المرتبطةbell {Boolean} أحدث ضجيجًا (ربما يكون هذا مزعجًا جدًا.) يتم إطلاق كل حدث سجل مع كائن رسالة، وتحتوي قائمة log.record على كل الأحداث التي تم إنشاؤها. لديهم الحقول التالية:
id {الرقم}level {سلسلة}prefix {سلسلة}message {String} نتيجة util.format()messageRaw {Array} إلى util.format() نحن نستخدم set-blocking لتعيين حظر stderr وstdout إذا كانتا من نوع tty ولديها استدعاء setBlocking. يعد هذا حلاً بديلاً لمشكلة في الإصدارات القديمة من Node.js 6.x، والتي جعلت stderr وstdout غير محظورين على OSX. (إنهم يحظرون Windows دائمًا ولم يحظروا أبدًا على Linux.) يحتاج npmlog إلى حظرهم حتى يتمكن من السماح بتداخل الإخراج إلى stdout وstderr.
