DefinitelyTyped/superagent/superagent-tests.ts

/// <reference path="./superagent.d.ts" />
/// <reference path="../node/node.d.ts" />

// via: http://visionmedia.github.io/superagent/

import request = require('superagent')
import fs = require('fs');

request
  .post('/api/pet')
  .send({ name: 'Manny', species: 'cat' })
  .set('X-API-Key', 'foobar')
  .set('Accept', 'application/json')
  .end((res: request.Response) => {
    if (res.ok) {
      console.log('yay got ' + JSON.stringify(res.body));
    } else {
      console.log('Oh no! error ' + res.text);
    }
  });

var agent = request.agent();
agent
  .post('/api/pet')
  .send({ name: 'Manny', species: 'cat' })
  .set('X-API-Key', 'foobar')
  .set('Accept', 'application/json')
  .end((res: request.Response) => {
    if (res.error) {
      console.log('oh no ' + res.error.message);
    } else {
      console.log('got ' + res.status + ' response');
    }
  });


var callback = (res: request.Response) => {};

// Request basics
request
  .get('/search')
  .end(callback);

request('GET', '/search')
  .end(callback);

request
  .head('/favicon.ico')
  .end(callback);

request
  .del('/user/1')
  .end(callback);

request
  .delete('/user/1')
  .end(callback);

request('/search')
  .end(callback);

// Setting header fields
request
  .get('/search')
  .set('API-Key', 'foobar')
  .set('Accept', 'application/json')
  .end(callback);

request
  .get('/search')
  .set({ 'API-Key': 'foobar', Accept: 'application/json' })
  .end(callback);

// GET requests
request
  .get('/search')
  .query({ query: 'Manny' })
  .query({ range: '1..5' })
  .query({ order: 'desc' })
  .end(callback);

request
  .get('/search')
  .query({ query: 'Manny', range: '1..5', order: 'desc' })
  .end(callback);

request
  .get('/querystring')
  .query('search=Manny&range=1..5')
  .end(callback);

request
  .get('/querystring')
  .query('search=Manny')
  .query('range=1..5')
  .end(callback);

// POST / PUT requests
request.post('/user')
  .set('Content-Type', 'application/json')
  .send('{"name":"tj","pet":"tobi"}')
  .end(callback);

request.post('/user')
  .send({ name: 'tj', pet: 'tobi' })
  .end(callback);

request.post('/user')
  .send({ name: 'tj' })
  .send({ pet: 'tobi' })
  .end(callback);

request.post('/user')
  .send('name=tj')
  .send('pet=tobi')
  .end(callback);

request.post('/user')
  .type('form')
  .send({ name: 'tj' })
  .send({ pet: 'tobi' })
  .end(callback);

// Setting the Content-Type
request.post('/user')
  .set('Content-Type', 'application/json');

request.post('/user')
  .type('application/json');

request.post('/user')
  .type('json');

request.post('/user')
  .type('png');

request.get('/user')
  .accept('application/json');

request.get('/user')
  .accept('json');

request.get('/user')
  .accept('png');

// Query strings
request
  .post('/')
  .query({ format: 'json' })
  .query({ dest: '/login' })
  .send({ post: 'data', here: 'wahoo' })
  .end(callback);

// Parsing response bodies
request('/search')
  .end((res: request.Response) => {
    var status: number = res.status;
    var body = res.body;
    var files: Object = res.files;
    var text: string = res.text;
    var contentLength = res.header['content-length'];
    var contentType: string = res.type;
    var charset: string = res.charset;
  });

var req = request.get('/hoge');
// Aborting requests
req.abort();

// Request timeouts
req.timeout(100);

// Basic authentication
request.get('http://tobi:learnboost@local').end(callback);
request
  .get('http://local')
  .auth('tobo', 'learnboost')
  .end(callback);

// Following redirects
request
  .get('/some.png')
  .redirects(2)
  .end(callback);

// Piping data
/*
(function() {
var stream = fs.createReadStream('path/to/my.json');
var req = request.post('/somewhere');
req.type('json');
stream.pipe(req);
})();
*/

(function() {
var stream = fs.createWriteStream('path/to/my.json');
var req = request.get('/some.json');
req.pipe(stream);
})();

// Multipart requests
(function() {
var req = request.post('/upload');

req.part()
  .set('Content-Type', 'image/png')
  .set('Content-Disposition', 'attachment; filename="myimage.png"')
  .write('some image data')
  .write('some more image data');

req.part()
  .set('Content-Disposition', 'form-data; name="name"')
  .set('Content-Type', 'text/plain')
  .write('tobi');

req.end(callback);
})();

// Attaching files
request
  .post('/upload')
  .attach('avatar', 'path/to/tobi.png', 'user.png')
  .attach('image', 'path/to/loki.png')
  .attach('file', 'path/to/jane.png')
  .end(callback);

// Field values
request
  .post('/upload')
  .field('user[name]', 'Tobi')
  .field('user[email]', 'tobi@learnboost.com')
  .attach('image', 'path/to/tobi.png')
  .end(callback);

// CORS
request
  .get('http://localhost:4001/')
  .withCredentials()
  .end(callback);

// Error handling
request
  .post('/upload')
  .attach('image', 'path/to/tobi.png')
  .end((err: any, res: request.Response): void => {});
request
  .post('/upload')
  .attach('image', 'path/to/tobi.png')
  .on('error', (err: any) => {})
  .end(callback);