catta -Download - catta Quellcode herunterladen

catta

Andere Kategorien

1.0.0

Herunterladen

catta

catta ist ein einfacher Anforderungsclient für Browser, der Fetch, AJAX, JSONP und sogar die Anpassung Ihres eigenen Adapters unterstützt. 中文文档-请点我

Absolut einfach zu bedienen
Einheitliche Optionen und Verwendung für jeden Adapter
Unterstützt alle modernen Browser (einschließlich IE 9+, mit Comp.-Version)
Unterstützung der automatischen Browser-Erkennung für den ausgewählten Adapter (weitere Einzelheiten)
Benutzerdefinierter eigener Adapter
Geringes Gewicht, Kernversion weniger als 2 KB (min. + gzip)

Browserunterstützung

catta-min.js
- Alle modernen Browser, außer IE
- Keine es6+-Polyfüllung, nur reine Bibliothek
catta-min-comp.js
- Alle modernen Browser, IE 9+
- Kernbibliothek mit Promise- und Object.assign- Polyfill
- Kein Formdata- Polyfill, zum Senden von {data: HTMLFormElement} ist IE 10+ erforderlich
- Kein Global Fetch- Polyfill. Wenn der Browser diese Funktion nicht unterstützt, wird er auf AJAX heruntergestuft

Empfehlen Sie die Verwendung der reinen Version, wenn Ihr Projekt bereits über diese Polyfüllung verfügt oder keine IE-Unterstützung benötigt.

Verwendung

Zuerst installieren

 # local install
npm install catta --save

Anschließend in Ihr Projekt importieren

 // 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 >

Optionen

API

  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 ) ;

Wichtige Optionen

	Beschreibung	Typ	Standard	Bringen	AJAX	JSONP
URL	Anfrage-URL	Zeichenfolge	null	v	v	v
Verfahren	Anfragemethode	string { get , post, put, delete, head }	'erhalten'	v	v	X
Daten	Die Daten werden an den Server gesendet	Zeichenfolge/Objekt/Formularelement [3]	{}	v	v	v

Sekundäre Optionen

	Beschreibung	Typ	Standard	Bringen	AJAX	JSONP
Typ	Beschränken Sie den Anforderungstyp	string { fetch, ajax, jsonp, script }	'Auto'	—	—	—
Time-out	Timeout-Fehler nach Sekunden auslösen	Nummer	3	! [1]	v	! [1]
resultType	die Art des Ergebnisses	{Text, JSON, Antwort}	Text	v	v	! [2]

v Unterstützt ! Teilweise unterstützt × nicht unterstützt

Der Abruf und die JSONP-Anfrage können nicht abgebrochen werden. Das aktuelle Timeout ist nur ein Timeout-Fehler
Die resultType- Option kann nicht mit JSONP funktionieren, da das Ergebnis ausführbarer Javascript-Code sein muss
Unterstützt nur Formularelemente mit FormData-Funktion

Sonderoptionen

	Eigentum	Beschreibung	Typ
jsonp	Rückrufname	Legen Sie einen benutzerdefinierten Rückrufnamen fest	Zeichenfolge
bringen	kreuzen	Geben Sie an, ob die Anfrage ursprungsübergreifend sein kann	Boolescher Wert
Ajax	-	-	-

Beispiele

Einfach

 import catta from 'catta' ;

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

Mit vollen Optionen

 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 ) ) ;

Verwenden Sie nur Fetch / AJAX / JSONP

 import { fetch } from 'catta' ;

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

Benutzerdefinierte Anforderungsheader

 import catta from 'catta' ;

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

Globale Konfiguration überschreiben

 import { globalConfig } from 'catta' ;

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

Benutzerdefinierter Adapter

Ein benutzerdefinierter Adapter ist nur ein Objekt, das über detector und processor verfügt. Mit dieser Funktion können Sie einen Wrapper für Ihre spezielle Anfrage erstellen und catta damit beauftragen. Weitere Einzelheiten finden Sie im Beispiel für einen MTOP-Adapter

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

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