Unduh catta - unduh kode sumber catta

catta

Kategori lainnya

1.0.0

Unduh

catta

catta adalah klien permintaan sederhana untuk browser Support Fetch, AJAX, JSONP dan bahkan menyesuaikan adaptor Anda sendiri. 中文文档-请点我

Sangat mudah digunakan
Opsi dan penggunaan seragam untuk setiap adaptor
Mendukung semua browser modern (termasuk IE 9+, dengan versi comp.)
Mendukung deteksi otomatis browser ke adaptor pilihan (lebih detail)
Adaptor khusus sendiri
ringan, versi inti kurang dari 2 KB (min + gzip)

Dukungan peramban

catta-min.js
- Semua browser modern, kecuali IE
- Tidak ada es6+ polyfill, hanya perpustakaan murni
catta-min-comp.js
- Semua browser modern, IE 9+
- Pustaka inti dengan polyfill Promise dan Object.assign
- Tanpa polyfill Formdata , kirim {data: HTMLFormElement} memerlukan IE 10+ agar berfungsi
- Tidak ada polyfill Ambil Global , jika browser tidak mendukung fitur ini, maka browser akan menurunkan versi ke AJAX

Rekomendasikan untuk menggunakan yang murni, jika proyek Anda sudah memiliki polyfill tersebut atau tidak memerlukan Dukungan IE.

Penggunaan

Instal Pertama

 # local install
npm install catta --save

Kemudian impor ke proyek Anda

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

Pilihan

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

Opsi Penting

	Keterangan	Jenis	Bawaan	Mengambil	AJAX	JSONP
url	minta url	rangkaian	batal	ay	ay	ay
metode	metode permintaan	string {dapatkan, posting, masukkan, hapus, kepala }	'mendapatkan'	ay	ay	X
data	data dikirim ke server	string/Objek/Elemen Bentuk [3]	{}	ay	ay	ay

Opsi Sekunder

	Keterangan	Jenis	Bawaan	Mengambil	AJAX	JSONP
jenis	membatasi jenis permintaan	string { ambil, ajax, jsonp, skrip }	'mobil'	—	—	—
batas waktu	membuang kesalahan batas waktu setelah beberapa detik	nomor	3	! [1]	ay	! [1]
tipe hasil	jenis hasilnya	{ teks, json, tanggapan }	teks	ay	ay	! [2]

v Didukung ! Didukung Sebagian × Tidak Didukung

Permintaan pengambilan dan JSONP tidak dapat dibatalkan, batas waktu saat ini hanyalah kesalahan batas waktu
Opsi resultType tidak dapat berfungsi dengan jsonp, karena hasilnya harus berupa kode javascript yang dapat dieksekusi
Hanya mendukung elemen formulir dengan fitur FormData

Opsi Khusus

	Milik	Keterangan	Jenis
jsonp	nama panggilan balik	atur nama panggilan balik khusus	rangkaian
mengambil	menyeberang	menunjukkan apakah permintaan dapat lintas asal	boolean
ajax	-	-	-

Contoh

Sederhana

 import catta from 'catta' ;

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

Dengan Pilihan penuh

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

Hanya gunakan Ambil/AJAX/JSONP

 import { fetch } from 'catta' ;

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

Header permintaan khusus

 import catta from 'catta' ;

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

Timpa konfigurasi global

 import { globalConfig } from 'catta' ;

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

Adaptor khusus

Adaptor khusus hanyalah sebuah objek, yang memiliki fungsi detector dan processor Fitur ini digunakan untuk membuat pembungkus permintaan khusus Anda, dan biarkan catta menanganinya. Lebih detail lihat contoh adaptor mtop

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

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