objects

This block provides an object with a set of methods for working with JavaScript objects.

Overview

Properties and methods of the object

Public block technologies

The block is implemented in:

• vanilla.js

Description

Properties and methods of the object

extend method

Extends an object with the properties of another object. It only copies its own properties that weren't taken from the prototype chain.

Accepted arguments:

• target {Object} – Target object. Required argument.
• source {Object} – The object whose properties are added to the target object. Multiple objects can be passed. The properties of each of them will be added to the target object. Required argument.

Return value: Event. The target object with the added properties.

Example:

modules.require(['objects'], function(objects) {

var obj1 = { a : 1, b : 2 },
    obj2 = { b : 3, c : 4 };

console.log(objects.extend(obj1, obj2)); // { a : 1, b : 3, c : 4 }
});

isEmpty method

Determines whether the passed object is empty. In other words, whether the object has its own properties.

Accepted arguments:

• obj {Object} – The object to check. Required argument.

Return value: Boolean. If the object doesn't have its own properties, true.

Example:

modules.require(['objects'], function(objects) {

var obj1 = {},
    obj2 = { foo : 'bar' };

console.log(objects.isEmpty(obj1)); // true
console.log(objects.isEmpty(obj2)); // false
});

each method

Used for iterating through an object's properties. The handler function is invoked for each of the object's own properties.

Accepted arguments:

• obj {Object} – The object whose properties are being traversed. Required argument.
• fn {Function} – The handler function to call for each property. Required argument.
• [ctx {Object}] – The handler context.

No return value.

The handler function receives arguments with the value and key of the object property that it was invoked for.

Example:

modules.require(['objects'], function(objects) {
    objects.each(
        { a : 1, b : 2 },
        function(val, key) {
            console.log(key, val);
        });
    // a 1
    // b 2
});