handbid

Handbid-Js

I am the Handbid library. I work in both nodejs && in the browser. I rely on chai for my tests. To be honest, I've never run any unit tests in the browser, someone should figure out how to do that. =)

Lifecycle

Connecting to an auction in Handbid is a multi-step process. It's pretty simple though, here is a breakdown:

1. Instantiate new Handbid instance: var hb = new Handbid()
2. Connect to the main server by invoking: hb.connect();
3. Connect to any auction by key by invoking: hb.connectToAuction('any-auction-key');
4. Listen for auction connection: hb.on('did-connect-to-auction', function (e) { console.log(e.get('auction')); });

You can invoke connectToAuction() immediately after connect() (you don't have to wait for the main connection to be established).

Examples

Here are some code samples to get you started!

Nodejs

$npm install handbid

 
var Handbid = require('handbid'),
    hb      = new Handbid();
 
hb.connect();
hb.connectToAuction('auction key');
 
//from this point it's exactly the same as the browser examples.
 

Browser

 
<script type='text/javascript' src='https://handbid-js-handbid.netdna-ssl.com/handbid.js'></script>
 
<script type="text/javascript">
 
    /**
     * From the browser, a few operations are automatically performed for you. They are as follows:
     *
     * window.handbid = new Handbid();
     * window.handbid.connect();
     *
     * So, automatically, you will be connected to the main Handbid server. But, you will not be able to listen in on any
     * fancy update events. For
     */
    handbid.connectToAuction('handbid-demo-auction');
    handbid.on('did-connect-to-auction', function (e) {
 
        var auction = e.get('auction');
 
        auction.on('did-update-item', function (e) {
 
            var itemKey = e.get('key'),
                changes = e.get('changes');
 
            console.log('the following was changed:', changes, 'on item with key:', itemKey);
 
        });
 
        auction.on('did-update', function (e) {
 
            console.log(e);
 
        });
 
    });
 
 
</script> 
 

Authentication

Events

Under each event name is a description of the data passed with the event. This event is the single object passed to a listener of any event.

 
hb.on('did-connect-to-server', function (e) {
 
    console.log(e.data); //will output everything in the event
    console.log(e.get('url')); //use this rather than e.data.url because get() allows for a default value
 
    if(e.get('anything', false)) {
 
 
    }
 
});
 

Handbid

• did-connect-to-server: when a server connection is made after invoking hb.connect()
  • handbid: instance that dispatched the event
  • url: the url we connected to
• did-connect-to-auction: dispatched after hb.connectToAuction('auction-key')
  • handbid: instance that dispatched the event
  • auction: the auction we connected to
• did-receive-message: whenever the current user gets a message
  • message: text of message that was sent
• error: anytime any error occurs

Handbid API

• `

Connect Button

Throwing in a connect button is wicked easy!

 
<a href="#" data-handbid-connect data-handbid-pass="http://mywebsite.com/where/on/success" data-handbid-fail="http://mywebsite.com/where/on/fail">
    <img src="assets/btn-hb-blue-big.png" />
</a>