Zero-dependency, pure JavaScript, promise enabled, cancelable XMLHttpRequest (i.e. Ajax)
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
node 7.x
Clone this repository:
$ git clone https://github.com/mvilrokx/request.git
(or download the zip file and unzip)
Install all the devDependencies (remember, there are no runtime dependencies!). First cd
into the project root folder and from there run:
$ npm install
Finally, you can (re)build the library locally, recreate the documentation and run all the tests by issueing the following command:
$ npm run prod
$ npm run test
If you want to (re)develop parts of the library yourself, you can easily re-build as you develop by using:
$ npm run watch
This will watch for changes and re-build the library as you code away
The API Documentation can be found in the docs
directory, published here.
If you want to (re)write parts of the API's documentation yourself, you can easily re-build by using:
$ npm run doc
This will re-build the API documentation (in the docs
directory).
For usage in your projects, just install the npm module in your project and require it in your code:
$ npm install mvilrokx/request --save
Then in your code, e.g. index.js
import request from 'request'
// Use Generic Scraper API to get the Twitter name from my twitter profile page
request('https://htmlscraper.herokuapp.com/api/scrape', {
method: 'POST',
headers: {'content-type': 'application/json'},
body: {
url:'https://www.twitter.com/mvilrokx',
selector: '.ProfileHeaderCard-nameLink.u-textInheritColor.js-nav'
}
}).then((data) => console.log(data)) // {"scraped":"Mark Vilrokx"}
For more information, refer to the docs.
- Babel - The compiler for writing next generation JavaScript
- ESLint - Pluggable JavaScript linter (with Airbnb Base config)
- Tape - tap-producing test harness for node and browsers (with faucet)
- JSdoc - an API documentation generator for JavaScript
- Webpack - Bundler
- Mark Vilrokx - Initial work - Oracle