catta

catta

catta es un cliente de solicitud simple para el navegador. Admite Fetch, AJAX, JSONP e incluso personaliza tu propio adaptador. 中文文档-请点我

• Muy simple de usar
• Opciones y uso uniformes para cada adaptador.
• Admite todos los navegadores modernos (incluye IE 9+, con versión comp.)
• Admite la detección automática del navegador para elegir el adaptador (más detalles)
• Adaptador propio personalizado
• peso ligero, versión principal de menos de 2 KB (min + gzip)

Soporte del navegador

• catta-min.js
  • Todos los navegadores modernos, excepto IE
  • No hay ningún polyfill es6+, solo biblioteca pura
• catta-min-comp.js
  • Todo el navegador moderno, IE 9+
  • Biblioteca principal con Promise y Object.assign polyfill
  • Sin Polyfill de Formdata , envíe {data: HTMLFormElement} necesita IE 10+ para funcionar
  • Sin polirelleno de Global Fetch . Si el navegador no admite esta función, se cambiará a AJAX.

Recomiende usar el puro, si su proyecto ya tiene esos polyfill o no necesita soporte de IE.

Uso

Instalar primero

 # local install
npm install catta --save

Luego importe a su proyecto

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

Opciones

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

Opciones importantes

	Descripción	Tipo	Por defecto	Buscar	AJAX	JSONP
URL	URL de solicitud	cadena	nulo	v	v	v
método	método de solicitud	cadena {obtener, publicar, poner, eliminar, encabezado}	'conseguir'	v	v	incógnita
datos	los datos se envían al servidor	cadena/Objeto/Elemento de formulario [3]	{}	v	v	v

Opciones secundarias

	Descripción	Tipo	Por defecto	Buscar	AJAX	JSONP
tipo	restringir el tipo de solicitud	cadena {buscar, ajax, jsonp, script}	'auto'	—	—	—
se acabó el tiempo	arrojar error de tiempo de espera después de segundos	número	3	! [1]	v	! [1]
tipo de resultado	el tipo de resultado	{texto, json, respuesta}	texto	v	v	! [2]

¡ Soportado ! Parcialmente compatible × No compatible

1. La solicitud de recuperación y JSONP no se puede cancelar, el tiempo de espera actual es simplemente un error de tiempo de espera

2. La opción resultType no puede funcionar con jsonp porque el resultado debe ser un código javascript ejecutable.

3. Solo admite elementos de formulario con la función FormData

   ​

Opciones especiales

	Propiedad	Descripción	Tipo
jsonp	nombre de devolución de llamada	establecer un nombre de devolución de llamada personalizado	cadena
buscar	cruz	indicar si la solicitud puede tener orígenes cruzados	booleano
ajax	-	-	-

Ejemplos

Simple

 import catta from 'catta' ;

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

Con opciones completas

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

Utilice únicamente Fetch/AJAX/JSONP

 import { fetch } from 'catta' ;

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

Encabezados de solicitud personalizados

 import catta from 'catta' ;

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

Sobrescribir la configuración global

 import { globalConfig } from 'catta' ;

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

Adaptador personalizado

Un adaptador personalizado es solo un objeto que tiene función detector y processor Esta función se utiliza para crear un contenedor para su solicitud especial y dejar que catta se encargue de ello. Para obtener más detalles, consulte el ejemplo del adaptador mtop.

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

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

Otros avisos

• Lógica del adaptador de detección automática
  • options.type específicas.tipo
  • Cada adaptador personalizado
  • ¿Soporte de recuperación? buscar: ajax

Licencia

Licencia MIT