تحتوي هذه الوحدة ذات الأغراض العامة على العديد من وظائف الأداة المفيدة التي يمكن أن توفر عليك جهد كتابة تعليمات برمجية إضافية.
توفر وحدة الاستخدام مجموعة من الأدوات المساعدة التي يمكنك استخدامها لتصحيح البيانات وفحصها وتنسيقها في تطبيقات Node.js.
تعمق في الوظائف المختلفة لوحدة الاستخدام واستكشف بعض الأمثلة لمساعدتك على الاستفادة من هذه الأدوات.
التسجيل بمزيد من الراحة
يشير التسجيل إلى تسجيل المعلومات أو الأحداث المهمة ، مثل القيم المتغيرة ورسائل الخطأ وتدفق التنفيذ ، التي تحدث داخل تطبيق البرنامج. يخدم التسجيل أغراضًا متعددة ، بما في ذلك التصحيح والمراقبة والتدقيق.
توفر الوحدة النمطية المستخدمة Node.js آلية تسجيل ملائمة باستخدام امتداد use.debuglog طريقة. يتيح لك إنشاء وظائف تسجيل تصحيح الأخطاء باستخدام مساحة اسم ، ويمكنك تمكينها أو تعطيلها عن طريق تعيين NODE_DEBUG متغيرات البيئة. هذا مثال:
// index.js
مقدار ثابت الاستفادة = يتطلب("الاستفادة");مقدار ثابت التصحيح = util.debuglog ("تطبيقي"); // تهيئة مسجل التصحيح
تصحيح ("هذه رسالة تصحيح"); // MYAPP 39668: هذه رسالة تصحيح
يوضح هذا المثال كيف يمكنك تعيين مسجل تصحيح أخطاء بسيط ، في مساحة اسم "myapp" ، وتسجيل رسالة ومعرف العملية الخاص بها في وحدة التحكم.
لتمكين سجلات تصحيح الأخطاء ، قم بتعيين ملف NODE_DEBUG متغير البيئة إلى مساحة الاسم عند تشغيل البرنامج النصي:
NODE_DEBUG = index.js عقدة myapp
إذا كنت تريد تمكين مساحات أسماء تصحيح أخطاء متعددة ، فأضف فاصلة لفصل مساحات الأسماء:
NODE_DEBUG = myapp و myapp2 و myapp3 node index.js
إذا لم تقم بتضمين مساحة الاسم في ملف NODE_DEBUG متغير البيئة ، فإن استدعاءات سجل التصحيح ستتجاهل مساحة الاسم هذه.
ال use.debuglog توفر الطريقة وظائف مفيدة ، ولكن إذا كان تطبيقك يتطلب عمليات تسجيل أكثر تعقيدًا ، فيمكنك استخدام أحد الأساليب الأخرى القوية حزم التسجيل في النظام البيئي Node.js.
وظائف واعدة من أجل المرونة
توفر الوعود في JavaScript طريقة للتعامل مع التعليمات البرمجية غير المتزامنة بطريقة أكثر تنظيماً وقابلية للإدارة بطريقة تسمح لك بتسلسل العمليات ومعالجة الأخطاء وأحداث النجاح بشكل منفصل وتجنب معاودة الاتصال جحيم.
على الرغم من أن ليست كل الوظائف الداخلية تدعم الوعود. ومع ذلك ، يمكنك "التعهد" بالوظائف التي تستخدم عمليات الاسترجاعات التقليدية لتمكينها من دعم الوعود بوحدة الاستخدام الاستفادة طريقة.
تأخذ هذه الطريقة وظيفة تستخدم نظام رد الاتصال التقليدي وتعيد دالة تستخدم الوعود.
على سبيل المثال:
مقدار ثابت الاستفادة = يتطلب("الاستفادة");// نسخة رد الاتصال
وظيفةوظيفة رد الاتصال(arg1 ، arg2 ، رد الاتصال) {
// عملية غير متزامنة
// استدعاء رد مع الخطأ (إن وجد) والنتيجة
}// Promisify وظيفة رد الاتصال
مقدار ثابت callbackFunctionPromise = util.promisify (callbackFunction) ،
// النسخة الموعودة
callbackFunctionPromise (arg1، arg2)
.ثم((نتيجة) => {
// نتيجة العملية
})
.يمسك((خطأ) => {
// معالجة الخطأ
});
في المثال أعلاه ، فإن ملف الاستفادة طريقة تحويل إصدار رد الاتصال من الوظيفة إلى إصدار يستخدم الوعود.
يمكّنك هذا التحويل من استخدام السلسلة ثم و يمسك كتل ، استخدم حاول التقاط، وإدارة الشفرة غير المتزامنة بشكل أفضل.
تنسيق السلاسل بطريقة مألوفة
Node.js الاستفادة توفر الوحدة النمطية وظيفة تنسيق تسمى الاستفادة يسمح لك بإنشاء سلاسل منسقة. تعمل هذه الطريقة بشكل مشابه لـ ال printf تعمل في باش ولغات البرمجة الأخرى مثل C و C ++.
ال use.format () تأخذ الطريقة سلسلة تنسيق يمكن أن تحتوي على صفر أو أكثر من محددات التنسيق ، مثل ٪س (سلاسل)، ٪د (أرقام) ، كوسيطة. يتطلب أيضًا عددًا عشوائيًا من القيم التي ستحل محل محدداتها المقابلة.
على سبيل المثال:
مقدار ثابت الاستفادة = يتطلب("الاستفادة");مقدار ثابت الاسم = "Bonnie";
مقدار ثابت العمر = 30;مقدار ثابت formattedString = util.format (
"اسمي٪ s ، وعمري٪ d سنة.",
اسم،
عمر
);
وحدة التحكم.log (formattedString) ؛ // اسمي بوني وعمري 30 عامًا.
يستخدم هذا المثال سلسلة تنسيق مع عنصرين نائبين: ٪س و ٪د. ال ٪س العنصر النائب هو لاستبدال السلسلة ، بينما ٪د هو الاستبدال الرقمي. يمرر استدعاء use.format القيم المقابلة -اسم و عمر—لكل عنصر نائب.
إذا لم يكن للمحدد وسيطة مقابلة ، فإن الاستفادة لن يستبدلها التابع ، وسيعيد السلسلة دون تغييرها:
مقدار ثابت الاستفادة = يتطلب("الاستفادة");
مقدار ثابت formattedString = util.format ("اسمي٪ s");
وحدة التحكم.log (formattedString) ؛ // اسمي٪ s
يستدعي هذا المثال التنسيق باستخدام وسيط واحد فقط ، لذلك تُرجع الطريقة السلسلة النصية الأصلية.
هناك الكثير من الاستخدامات لوحدة Util
بصرف النظر عن هذه الاستخدامات ، توفر الوحدة النمطية المستخدمة Node.js وظائف مفيدة أخرى. تشمل الأمثلة فحص الأشياء والقيم وإهمال الأدوات القديمة.
من خلال الاستفادة من الوظائف التي توفرها الوحدة النمطية ، يمكنك تحسين قابلية قراءة التعليمات البرمجية الخاصة بك وصيانتها وسير العمل الإجمالي الخاص بك.
