cb fetch

cb-fetch

متصفح متقاطع حقيقي ومكتبة متوافقة مع التوجيه الأمامي لتنفيذ طلبات HTTP غير المتزامنة التي تتبع نمط c all b الخلفي.

جدول المحتويات

• الاستخدام
  • تثبيت
  • استيراد
  • أمثلة
• يدعم
• طُرق
• ملكيات
• مسكتك
• رخصة

الاستخدام

تثبيت

npm

npm install --save cb-fetch

غزل

yarn add cb-fetch

com.jspm

jspm install cb-fetch

كوخ

bower install --save cb-fetch

jsDelivr

< script src = " //cdn.jsdelivr.net/combine/npm/@string/isstring/isString.min.js,npm/cb-fetch/index.min.js " type = " text/javascript " ></ script >

استيراد

أيه إم دي

  define(function (require) {
    var request = require('cb-fetch');
  });
  

CJS

متوافقة مع المعايير

  var request = require('cb-fetch')['default'];
  

متوافق مع Node.js

  var request = require('cb-fetch');
  

يوي

  YUI({
    modules: { 'is-string': 'path/to/@string/isstring.js' }
  }).use('is-string', 'cb-fetch', function (Y) {
    var request = Y['default'];
  });
  

TS

  import request = require('cb-fetch');
  

مساحة الاسم العالمية

إذا لم يتم دعم أي من طرق تسجيل الوحدة المدرجة مسبقًا، فسيتم عرض متغير عام يسمى request .

أمثلة

 // here's your typical request
request ( 'http://www.example.com?key1=value1&key2=value2' )
  . done ( response => { /* … */ } ) ;

// taking a comprehensive approach is encouraged though
request ( )
  . get ( 'http://www.example.com' )
  . query ( 'key1=value1&key2=value2' )
  . done ( onSuccessCallback , onErrorCallback ) ;

// passing an object offers options not available otherwise
let abort = request ( {
  url :          new URL ( 'http://www.example.com' ) ,
  parameters :   new URLSearchParams ( '_csrf=TOKEN' ) ,
  mode :         'cors' ,
  credentials :  'include' ,
  responseType : 'json'
} ) . get ( '/segment' )
  . query ( { foo : [ 'bar' , 'qux' ] } )
  . pass ( 'Content-Type' , 'application/json' )
  . hook ( 'download' , e => { /* … */ } )
  . done ( {
    success : onSuccessCallback ,
    error :   onErrorCallback ,
    abort :   onAbortCallback
  } ) ;

// forcefully aborts the request
abort ( ) ; 

يدعم

• fetch
• XMLHttpRequest
• XDomainRequest
• تعريف الوحدة العالمية
• WebDAV
• تايب سكريبت
• تدفق

طُرق

الحصول على / الرأس / الحذف / النشر / التصحيح / الوضع

 (Options.url?) => Object

استفسار

 (Options.parameters?) => Object

يرسل

 (Options.body?) => Object

خطاف

تحميل

 ('loadstart', () => Boolean | Void) => Object

تحميل

 ('download', Object => Any) => Object

تحميل

 ('loadend', () => Any) => Object

يمر

 {
  (name: String, value: String),
  (headers: Object | Headers)
} => Object

  // assigns
  . pass ( new Headers ( { key : 'value' } ) )

  // appends
  . pass ( { key : 'value' } )

  // sets
  . pass ( 'key' , 'value' )

منتهي

 {
  (onSuccess?: Function, onError?: Function),
  ({
    success?:  Function,
    error?:    Function,
    timeout?:  Function,
    abort?:    Function
  })
} => () => Void,
  throws: TypeError

ملكيات

خيارات الطلب

ملكية	تقصير	قيم)
جسم	باطل	BufferSource، Blob، Document²، FormData، String، URLSearchParams، ReadableStream
أوراق اعتماد	"نفس الأصل"	"تضمين"، "حذف"، "نفس الأصل"
رؤوس	{}	الكائن، الرؤوس³
طريقة	'يحصل'	خيط
وضع	"نفس الأصل"	"كورس"، "لا كورس"¹، "نفس الأصل"
كلمة المرور	باطل	خيط
حدود		URLSearchParams، كائن، سلسلة
استجابةMediaType²		خيط
نوع الاستجابة		"نص"، "json"، "blob"، "مستند"، "arraybuffer"، "formdata"¹، "moz-blob"، "moz-chunked-arraybuffer"، "moz-chunked-text"، "msxml-" وثيقة'
نفذ الوقت	0	ℕ
اسم المستخدم	باطل	خيط
عنوان URL	location.href	سلسلة، URL
متعدد الأجزاء⁷	خطأ شنيع	منطقية
نفق⁵	خطأ شنيع	منطقية
نمط XSLP⁴	خطأ شنيع	منطقية

حدث التقدم

ملكية	يكتب
قطعة	String، ArrayBuffer، Blob، Uint8Array، null
إجمالي	String، ArrayBuffer، Blob، Uint8Array، null
محملة	ℕ
المجموع	ℕ
lengthComputable	منطقية

إجابة

ملكية	يكتب
جسم	كائن، سلسلة، مستند، ArrayBuffer، Blob، FormData¹، ReadableStream¹، null
رؤوس	هدف
مثال	XMLHttpRequest، XDomainRequest، الاستجابة، AnonXMLHttpRequest
كود الحالة	ℕ
StatusText	خيط
عنوان URL	خيط

_{^{¹ جلب فقط
² XHR فقط
³ باستثناء أبو بريص 34-43
⁴ MSXML 3.0 فقط
⁵ تجاوز الطريقة
⁶ جلب، أبو بريص 16+، المعزوفة/2.10.232–2.12.423
⁷ أبو بريص 1.7β–22}}

مسكتك

delete الكلمة المحجوزة

في بيئات ما قبل ES5، تتطلب طريقة الحذف استخدام تدوين الأقواس.

أبو بريص

لكي يتم ملء المتصفحات التي تعمل بنظام Gecko 1.9.1–20 برؤوس الاستجابة المكشوفة في خاصية headers ، يجب استيفاء الشروط التالية:

• يكشف رأس استجابة Access-Control-Expose-Headers عن نفسه
• قيمة حقل Access-Control-Expose-Headers ليست *
• تم ضبط mode على cors

ترايدنت

XDomainRequest القيود الجوهرية

• يدعم فقط أساليب GET وPOST
• لا يمكن تعيين رؤوس الطلب
• لا أوراق اعتماد
• نفس قيود المخطط
• تعتبر فئات رمز الحالة المعلوماتية وإعادة التوجيه أخطاء
• لم يتم توفير رمز حالة الاستجابة ونص الحالة
• تتطلب طلبات نفس المصدر أيضًا أن يستجيب الخادم برأس Access-Control-Allow-Origin إما * أو عنوان URL الدقيق للمستند المطلوب

منصة لتفضيلات الخصوصية

تعمل الإعدادات الافتراضية لبرنامج Internet Explorer على تقييد استخدام ملفات تعريف الارتباط التابعة لجهات ^خارجية ما لم يتم تضمين إعلان سياسة ضغط P3P من خلال رأس استجابة HTTP مخصص؛ وبالتالي، لا يمكن احترام وضع بيانات الاعتماد "include" بشكل كامل إذا تم اعتبار ملف تعريف الارتباط غير مرضٍ.

رخصة