Viewing file: -rw-r--r-- + ) | + ) | + ) | Code + ) | Session + ) | + ) | SDB + ) | + ) | + ) | + ) | + ) | + ) |SuperAgent — elegant API for AJAX in Node and browsers
Agent
should remember defaults
if (typeof Promise === 'undefined') {
return;
}
let called = 0;
let event_called = 0;
const agent = request
.agent()
.accept('json')
.use(() => {
called++;
})
.once('request', () => {
event_called++;
})
.query({ hello: 'world' })
.set('X-test', 'testing');
assert.equal(0, called);
assert.equal(0, event_called);
return agent
.get(`${base}/echo`)
.then((res) => {
assert.equal(1, called);
assert.equal(1, event_called);
assert.equal('application/json', res.headers.accept);
assert.equal('testing', res.headers['x-test']);
return agent.get(`${base}/querystring`);
})
.then((res) => {
assert.equal(2, called);
assert.equal(2, event_called);
assert.deepEqual({ hello: 'world' }, res.body);
});
request
res.statusCode
should set statusCode
request.get(`${uri}/login`, (err, res) => {
try {
assert.strictEqual(res.statusCode, 200);
done();
} catch (err_) {
done(err_);
}
});
should allow the send shorthand
with callback in the method call
request.get(`${uri}/login`, (err, res) => {
assert.equal(res.status, 200);
done();
});with data in the method call
request.post(`${uri}/echo`, { foo: 'bar' }).end((err, res) => {
assert.equal('{"foo":"bar"}', res.text);
done();
});with callback and data in the method call
request.post(`${uri}/echo`, { foo: 'bar' }, (err, res) => {
assert.equal('{"foo":"bar"}', res.text);
done();
});
with a callback
should invoke .end()
request.get(`${uri}/login`, (err, res) => {
try {
assert.equal(res.status, 200);
done();
} catch (err_) {
done(err_);
}
});
.end()
should issue a request
request.get(`${uri}/login`).end((err, res) => {
try {
assert.equal(res.status, 200);
done();
} catch (err_) {
done(err_);
}
});is optional with a promise
if (typeof Promise === 'undefined') {
return;
}
return request
.get(`${uri}/login`)
.then((res) => res.status)
.then()
.then((status) => {
assert.equal(200, status, 'Real promises pass results through');
});called only once with a promise
if (typeof Promise === 'undefined') {
return;
}
const req = request.get(`${uri}/unique`);
return Promise.all([req, req, req]).then((results) => {
results.forEach((item) => {
assert.equal(
item.body,
results[0].body,
'It should keep returning the same result after being called once'
);
});
});
res.error
ok
let calledErrorEvent = false;
let calledOKHandler = false;
request
.get(`${uri}/error`)
.ok((res) => {
assert.strictEqual(500, res.status);
calledOKHandler = true;
return true;
})
.on('error', (err) => {
calledErrorEvent = true;
})
.end((err, res) => {
try {
assert.ifError(err);
assert.strictEqual(res.status, 500);
assert(!calledErrorEvent);
assert(calledOKHandler);
done();
} catch (err_) {
done(err_);
}
});should be an Error object
let calledErrorEvent = false;
request
.get(`${uri}/error`)
.on('error', (err) => {
assert.strictEqual(err.status, 500);
calledErrorEvent = true;
})
.end((err, res) => {
try {
if (NODE) {
res.error.message.should.equal('cannot GET /error (500)');
} else {
res.error.message.should.equal(`cannot GET ${uri}/error (500)`);
}
assert.strictEqual(res.error.status, 500);
assert(err, 'should have an error for 500');
assert.equal(err.message, 'Internal Server Error');
assert(calledErrorEvent);
done();
} catch (err_) {
done(err_);
}
});with .then() promise
if (typeof Promise === 'undefined') {
return;
}
return request.get(`${uri}/error`).then(
() => {
assert.fail();
},
(err) => {
assert.equal(err.message, 'Internal Server Error');
}
);with .ok() returning false
if (typeof Promise === 'undefined') {
return;
}
return request
.get(`${uri}/echo`)
.ok(() => false)
.then(
() => {
assert.fail();
},
(err) => {
assert.equal(200, err.response.status);
assert.equal(err.message, 'OK');
}
);with .ok() throwing an Error
if (typeof Promise === 'undefined') {
return;
}
return request
.get(`${uri}/echo`)
.ok(() => {
throw new Error('boom');
})
.then(
() => {
assert.fail();
},
(err) => {
assert.equal(200, err.response.status);
assert.equal(err.message, 'boom');
}
);
res.header
should be an object
request.get(`${uri}/login`).end((err, res) => {
try {
assert.equal('Express', res.header['x-powered-by']);
done();
} catch (err_) {
done(err_);
}
});
set headers
should only set headers for ownProperties of header
try {
request
.get(`${uri}/echo-headers`)
.set('valid', 'ok')
.end((err, res) => {
if (
!err &&
res.body &&
res.body.valid &&
!res.body.hasOwnProperty('invalid')
) {
return done();
}
done(err || new Error('fail'));
});
} catch (err) {
done(err);
}
res.charset
should be set when present
request.get(`${uri}/login`).end((err, res) => {
try {
res.charset.should.equal('utf-8');
done();
} catch (err_) {
done(err_);
}
});
res.statusType
should provide the first digit
request.get(`${uri}/login`).end((err, res) => {
try {
assert(!err, 'should not have an error for success responses');
assert.equal(200, res.status);
assert.equal(2, res.statusType);
done();
} catch (err_) {
done(err_);
}
});
res.type
should provide the mime-type void of params
request.get(`${uri}/login`).end((err, res) => {
try {
res.type.should.equal('text/html');
res.charset.should.equal('utf-8');
done();
} catch (err_) {
done(err_);
}
});
req.set(field, val)
should set the header field
request
.post(`${uri}/echo`)
.set('X-Foo', 'bar')
.set('X-Bar', 'baz')
.end((err, res) => {
try {
assert.equal('bar', res.header['x-foo']);
assert.equal('baz', res.header['x-bar']);
done();
} catch (err_) {
done(err_);
}
});
req.set(obj)
should set the header fields
request
.post(`${uri}/echo`)
.set({ 'X-Foo': 'bar', 'X-Bar': 'baz' })
.end((err, res) => {
try {
assert.equal('bar', res.header['x-foo']);
assert.equal('baz', res.header['x-bar']);
done();
} catch (err_) {
done(err_);
}
});
req.type(str)
should set the Content-Type
request
.post(`${uri}/echo`)
.type('text/x-foo')
.end((err, res) => {
try {
res.header['content-type'].should.equal('text/x-foo');
done();
} catch (err_) {
done(err_);
}
});should map "json"
request
.post(`${uri}/echo`)
.type('json')
.send('{"a": 1}')
.end((err, res) => {
try {
res.should.be.json();
done();
} catch (err_) {
done(err_);
}
});should map "html"
request
.post(`${uri}/echo`)
.type('html')
.end((err, res) => {
try {
res.header['content-type'].should.equal('text/html');
done();
} catch (err_) {
done(err_);
}
});
req.accept(str)
should set Accept
request
.get(`${uri}/echo`)
.accept('text/x-foo')
.end((err, res) => {
try {
res.header.accept.should.equal('text/x-foo');
done();
} catch (err_) {
done(err_);
}
});should map "json"
request
.get(`${uri}/echo`)
.accept('json')
.end((err, res) => {
try {
res.header.accept.should.equal('application/json');
done();
} catch (err_) {
done(err_);
}
});should map "xml"
request
.get(`${uri}/echo`)
.accept('xml')
.end((err, res) => {
try {
// Mime module keeps changing this :(
assert(
res.header.accept == 'application/xml' ||
res.header.accept == 'text/xml'
);
done();
} catch (err_) {
done(err_);
}
});should map "html"
request
.get(`${uri}/echo`)
.accept('html')
.end((err, res) => {
try {
res.header.accept.should.equal('text/html');
done();
} catch (err_) {
done(err_);
}
});
req.send(str)
should write the string
request
.post(`${uri}/echo`)
.type('json')
.send('{"name":"tobi"}')
.end((err, res) => {
try {
res.text.should.equal('{"name":"tobi"}');
done();
} catch (err_) {
done(err_);
}
});
req.send(Object)
should default to json
request
.post(`${uri}/echo`)
.send({ name: 'tobi' })
.end((err, res) => {
try {
res.should.be.json();
res.text.should.equal('{"name":"tobi"}');
done();
} catch (err_) {
done(err_);
}
});
when called several times
should merge the objects
request
.post(`${uri}/echo`)
.send({ name: 'tobi' })
.send({ age: 1 })
.end((err, res) => {
try {
res.should.be.json();
if (NODE) {
res.buffered.should.be.true();
}
res.text.should.equal('{"name":"tobi","age":1}');
done();
} catch (err_) {
done(err_);
}
});
.end(fn)
should check arity
request
.post(`${uri}/echo`)
.send({ name: 'tobi' })
.end((err, res) => {
try {
assert.ifError(err);
res.text.should.equal('{"name":"tobi"}');
done();
} catch (err_) {
done(err_);
}
});should emit request
const req = request.post(`${uri}/echo`);
req.on('request', (request) => {
assert.equal(req, request);
done();
});
req.end();should emit response
request
.post(`${uri}/echo`)
.send({ name: 'tobi' })
.on('response', (res) => {
res.text.should.equal('{"name":"tobi"}');
done();
})
.end();
.then(fulfill, reject)
should support successful fulfills with .then(fulfill)
if (typeof Promise === 'undefined') {
return done();
}
request
.post(`${uri}/echo`)
.send({ name: 'tobi' })
.then((res) => {
res.type.should.equal('application/json');
res.text.should.equal('{"name":"tobi"}');
done();
});should reject an error with .then(null, reject)
if (typeof Promise === 'undefined') {
return done();
}
request.get(`${uri}/error`).then(null, (err) => {
assert.equal(err.status, 500);
assert.equal(err.response.text, 'boom');
done();
});
.catch(reject)
should reject an error with .catch(reject)
if (typeof Promise === 'undefined') {
return done();
}
request.get(`${uri}/error`).catch((err) => {
assert.equal(err.status, 500);
assert.equal(err.response.text, 'boom');
done();
});
.abort()
should abort the request
const req = request.get(`${uri}/delay/3000`);
req.end((err, res) => {
try {
assert(false, 'should not complete the request');
} catch (err_) {
done(err_);
}
});
req.on('error', (error) => {
done(error);
});
req.on('abort', done);
setTimeout(() => {
req.abort();
}, 500);should abort the promise
const req = request.get(`${uri}/delay/3000`);
setTimeout(() => {
req.abort();
}, 10);
return req.then(
() => {
assert.fail('should not complete the request');
},
(err) => {
assert.equal('ABORTED', err.code);
}
);should allow chaining .abort() several times
const req = request.get(`${uri}/delay/3000`);
req.end((err, res) => {
try {
assert(false, 'should not complete the request');
} catch (err_) {
done(err_);
}
});
// This also verifies only a single 'done' event is emitted
req.on('abort', done);
setTimeout(() => {
req.abort().abort().abort();
}, 1000);should not allow abort then end
request
.get(`${uri}/delay/3000`)
.abort()
.end((err, res) => {
done(err ? undefined : new Error('Expected abort error'));
});
req.toJSON()
should describe the request
const req = request.post(`${uri}/echo`).send({ foo: 'baz' });
req.end((err, res) => {
try {
const json = req.toJSON();
assert.equal('POST', json.method);
assert(/\/echo$/.test(json.url));
assert.equal('baz', json.data.foo);
done();
} catch (err_) {
done(err_);
}
});
req.options()
should allow request body
request
.options(`${uri}/options/echo/body`)
.send({ foo: 'baz' })
.end((err, res) => {
try {
assert.equal(err, null);
assert.strictEqual(res.body.foo, 'baz');
done();
} catch (err_) {
done(err_);
}
});
req.sortQuery()
nop with no querystring
request
.get(`${uri}/url`)
.sortQuery()
.end((err, res) => {
try {
assert.equal(res.text, '/url');
done();
} catch (err_) {
done(err_);
}
});should sort the request querystring
request
.get(`${uri}/url`)
.query('search=Manny')
.query('order=desc')
.sortQuery()
.end((err, res) => {
try {
assert.equal(res.text, '/url?order=desc&search=Manny');
done();
} catch (err_) {
done(err_);
}
});should allow disabling sorting
request
.get(`${uri}/url`)
.query('search=Manny')
.query('order=desc')
.sortQuery() // take default of true
.sortQuery(false) // override it in later call
.end((err, res) => {
try {
assert.equal(res.text, '/url?search=Manny&order=desc');
done();
} catch (err_) {
done(err_);
}
});should sort the request querystring using customized function
request
.get(`${uri}/url`)
.query('name=Nick')
.query('search=Manny')
.query('order=desc')
.sortQuery((a, b) => a.length - b.length)
.end((err, res) => {
try {
assert.equal(res.text, '/url?name=Nick&order=desc&search=Manny');
done();
} catch (err_) {
done(err_);
}
});
req.set("Content-Type", contentType)
should work with just the contentType component
request
.post(`${uri}/echo`)
.set('Content-Type', 'application/json')
.send({ name: 'tobi' })
.end((err, res) => {
assert(!err);
done();
});should work with the charset component
request
.post(`${uri}/echo`)
.set('Content-Type', 'application/json; charset=utf-8')
.send({ name: 'tobi' })
.end((err, res) => {
assert(!err);
done();
});
req.send(Object) as "form"
with req.type() set to form
should send x-www-form-urlencoded data
request
.post(`${base}/echo`)
.type('form')
.send({ name: 'tobi' })
.end((err, res) => {
res.header['content-type'].should.equal(
'application/x-www-form-urlencoded'
);
res.text.should.equal('name=tobi');
done();
});
when called several times
should merge the objects
request
.post(`${base}/echo`)
.type('form')
.send({ name: { first: 'tobi', last: 'holowaychuk' } })
.send({ age: '1' })
.end((err, res) => {
res.header['content-type'].should.equal(
'application/x-www-form-urlencoded'
);
res.text.should.equal(
'name%5Bfirst%5D=tobi&name%5Blast%5D=holowaychuk&age=1'
);
done();
});
req.attach
ignores null file
request
.post('/echo')
.attach('image', null)
.end((err, res) => {
done();
});
req.field
allow bools
if (!formDataSupported) {
return done();
}
request
.post(`${base}/formecho`)
.field('bools', true)
.field('strings', 'true')
.end((err, res) => {
assert.ifError(err);
assert.deepStrictEqual(res.body, { bools: 'true', strings: 'true' });
done();
});allow objects
if (!formDataSupported) {
return done();
}
request
.post(`${base}/formecho`)
.field({ bools: true, strings: 'true' })
.end((err, res) => {
assert.ifError(err);
assert.deepStrictEqual(res.body, { bools: 'true', strings: 'true' });
done();
});works with arrays in objects
if (!formDataSupported) {
return done();
}
request
.post(`${base}/formecho`)
.field({ numbers: [1, 2, 3] })
.end((err, res) => {
assert.ifError(err);
assert.deepStrictEqual(res.body, { numbers: ['1', '2', '3'] });
done();
});works with arrays
if (!formDataSupported) {
return done();
}
request
.post(`${base}/formecho`)
.field('letters', ['a', 'b', 'c'])
.end((err, res) => {
assert.ifError(err);
assert.deepStrictEqual(res.body, { letters: ['a', 'b', 'c'] });
done();
});throw when empty
should.throws(() => {
request.post(`${base}/echo`).field();
}, /name/);
should.throws(() => {
request.post(`${base}/echo`).field('name');
}, /val/);cannot be mixed with send()
assert.throws(() => {
request.post('/echo').field('form', 'data').send('hi');
});
assert.throws(() => {
request.post('/echo').send('hi').field('form', 'data');
});
req.send(Object) as "json"
should default to json
request
.post(`${uri}/echo`)
.send({ name: 'tobi' })
.end((err, res) => {
res.should.be.json();
res.text.should.equal('{"name":"tobi"}');
done();
});should work with arrays
request
.post(`${uri}/echo`)
.send([1, 2, 3])
.end((err, res) => {
res.should.be.json();
res.text.should.equal('[1,2,3]');
done();
});should work with value null
request
.post(`${uri}/echo`)
.type('json')
.send('null')
.end((err, res) => {
res.should.be.json();
assert.strictEqual(res.body, null);
done();
});should work with value false
request
.post(`${uri}/echo`)
.type('json')
.send('false')
.end((err, res) => {
res.should.be.json();
res.body.should.equal(false);
done();
});should work with value 0
// fails in IE9
request
.post(`${uri}/echo`)
.type('json')
.send('0')
.end((err, res) => {
res.should.be.json();
res.body.should.equal(0);
done();
});should work with empty string value
request
.post(`${uri}/echo`)
.type('json')
.send('""')
.end((err, res) => {
res.should.be.json();
res.body.should.equal('');
done();
});should work with GET
request
.get(`${uri}/echo`)
.send({ tobi: 'ferret' })
.end((err, res) => {
try {
res.should.be.json();
res.text.should.equal('{"tobi":"ferret"}');
({ tobi: 'ferret' }.should.eql(res.body));
done();
} catch (err_) {
done(err_);
}
});should work with vendor MIME type
request
.post(`${uri}/echo`)
.set('Content-Type', 'application/vnd.example+json')
.send({ name: 'vendor' })
.end((err, res) => {
res.text.should.equal('{"name":"vendor"}');
({ name: 'vendor' }.should.eql(res.body));
done();
});
when called several times
should merge the objects
request
.post(`${uri}/echo`)
.send({ name: 'tobi' })
.send({ age: 1 })
.end((err, res) => {
res.should.be.json();
res.text.should.equal('{"name":"tobi","age":1}');
({ name: 'tobi', age: 1 }.should.eql(res.body));
done();
});
res.body
application/json
should parse the body
request.get(`${uri}/json`).end((err, res) => {
res.text.should.equal('{"name":"manny"}');
res.body.should.eql({ name: 'manny' });
done();
});
HEAD requests
should not throw a parse error
request.head(`${uri}/json`).end((err, res) => {
try {
assert.strictEqual(err, null);
assert.strictEqual(res.text, undefined);
assert.strictEqual(Object.keys(res.body).length, 0);
done();
} catch (err_) {
done(err_);
}
});
Invalid JSON response
should return the raw response
request.get(`${uri}/invalid-json`).end((err, res) => {
assert.deepEqual(
err.rawResponse,
")]}', {'header':{'code':200,'text':'OK','version':'1.0'},'data':'some data'}"
);
done();
});should return the http status code
request.get(`${uri}/invalid-json-forbidden`).end((err, res) => {
assert.equal(err.statusCode, 403);
done();
});
No content
should not throw a parse error
request.get(`${uri}/no-content`).end((err, res) => {
try {
assert.strictEqual(err, null);
assert.strictEqual(res.text, '');
assert.strictEqual(Object.keys(res.body).length, 0);
done();
} catch (err_) {
done(err_);
}
});
application/json+hal
should parse the body
request.get(`${uri}/json-hal`).end((err, res) => {
if (err) return done(err);
res.text.should.equal('{"name":"hal 5000"}');
res.body.should.eql({ name: 'hal 5000' });
done();
});
vnd.collection+json
should parse the body
request.get(`${uri}/collection-json`).end((err, res) => {
res.text.should.equal('{"name":"chewbacca"}');
res.body.should.eql({ name: 'chewbacca' });
done();
});
request
on redirect
should retain header fields
request
.get(`${base}/header`)
.set('X-Foo', 'bar')
.end((err, res) => {
try {
assert(res.body);
res.body.should.have.property('x-foo', 'bar');
done();
} catch (err_) {
done(err_);
}
});should preserve timeout across redirects
request
.get(`${base}/movies/random`)
.timeout(250)
.end((err, res) => {
try {
assert(err instanceof Error, 'expected an error');
err.should.have.property('timeout', 250);
done();
} catch (err_) {
done(err_);
}
});should successfully redirect after retry on error
const id = Math.random() * 1000000 * Date.now();
request
.get(`${base}/error/redirect/${id}`)
.retry(2)
.end((err, res) => {
assert(res.ok, 'response should be ok');
assert(res.text, 'first movie page');
done();
});should preserve retries across redirects
const id = Math.random() * 1000000 * Date.now();
request
.get(`${base}/error/redirect-error${id}`)
.retry(2)
.end((err, res) => {
assert(err, 'expected an error');
assert.equal(2, err.retries, 'expected an error with .retries');
assert.equal(500, err.status, 'expected an error status of 500');
done();
});
on 303
should redirect with same method
request
.put(`${base}/redirect-303`)
.send({ msg: 'hello' })
.redirects(1)
.on('redirect', (res) => {
res.headers.location.should.equal('/reply-method');
})
.end((err, res) => {
if (err) {
done(err);
return;
}
res.text.should.equal('method=get');
done();
});
on 307
should redirect with same method
if (isMSIE) return done(); // IE9 broken
request
.put(`${base}/redirect-307`)
.send({ msg: 'hello' })
.redirects(1)
.on('redirect', (res) => {
res.headers.location.should.equal('/reply-method');
})
.end((err, res) => {
if (err) {
done(err);
return;
}
res.text.should.equal('method=put');
done();
});
on 308
should redirect with same method
if (isMSIE) return done(); // IE9 broken
request
.put(`${base}/redirect-308`)
.send({ msg: 'hello' })
.redirects(1)
.on('redirect', (res) => {
res.headers.location.should.equal('/reply-method');
})
.end((err, res) => {
if (err) {
done(err);
return;
}
res.text.should.equal('method=put');
done();
});
request
Request inheritance
assert(request.get(`${uri}/`) instanceof request.Request);request() simple GET without callback
request('GET', 'test/test.request.js').end();
next();request() simple GET
request('GET', `${uri}/ok`).end((err, res) => {
try {
assert(res instanceof request.Response, 'respond with Response');
assert(res.ok, 'response should be ok');
assert(res.text, 'res.text');
next();
} catch (err_) {
next(err_);
}
});request() simple HEAD
request.head(`${uri}/ok`).end((err, res) => {
try {
assert(res instanceof request.Response, 'respond with Response');
assert(res.ok, 'response should be ok');
assert(!res.text, 'res.text');
next();
} catch (err_) {
next(err_);
}
});request() GET 5xx
request('GET', `${uri}/error`).end((err, res) => {
try {
assert(err);
assert.equal(err.message, 'Internal Server Error');
assert(!res.ok, 'response should not be ok');
assert(res.error, 'response should be an error');
assert(!res.clientError, 'response should not be a client error');
assert(res.serverError, 'response should be a server error');
next();
} catch (err_) {
next(err_);
}
});request() GET 4xx
request('GET', `${uri}/notfound`).end((err, res) => {
try {
assert(err);
assert.equal(err.message, 'Not Found');
assert(!res.ok, 'response should not be ok');
assert(res.error, 'response should be an error');
assert(res.clientError, 'response should be a client error');
assert(!res.serverError, 'response should not be a server error');
next();
} catch (err_) {
next(err_);
}
});request() GET 404 Not Found
request('GET', `${uri}/notfound`).end((err, res) => {
try {
assert(err);
assert(res.notFound, 'response should be .notFound');
next();
} catch (err_) {
next(err_);
}
});request() GET 400 Bad Request
request('GET', `${uri}/bad-request`).end((err, res) => {
try {
assert(err);
assert(res.badRequest, 'response should be .badRequest');
next();
} catch (err_) {
next(err_);
}
});request() GET 401 Bad Request
request('GET', `${uri}/unauthorized`).end((err, res) => {
try {
assert(err);
assert(res.unauthorized, 'response should be .unauthorized');
next();
} catch (err_) {
next(err_);
}
});request() GET 406 Not Acceptable
request('GET', `${uri}/not-acceptable`).end((err, res) => {
try {
assert(err);
assert(res.notAcceptable, 'response should be .notAcceptable');
next();
} catch (err_) {
next(err_);
}
});request() GET 204 No Content
request('GET', `${uri}/no-content`).end((err, res) => {
try {
assert.ifError(err);
assert(res.noContent, 'response should be .noContent');
next();
} catch (err_) {
next(err_);
}
});request() DELETE 204 No Content
request('DELETE', `${uri}/no-content`).end((err, res) => {
try {
assert.ifError(err);
assert(res.noContent, 'response should be .noContent');
next();
} catch (err_) {
next(err_);
}
});request() header parsing
request('GET', `${uri}/notfound`).end((err, res) => {
try {
assert(err);
assert.equal('text/html; charset=utf-8', res.header['content-type']);
assert.equal('Express', res.header['x-powered-by']);
next();
} catch (err_) {
next(err_);
}
});request() .status
request('GET', `${uri}/notfound`).end((err, res) => {
try {
assert(err);
assert.equal(404, res.status, 'response .status');
assert.equal(4, res.statusType, 'response .statusType');
next();
} catch (err_) {
next(err_);
}
});get()
request.get(`${uri}/notfound`).end((err, res) => {
try {
assert(err);
assert.equal(404, res.status, 'response .status');
assert.equal(4, res.statusType, 'response .statusType');
next();
} catch (err_) {
next(err_);
}
});put()
request.put(`${uri}/user/12`).end((err, res) => {
try {
assert.equal('updated', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});put().send()
request
.put(`${uri}/user/13/body`)
.send({ user: 'new' })
.end((err, res) => {
try {
assert.equal('received new', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});post()
request.post(`${uri}/user`).end((err, res) => {
try {
assert.equal('created', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});del()
request.del(`${uri}/user/12`).end((err, res) => {
try {
assert.equal('deleted', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});delete()
request.delete(`${uri}/user/12`).end((err, res) => {
try {
assert.equal('deleted', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});post() data
request
.post(`${uri}/todo/item`)
.type('application/octet-stream')
.send('tobi')
.end((err, res) => {
try {
assert.equal('added "tobi"', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});request .type()
request
.post(`${uri}/user/12/pet`)
.type('urlencoded')
.send('pet=tobi')
.end((err, res) => {
try {
assert.equal('added pet "tobi"', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});request .type() with alias
request
.post(`${uri}/user/12/pet`)
.type('application/x-www-form-urlencoded')
.send('pet=tobi')
.end((err, res) => {
try {
assert.equal('added pet "tobi"', res.text, 'response text');
next();
} catch (err_) {
next(err_);
}
});request .get() with no data or callback
request.get(`${uri}/echo-header/content-type`);
next();request .send() with no data only
request.post(`${uri}/user/5/pet`).type('urlencoded').send('pet=tobi');
next();request .send() with callback only
request
.get(`${uri}/echo-header/accept`)
.set('Accept', 'foo/bar')
.end((err, res) => {
try {
assert.equal('foo/bar', res.text);
next();
} catch (err_) {
next(err_);
}
});request .accept() with json
request
.get(`${uri}/echo-header/accept`)
.accept('json')
.end((err, res) => {
try {
assert.equal('application/json', res.text);
next();
} catch (err_) {
next(err_);
}
});request .accept() with application/json
request
.get(`${uri}/echo-header/accept`)
.accept('application/json')
.end((err, res) => {
try {
assert.equal('application/json', res.text);
next();
} catch (err_) {
next(err_);
}
});request .accept() with xml
request
.get(`${uri}/echo-header/accept`)
.accept('xml')
.end((err, res) => {
try {
// We can't depend on mime module to be consistent with this
assert(res.text == 'application/xml' || res.text == 'text/xml');
next();
} catch (err_) {
next(err_);
}
});request .accept() with application/xml
request
.get(`${uri}/echo-header/accept`)
.accept('application/xml')
.end((err, res) => {
try {
assert.equal('application/xml', res.text);
next();
} catch (err_) {
next(err_);
}
});request .end()
request
.put(`${uri}/echo-header/content-type`)
.set('Content-Type', 'text/plain')
.send('wahoo')
.end((err, res) => {
try {
assert.equal('text/plain', res.text);
next();
} catch (err_) {
next(err_);
}
});request .send()
request
.put(`${uri}/echo-header/content-type`)
.set('Content-Type', 'text/plain')
.send('wahoo')
.end((err, res) => {
try {
assert.equal('text/plain', res.text);
next();
} catch (err_) {
next(err_);
}
});request .set()
request
.put(`${uri}/echo-header/content-type`)
.set('Content-Type', 'text/plain')
.send('wahoo')
.end((err, res) => {
try {
assert.equal('text/plain', res.text);
next();
} catch (err_) {
next(err_);
}
});request .set(object)
request
.put(`${uri}/echo-header/content-type`)
.set({ 'Content-Type': 'text/plain' })
.send('wahoo')
.end((err, res) => {
try {
assert.equal('text/plain', res.text);
next();
} catch (err_) {
next(err_);
}
});POST urlencoded
request
.post(`${uri}/pet`)
.type('urlencoded')
.send({ name: 'Manny', species: 'cat' })
.end((err, res) => {
try {
assert.equal('added Manny the cat', res.text);
next();
} catch (err_) {
next(err_);
}
});POST json
request
.post(`${uri}/pet`)
.type('json')
.send({ name: 'Manny', species: 'cat' })
.end((err, res) => {
try {
assert.equal('added Manny the cat', res.text);
next();
} catch (err_) {
next(err_);
}
});POST json array
request
.post(`${uri}/echo`)
.send([1, 2, 3])
.end((err, res) => {
try {
assert.equal(
'application/json',
res.header['content-type'].split(';')[0]
);
assert.equal('[1,2,3]', res.text);
next();
} catch (err_) {
next(err_);
}
});POST json default
request
.post(`${uri}/pet`)
.send({ name: 'Manny', species: 'cat' })
.end((err, res) => {
try {
assert.equal('added Manny the cat', res.text);
next();
} catch (err_) {
next(err_);
}
});POST json contentType charset
request
.post(`${uri}/echo`)
.set('Content-Type', 'application/json; charset=UTF-8')
.send({ data: ['data1', 'data2'] })
.end((err, res) => {
try {
assert.equal('{"data":["data1","data2"]}', res.text);
next();
} catch (err_) {
next(err_);
}
});POST json contentType vendor
request
.post(`${uri}/echo`)
.set('Content-Type', 'application/vnd.example+json')
.send({ data: ['data1', 'data2'] })
.end((err, res) => {
try {
assert.equal('{"data":["data1","data2"]}', res.text);
next();
} catch (err_) {
next(err_);
}
});POST multiple .send() calls
request
.post(`${uri}/pet`)
.send({ name: 'Manny' })
.send({ species: 'cat' })
.end((err, res) => {
try {
assert.equal('added Manny the cat', res.text);
next();
} catch (err_) {
next(err_);
}
});POST multiple .send() strings
request
.post(`${uri}/echo`)
.send('user[name]=tj')
.send('user[email]=tj@vision-media.ca')
.end((err, res) => {
try {
assert.equal(
'application/x-www-form-urlencoded',
res.header['content-type'].split(';')[0]
);
assert.equal(
res.text,
'user[name]=tj&user[email]=tj@vision-media.ca'
);
next();
} catch (err_) {
next(err_);
}
});POST with no data
request
.post(`${uri}/empty-body`)
.send()
.end((err, res) => {
try {
assert.ifError(err);
assert(res.noContent, 'response should be .noContent');
next();
} catch (err_) {
next(err_);
}
});GET .type
request.get(`${uri}/pets`).end((err, res) => {
try {
assert.equal('application/json', res.type);
next();
} catch (err_) {
next(err_);
}
});GET Content-Type params
request.get(`${uri}/text`).end((err, res) => {
try {
assert.equal('utf-8', res.charset);
next();
} catch (err_) {
next(err_);
}
});GET json
request.get(`${uri}/pets`).end((err, res) => {
try {
assert.deepEqual(res.body, ['tobi', 'loki', 'jane']);
next();
} catch (err_) {
next(err_);
}
});GET json-seq
request
.get(`${uri}/json-seq`)
.buffer()
.end((err, res) => {
try {
assert.ifError(err);
assert.deepEqual(res.text, '\u001E{"id":1}\n\u001E{"id":2}\n');
next();
} catch (err_) {
next(err_);
}
});GET x-www-form-urlencoded
request.get(`${uri}/foo`).end((err, res) => {
try {
assert.deepEqual(res.body, { foo: 'bar' });
next();
} catch (err_) {
next(err_);
}
});GET shorthand
request.get(`${uri}/foo`, (err, res) => {
try {
assert.equal('foo=bar', res.text);
next();
} catch (err_) {
next(err_);
}
});POST shorthand
request.post(`${uri}/user/0/pet`, { pet: 'tobi' }, (err, res) => {
try {
assert.equal('added pet "tobi"', res.text);
next();
} catch (err_) {
next(err_);
}
});POST shorthand without callback
request.post(`${uri}/user/0/pet`, { pet: 'tobi' }).end((err, res) => {
try {
assert.equal('added pet "tobi"', res.text);
next();
} catch (err_) {
next(err_);
}
});GET querystring object with array
request
.get(`${uri}/querystring`)
.query({ val: ['a', 'b', 'c'] })
.end((err, res) => {
try {
assert.deepEqual(res.body, { val: ['a', 'b', 'c'] });
next();
} catch (err_) {
next(err_);
}
});GET querystring object with array and primitives
request
.get(`${uri}/querystring`)
.query({ array: ['a', 'b', 'c'], string: 'foo', number: 10 })
.end((err, res) => {
try {
assert.deepEqual(res.body, {
array: ['a', 'b', 'c'],
string: 'foo',
number: 10
});
next();
} catch (err_) {
next(err_);
}
});GET querystring object with two arrays
request
.get(`${uri}/querystring`)
.query({ array1: ['a', 'b', 'c'], array2: [1, 2, 3] })
.end((err, res) => {
try {
assert.deepEqual(res.body, {
array1: ['a', 'b', 'c'],
array2: [1, 2, 3]
});
next();
} catch (err_) {
next(err_);
}
});GET querystring object
request
.get(`${uri}/querystring`)
.query({ search: 'Manny' })
.end((err, res) => {
try {
assert.deepEqual(res.body, { search: 'Manny' });
next();
} catch (err_) {
next(err_);
}
});GET querystring append original
request
.get(`${uri}/querystring?search=Manny`)
.query({ range: '1..5' })
.end((err, res) => {
try {
assert.deepEqual(res.body, { search: 'Manny', range: '1..5' });
next();
} catch (err_) {
next(err_);
}
});GET querystring multiple objects
request
.get(`${uri}/querystring`)
.query({ search: 'Manny' })
.query({ range: '1..5' })
.query({ order: 'desc' })
.end((err, res) => {
try {
assert.deepEqual(res.body, {
search: 'Manny',
range: '1..5',
order: 'desc'
});
next();
} catch (err_) {
next(err_);
}
});GET querystring with strings
request
.get(`${uri}/querystring`)
.query('search=Manny')
.query('range=1..5')
.query('order=desc')
.end((err, res) => {
try {
assert.deepEqual(res.body, {
search: 'Manny',
range: '1..5',
order: 'desc'
});
next();
} catch (err_) {
next(err_);
}
});GET querystring with strings and objects
request
.get(`${uri}/querystring`)
.query('search=Manny')
.query({ order: 'desc', range: '1..5' })
.end((err, res) => {
try {
assert.deepEqual(res.body, {
search: 'Manny',
range: '1..5',
order: 'desc'
});
next();
} catch (err_) {
next(err_);
}
});GET shorthand payload goes to querystring
request.get(
`${uri}/querystring`,
{ foo: 'FOO', bar: 'BAR' },
(err, res) => {
try {
assert.deepEqual(res.body, { foo: 'FOO', bar: 'BAR' });
next();
} catch (err_) {
next(err_);
}
}
);HEAD shorthand payload goes to querystring
request.head(
`${uri}/querystring-in-header`,
{ foo: 'FOO', bar: 'BAR' },
(err, res) => {
try {
assert.deepEqual(JSON.parse(res.headers.query), {
foo: 'FOO',
bar: 'BAR'
});
next();
} catch (err_) {
next(err_);
}
}
);request(method, url)
request('GET', `${uri}/foo`).end((err, res) => {
try {
assert.equal('bar', res.body.foo);
next();
} catch (err_) {
next(err_);
}
});request(url)
request(`${uri}/foo`).end((err, res) => {
try {
assert.equal('bar', res.body.foo);
next();
} catch (err_) {
next(err_);
}
});request(url, fn)
request(`${uri}/foo`, (err, res) => {
try {
assert.equal('bar', res.body.foo);
next();
} catch (err_) {
next(err_);
}
});req.timeout(ms)
const req = request.get(`${uri}/delay/3000`).timeout(1000);
req.end((err, res) => {
try {
assert(err, 'error missing');
assert.equal(1000, err.timeout, 'err.timeout missing');
assert.equal(
'Timeout of 1000ms exceeded',
err.message,
'err.message incorrect'
);
assert.equal(null, res);
assert(req.timedout, true);
next();
} catch (err_) {
next(err_);
}
});req.timeout(ms) with redirect
const req = request.get(`${uri}/delay/const`).timeout(1000);
req.end((err, res) => {
try {
assert(err, 'error missing');
assert.equal(1000, err.timeout, 'err.timeout missing');
assert.equal(
'Timeout of 1000ms exceeded',
err.message,
'err.message incorrect'
);
assert.equal(null, res);
assert(req.timedout, true);
next();
} catch (err_) {
next(err_);
}
});request event
request
.get(`${uri}/foo`)
.on('request', (req) => {
try {
assert.equal(`${uri}/foo`, req.url);
next();
} catch (err) {
next(err);
}
})
.end();response event
request
.get(`${uri}/foo`)
.on('response', (res) => {
try {
assert.equal('bar', res.body.foo);
next();
} catch (err) {
next(err);
}
})
.end();response should set statusCode
request.get(`${uri}/ok`, (err, res) => {
try {
assert.strictEqual(res.statusCode, 200);
next();
} catch (err_) {
next(err_);
}
});req.toJSON()
request.get(`${uri}/ok`).end((err, res) => {
try {
const j = (res.request || res.req).toJSON();
['url', 'method', 'data', 'headers'].forEach((prop) => {
assert(j.hasOwnProperty(prop));
});
next();
} catch (err_) {
next(err_);
}
});
.retry(count)
should not retry if passed "0"
request
.get(`${base}/error`)
.retry(0)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(
undefined,
err.retries,
'expected an error without .retries'
);
assert.equal(500, err.status, 'expected an error status of 500');
done();
} catch (err_) {
done(err_);
}
});should not retry if passed an invalid number
request
.get(`${base}/error`)
.retry(-2)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(
undefined,
err.retries,
'expected an error without .retries'
);
assert.equal(500, err.status, 'expected an error status of 500');
done();
} catch (err_) {
done(err_);
}
});should not retry if passed undefined
request
.get(`${base}/error`)
.retry(undefined)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(
undefined,
err.retries,
'expected an error without .retries'
);
assert.equal(500, err.status, 'expected an error status of 500');
done();
} catch (err_) {
done(err_);
}
});should handle server error after repeat attempt
request
.get(`${base}/error`)
.retry(2)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(2, err.retries, 'expected an error with .retries');
assert.equal(500, err.status, 'expected an error status of 500');
done();
} catch (err_) {
done(err_);
}
});should retry if passed nothing
request
.get(`${base}/error`)
.retry()
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(1, err.retries, 'expected an error with .retries');
assert.equal(500, err.status, 'expected an error status of 500');
done();
} catch (err_) {
done(err_);
}
});should retry if passed "true"
request
.get(`${base}/error`)
.retry(true)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(1, err.retries, 'expected an error with .retries');
assert.equal(500, err.status, 'expected an error status of 500');
done();
} catch (err_) {
done(err_);
}
});should handle successful request after repeat attempt from server error
request
.get(`${base}/error/ok/${uniqid()}`)
.query({ qs: 'present' })
.retry(2)
.end((err, res) => {
try {
assert.ifError(err);
assert(res.ok, 'response should be ok');
assert(res.text, 'res.text');
done();
} catch (err_) {
done(err_);
}
});should handle server timeout error after repeat attempt
request
.get(`${base}/delay/400`)
.timeout(200)
.retry(2)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(2, err.retries, 'expected an error with .retries');
assert.equal(
'number',
typeof err.timeout,
'expected an error with .timeout'
);
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
done();
} catch (err_) {
done(err_);
}
});should handle successful request after repeat attempt from server timeout
const url = `/delay/1200/ok/${uniqid()}?built=in`;
request
.get(base + url)
.query('string=ified')
.query({ json: 'ed' })
.timeout(600)
.retry(2)
.end((err, res) => {
try {
assert.ifError(err);
assert(res.ok, 'response should be ok');
assert.equal(res.text, `ok = ${url}&string=ified&json=ed`);
done();
} catch (err_) {
done(err_);
}
});should handle successful request after repeat attempt from server timeout when using .then(fulfill, reject)
const url = `/delay/1200/ok/${uniqid()}?built=in`;
request
.get(base + url)
.query('string=ified')
.query({ json: 'ed' })
.timeout(600)
.retry(1)
.then((res, err) => {
try {
assert.ifError(err);
assert(res.ok, 'response should be ok');
assert.equal(res.text, `ok = ${url}&string=ified&json=ed`);
done();
} catch (err_) {
done(err_);
}
});should correctly abort a retry attempt
let aborted = false;
const req = request.get(`${base}/delay/400`).timeout(200).retry(2);
req.end((err, res) => {
try {
assert(false, 'should not complete the request');
} catch (err_) {
done(err_);
}
});
req.on('abort', () => {
aborted = true;
});
setTimeout(() => {
req.abort();
setTimeout(() => {
try {
assert(aborted, 'should be aborted');
done();
} catch (err) {
done(err);
}
}, 150);
}, 150);should correctly retain header fields
request
.get(`${base}/error/ok/${uniqid()}`)
.query({ qs: 'present' })
.retry(2)
.set('X-Foo', 'bar')
.end((err, res) => {
try {
assert.ifError(err);
assert(res.body);
res.body.should.have.property('x-foo', 'bar');
done();
} catch (err_) {
done(err_);
}
});should not retry on 4xx responses
request
.get(`${base}/bad-request`)
.retry(2)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(0, err.retries, 'expected an error with 0 .retries');
assert.equal(400, err.status, 'expected an error status of 400');
done();
} catch (err_) {
done(err_);
}
});should execute callback on retry if passed
let callbackCallCount = 0;
function retryCallback(request) {
callbackCallCount++;
}
request
.get(`${base}/error`)
.retry(2, retryCallback)
.end((err, res) => {
try {
assert(err, 'expected an error');
assert.equal(2, err.retries, 'expected an error with .retries');
assert.equal(500, err.status, 'expected an error status of 500');
assert.equal(
2,
callbackCallCount,
'expected the callback to be called on each retry'
);
done();
} catch (err_) {
done(err_);
}
});
.timeout(ms)
when timeout is exceeded
should error
request
.get(`${base}/delay/500`)
.timeout(150)
.end((err, res) => {
assert(err, 'expected an error');
assert.equal(
'number',
typeof err.timeout,
'expected an error with .timeout'
);
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
done();
});should error in promise interface
request
.get(`${base}/delay/500`)
.timeout(150)
.catch((err) => {
assert(err, 'expected an error');
assert.equal(
'number',
typeof err.timeout,
'expected an error with .timeout'
);
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
done();
});should handle gzip timeout
request
.get(`${base}/delay/zip`)
.timeout(150)
.end((err, res) => {
assert(err, 'expected an error');
assert.equal(
'number',
typeof err.timeout,
'expected an error with .timeout'
);
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
done();
});should handle buffer timeout
request
.get(`${base}/delay/json`)
.buffer(true)
.timeout(150)
.end((err, res) => {
assert(err, 'expected an error');
assert.equal(
'number',
typeof err.timeout,
'expected an error with .timeout'
);
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
done();
});should error on deadline
request
.get(`${base}/delay/500`)
.timeout({ deadline: 150 })
.end((err, res) => {
assert(err, 'expected an error');
assert.equal(
'number',
typeof err.timeout,
'expected an error with .timeout'
);
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
done();
});should support setting individual options
request
.get(`${base}/delay/500`)
.timeout({ deadline: 10 })
.timeout({ response: 99999 })
.end((err, res) => {
assert(err, 'expected an error');
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
assert.equal('ETIME', err.errno);
done();
});should error on response
request
.get(`${base}/delay/500`)
.timeout({ response: 150 })
.end((err, res) => {
assert(err, 'expected an error');
assert.equal(
'number',
typeof err.timeout,
'expected an error with .timeout'
);
assert.equal('ECONNABORTED', err.code, 'expected abort error code');
assert.equal('ETIMEDOUT', err.errno);
done();
});should accept slow body with fast response
request
.get(`${base}/delay/slowbody`)
.timeout({ response: 1000 })
.on('progress', () => {
// This only makes the test faster without relying on arbitrary timeouts
request.get(`${base}/delay/slowbody/finish`).end();
})
.end(done);
request
use
should use plugin success
const now = `${Date.now()}`;
function uuid(req) {
req.set('X-UUID', now);
return req;
}
function prefix(req) {
req.url = uri + req.url;
return req;
}
request
.get('/echo')
.use(uuid)
.use(prefix)
.end((err, res) => {
assert.strictEqual(res.statusCode, 200);
assert.equal(res.get('X-UUID'), now);
done();
});
subclass
should be an instance of Request
const req = request.get('/');
assert(req instanceof request.Request);should use patched subclass
assert(OriginalRequest);
let constructorCalled;
let sendCalled;
function NewRequest(...args) {
constructorCalled = true;
OriginalRequest.apply(this, args);
}
NewRequest.prototype = Object.create(OriginalRequest.prototype);
NewRequest.prototype.send = function () {
sendCalled = true;
return this;
};
request.Request = NewRequest;
const req = request.get('/').send();
assert(constructorCalled);
assert(sendCalled);
assert(req instanceof NewRequest);
assert(req instanceof OriginalRequest);should use patched subclass in agent too
if (!request.agent) return; // Node-only
function NewRequest(...args) {
OriginalRequest.apply(this, args);
}
NewRequest.prototype = Object.create(OriginalRequest.prototype);
request.Request = NewRequest;
const req = request.agent().del('/');
assert(req instanceof NewRequest);
assert(req instanceof OriginalRequest);
request
persistent agent
should gain a session on POST
agent3.post(`${base}/signin`).then((res) => {
res.should.have.status(200);
should.not.exist(res.headers['set-cookie']);
res.text.should.containEql('dashboard');
})should start with empty session (set cookies)
agent1.get(`${base}/dashboard`).end((err, res) => {
should.exist(err);
res.should.have.status(401);
should.exist(res.headers['set-cookie']);
done();
});should gain a session (cookies already set)
agent1.post(`${base}/signin`).then((res) => {
res.should.have.status(200);
should.not.exist(res.headers['set-cookie']);
res.text.should.containEql('dashboard');
})should persist cookies across requests
agent1.get(`${base}/dashboard`).then((res) => {
res.should.have.status(200);
})should have the cookie set in the end callback
agent4
.post(`${base}/setcookie`)
.then(() => agent4.get(`${base}/getcookie`))
.then((res) => {
res.should.have.status(200);
assert.strictEqual(res.text, 'jar');
})should not share cookies
agent2.get(`${base}/dashboard`).end((err, res) => {
should.exist(err);
res.should.have.status(401);
done();
});should not lose cookies between agents
agent1.get(`${base}/dashboard`).then((res) => {
res.should.have.status(200);
})should be able to follow redirects
agent1.get(base).then((res) => {
res.should.have.status(200);
res.text.should.containEql('dashboard');
})should be able to post redirects
agent1
.post(`${base}/redirect`)
.send({ foo: 'bar', baz: 'blaaah' })
.then((res) => {
res.should.have.status(200);
res.text.should.containEql('simple');
res.redirects.should.eql([`${base}/simple`]);
})should be able to limit redirects
agent1
.get(base)
.redirects(0)
.end((err, res) => {
should.exist(err);
res.should.have.status(302);
res.redirects.should.eql([]);
res.header.location.should.equal('/dashboard');
done();
});should be able to create a new session (clear cookie)
agent1.post(`${base}/signout`).then((res) => {
res.should.have.status(200);
should.exist(res.headers['set-cookie']);
})should regenerate with an empty session
agent1.get(`${base}/dashboard`).end((err, res) => {
should.exist(err);
res.should.have.status(401);
should.not.exist(res.headers['set-cookie']);
done();
});
Basic auth
when credentials are present in url
should set Authorization
const new_url = URL.parse(base);
new_url.auth = 'tobi:learnboost';
new_url.pathname = '/basic-auth';
request.get(URL.format(new_url)).end((err, res) => {
res.status.should.equal(200);
done();
});
req.auth(user, pass)
should set Authorization
request
.get(`${base}/basic-auth`)
.auth('tobi', 'learnboost')
.end((err, res) => {
res.status.should.equal(200);
done();
});
req.auth(user + ":" + pass)
should set authorization
request
.get(`${base}/basic-auth/again`)
.auth('tobi')
.end((err, res) => {
res.status.should.eql(200);
done();
});
[node] request
should send body with .get().send()
request
.get(`${base}/echo`)
.set('Content-Type', 'text/plain')
.send('wahoo')
.end((err, res) => {
try {
assert.equal('wahoo', res.text);
next();
} catch (err_) {
next(err_);
}
});
with an url
should preserve the encoding of the url
request.get(`${base}/url?a=(b%29`).end((err, res) => {
assert.equal('/url?a=(b%29', res.text);
done();
});
with an object
should format the url
request.get(url.parse(`${base}/login`)).then((res) => {
assert(res.ok);
})
without a schema
should default to http
request.get('localhost:5000/login').then((res) => {
assert.equal(res.status, 200);
})
res.toJSON()
should describe the response
request
.post(`${base}/echo`)
.send({ foo: 'baz' })
.then((res) => {
const obj = res.toJSON();
assert.equal('object', typeof obj.header);
assert.equal('object', typeof obj.req);
assert.equal(200, obj.status);
assert.equal('{"foo":"baz"}', obj.text);
})
res.links
should default to an empty object
request.get(`${base}/login`).then((res) => {
res.links.should.eql({});
})should parse the Link header field
request.get(`${base}/links`).end((err, res) => {
res.links.next.should.equal(
'https://api.github.com/repos/visionmedia/mocha/issues?page=2'
);
done();
});
req.unset(field)
should remove the header field
request
.post(`${base}/echo`)
.unset('User-Agent')
.end((err, res) => {
assert.equal(void 0, res.header['user-agent']);
done();
});
case-insensitive
should set/get header fields case-insensitively
const r = request.post(`${base}/echo`);
r.set('MiXeD', 'helloes');
assert.strictEqual(r.get('mixed'), 'helloes');should unset header fields case-insensitively
const r = request.post(`${base}/echo`);
r.set('MiXeD', 'helloes');
r.unset('MIXED');
assert.strictEqual(r.get('mixed'), undefined);
req.write(str)
should write the given data
const req = request.post(`${base}/echo`);
req.set('Content-Type', 'application/json');
assert.equal('boolean', typeof req.write('{"name"'));
assert.equal('boolean', typeof req.write(':"tobi"}'));
req.end((err, res) => {
res.text.should.equal('{"name":"tobi"}');
done();
});
req.pipe(stream)
should pipe the response to the given stream
const stream = new EventEmitter();
stream.buf = '';
stream.writable = true;
stream.write = function (chunk) {
this.buf += chunk;
};
stream.end = function () {
this.buf.should.equal('{"name":"tobi"}');
done();
};
request.post(`${base}/echo`).send('{"name":"tobi"}').pipe(stream);
.buffer()
should enable buffering
request
.get(`${base}/custom`)
.buffer()
.end((err, res) => {
assert.ifError(err);
assert.equal('custom stuff', res.text);
assert(res.buffered);
done();
});should take precedence over request.buffer['someMimeType'] = false
const type = 'application/barbaz';
const send = 'some text';
request.buffer[type] = false;
request
.post(`${base}/echo`)
.type(type)
.send(send)
.buffer()
.end((err, res) => {
delete request.buffer[type];
assert.ifError(err);
assert.equal(res.type, type);
assert.equal(send, res.text);
assert(res.buffered);
done();
});
.buffer(false)
should disable buffering
request
.post(`${base}/echo`)
.type('application/x-dog')
.send('hello this is dog')
.buffer(false)
.end((err, res) => {
assert.ifError(err);
assert.equal(null, res.text);
res.body.should.eql({});
let buf = '';
res.setEncoding('utf8');
res.on('data', (chunk) => {
buf += chunk;
});
res.on('end', () => {
buf.should.equal('hello this is dog');
done();
});
});should take precedence over request.buffer['someMimeType'] = true
const type = 'application/foobar';
const send = 'hello this is a dog';
request.buffer[type] = true;
request
.post(`${base}/echo`)
.type(type)
.send(send)
.buffer(false)
.end((err, res) => {
delete request.buffer[type];
assert.ifError(err);
assert.equal(null, res.text);
assert.equal(res.type, type);
assert(!res.buffered);
res.body.should.eql({});
let buf = '';
res.setEncoding('utf8');
res.on('data', (chunk) => {
buf += chunk;
});
res.on('end', () => {
buf.should.equal(send);
done();
});
});
.withCredentials()
should not throw an error when using the client-side "withCredentials" method
request
.get(`${base}/custom`)
.withCredentials()
.end((err, res) => {
assert.ifError(err);
done();
});
.agent()
should return the defaut agent
const req = request.post(`${base}/echo`);
req.agent().should.equal(false);
done();
.agent(undefined)
should set an agent to undefined and ensure it is chainable
const req = request.get(`${base}/echo`);
const ret = req.agent(undefined);
ret.should.equal(req);
assert.strictEqual(req.agent(), undefined);
done();
.agent(new http.Agent())
should set passed agent
const http = require('http');
const req = request.get(`${base}/echo`);
const agent = new http.Agent();
const ret = req.agent(agent);
ret.should.equal(req);
req.agent().should.equal(agent);
done();
with a content type other than application/json or text/*
should still use buffering
return request
.post(`${base}/echo`)
.type('application/x-dog')
.send('hello this is dog')
.then((res) => {
assert.equal(null, res.text);
assert.equal(res.body.toString(), 'hello this is dog');
res.buffered.should.be.true;
});
content-length
should be set to the byte length of a non-buffer object
const decoder = new StringDecoder('utf8');
let img = fs.readFileSync(`${__dirname}/fixtures/test.png`);
img = decoder.write(img);
request
.post(`${base}/echo`)
.type('application/x-image')
.send(img)
.buffer(false)
.end((err, res) => {
assert.ifError(err);
assert(!res.buffered);
assert.equal(res.header['content-length'], Buffer.byteLength(img));
done();
});should be set to the length of a buffer object
const img = fs.readFileSync(`${__dirname}/fixtures/test.png`);
request
.post(`${base}/echo`)
.type('application/x-image')
.send(img)
.buffer(true)
.end((err, res) => {
assert.ifError(err);
assert(res.buffered);
assert.equal(res.header['content-length'], img.length);
done();
});
req.buffer['someMimeType']
should respect that agent.buffer(true) takes precedent
const agent = request.agent();
agent.buffer(true);
const type = 'application/somerandomtype';
const send = 'somerandomtext';
request.buffer[type] = false;
agent
.post(`${base}/echo`)
.type(type)
.send(send)
.end((err, res) => {
delete request.buffer[type];
assert.ifError(err);
assert.equal(res.type, type);
assert.equal(send, res.text);
assert(res.buffered);
done();
});should respect that agent.buffer(false) takes precedent
const agent = request.agent();
agent.buffer(false);
const type = 'application/barrr';
const send = 'some random text2';
request.buffer[type] = true;
agent
.post(`${base}/echo`)
.type(type)
.send(send)
.end((err, res) => {
delete request.buffer[type];
assert.ifError(err);
assert.equal(null, res.text);
assert.equal(res.type, type);
assert(!res.buffered);
res.body.should.eql({});
let buf = '';
res.setEncoding('utf8');
res.on('data', (chunk) => {
buf += chunk;
});
res.on('end', () => {
buf.should.equal(send);
done();
});
});should disable buffering for that mimetype when false
const type = 'application/bar';
const send = 'some random text';
request.buffer[type] = false;
request
.post(`${base}/echo`)
.type(type)
.send(send)
.end((err, res) => {
delete request.buffer[type];
assert.ifError(err);
assert.equal(null, res.text);
assert.equal(res.type, type);
assert(!res.buffered);
res.body.should.eql({});
let buf = '';
res.setEncoding('utf8');
res.on('data', (chunk) => {
buf += chunk;
});
res.on('end', () => {
buf.should.equal(send);
done();
});
});should enable buffering for that mimetype when true
const type = 'application/baz';
const send = 'woooo';
request.buffer[type] = true;
request
.post(`${base}/echo`)
.type(type)
.send(send)
.end((err, res) => {
delete request.buffer[type];
assert.ifError(err);
assert.equal(res.type, type);
assert.equal(send, res.text);
assert(res.buffered);
done();
});should fallback to default handling for that mimetype when undefined
const type = 'application/bazzz';
const send = 'woooooo';
return request
.post(`${base}/echo`)
.type(type)
.send(send)
.then((res) => {
assert.equal(res.type, type);
assert.equal(send, res.body.toString());
assert(res.buffered);
});
exports
should expose .protocols
Object.keys(request.protocols).should.eql(['http:', 'https:', 'http2:']);should expose .serialize
Object.keys(request.serialize).should.eql([
'application/x-www-form-urlencoded',
'application/json'
]);should expose .parse
Object.keys(request.parse).should.eql([
'application/x-www-form-urlencoded',
'application/json',
'text',
'application/octet-stream',
'application/pdf',
'image'
]);should export .buffer
Object.keys(request.buffer).should.eql([]);
flags
with 4xx response
should set res.error and res.clientError
request.get(`${base}/notfound`).end((err, res) => {
assert(err);
assert(!res.ok, 'response should not be ok');
assert(res.error, 'response should be an error');
assert(res.clientError, 'response should be a client error');
assert(!res.serverError, 'response should not be a server error');
done();
});
with 5xx response
should set res.error and res.serverError
request.get(`${base}/error`).end((err, res) => {
assert(err);
assert(!res.ok, 'response should not be ok');
assert(!res.notFound, 'response should not be notFound');
assert(res.error, 'response should be an error');
assert(!res.clientError, 'response should not be a client error');
assert(res.serverError, 'response should be a server error');
done();
});
with 404 Not Found
should res.notFound
request.get(`${base}/notfound`).end((err, res) => {
assert(err);
assert(res.notFound, 'response should be .notFound');
done();
});
with 400 Bad Request
should set req.badRequest
request.get(`${base}/bad-request`).end((err, res) => {
assert(err);
assert(res.badRequest, 'response should be .badRequest');
done();
});
with 401 Bad Request
should set res.unauthorized
request.get(`${base}/unauthorized`).end((err, res) => {
assert(err);
assert(res.unauthorized, 'response should be .unauthorized');
done();
});
with 406 Not Acceptable
should set res.notAcceptable
request.get(`${base}/not-acceptable`).end((err, res) => {
assert(err);
assert(res.notAcceptable, 'response should be .notAcceptable');
done();
});
with 204 No Content
should set res.noContent
request.get(`${base}/no-content`).end((err, res) => {
assert(!err);
assert(res.noContent, 'response should be .noContent');
done();
});
with 201 Created
should set res.created
request.post(`${base}/created`).end((err, res) => {
assert(!err);
assert(res.created, 'response should be .created');
done();
});
with 422 Unprocessable Entity
should set res.unprocessableEntity
request.post(`${base}/unprocessable-entity`).end((err, res) => {
assert(err);
assert(
res.unprocessableEntity,
'response should be .unprocessableEntity'
);
done();
});
Merging objects
Don't mix Buffer and JSON
assert.throws(() => {
request
.post('/echo')
.send(Buffer.from('some buffer'))
.send({ allowed: false });
});
req.send(String)
should default to "form"
request
.post(`${base}/echo`)
.send('user[name]=tj')
.send('user[email]=tj@vision-media.ca')
.end((err, res) => {
res.header['content-type'].should.equal(
'application/x-www-form-urlencoded'
);
res.body.should.eql({
user: { name: 'tj', email: 'tj@vision-media.ca' }
});
done();
});
res.body
application/x-www-form-urlencoded
should parse the body
request.get(`${base}/form-data`).end((err, res) => {
res.text.should.equal('pet[name]=manny');
res.body.should.eql({ pet: { name: 'manny' } });
done();
});
https
certificate authority
request
should give a good response
request
.get(testEndpoint)
.ca(ca)
.end((err, res) => {
assert.ifError(err);
assert(res.ok);
assert.strictEqual('Safe and secure!', res.text);
done();
});should reject unauthorized response
return request
.get(testEndpoint)
.trustLocalhost(false)
.then(
() => {
throw new Error('Allows MITM');
},
() => {}
);should not reject unauthorized response
return request
.get(testEndpoint)
.disableTLSCerts()
.then(({ status }) => {
assert.strictEqual(status, 200);
});should trust localhost unauthorized response
return request.get(testEndpoint).trustLocalhost(true);should trust overriden localhost unauthorized response
return request
.get(`https://example.com:${server.address().port}`)
.connect('127.0.0.1')
.trustLocalhost();
.agent
should be able to make multiple requests without redefining the certificate
const agent = request.agent({ ca });
agent.get(testEndpoint).end((err, res) => {
assert.ifError(err);
assert(res.ok);
assert.strictEqual('Safe and secure!', res.text);
agent.get(url.parse(testEndpoint)).end((err, res) => {
assert.ifError(err);
assert(res.ok);
assert.strictEqual('Safe and secure!', res.text);
done();
});
});
res.body
image/png
should parse the body
request.get(`${base}/image`).end((err, res) => {
res.type.should.equal('image/png');
Buffer.isBuffer(res.body).should.be.true();
(res.body.length - img.length).should.equal(0);
done();
});
application/octet-stream
should parse the body
request
.get(`${base}/image-as-octets`)
.buffer(true) // that's tech debt :(
.end((err, res) => {
res.type.should.equal('application/octet-stream');
Buffer.isBuffer(res.body).should.be.true();
(res.body.length - img.length).should.equal(0);
done();
});
application/octet-stream
should parse the body (using responseType)
request
.get(`${base}/image-as-octets`)
.responseType('blob')
.end((err, res) => {
res.type.should.equal('application/octet-stream');
Buffer.isBuffer(res.body).should.be.true();
(res.body.length - img.length).should.equal(0);
done();
});
zlib
should deflate the content
request.get(base).end((err, res) => {
res.should.have.status(200);
res.text.should.equal(subject);
res.headers['content-length'].should.be.below(subject.length);
done();
});should protect from zip bombs
request
.get(base)
.buffer(true)
.maxResponseSize(1)
.end((err, res) => {
try {
assert.equal('Maximum response size reached', err && err.message);
done();
} catch (err_) {
done(err_);
}
});should ignore trailing junk
request.get(`${base}/junk`).end((err, res) => {
res.should.have.status(200);
res.text.should.equal(subject);
done();
});should ignore missing data
request.get(`${base}/chopped`).end((err, res) => {
assert.equal(undefined, err);
res.should.have.status(200);
res.text.should.startWith(subject);
done();
});should handle corrupted responses
request.get(`${base}/corrupt`).end((err, res) => {
assert(err, 'missing error');
assert(!res, 'response should not be defined');
done();
});should handle no content with gzip header
request.get(`${base}/nocontent`).end((err, res) => {
assert.ifError(err);
assert(res);
res.should.have.status(204);
res.text.should.equal('');
res.headers.should.not.have.property('content-length');
done();
});
without encoding set
should buffer if asked
return request
.get(`${base}/binary`)
.buffer(true)
.then((res) => {
res.should.have.status(200);
assert(res.headers['content-length']);
assert(res.body.byteLength);
assert.equal(subject, res.body.toString());
});should emit buffers
request.get(`${base}/binary`).end((err, res) => {
res.should.have.status(200);
res.headers['content-length'].should.be.below(subject.length);
res.on('data', (chunk) => {
chunk.should.have.length(subject.length);
});
res.on('end', done);
});
Multipart
#field(name, value)
should set a multipart field value
const req = request.post(`${base}/echo`);
req.field('user[name]', 'tobi');
req.field('user[age]', '2');
req.field('user[species]', 'ferret');
return req.then((res) => {
res.body['user[name]'].should.equal('tobi');
res.body['user[age]'].should.equal('2');
res.body['user[species]'].should.equal('ferret');
});should work with file attachments
const req = request.post(`${base}/echo`);
req.field('name', 'Tobi');
req.attach('document', 'test/node/fixtures/user.html');
req.field('species', 'ferret');
return req.then((res) => {
res.body.name.should.equal('Tobi');
res.body.species.should.equal('ferret');
const html = res.files.document;
html.name.should.equal('user.html');
html.type.should.equal('text/html');
read(html.path).should.equal('<h1>name</h1>');
});
#attach(name, path)
should attach a file
const req = request.post(`${base}/echo`);
req.attach('one', 'test/node/fixtures/user.html');
req.attach('two', 'test/node/fixtures/user.json');
req.attach('three', 'test/node/fixtures/user.txt');
return req.then((res) => {
const html = res.files.one;
const json = res.files.two;
const text = res.files.three;
html.name.should.equal('user.html');
html.type.should.equal('text/html');
read(html.path).should.equal('<h1>name</h1>');
json.name.should.equal('user.json');
json.type.should.equal('application/json');
read(json.path).should.equal('{"name":"tobi"}');
text.name.should.equal('user.txt');
text.type.should.equal('text/plain');
read(text.path).should.equal('Tobi');
});
when a file does not exist
should fail the request with an error
const req = request.post(`${base}/echo`);
req.attach('name', 'foo');
req.attach('name2', 'bar');
req.attach('name3', 'baz');
req.end((err, res) => {
assert.ok(Boolean(err), 'Request should have failed.');
err.code.should.equal('ENOENT');
err.message.should.containEql('ENOENT');
err.path.should.equal('foo');
done();
});promise should fail
return request
.post(`${base}/echo`)
.field({ a: 1, b: 2 })
.attach('c', 'does-not-exist.txt')
.then(
(res) => assert.fail('It should not allow this'),
(err) => {
err.code.should.equal('ENOENT');
err.path.should.equal('does-not-exist.txt');
}
);should report ECONNREFUSED via the callback
request
.post('http://127.0.0.1:1') // nobody is listening there
.attach('name', 'file-does-not-exist')
.end((err, res) => {
assert.ok(Boolean(err), 'Request should have failed');
err.code.should.equal('ECONNREFUSED');
done();
});should report ECONNREFUSED via Promise
return request
.post('http://127.0.0.1:1') // nobody is listening there
.attach('name', 'file-does-not-exist')
.then(
(res) => assert.fail('Request should have failed'),
(err) => err.code.should.equal('ECONNREFUSED')
);
#attach(name, path, filename)
should use the custom filename
request
.post(`${base}/echo`)
.attach('document', 'test/node/fixtures/user.html', 'doc.html')
.then((res) => {
const html = res.files.document;
html.name.should.equal('doc.html');
html.type.should.equal('text/html');
read(html.path).should.equal('<h1>name</h1>');
})should fire progress event
let loaded = 0;
let total = 0;
let uploadEventWasFired = false;
request
.post(`${base}/echo`)
.attach('document', 'test/node/fixtures/user.html')
.on('progress', (event) => {
total = event.total;
loaded = event.loaded;
if (event.direction === 'upload') {
uploadEventWasFired = true;
}
})
.end((err, res) => {
if (err) return done(err);
const html = res.files.document;
html.name.should.equal('user.html');
html.type.should.equal('text/html');
read(html.path).should.equal('<h1>name</h1>');
total.should.equal(223);
loaded.should.equal(223);
uploadEventWasFired.should.equal(true);
done();
});filesystem errors should be caught
request
.post(`${base}/echo`)
.attach('filedata', 'test/node/fixtures/non-existent-file.ext')
.end((err, res) => {
assert.ok(Boolean(err), 'Request should have failed.');
err.code.should.equal('ENOENT');
err.path.should.equal('test/node/fixtures/non-existent-file.ext');
done();
});
#field(name, val)
should set a multipart field value
request
.post(`${base}/echo`)
.field('first-name', 'foo')
.field('last-name', 'bar')
.end((err, res) => {
if (err) done(err);
res.should.be.ok();
res.body['first-name'].should.equal('foo');
res.body['last-name'].should.equal('bar');
done();
});
#field(object)
should set multiple multipart fields
request
.post(`${base}/echo`)
.field({ 'first-name': 'foo', 'last-name': 'bar' })
.end((err, res) => {
if (err) done(err);
res.should.be.ok();
res.body['first-name'].should.equal('foo');
res.body['last-name'].should.equal('bar');
done();
});
with network error
should error
request.get(`http://localhost:${this.port}/`).end((err, res) => {
assert(err, 'expected an error');
done();
});
request
not modified
should start with 200
request.get(`${base}/if-mod`).end((err, res) => {
res.should.have.status(200);
res.text.should.match(/^\d+$/);
ts = Number(res.text);
done();
});should then be 304
request
.get(`${base}/if-mod`)
.set('If-Modified-Since', new Date(ts).toUTCString())
.end((err, res) => {
res.should.have.status(304);
// res.text.should.be.empty
done();
});
req.parse(fn)
should take precedence over default parsers
request
.get(`${base}/manny`)
.parse(request.parse['application/json'])
.end((err, res) => {
assert(res.ok);
assert.equal('{"name":"manny"}', res.text);
assert.equal('manny', res.body.name);
done();
});should be the only parser
request
.get(`${base}/image`)
.buffer(false)
.parse((res, fn) => {
res.on('data', () => {});
})
.then((res) => {
assert(res.ok);
assert.strictEqual(res.text, undefined);
res.body.should.eql({});
})should emit error if parser throws
request
.get(`${base}/manny`)
.parse(() => {
throw new Error('I am broken');
})
.on('error', (err) => {
err.message.should.equal('I am broken');
done();
})
.end();should emit error if parser returns an error
request
.get(`${base}/manny`)
.parse((res, fn) => {
fn(new Error('I am broken'));
})
.on('error', (err) => {
err.message.should.equal('I am broken');
done();
})
.end();should not emit error on chunked json
request.get(`${base}/chunked-json`).end((err) => {
assert.ifError(err);
done();
});should not emit error on aborted chunked json
const req = request.get(`${base}/chunked-json`);
req.end((err) => {
assert.ifError(err);
done();
});
setTimeout(() => {
req.abort();
}, 50);
pipe on redirect
should follow Location
const stream = fs.createWriteStream(destPath);
const redirects = [];
const req = request
.get(base)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.connect({
inapplicable: 'should be ignored'
});
stream.on('finish', () => {
redirects.should.eql(['/movies', '/movies/all', '/movies/all/0']);
fs.readFileSync(destPath, 'utf8').should.eql('first movie page');
done();
});
req.pipe(stream);
request pipe
should act as a writable stream
const req = request.post(base);
const stream = fs.createReadStream('test/node/fixtures/user.json');
req.type('json');
req.on('response', (res) => {
res.body.should.eql({ name: 'tobi' });
done();
});
stream.pipe(req);end() stops piping
const stream = fs.createWriteStream(destPath);
request.get(base).end((err, res) => {
try {
res.pipe(stream);
return done(new Error('Did not prevent nonsense pipe'));
} catch {
/* expected error */
}
done();
});should act as a readable stream
const stream = fs.createWriteStream(destPath);
let responseCalled = false;
const req = request.get(base);
req.type('json');
req.on('response', (res) => {
res.status.should.eql(200);
responseCalled = true;
});
stream.on('finish', () => {
JSON.parse(fs.readFileSync(destPath, 'utf8')).should.eql({
name: 'tobi'
});
responseCalled.should.be.true();
done();
});
req.pipe(stream);should follow redirects
const stream = fs.createWriteStream(destPath);
let responseCalled = false;
const req = request.get(base + '/redirect');
req.type('json');
req.on('response', (res) => {
res.status.should.eql(200);
responseCalled = true;
});
stream.on('finish', () => {
JSON.parse(fs.readFileSync(destPath, 'utf8')).should.eql({
name: 'tobi'
});
responseCalled.should.be.true();
done();
});
req.pipe(stream);should not throw on bad redirects
const stream = fs.createWriteStream(destPath);
let responseCalled = false;
let errorCalled = false;
const req = request.get(base + '/badRedirectNoLocation');
req.type('json');
req.on('response', (res) => {
responseCalled = true;
});
req.on('error', (err) => {
err.message.should.eql('No location header for redirect');
errorCalled = true;
stream.end();
});
stream.on('finish', () => {
responseCalled.should.be.false();
errorCalled.should.be.true();
done();
});
req.pipe(stream);
req.query(String)
should support passing in a string
request
.del(base)
.query('name=t%F6bi')
.end((err, res) => {
res.body.should.eql({ name: 't%F6bi' });
done();
});should work with url query-string and string for query
request
.del(`${base}/?name=tobi`)
.query('age=2%20')
.end((err, res) => {
res.body.should.eql({ name: 'tobi', age: '2 ' });
done();
});should support compound elements in a string
request
.del(base)
.query('name=t%F6bi&age=2')
.end((err, res) => {
res.body.should.eql({ name: 't%F6bi', age: '2' });
done();
});should work when called multiple times with a string
request
.del(base)
.query('name=t%F6bi')
.query('age=2%F6')
.end((err, res) => {
res.body.should.eql({ name: 't%F6bi', age: '2%F6' });
done();
});should work with normal `query` object and query string
request
.del(base)
.query('name=t%F6bi')
.query({ age: '2' })
.end((err, res) => {
res.body.should.eql({ name: 't%F6bi', age: '2' });
done();
});should not encode raw backticks, but leave encoded ones as is
return Promise.all([
request
.get(`${base}/raw-query`)
.query('name=`t%60bi`&age`=2')
.then((res) => {
res.text.should.eql('name=`t%60bi`&age`=2');
}),
request.get(base + '/raw-query?`age%60`=2%60`').then((res) => {
res.text.should.eql('`age%60`=2%60`');
}),
request
.get(`${base}/raw-query`)
.query('name=`t%60bi`')
.query('age`=2')
.then((res) => {
res.text.should.eql('name=`t%60bi`&age`=2');
})
]);
req.query(Object)
should construct the query-string
request
.del(base)
.query({ name: 'tobi' })
.query({ order: 'asc' })
.query({ limit: ['1', '2'] })
.end((err, res) => {
res.body.should.eql({ name: 'tobi', order: 'asc', limit: ['1', '2'] });
done();
});should encode raw backticks
request
.get(`${base}/raw-query`)
.query({ name: '`tobi`' })
.query({ 'orde%60r': null })
.query({ '`limit`': ['%602`'] })
.end((err, res) => {
res.text.should.eql('name=%60tobi%60&orde%2560r&%60limit%60=%25602%60');
done();
});should not error on dates
const date = new Date(0);
request
.del(base)
.query({ at: date })
.end((err, res) => {
assert.equal(date.toISOString(), res.body.at);
done();
});should work after setting header fields
request
.del(base)
.set('Foo', 'bar')
.set('Bar', 'baz')
.query({ name: 'tobi' })
.query({ order: 'asc' })
.query({ limit: ['1', '2'] })
.end((err, res) => {
res.body.should.eql({ name: 'tobi', order: 'asc', limit: ['1', '2'] });
done();
});should append to the original query-string
request
.del(`${base}/?name=tobi`)
.query({ order: 'asc' })
.end((err, res) => {
res.body.should.eql({ name: 'tobi', order: 'asc' });
done();
});should retain the original query-string
request.del(`${base}/?name=tobi`).end((err, res) => {
res.body.should.eql({ name: 'tobi' });
done();
});should keep only keys with null querystring values
request
.del(`${base}/url`)
.query({ nil: null })
.end((err, res) => {
res.text.should.equal('/url?nil');
done();
});query-string should be sent on pipe
const req = request.put(`${base}/?name=tobi`);
const stream = fs.createReadStream('test/node/fixtures/user.json');
req.on('response', (res) => {
res.body.should.eql({ name: 'tobi' });
done();
});
stream.pipe(req);
request.get
on 301 redirect
should follow Location with a GET request
const req = request.get(`${base}/test-301`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
on 302 redirect
should follow Location with a GET request
const req = request.get(`${base}/test-302`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
on 303 redirect
should follow Location with a GET request
const req = request.get(`${base}/test-303`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
on 307 redirect
should follow Location with a GET request
const req = request.get(`${base}/test-307`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
on 308 redirect
should follow Location with a GET request
const req = request.get(`${base}/test-308`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
request.post
on 301 redirect
should follow Location with a GET request
const req = request.post(`${base}/test-301`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
on 302 redirect
should follow Location with a GET request
const req = request.post(`${base}/test-302`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
on 303 redirect
should follow Location with a GET request
const req = request.post(`${base}/test-303`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('GET');
done();
});
on 307 redirect
should follow Location with a POST request
const req = request.post(`${base}/test-307`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('POST');
done();
});
on 308 redirect
should follow Location with a POST request
const req = request.post(`${base}/test-308`).redirects(1);
req.end((err, res) => {
const headers = req.req.getHeaders
? req.req.getHeaders()
: req.req._headers;
headers.host.should.eql(`localhost:${server2.address().port}`);
res.status.should.eql(200);
res.text.should.eql('POST');
done();
});
request
on redirect
should merge cookies if agent is used
request
.agent()
.get(`${base}/cookie-redirect`)
.set('Cookie', 'orig=1; replaced=not')
.end((err, res) => {
try {
assert.ifError(err);
assert(/orig=1/.test(res.text), 'orig=1/.test');
assert(/replaced=yes/.test(res.text), 'replaced=yes/.test');
assert(/from-redir=1/.test(res.text), 'from-redir=1');
done();
} catch (err_) {
done(err_);
}
});should not merge cookies if agent is not used
request
.get(`${base}/cookie-redirect`)
.set('Cookie', 'orig=1; replaced=not')
.end((err, res) => {
try {
assert.ifError(err);
assert(/orig=1/.test(res.text), '/orig=1');
assert(/replaced=not/.test(res.text), '/replaced=not');
assert(!/replaced=yes/.test(res.text), '!/replaced=yes');
assert(!/from-redir/.test(res.text), '!/from-redir');
done();
} catch (err_) {
done(err_);
}
});should have previously set cookie for subsquent requests when agent is used
const agent = request.agent();
agent.get(`${base}/set-cookie`).end((err) => {
assert.ifError(err);
agent
.get(`${base}/show-cookies`)
.set({ Cookie: 'orig=1' })
.end((err, res) => {
try {
assert.ifError(err);
assert(/orig=1/.test(res.text), 'orig=1/.test');
assert(/persist=123/.test(res.text), 'persist=123');
done();
} catch (err_) {
done(err_);
}
});
});should follow Location
const redirects = [];
request
.get(base)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.end((err, res) => {
try {
const arr = ['/movies', '/movies/all', '/movies/all/0'];
redirects.should.eql(arr);
res.text.should.equal('first movie page');
done();
} catch (err_) {
done(err_);
}
});should follow Location with IP override
const redirects = [];
const url = URL.parse(base);
return request
.get(`http://redir.example.com:${url.port || '80'}${url.pathname}`)
.connect({
'*': url.hostname
})
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.then((res) => {
const arr = ['/movies', '/movies/all', '/movies/all/0'];
redirects.should.eql(arr);
res.text.should.equal('first movie page');
});should follow Location with IP:port override
const redirects = [];
const url = URL.parse(base);
return request
.get(`http://redir.example.com:9999${url.pathname}`)
.connect({
'*': { host: url.hostname, port: url.port || 80 }
})
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.then((res) => {
const arr = ['/movies', '/movies/all', '/movies/all/0'];
redirects.should.eql(arr);
res.text.should.equal('first movie page');
});should not follow on HEAD by default
const redirects = [];
return request
.head(base)
.ok(() => true)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.then((res) => {
redirects.should.eql([]);
res.status.should.equal(302);
});should follow on HEAD when redirects are set
const redirects = [];
request
.head(base)
.redirects(10)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.end((err, res) => {
try {
const arr = [];
arr.push('/movies');
arr.push('/movies/all');
arr.push('/movies/all/0');
redirects.should.eql(arr);
assert(!res.text);
done();
} catch (err_) {
done(err_);
}
});should remove Content-* fields
request
.post(`${base}/header`)
.type('txt')
.set('X-Foo', 'bar')
.set('X-Bar', 'baz')
.send('hey')
.end((err, res) => {
try {
assert(res.body);
res.body.should.have.property('x-foo', 'bar');
res.body.should.have.property('x-bar', 'baz');
res.body.should.not.have.property('content-type');
res.body.should.not.have.property('content-length');
res.body.should.not.have.property('transfer-encoding');
done();
} catch (err_) {
done(err_);
}
});should retain cookies
request
.get(`${base}/header`)
.set('Cookie', 'foo=bar;')
.end((err, res) => {
try {
assert(res.body);
res.body.should.have.property('cookie', 'foo=bar;');
done();
} catch (err_) {
done(err_);
}
});should not resend query parameters
const redirects = [];
const query = [];
request
.get(`${base}/?foo=bar`)
.on('redirect', (res) => {
query.push(res.headers.query);
redirects.push(res.headers.location);
})
.end((err, res) => {
try {
const arr = [];
arr.push('/movies');
arr.push('/movies/all');
arr.push('/movies/all/0');
redirects.should.eql(arr);
res.text.should.equal('first movie page');
query.should.eql(['{"foo":"bar"}', '{}', '{}']);
res.headers.query.should.eql('{}');
done();
} catch (err_) {
done(err_);
}
});should handle no location header
request.get(`${base}/bad-redirect`).end((err, res) => {
try {
err.message.should.equal('No location header for redirect');
done();
} catch (err_) {
done(err_);
}
});
when relative
should redirect to a sibling path
const redirects = [];
request
.get(`${base}/relative`)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.end((err, res) => {
try {
redirects.should.eql(['tobi']);
res.text.should.equal('tobi');
done();
} catch (err_) {
done(err_);
}
});should redirect to a parent path
const redirects = [];
request
.get(`${base}/relative/sub`)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.end((err, res) => {
try {
redirects.should.eql(['../tobi']);
res.text.should.equal('tobi');
done();
} catch (err_) {
done(err_);
}
});
req.redirects(n)
should alter the default number of redirects to follow
const redirects = [];
request
.get(base)
.redirects(2)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.end((err, res) => {
try {
const arr = [];
assert(res.redirect, 'res.redirect');
arr.push('/movies');
arr.push('/movies/all');
redirects.should.eql(arr);
res.text.should.match(/Moved Temporarily|Found/);
done();
} catch (err_) {
done(err_);
}
});
on POST
should redirect as GET
const redirects = [];
return request
.post(`${base}/movie`)
.send({ name: 'Tobi' })
.redirects(2)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.then((res) => {
redirects.should.eql(['/movies/all/0']);
res.text.should.equal('first movie page');
});using multipart/form-data should redirect as GET
const redirects = [];
request
.post(`${base}/movie`)
.type('form')
.field('name', 'Tobi')
.redirects(2)
.on('redirect', (res) => {
redirects.push(res.headers.location);
})
.then((res) => {
redirects.should.eql(['/movies/all/0']);
res.text.should.equal('first movie page');
});
response
should act as a readable stream
const req = request.get(base).buffer(false);
req.end((err, res) => {
if (err) return done(err);
let trackEndEvent = 0;
let trackCloseEvent = 0;
res.on('end', () => {
trackEndEvent++;
trackEndEvent.should.equal(1);
if (!process.env.HTTP2_TEST) {
trackCloseEvent.should.equal(0); // close should not have been called
}
done();
});
res.on('close', () => {
trackCloseEvent++;
});
(() => {
res.pause();
}).should.not.throw();
(() => {
res.resume();
}).should.not.throw();
(() => {
res.destroy();
}).should.not.throw();
});
req.serialize(fn)
should take precedence over default parsers
request
.post(`${base}/echo`)
.send({ foo: 123 })
.serialize((data) => '{"bar":456}')
.end((err, res) => {
assert.ifError(err);
assert.equal('{"bar":456}', res.text);
assert.equal(456, res.body.bar);
done();
});
request.get().set()
should set host header after get()
app.get('/', (req, res) => {
assert.equal(req.hostname, 'example.com');
res.end();
});
server = http.createServer(app);
server.listen(0, function listening() {
request
.get(`http://localhost:${server.address().port}`)
.set('host', 'example.com')
.then(() => {
return request
.get(`http://example.com:${server.address().port}`)
.connect({
'example.com': 'localhost',
'*': 'fail'
});
})
.then(() => done(), done);
});
res.toError()
should return an Error
request.get(base).end((err, res) => {
var err = res.toError();
assert.equal(err.status, 400);
assert.equal(err.method, 'GET');
assert.equal(err.path, '/');
assert.equal(err.message, 'cannot GET / (400)');
assert.equal(err.text, 'invalid json');
done();
});
[unix-sockets] http
request
path: / (root)
request.get(`${base}/`).end((err, res) => {
assert(res.ok);
assert.strictEqual('root ok!', res.text);
done();
});path: /request/path
request.get(`${base}/request/path`).end((err, res) => {
assert(res.ok);
assert.strictEqual('request path ok!', res.text);
done();
});
[unix-sockets] https
request
path: / (root)
request
.get(`${base}/`)
.ca(cacert)
.end((err, res) => {
assert.ifError(err);
assert(res.ok);
assert.strictEqual('root ok!', res.text);
done();
});path: /request/path
request
.get(`${base}/request/path`)
.ca(cacert)
.end((err, res) => {
assert.ifError(err);
assert(res.ok);
assert.strictEqual('request path ok!', res.text);
done();
});
req.get()
should not set a default user-agent
request.get(`${base}/ua`).then((res) => {
assert(res.headers);
assert(!res.headers['user-agent']);
})
utils.type(str)
should return the mime type
utils
.type('application/json; charset=utf-8')
.should.equal('application/json');
utils.type('application/json').should.equal('application/json');
utils.params(str)
should return the field parameters
const obj = utils.params('application/json; charset=utf-8; foo = bar');
obj.charset.should.equal('utf-8');
obj.foo.should.equal('bar');
utils.params('application/json').should.eql({});
utils.parseLinks(str)
should parse links
const str =
'<https://api.github.com/repos/visionmedia/mocha/issues?page=2>; rel="next", <https://api.github.com/repos/visionmedia/mocha/issues?page=5>; rel="last"';
const ret = utils.parseLinks(str);
ret.next.should.equal(
'https://api.github.com/repos/visionmedia/mocha/issues?page=2'
);
ret.last.should.equal(
'https://api.github.com/repos/visionmedia/mocha/issues?page=5'
);
