jsdoc-75lb/lib/jsdoc/util/doop.js

An API documentation generator for JavaScript.

/* global Set */

/**
    Deep clone a simple object. Ignores non-enumerable properties.
    @private
 */
'use strict';

var setDefined = typeof Set !== 'undefined';

function addItem(set, item) {
    if (setDefined) {
        set.add(item);
    }
    else if (set.indexOf(item) === -1) {
        set.push(item);
    }
}

function hasItem(set, item) {
    if (setDefined) {
        return set.has(item);
    }
    else {
        return set.indexOf(item) !== -1;
    }
}

// TODO: can we remove the circular-ref checking? pretty sure it's not needed anymore...
// if we need this here for some reason I'm forgetting, we should share code with jsdoc/util/dumper
function doop(o, seen) {
    var clone;
    var descriptor;
    var props;
    var i;
    var l;

    if (!seen) {
        seen = setDefined ? new Set() : [];
    }

    if (o instanceof Object && o.constructor !== Function) {
        if ( hasItem(seen, o) ) {
            clone = '<CircularRef>';
        }
        else {
            addItem(seen, o);

            if ( Array.isArray(o) ) {
                clone = [];
                for (i = 0, l = o.length; i < l; i++) {
                    clone[i] = (o[i] instanceof Object) ? doop(o[i], seen) : o[i];
                }
            }
            else {
                clone = Object.create( Object.getPrototypeOf(o) );
                props = Object.keys(o);
                for (i = 0, l = props.length; i < l; i++) {
                    descriptor = Object.getOwnPropertyDescriptor(o, props[i]);
                    if (descriptor.value) {
                        descriptor.value = doop(descriptor.value, seen);
                    }

                    Object.defineProperty(clone, props[i], descriptor);
                }
            }
        }

        return clone;
    }

    return o;
}

// Wrapper to avoid exposing the 'seen' parameter outside of this module.
function doopWrapper(o) {
    return doop(o);
}

// for backwards compatibility
doopWrapper.doop = doopWrapper;

module.exports = doopWrapper;