ajax异步请求ay,GitHub - aydany/superagent: Ajax with less suck - (and node.js HTTP client to match)...

SuperAgent

SuperAgent is a small progressive client-side HTTP request library, and Node.js module with the same API, sporting many high-level HTTP client features. View the docs.

687474703a2f2f662e636c2e6c792f6974656d732f33643238326e33413068305a304b3277307132612f53637265656e73686f742e706e67

Installation

node:

$ npm install superagent

component:

$ component install visionmedia/superagent

with script tags use ./superagent.js

Motivation

This library spawned from my frustration with jQuery's weak & inconsistent Ajax support. jQuery's API, while having recently added some promise-like support, is largely static, forcing you to build up big objects containing all the header fields and options, not to mention most of the options are awkwardly named "type" instead of "method", etc. Onto examples!

The following is what you might typically do for a simple GET with jQuery:

$.get('/user/1', function(data, textStatus, xhr){

});

Great, it's ok, but it's kinda lame having 3 arguments just to access something on the xhr. Our equivalent would be:

request.get('/user/1', function(res){

});

The response object is an instanceof request.Response, encapsulating all of this information instead of throwing a bunch of arguments at you. For example, we can check res.status, res.header for header fields, res.text, res.body etc.

An example of a JSON POST with jQuery typically might use $.post(), however once you need to start defining header fields you have to then re-write it using $.ajax()... so that might look like:

$.ajax({

url: '/api/pet',

type: 'POST',

data: { name: 'Manny', species: 'cat' },

headers: { 'X-API-Key': 'foobar' }

}).success(function(res){

}).error(function(){

});

Not only is it ugly, but it's pretty opinionated. jQuery likes to special-case {4,5}xx- for example, you cannot (easily at least) receive a parsed JSON response for say "400 Bad Request". This same request would look like this:

request

.post('/api/pet')

.send({ name: 'Manny', species: 'cat' })

.set('X-API-Key', 'foobar')

.set('Accept', 'application/json')

.end(function(error, res){

});

Building on the existing API internally, we also provide something similar to $.post() for those times in life where your interactions are very basic:

request.post('/api/pet', cat, function(error, res){

});

Plugins

Usage:

var nocache = require('no-cache');

var request = require('superagent');

var prefix = require('superagent-prefix')('/static');

prefix(request); // Prefixes *all* requests

request

.get('/some-url')

.use(nocache) // Prevents caching of *only* this request

.end(function(res){

// Do something

});

Existing plugins:

superagent-no-cache - prevents caching by including Cache-Control header

superagent-prefix - prefixes absolute URLs (useful in test environment)

Please prefix your plugin component with superagent-*

For superagent extensions such as couchdb and oauth visit the wiki.

Running node tests

Install dependencies:

$ npm install

Run em!

$ make test

Running browser tests

Install the test server deps (nodejs / express):

$ npm install

Start the test server:

$ make test-server

Visit localhost:4000/ in the browser.

Browser build

The browser build of superagent is located in ./superagent.js

Examples:

License

MIT

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值