Nuptial Predicament Mediation

    This package has been deprecated

    Author message:

    Use ask module instead

    bid

    1.0.0 • Public • Published

    bid

    A simple, chainable way to construct HTTP requests in Node or the browser (Angular or Standalone);

    Usage Environments:

    Install

    Bower

    bower install bid --save
    

    NPM

    npm install bid --save
    

    Usage

    Include in App

    Standalone

    <script src="/bower_components/bid/dist/bid.js"></script>

    Angular

    <script src="/bower_components/bid/dist/bid.angular.js"></script>
    var myApp = angular.module('myApp', ['bid']);
     
    myApp.config(function (bidProvider) {
      
      /* This is optional */
      
      bidProvider.configure({
        origin: 'http://api.example.com',
        headers: {/* optional default headers */},
        xhrOptions: {/* optional xhr options */}
      });
    });
     
    myApp.controller('SomeController', function (bid /* instance of Bid */) {
      
    });
     
    myApp.controller('AnotherController', function (Bid /* ready to instantiate */) {
      
    })

    Nodejs/Browserify

    var bid = require('bid');

    How to Build Requests

    Simple GET request

    var request = bid({
      origin: '', /* default origin */
      headers: {/* set default headers */},
      xhrOptions: {/* default xhr options */
    });
     
    // Settings for all endpoints
    request
      .origin('http://api.example.com')
      .header('Authorzation', 'Bearer 1234')
      .xhrOption('withCredentials', true);
     
    // Create an endpoint and customize with endpoint-specific settings
    // Returns a function to execute later
    var getUserFriends = request
      .get('users', 123, 'friends')
      .query('page', 1)
      .query('limit', 10);
     
    // Request to '/users/123/friends'
    getUserFriends().then(function (res) {
      var users = res.body;
    }, function (err) {
      // err.body
    });

    Simple POST request

    var request = bid();
     
    request.origin('http://api.example.com');
     
    var createUser = request.post('users');
     
    // Send body data with request
    createUser({
      name: 'example',
      email: 'something@aol.com'
    }).then(function (res) {
        // Success!
    });
     

    API

    (Coming soon)

    Mocking HTTP Requests

    A useful feature with Bid is the ability to intercept http/xhr requests and provide custom response attributes, such as statusCode, headers, etc. This is is very helpful when testing code that uses the Bid module.

    Before building a request:

    var bid = require('bid');
    var request = bid();
     
    request
      .when('GET', '/some/path')
      .respond('custom response')
      .status(201)
      .header('content-type', 'text/html');
     
    var somePath = request.get('some', 'path');
     
    somePath().then(function (res) {
        
    });

    Mocking API

    when(method, path)

    Set up the http mocking interceptor. Returns an object mocking helper methods

    • method - GET, POST, PUT, DELETE, etc.
    • path - the relative path to intercept

    respond(body)

    Set the response body text for the mocked request

    • body - the data to set the response to

    status(code)

    Set the status code of the mocked response. Any code that is greater than or equal to 400 will cause the request promise to be rejected.

    • code - a number, 200, 201, etc., that sets the statusCode of the response

    header(name, value)

    Set individual headers for the response. If no value is provided, the current header value is returned.

    • name - the name of the header (case-insensitive)
    • value - the value of the header

    Build

    Builds standalone and Angular version of the module

    npm install
    npm run build
    

    Run Tests

    npm install
    npm test
    

    Install

    npm i bid

    DownloadsWeekly Downloads

    2

    Version

    1.0.0

    License

    MIT

    Last publish

    Collaborators

    • scottcorgan