browser-deeplink.js

/**
 * browser-deeplink v0.1
 *
 * Author: Hampus Ohlsson, Nov 2014
 * GitHub: http://github.com/hampusohlsson/browser-deeplink
 *
 * MIT License
 */
 
/* global define:true */
/* global module:true */

'use strict';

(function (root, factory) {
    if ( typeof define === 'function' && define.amd ) {
        define('deeplink', factory(root));
    } else if ( typeof exports === 'object' ) {
        module.exports = factory(root);
    } else {
        root.deeplink = factory(root);
    }
})(window || {}, function (root) {
 
    /**
     * Cannot run without DOM or user-agent
     */
    if (!root.document || !root.navigator) {
        return;
    }

    /**
     * Set up scope variables and settings
     */
    var timeout;
    var settings = {};
    var defaults = {
        iOS: {},
        android: {},
        androidDisabled: false,
        fallback: true,
        delay: 1000,
        delta: 500
    };
    var ua = navigator.userAgent;

    /**
     * Merge defaults with user options
     * @private
     * @param {Object} defaults Default settings
     * @param {Object} options User options
     * @returns {Object} Merged values of defaults and options
     */
    var extend = function(defaults, options) {
        var extended = {}, key = null;
        for(key in defaults) {
            extended[key] = defaults[key];
        }
        for(key in options) {
            extended[key] = options[key];
        }
        return extended;
    };

    /**
     * Generate the app store link for iOS / Apple app store
     *
     * @private
     * @returns {String} App store itms-apps:// link 
     */
    var getStoreURLiOS = function() {
        var baseurl = 'itms-apps://itunes.apple.com/app/';
        var name = settings.iOS.appName;
        var id = settings.iOS.appId; 
        return (id && name) ? (baseurl + name + '/id' + id + '?mt=8') : null;
    };

    /**
     * Generate the app store link for Google Play
     *
     * @private
     * @returns {String} Play store https:// link
     */
    var getStoreURLAndroid = function() {
        var baseurl = 'market://details?id=';
        var id = settings.android.appId;
        return id ? (baseurl + id) : null;        
    };

    /**
     * Get app store link, depending on the current platform
     *
     * @private
     * @returns {String} url
     */
    var getStoreLink = function() {
        var linkmap = {
            ios: settings.iOS.storeUrl || getStoreURLiOS(),
            android: settings.android.storeUrl || getStoreURLAndroid()
        };

        return linkmap[settings.platform];
    };

    /**
     * Check if the user-agent is Android
     *
     * @private
     * @returns {Boolean} true/false
     */
    var isAndroid = function() {
        return /Android/i.test(ua);
    };

    /**
     * Check if the user-agent is iPad/iPhone/iPod
     *
     * @private
     * @returns {Boolean} true/false
     */
    var isIOS = function() {
        return /iPhone|iPad|iPod/i.test(ua);
    };

    /**
     * Check if the user is on mobile
     *
     * @private
     * @returns {Boolean} true/false
     */
    var isMobile = function() {
        return isAndroid() || isIOS();
    };

    /**
     * Timeout function that tries to open the app store link.
     * The time delta comparision is to prevent the app store
     * link from opening at a later point in time. E.g. if the 
     * user has your app installed, opens it, and then returns 
     * to their browser later on.
     *
     * @private
     * @param {Integer} Timestamp when trying to open deeplink
     * @returns {Function} Function to be executed by setTimeout
     */
    var openAppStore = function(ts) {
        return function() {
            var link = getStoreLink();
            var wait = settings.delay + settings.delta;
            if (typeof link === 'string' && (Date.now() - ts) < wait) {
                window.location.href = link;
            }
        };
    };

    /**
     * The setup() function needs to be run before deeplinking can work,
     * as you have to provide the iOS and/or Android settings for your app.
     *
     * @public
     * @param {object} setup options
     */
    var setup = function(options) {
        settings = extend(defaults, options);

        if (isAndroid()) {
            settings.platform = 'android';
        } else if (isIOS()) {
            settings.platform = 'ios';
        }
    };

    /**
     * Tries to open your app URI through a hidden iframe.
     *
     * @public
     * @param {String} Deeplink URI
     * @return {Boolean} true, if you're on a mobile device and the link was opened
     */
    var open = function(uri) {
        if (!isMobile()) {
            return false;
        }

        if (isAndroid() && settings.androidDisabled) {
            return false;
        }

        if (settings.fallback) {
            timeout = setTimeout(openAppStore(Date.now()), settings.delay);
        }

        if (isIOS() && (ua.match(/CriOS/) || (ua.match(/Safari/) && ua.match(/Version\/9/)))) {
            document.location = uri;
            return true;
        }

        if (isAndroid() && !ua.match(/Firefox/)) {
            var matches = uri.match(/([^:]+):\/\/(.*)$/i);  // schema://*
            uri = 'intent://' + matches[2] + '#Intent;scheme=' + matches[1];
            uri += ';package=' + settings.android.appId + ';end';
        }
        
        var iframe = document.createElement('iframe');
        iframe.onload = function() {
            clearTimeout(timeout);
            iframe.parentNode.removeChild(iframe);
            window.location.href = uri;
        };

        iframe.src = uri;
        iframe.setAttribute('style', 'display:none;');
        document.body.appendChild(iframe);
        
        return true;
    };

    // Public API
    return {
        setup: setup,
        open: open,
        getStoreLink: getStoreLink
    };
});