A promise based Ajax library for Node.js

Ajaxed-promise is promise based ajax library for Node.js with backward compatibility for older browsers. For the browsers that support ES6 Promises , Ajax call will return a promise. For the browsers that lacks Promises, the library will fallback to tradional Ajax calls. For browsers IE9 and below, it'll make suitable calls to get Ajax results.

The best part about this library is that the order of call doesn't change for users. Also it quite small library which is just 4Kb, or less than 2Kb when minimized, and ~860 bytes when minimized and gzipped.

Installation

Install the package by issue the command -

npm install --save ajaxed-promise

Including in code

Include the package by issuing following command

ES6 module syntax -

import ajax from ' ajaxed-promise ' ;

Node.js module syntax -

var ajax = require ( ' ajaxed-promise ' ) ;

Usage

You can now make various AJAX requests as follows

GET

ajax ( url ) . get ( data ) . then ( successCallback , failureCallback ) ;

POST

ajax ( url ) . post ( data ) . then ( successCallback , failureCallback ) ;

PUT

ajax ( url ) . put ( data ) . then ( successCallback , failureCallback ) ;

DELETE

ajax ( url ) . delete ( data ) . then ( successCallback , failureCallback ) ;

JSONP

ajax ( url ) . jsonp ( ) . then ( successCallback , failureCallback ) ;

where various attributes are

` url ` ( String ) - URL from where data is to be retrieved ` data ` ( Object ) - Data to be sent as a part of AJAX request ( details below ) ` successCallback ` ( Function ) - Function that will be called when a data is obtained successfully from Ajax call ` failureCallback ` ( Function ) - Function that will be called when Ajax call fails

Data Param

Sample data for Ajax request is -

{ config : { timeout : 200 , credentials : true , headers : [ ' Access-Control-Allow-Headers ' : ' * ' , ' Content-type ' , ' application/json; charset=UTF-8 ' ] } , payload : { urlParam : false , data : { } } }

Example

ajax ( ' http://api.randomuser.me/ ' ) . get ( { payload : { urlParam : true , data : { results : 1 } } } ) . then ( function ( data ) { console . log ( data ) ; } ) ;

Know issue