jQuery.Deferred(): If an array contains promises, replace them with the real value once resolved

gistfile1.js

// Usage: 
// resolvePromisesInArray(values_with_promises).then(function(values_resolved) 
// { console.log(values_resolved); });

function resolvePromisesInArray(values)
{
    var deferred, deferred_values;
    
    if (! $.isArray(values))
    {
        return values;
    }
    
    // Check which of the values are promises to return the real value later
    
    deferred_values = [ ];
        
    $.each(values, function(i, value)
    {
        var deferred_value;
        
        if ($.type(value) !== 'object')
        {
            return;
        }
        
        if (! $.isFunction(value.promise))
        {
            return;
        }
        
        deferred_value = $.Deferred();
        
        deferred_values.push(deferred_value);
        
        // When a promise is fulfilled, replace it with the real value
        
        value.then(function(real_value)
        {
            values[ i ] = real_value;
            deferred_value.resolve();
        });
    });

    // Return a promise: Will provide the values array once all real values have arrived

    deferred = $.Deferred();
        
    $.when.apply($, deferred_values).done(function()
    {
        deferred.resolve(values);
    });

    return deferred.promise();
}