Cacher is the code snippet organizer for pro developers

/**
 * Implement a tryCatch() method that logs exceptions for method invocations AND 
 * promise rejection activity.
 *
 * @param notifyFn      Function callback with logging/exception information (typically $log.error )
 * @param scope         Object Receiver for the notifyFn invocation ( optional )
 *
 * @return Function used to guard and invoke the targeted actionFn
 */
function makeTryCatch( notifyFn, scope ) 
{
      /**
       * Report error (with stack trace if possible) to the logger function
       */
  var isObject = function (value)
      {
          return value != null && typeof value == 'object';
      },
      reportError = function (reason)
      {
          if(notifyFn != null)
          {
              var error   = (reason && reason.stack)  ? reason         : null,
                  message = reason != null            ? String(reason) : "";

              if(error != null)
              {
                  message = error.message + "\n" + error.stack;
              }

              notifyFn.apply(scope, [message]);
          }

          return reason;
        },
        /**
         * Publish the tryCatch() guard 'n report function
         */
        tryCatch = function (actionFn, scope, args)
        {
          try
          {
            // Invoke the targeted `actionFn`
            var result  = actionFn.apply(scope, args || []),
                promise = ( isObject(result) && result.then ) ? result : null;

            // Catch and report any promise rejection reason...
            if ( promise ) 
            {
                  promise.then( null, reportError );
            }

            actionFn = null;
            return result;

          }
          catch(e)
          {
            actionFn = null;
            throw reportError(e);
          }

        };

    return tryCatch;
}