A collection of Hash methods.

Tutorial/Demo

See Also

Returns a value of an object by its path.

Syntax

myHash.getFromPath(path);

Arguments

  1. path - (string) the path to the key for the value you wish to retrieve

Returns

  • (null or mixed) if the path has no value, null is returned; otherwise the value that corresponds to the path is returned.

Example

#H({
    food: {
        fruits: {
            apples: "red",
            lemon: "yellow"
        }
    }
}).getFromPath("food.fruits.apples");
//returns "red"

Removes values from the Hash.

Syntax

myHash.cleanValues(method);

Arguments

  1. method - (function) The function that each value in the Hash is passed. If it returns true the value is kept. Defaults to $defined.

Returns

  • (Hash) - This Hash.

Example

$H({
    foo: 'bar',
    something: 'else',
    missing: null
}).cleanValues();

//remove all values < 0
$H({
    a: -1,
    b: 2,
    c: 0,
    d: -5
}).cleanValues(function(value){
    if ($type(value) != "number") return true;
    return value > 0;
});

Runs all the methods that are values of the hash.

Syntax

myHash.run()

Example

var myPage = {
    init: new Hash({
        setupNav: function(){
            //set up the nav
        },
        setupSearch: function(){
            //set up the search
        }
    })
};
window.addEvent('domready', myPage.init.run.bind(myPage.init));