catta

gato

catta é um cliente de solicitação simples para navegador Support Fetch, AJAX, JSONP e até mesmo personalizar seu próprio adaptador. 中文文档-请点我

• Muito simples de usar
• Opções uniformes e uso para cada adaptador
• Suporta todos os navegadores modernos (inclui IE 9+, com versão comp.)
• Suporta detecção automática de navegador para adaptador escolhido (mais detalhes)
• Adaptador próprio personalizado
• peso leve, versão principal com menos de 2 KB (min + gzip)

Suporte ao navegador

• catta-min.js
  • Todos os navegadores modernos, exceto IE
  • Não há nenhum polyfill es6 +, apenas biblioteca pura
• catta-min-comp.js
  • Navegador totalmente moderno, IE 9+
  • Biblioteca principal com Promise e Object.assign polyfill
  • Sem polyfill Formdata , enviar {data: HTMLFormElement} precisa do IE 10+ para funcionar
  • Sem polyfill Global Fetch , se o navegador não suportar esse recurso, ele fará o downgrade para AJAX

Recomendo usar o puro, caso seu projeto já tenha aqueles polyfill ou não precise de suporte do IE.

Uso

Instale primeiro

 # local install
npm install catta --save

Em seguida, importe para o seu projeto

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

Opções

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

Opções importantes

	Descrição	Tipo	Padrão	Buscar	AJAX	JSONP
url	solicitar URL	corda	nulo	v	v	v
método	método de solicitação	string {obter, postar, colocar, excluir, cabeçalho}	'pegar'	v	v	x
dados	os dados são enviados para o servidor	string/Objeto/Elemento de formulário [3]	{}	v	v	v

Opções secundárias

	Descrição	Tipo	Padrão	Buscar	AJAX	JSONP
tipo	restringir tipo de solicitação	string {buscar, ajax, jsonp, script}	'auto'	-	-	-
tempo esgotado	lançar erro de tempo limite após segundos	número	3	! [1]	v	! [1]
tipo de resultado	o tipo de resultado	{texto, json, resposta}	texto	v	v	! [2]

v Suportado ! Parcialmente Suportado × Não Suportado

1. A solicitação de busca e JSONP não pode ser abortada, o tempo limite atual é apenas um erro de tempo limite

2. A opção resultType não funciona com jsonp, porque o resultado deve ser um código javascript executável

3. Suporta apenas elemento de formulário com recurso FormData

   ​

Opções Especiais

	Propriedade	Descrição	Tipo
jsonp	nome de retorno	definir nome de retorno de chamada personalizado	corda
buscar	cruzar	indicar se a solicitação pode ter origem cruzada	booleano
ajax	-	-	-

Exemplos

Simples

 import catta from 'catta' ;

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

Com opções 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 ) ) ; 

Use apenas Fetch/AJAX/JSONP

 import { fetch } from 'catta' ;

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

Cabeçalhos de solicitação personalizados

 import catta from 'catta' ;

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

Substituir configuração global

 import { globalConfig } from 'catta' ;

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

Adaptador personalizado

Um adaptador customizado é apenas um objeto, que possui função detector e processor Este recurso é usado para criar um wrapper para sua solicitação especial e deixar que catta o trate. Mais detalhes, consulte o exemplo do adaptador mtop

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

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

Outros avisos

• Lógica do adaptador de detecção automática
  • options.type específicas.type
  • Cada adaptador personalizado
  • Busca de suporte? buscar: ajax

Licença

Licença MIT