في جافا سكريبت، يمكن تنفيذ ذلك عبر ' نافذة. جلب () ' طريقة. ومع ذلك، في ' Node.js '، يمكن تحقيق هذه الوظيفة باستخدام حزم متعددة، مثل جلب العقدة، وما إلى ذلك.
تشرح هذه المدونة مجالات المحتوى التالية:
- ما هو 'جلب العقدة'؟
- المتطلبات الأساسية لاستخدام جلب العقدة.
- كيفية تقديم طلبات HTTP في Node.js باستخدام Node-Fetch؟
- كيف تبدأ مع جلب العقدة؟
- إرسال الحصول على الطلبات عبر جلب العقدة.
- استرداد بيانات JSON من Rest API.
- نشر الطلبات عبر جلب العقدة.
- ما هي رموز حالة HTTP؟
- التعامل مع الاستثناءات والقيود.
- حالات الاستخدام الأخرى لـnode-fetch.
- خاتمة
ما هو 'جلب العقدة'؟
ال ' جلب العقدة 'يتوافق مع وحدة خفيفة الوزن تجعل واجهة برمجة التطبيقات (fetch API) قابلة للوصول إلى Node.js. تتيح هذه الوحدة أيضًا للمستخدمين استخدام ' أحضر() 'الطريقة في Node.js والتي تشبه في الغالب JavaScript' نافذة. جلب () ' طريقة.
بناء الجملة (طريقة الجلب ()
أحضر ( عنوان URL [ ، خيارات ] ) ;
في بناء الجملة هذا:
- ' عنوان URL ' يشير إلى عنوان URL للمورد الذي يجب جلبه/استرداده.
- ال ' خيارات ' تكون المعلمة مطلوبة عندما تكون هناك حاجة لاستخدام طريقة 'fetch()' بخلاف إنشاء ' يحصل ' طلب.
قيمة الإرجاع
تقوم هذه الوظيفة باسترداد كائن استجابة يشتمل على معلومات تتعلق باستجابة HTTP كما يلي:
- نص: يسترجع نص الاستجابة على شكل سلسلة.
- رؤوس: إرجاع كائن يشتمل على معالجات الاستجابة.
- جسون (): يوزع نص الاستجابة في كائن JSON.
- نص الحالة/الحالة: يتضمن المعلومات المتعلقة برمز حالة HTTP.
- نعم: يعطي ' حقيقي 'إذا كانت الحالة عبارة عن رمز حالة 2xx.
المتطلبات الأساسية لاستخدام جلب العقدة
فيما يلي المتطلبات الأساسية التي يجب مراعاتها قبل البدء بـ ' جلب العقدة ':
- تم تثبيت الإصدار 17.5 على الأقل أو الأحدث.
- المعرفة الأساسية بجافا سكريبت.
كيفية تقديم طلبات HTTP في Node.js باستخدام Node-Fetch؟
يعد إجراء طلبات HTTP إجراءً غير متزامن حيث أن تلقي الاستجابة المطلوبة يستغرق بعض الوقت. ومن الممكن أن يكون هناك منهجيتان لاستخدام الإجراءات غير المتزامنة. الأول هو أنه يمكن للمستخدم انتظار الرد ثم الاستئناف باستخدام الرمز. والآخر هو تنفيذ التعليمات البرمجية بالتوازي.
كيف تبدأ مع جلب العقدة؟
قبل البدء أو تثبيت ' جلب العقدة '، قم بتهيئة مشروع العقدة بمساعدة الأمر الموضح أدناه:
الحرف npm - و 
يؤدي تنفيذ هذا الأمر إلى إنشاء ' package.json 'الملف في الدليل الحالي، كما يلي:
الآن قم بتثبيت ' جلب العقدة 'وحدة باستخدام الأمر cmdlet التالي:
عقدة تثبيت npm - أحضر 
ومع ذلك، لتثبيت إصدار الوحدة المستهدفة، استخدم الأمر التالي:
عقدة تثبيت npm - أحضر@ 2.0وفي هذه الحالة ' 2.0 سيتم تثبيت نسخة الوحدة.
ملحوظة: قبل متابعة الأمثلة، قم بإنشاء ' Index.mjs 'ملف في مساحة العمل التي سيتم استخدامها لتطبيق الوظائف.
مثال 1: إرسال الحصول على الطلبات عبر جلب العقدة
ال ' جلب العقدة يمكن استخدام الوحدة للحصول على نص من خادم الويب أو البيانات عبر Rest API.
مثال التعليمات البرمجية أدناه المكتوب في ' Index.mjs يقدم الملف طلب Get بسيطًا إلى صفحة YouTube الرئيسية:
يستورد أحضر من 'جلب العقدة' ;أحضر ( 'https://youtube.com' )
. ثم ( الدقة => الدقة. نص ( ) )
. ثم ( نص => وحدة التحكم. سجل ( نص ) ) ;
في هذه الأسطر من التعليمات البرمجية:
- حمل ال ' جلب العقدة ' واسترجاع صفحة YouTube الرئيسية عبر عنوان URL المحدد الذي يتم إرسال طلب HTTP إليه.
- بعد ذلك، قم بسلسلة ' ثم() طرق التعامل مع الاستجابة والبيانات من الطلب المقدم.
- تشير طريقة 'then()' السابقة إلى انتظار الحصول على الاستجابة من خادم YouTube وتحويلها إلى تنسيق نصي.
- تشير طريقة 'then()' الأخيرة إلى انتظار نتيجة التحويل السابق وتعرضها على وحدة التحكم.
انتاج |
الآن قم بتنفيذ الكود عبر الأمر cmdlet التالي:
مؤشر العقدة. mjsيؤدي تنفيذ الأمر أعلاه إلى استرداد علامة HTML الكاملة لصفحة YouTube الرئيسية المعروضة على وحدة التحكم:
مثال 2: استرداد بيانات JSON من Rest API
يستخدم هذا المثال ' جلب العقدة 'للحصول على بيانات مزيفة عبر JSONPlaceholder RestAPI. ومن ذلك أن ' أحضر() تتضمن الطريقة عنوان URL للخادم وتنتظر الرد:
يستورد أحضر من 'جلب العقدة' ;أحضر ( 'https://jsonplaceholder.typicode.com/users' )
. ثم ( الدقة => الدقة. json ( ) )
. ثم ( json => {
وحدة التحكم. سجل ( 'مستخدم المصفوفة الأول -> ' ) ;
وحدة التحكم. سجل ( json [ 0 ] ) ;
وحدة التحكم. سجل ( 'اسم مستخدم الصفيف الأول -> ' ) ;
وحدة التحكم. سجل ( json [ 0 ] . اسم ) ;
} )
وفقًا لهذه المجموعة من التعليمات البرمجية، قم بالخطوات التالية:
- يشتمل نص HTTPS على بيانات بتنسيق JSON تحتوي على بيانات المستخدم.
- وبعد ذلك ' جسون () يتم تطبيق الوظيفة لاستدعاء الإدخالات الفردية والقيم المقابلة.
انتاج |
قم بتطبيق الأمر cmdlet الموضح أدناه لتنفيذ التعليمات البرمجية:
مؤشر العقدة. mjs 
المثال 3: نشر الطلبات عبر جلب العقدة
ال ' جلب العقدة يمكن أيضًا استخدام الوحدة لنشر الطلبات بدلاً من استرجاعها. ويمكن تحقيق ذلك عبر ' أحضر() ' الطريقة التي تتضمن معلمة إضافية لتقديم طلبات POST إلى الخادم.
هناك العديد من الخيارات التي يمكن تخصيصها باستخدام هذه المعلمة. ومع ذلك، في هذه الحالة، ' طريقة '،' جسم ' و ' رؤوس ' سوف يستخدم. فيما يلي وصف لكل خيار من الخيارات:
- ال ' طريقة 'يحدد الخيار نوع طلبات HTTP، أي 'POST' في هذا السيناريو.
- ال ' جسم 'يتضمن الخيار نص الطلب.
- ال ' header 'يحتوي الخيار على جميع الرؤوس المطلوبة، مثل ' نوع المحتوى ' في هذا السيناريو.
انتقل الآن إلى التنفيذ العملي لإرسال طلبات النشر عن طريق إلحاق عنصر جديد بالعنصر النائب 'JSON' الجميع '. ويتم ذلك عن طريق إلحاق عنصر جديد بالقائمة التي تحتوي على معرف المستخدم كـ '476':
يستورد أحضر من 'جلب العقدة' ;دع كل شيء = {
معرف المستخدم : 476 ,
موقع : 'هذا هو لينكسشينت' ,
مكتمل : خطأ شنيع
} ;
أحضر ( 'https://jsonplaceholder.typicode.com/todos' , {
طريقة : 'بريد' ,
جسم : JSON. توتر ( الجميع ) ,
رؤوس : { 'نوع المحتوى' : 'التطبيق/json' }
} ) . ثم ( الدقة => الدقة. json ( ) )
. ثم ( json => وحدة التحكم. سجل ( json ) ) ;
في هذا الكود:
- أولاً، قم بإنشاء كائن المهام وتحويله إلى JSON أثناء إلحاقه بالنص.
- الآن، بالمثل، حدد عنوان URL بالخيارات المطلوبة باسم ' أحضر() 'المعلمات الاختيارية للطريقة.
- وبعد ذلك قم بتطبيق ' JSON.stringify() 'طريقة لتحويل الكائن إلى سلسلة منسقة (JSON) قبل إرساله/إرساله إلى خادم الويب.
- للمضي قدمًا، قم بتنفيذ 'الدمج' ثم() 'طرق استرداد البيانات من خلال انتظار الاستجابة، وتحويلها إلى JSON، وتسجيل الدخول إلى وحدة التحكم، على التوالي.
انتاج |
قم بتنفيذ الأمر الموضح أدناه لتنفيذ الكود:
مؤشر العقدة. mjs 
ما هي رموز حالة HTTP؟
قبل الانتقال إلى المثال التالي، تأكد من أنه إذا كانت الاستجابة تحتوي على ' 3xx 'رمز الحالة، يجب على العميل اتخاذ الخطوات الإضافية. وبالمثل فإن ' 4xx ' تمثل الرموز طلبًا غير صالح و' 5xx 'تتوافق الرموز مع أخطاء الخادم.
ملحوظة: ال ' يمسك() لا يمكن لوظيفة 'التعامل مع الحالات التي تمت مناقشتها أعلاه نظرًا لأن اتصال الخادم يتم بطريقة مبسطة. ولذلك، فإن الطريقة الفعالة للتأكد من أن الطلبات الفاشلة ترجع الخطأ هي تحديد وظيفة تحلل حالة HTTP لاستجابة الخادم.
مثال 4: التعامل مع الاستثناءات والقيود
يمكن أن يكون هناك العديد من القيود أو الاستثناءات فيما يتعلق بالطلبات المرسلة، مثل مشكلات الإنترنت، ' أحضر() ' قيود الوظيفة، وما إلى ذلك. يمكن التعامل مع هذه الاستثناءات عن طريق إلحاق ' يمسك() ' وظيفة:
وظيفة تحليل الحالة ( س ) {لو ( س. نعم ) {
يعود س
} آخر {
يرمي جديد خطأ ( `حالة HTTP فيما يتعلق بالاستجابة -> $ { س. حالة } ( $ { س. StatusText } ) ` ) ;
}
}
أحضر ( 'https://jsonplaceholder.typicode.com/MissingResource' )
. ثم ( analyseStatus )
. ثم ( س => س. json ( ) )
. ثم ( json => وحدة التحكم. سجل ( json ) )
. يمسك ( يخطئ => وحدة التحكم. سجل ( يخطئ ) ) ;
في هذا المقتطف من الكود:
- أولاً، حدد دالة تحتوي على المعلمة المذكورة قبل تحليل الاستجابة للتعامل مع القيود التي تواجهها.
- الآن قم بتضمين ' إذا كان غير ذلك 'عبارات لإلقاء الخطأ الذي يواجهه أو وجود قيود مخصصة.
- بعد ذلك، بالمثل، قم بتطبيق ' أحضر() ' وأساليب 'then()' المرتبطة بها لاسترداد البيانات من خلال انتظار الاستجابة، وتحويلها إلى JSON، وتسجيل الدخول إلى وحدة التحكم.
- وأخيرًا، يمكن التعامل مع استثناءات وقت التشغيل عن طريق وضع ' يمسك() 'الطريقة في نهاية سلسلة الوعد.
انتاج |
وأخيرًا، قم بتشغيل الأمر cmdlet الموضح أدناه لتشغيل التعليمات البرمجية وطرح الاستثناءات التي تواجهها:
مؤشر العقدة. mjs 
حالات الاستخدام الأخرى لـ 'node-fetch'
ال ' جلب العقدة 'يمكن استخدامها أيضًا لصنع' طلبات واجهة برمجة التطبيقات ' أو ' تجريف على شبكة الإنترنت '. دعونا نناقش حالات الاستخدام هذه بالتفصيل.
استخدام جلب العقدة لتقديم طلبات API
يمكن أن تكون واجهة برمجة التطبيقات (API) مطلوبة في عدة سيناريوهات لجلب البيانات المستهدفة عبر مصدر خلفي. يمكن أن تحتوي طلبات HTTP على العديد من طرق المصادقة، مثل استخدام مفتاح واجهة برمجة التطبيقات (API) حيث يوفر موفر واجهة برمجة التطبيقات (API) مفتاحًا يقتصر على المستخدم فقط. هناك طريقة أخرى لحماية واجهة برمجة التطبيقات (API) وهي عبر ' المصادقة الأساسية 'حيث يجب إرسال الرأس لاستدعاء واجهة برمجة التطبيقات.
فيما يلي عرض للنهج الأخير، أي 'المصادقة الأساسية' في طلب ما بعد بمساعدة ' أحضر() ' طريقة:
( غير متزامن ( ) => {مقدار ثابت س = تنتظر الجلب ( 'http://httpbin.org/post' , {
طريقة : 'بريد' ,
رؤوس : {
'تفويض' : ``الدولار الأساسي { أخ ( 'كلمة سر الدخول' ) } `
} ,
جسم : JSON. توتر ( {
'مفتاح' : 'قيمة'
} )
} ) ;
مقدار ثابت نتيجة = انتظر ×. نص ( ) ;
وحدة التحكم. سجل ( نتيجة ) ;
} ) ( ) ;
في العرض التوضيحي أعلاه، يتم إرسال رأس مع ' base64 'سلسلة مشفرة من التنسيق' كلمة سر الدخول '.
استخدام عقدة الجلب لتجريد الويب
' تجريف على شبكة الإنترنت ' يشير إلى التقنية التي يتم من خلالها جلب البيانات/المحتوى من المواقع وتحليلها. ويتم هذا التحليل عن طريق ' com.cherio ' مكتبة.
فيما يلي عرض توضيحي لجلب عنوان الصفحة عبر ' أحضر() 'طريقة و' com.cherio ' مكتبة:
مقدار ثابت ليب = يتطلب ( 'يشجع' ) ;( غير متزامن ( ) => {
مقدار ثابت س = تنتظر الجلب ( 'https://linuxhint.com/' ) ;
مقدار ثابت و = انتظر ×. نص ( ) ;
مقدار ثابت $ = ليب. حمولة ( و ) ;
وحدة التحكم. سجل ( $ ( 'عنوان' ) . أولاً ( ) . نص ( ) ) ;
} ) ( ) ;
يسترد هذا المثال بلاط ' لينكس 'عنوان الموقع.
خاتمة
يمكن إجراء طلبات HTTP في Node.js باستخدام جلب العقدة عن طريق إرسال طلبات الحصول أو استرداد بيانات JSON من REST API أو إرسال طلبات النشر. كما يمكن التعامل مع الاستثناءات والتقييدات بشكل فعال عبر ' يمسك() ' وظيفة.