Programming Social Applications

Working with Bunch Objects

ADsafe uses a wrapper object on top of DOM nodes called a bunch object. Bunch objects allow the user to easily capture one or multiple DOM nodes under a single bunch and then manipulate all or some of it as needed.

Bunch objects are the cornerstone of all data fetching and manipulation that you will do through ADsafe. They increase code modularity, reduce code bloat, and improve overall application performance.

Within the bunch node wrapper are a series of methods that allow you to capture information about the nodes in the bunch, change and manipulate their attributes and values, and perform actions like cloning the nodes or stripping them from the bunch.

Bunch GET methods

Fetching data about the nodes that are contained within a bunch is the most-often used functionality for bunch objects, and ADsafe makes a series of GET methods available for developers to do this. Depending on the number of nodes contained within the bunch, the return values and structures from the GET method calls will differ, as outlined here:

• If a bunch contains no nodes, then the methods return undefined.

• If a bunch contains one node, a single value is returned (usually as a string).

• If a bunch contains more than one node, an array of values is returned.

There are a number of GET helper methods, described in Table 8-9, available for obtaining information about the bunch nodes returned from a query request.

Table 8-9. Bunch GET methods

Selector	Description
getCheck()	Obtains the checked value ...