regrest

Regrest - عميل Micro HTTP

عميل HTTP المستند إلى Micro Promise للمتصفح وnode.js

سمات

• قم بإجراء طلبات XMLHttpRequests من المتصفح

• قم بإجراء طلبات http من Node.js

• يدعم واجهة برمجة تطبيقات الوعد

• بنيت في دعم TypeScript

دعم المتصفح

الأحدث ✔	الأحدث ✔	الأحدث ✔	الأحدث ✔	الأحدث ✔	11✔

ملحوظة

إذا كنت تنوي دعم Internet Explorer، فتأكد من وجود تعبئة متعددة تضيف كائن Promise عالمي

التثبيت

باستخدام npm:

 $ npm تثبيت التسجيل

باستخدام سي دي:

 <script src="https://cdn.jsdelivr.net/npm/regrest/lib/index.umd.min.js"></script>

مثال

تم تصميم Regrest ليكون أبسط طريقة ممكنة لإجراء مكالمات http

تنفيذ طلب GET

 // الاستيراد باستخدام NodeJS أو CommonJS Moduleconst regrest = require("regrest").default;// أو باستخدام ES6 Moduleimport regrest من "regrest";// استخدم Promiseregrest
  .get("/رجل/دب/خنزير")
  // اطبع سلسلة الاستجابة الأولية
  .ثم((الاستجابة) => console.log(response.text))
  // اطبع أي خطأ إذا حدث
  .catch((error) => console.log(`*** Error: ${error}`));// أو استخدم الكلمات الأساسية الجديدة غير المتزامنة/الانتظار getGood = async () => {
  حاول {// قم بتخزين الاستجابة في استجابة متغيرة = انتظار regrest.get("/foo/bar.json");// اطبع الاستجابة التي تم تحليلها Responseconsole.log(response.json);
  } قبض (خطأ) {// اطبع أي خطأ إذا حدثconsole.log(`*** خطأ: ${error}`);
  }};getGood();// أو استخدم عمليات الاسترجاعات// نحن لا نفعل ذلك هنا

تنفيذ طلب POST

 نأسف
  .post("/comment"، JSON.stringify({ name: "Foo"، comment: "Bar" }))
  .then((response) => console.log(response.status, Response.statusText))
  .catch((خطأ) => console.log(خطأ));

التوثيق

أساليب الراحة

تسجيل.طلب(خيارات)

regrest.get(url[, options])

regrest.head(url[, options])

regrest.post(url[, data[, options]])

regrest.put(url[, data[, options]])

regrest.delete(url[, options])

regrest.options(url[, options])

regrest.patch(url[, data[, options]])

خيارات الخيارات

 // يتم تمييز الخيارات الافتراضية بـ *const options = {
  الطريقة: "GET"، // *GET، POST، PUT، DELETE، إلخ.
  عنوان URL: "https://some-domain.com/api/"،
  الرؤوس: { "نوع المحتوى": "application/json; charset=utf-8" }, // *{}
  المعلمات: {المعرف الفريد: 9873}،
  البيانات: JSON.stringify(data)، // *null
  الحد الأقصى لإعادة التوجيه: 10, // *5
  withCredentials: true, // *false, true};

سمات كائن الاستجابة

 {
  // يحتوي على رمز الحالة للاستجابة، على سبيل المثال 404 لمورد غير موجود، 200 للنجاح
  الحالة: 200،
  // رسالة تتعلق بسمة الحالة، على سبيل المثال موافق للحالة 200
  نص الحالة: "موافق"،
  // الرؤوس التي استجاب بها الخادم
  العناوين: {}،
  // محتوى الاستجابة كسلسلة
  نص: ""،
  // محتوى الاستجابة بتنسيق JSON
  جسون: {}،
  // محتوى الاستجابة مثل Blob على المتصفح والمخزن المؤقت على Node js
  arrayBuffer: مثيل Blob || مثيل المخزن المؤقت,
  // الرد على المحتوى كـ Blob
  النقطة: مثيل النقطة}؛

معالجة الأخطاء

 regrest.get("/McNullington").catch((خطأ) => {
  إذا (error.response) {/** * تم تقديم طلب ولكن الخادم استجاب * برمز الحالة خارج النطاق 2XX * `error.response` هو مثيل لكائن الاستجابة */console.log(error.response. الحالة);console.log(error.response.statusText);console.log(error.response.headers);// ...
  } else if (error.request) {/** * تم تقديم طلب، ولكن لم يتم تلقي أي استجابة * `error.request` هو مثيل لـ XMLHttpRequest على المتصفح ومثيل لـ * http.ClientRequest على Node js */console .log(error.request);
  } آخر {// حدث شيء آخرconsole.log(error.message);
  }});