https://github.com/matthisk/xmlhttp-request
XMLHttpRequest port of the Node.js 'request' package (compatible with React Native)
https://github.com/matthisk/xmlhttp-request
Last synced: over 1 year ago
JSON representation
XMLHttpRequest port of the Node.js 'request' package (compatible with React Native)
- Host: GitHub
- URL: https://github.com/matthisk/xmlhttp-request
- Owner: matthisk
- License: apache-2.0
- Created: 2016-03-01T13:58:07.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-07-11T11:04:18.000Z (about 9 years ago)
- Last Synced: 2025-03-26T01:41:32.274Z (over 1 year ago)
- Language: JavaScript
- Size: 6.2 MB
- Stars: 5
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Node request implemented with XMLHttpRequest
Note this is a fork of jhs' [browser-request](https://github.com/iriscouch/browser-request) compatible with IE8 and React Native.
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:
```javascript
request('/some/resource.txt', function(er, response, body) {
if(er)
throw er;
console.log("I got: " + body);
})
```
Send a resource:
```javascript
request.put({uri:'/some/resource.xml', body:''}, function(er, response) {
if(er)
throw new Error("XML PUT failed (" + er + "): HTTP status was " + response.status);
console.log("Stored the XML");
})
```
To work with JSON, set `options.json` to `true`. Request will set the `Content-Type` and `Accept` headers, and handle parsing and serialization.
```javascript
request({method:'POST', url:'/db', body:'{"relaxed":true}', json:true}, on_response)
function on_response(er, response, body) {
if(er)
throw er
if(result.ok)
console.log('Server ok, id = ' + result.id)
}
```
Or, use this shorthand version (pass data into the `json` option directly):
```javascript
request({method:'POST', url:'/db', json:{relaxed:true}}, on_response)
```
## 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`.
```javascript
request.couch({method:'PUT', url:'/db/existing_doc', body:{"will_conflict":"you bet!"}}, function(er, resp, result) {
if(er.error === 'conflict')
return console.error("Couch said no: " + er.reason); // Output: Couch said no: Document update conflict.
if(er)
throw er;
console.log("Existing doc stored. This must have been the first run.");
})
```
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.
```javascript
// example.js - Example front-end (client-side) code using browser-request via browserify
//
var request = require('browser-request')
request('/', function(er, res) {
if(!er)
return console.log('browser-request got your root path:\n' + res.body)
console.log('There was an error, but at least browser-request loaded and ran!')
throw er
})
```
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.
```html
```
## License
Browser Request is licensed under the Apache 2.0 license.