node-redis/lib/createClient.js

'use strict';

var utils = require('./utils');
var URL = require('url');

module.exports = function createClient (portArg, hostArg, options) {

    if (typeof portArg === 'number' || typeof portArg === 'string' && /^\d+$/.test(portArg)) {

        var host;
        if (typeof hostArg === 'string') {
            host = hostArg;
        } else {
            if (options && hostArg) {
                throw new TypeError('Unknown type of connection in createClient()');
            }
            options = options || hostArg;
        }
        options = utils.clone(options);
        options.host = host || options.host;
        options.port = portArg;

    } else if (typeof portArg === 'string' || portArg && portArg.url) {

        options = utils.clone(portArg.url ? portArg : hostArg || options);

        var parsed = URL.parse(portArg.url || portArg, true, true);

        // [redis:]//[[user][:password]@][host][:port][/db-number][?db=db-number[&password=bar[&option=value]]]
        if (parsed.slashes) { // We require slashes
            if (parsed.auth) {
                options.password = parsed.auth.split(':')[1];
            }
            if (parsed.protocol && parsed.protocol !== 'redis:') {
                console.warn('nodeRedis: WARNING: You passed "' + parsed.protocol.substring(0, parsed.protocol.length - 1) + '" as protocol instead of the "redis" protocol!');
            }
            if (parsed.pathname && parsed.pathname !== '/') {
                options.db = parsed.pathname.substr(1);
            }
            if (parsed.hostname) {
                options.host = parsed.hostname;
            }
            if (parsed.port) {
                options.port = parsed.port;
            }
            if (parsed.search !== '') {
                var elem;
                for (elem in parsed.query) {
                    // If options are passed twice, only the parsed options will be used
                    if (elem in options) {
                        if (options[elem] === parsed.query[elem]) {
                            console.warn('nodeRedis: WARNING: You passed the ' + elem + ' option twice!');
                        } else {
                            throw new RangeError('The ' + elem + ' option is added twice and does not match');
                        }
                    }
                    options[elem] = parsed.query[elem];
                }
            }
        } else if (parsed.hostname) {
            throw new RangeError('The redis url must begin with slashes "//" or contain slashes after the redis protocol');
        } else {
            options.path = portArg;
        }

    } else if (typeof portArg === 'object' || portArg === undefined) {
        options = utils.clone(portArg || options);
        options.host = options.host || hostArg;

        if (portArg && arguments.length !== 1) {
            throw new TypeError('To many arguments passed to createClient. Please only pass the options object');
        }
    }

    if (!options) {
        throw new TypeError('Unknown type of connection in createClient()');
    }

    return options;
};