Browser Request: The easiest HTTP library you'll ever see
Browser Request is a port of Mikeal Rogers's ubiquitous and excellent [request][req] package to the browser.
Jealous of Node.js? Pining for clever callbacks? Request is for you.
Don't care about Node.js? Looking for less tedium and a no-nonsense API? Request is for you too.
Examples
Fetch a resource:
Send a resource:
request
To work with JSON, set options.json
to true
. Request will set the Content-Type
and Accept
headers, and handle parsing and serialization.
{ ifer throw er ifresultok console}
Or, use this shorthand version (pass data into the json
option directly):
Convenient CouchDB
Browser Request provides a CouchDB wrapper. It is the same as the JSON wrapper, however it will indicate an error if the HTTP query was fine, but there was a problem at the database level. The most common example is 409 Conflict
.
request
See the [Node.js Request README][req] for several more examples. Request intends to maintain feature parity with Node request (except what the browser disallows). If you find a discrepancy, please submit a bug report. Thanks!
Usage
Browserify
Browser Request is a [browserify][browserify]-enabled package.
First, add browser-request
to your Node project
$ npm install browser-request
Next, make a module that uses the package.
// example.js - Example front-end (client-side) code using browser-request via browserify//var request =
To build this for the browser, run it through browserify.
$ browserify --entry example.js --outfile example-built.js
Deploy example-built.js
to your web site and use it from your page.
<!-- Runs the request, outputs the result to the console -->
License
Browser Request is licensed under the Apache 2.0 license.