catta

كاتا

catta هو عميل طلب بسيط للمتصفح يدعم Fetch وAJAX وJSONP وحتى تخصيص المحول الخاص بك. 中文文档-请点我

• الميت سهل الاستخدام
• خيارات موحدة والاستخدام لكل محول
• دعم جميع المتصفحات الحديثة (بما في ذلك IE 9+، مع إصدار الشركات)
• دعم متصفح الاكتشاف التلقائي لمحول الاختيار (مزيد من التفاصيل)
• محول خاص مخصص
• خفيف الوزن، الإصدار الأساسي أقل من 2 كيلو بايت (دقيقة + gzip)

دعم المتصفح

• catta-min.js
  • جميع المتصفحات الحديثة، باستثناء IE
  • لا يوجد أي es6+ polyfill، فقط مكتبة خالصة
• catta-min-comp.js
  • جميع المتصفحات الحديثة، IE 9+
  • المكتبة الأساسية مع Promise و Object.sign polyfill
  • لا توجد تعبئة بيانات Formdata ، أرسل {data: HTMLFormElement} يحتاج إلى IE 10+ للعمل
  • لا توجد خاصية Global Fetch polyfill، إذا كان المتصفح لا يدعم هذه الميزة، فسيتم الرجوع إلى AJAX

نوصي باستخدام النسخة النقية، إذا كان مشروعك يحتوي بالفعل على هذه العناصر المتعددة أو لا يحتاج إلى دعم IE.

الاستخدام

التثبيت أولاً

 # local install
npm install catta --save

ثم قم بالاستيراد إلى مشروعك

 // With ES6 - *Recommend*
import catta from 'catta' ;

catta ( 'http://some/url' ) . then ( function ( res ) {
  console . log ( res ) ;
} ) ; 

 // With CommonJS
const catta = require ( 'catta' ) ;

// or catta.ajax or catta.jsonp or catta.fetch
catta . default ( 'http://some/url' ) . then ( function ( res ) {
  console . log ( res ) ;
} ) ; 

 <!-- And also with <script> in HTML - *Not Recommend* -->
< script src =" ./node_modules/catta/dist/catta-min.js " > </ script >
< script >
  // or catta.ajax or catta.jsonp or catta.fetch
  catta . default ( 'http://some/url' ) . then ( function ( res ) {
    console . log ( res ) ;
  } ) ;
</ script > 

خيارات

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

  import { ajax , fetch , jsonp , getScript } from 'catta' ;

  /**
   * make fetch/ajax/jsonp/getScript request
   * @param {string} url - request url
   * @param {Object} options - request options
   * 
   */
  ajax ( url , options ) ;

  // fetch request
  fetch ( url , options ) ;

  // jsonp request
  jsonp ( url , options ) ;

  // getScript 
  getScript ( url ) ;

خيارات مهمة

	وصف	يكتب	تقصير	أحضر	اياكس	JSONP
عنوان URL	طلب عنوان URL	خيط	باطل	ضد	ضد	ضد
طريقة	طريقة الطلب	سلسلة {احصل، انشر، ضع، احذف، رأس}	'يحصل'	ضد	ضد	س
بيانات	إرسال البيانات إلى الخادم	سلسلة/كائن/عنصر النموذج [3]	{}	ضد	ضد	ضد

الخيارات الثانوية

	وصف	يكتب	تقصير	أحضر	اياكس	JSONP
يكتب	تقييد نوع الطلب	سلسلة {جلب، اياكس، jsonp، البرنامج النصي}	'آلي'	—	—	—
نفذ الوقت	رمي خطأ المهلة بعد ثواني	رقم	3	! [1]	ضد	! [1]
نوع النتيجة	نوع النتيجة	{ نص، جيسون، استجابة }	نص	ضد	ضد	! [2]

الخامس المدعومة ! مدعوم جزئيًا × غير مدعوم

1. لا يمكن إلغاء طلب الجلب وJSONP، فالمهلة الحالية هي مجرد خطأ في المهلة

2. لا يمكن أن يعمل خيار resultType مع jsonp، لأن النتيجة يجب أن تكون كود جافا سكريبت قابل للتنفيذ

3. دعم عنصر النموذج مع ميزة FormData فقط

   ​

خيارات خاصة

	ملكية	وصف	يكتب
jsonp	اسم رد الاتصال	تعيين اسم رد الاتصال المخصص	خيط
أحضر	يعبر	تشير إلى ما إذا كان الطلب يمكن أن يكون عبر الأصل	منطقية
اياكس	-	-	-

أمثلة

بسيط

 import catta from 'catta' ;

catta ( 'http://some/url' ) . then ( function ( res ) {
  console . log ( res ) ;
} ) ; 

مع خيارات كاملة

 import catta from 'catta' ;

catta ( 'http://some/url' , {
  type : 'jsonp' ,
  data : {
    page : 5 ,
    count : 20
  } ,
  timeout : 2 ,
  credential : false ,
  cross : false ,
  
  // sp. options
  jsonp : {
      callbackName : 'myCustomJSONP1'
  }
} )
. then ( res => console . log ( res ) )
. catch ( err => console . log ( err ) ) ; 

استخدم فقط Fetch/AJAX/JSONP

 import { fetch } from 'catta' ;

// only use fetch
fetch ( 'http://some/url' , {
  data : { a : 1 }
} ) . then ( function ( res ) {
  console . log ( res ) ;
} ) ; 

رؤوس الطلبات المخصصة

 import catta from 'catta' ;

catta ( 'http://some/url' , {
  headers : {
    'Content-Type' : 'appliction/json'
  }
} )
. then ( function ( res ) {
  console . log ( res ) ;
} ) ;

الكتابة فوق التكوين العام

 import { globalConfig } from 'catta' ;

// set global config, it will work for each request
globalConfig ( {
  timeout : 10
} ) ;

محول مخصص

المحول المخصص هو مجرد كائن يحتوي على وظيفة detector processor تُستخدم هذه الميزة لإنشاء غلاف لطلبك الخاص، والسماح catta بالتعامل معه. لمزيد من التفاصيل، راجع مثال محول mtop

 import { customAdapter } from 'catta' ;
import mtopAdapter from 'catta/lib/custom/mtop' ;

// set mtop adapter
customAdapter ( 'mtop' , mtopAdapter ) ; 

إشعارات أخرى

• الكشف التلقائي عن منطق المحول
  • options.type محددة.نوع
  • كل محول مخصص
  • جلب الدعم ؟ جلب : اياكس

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا