Merge pull request #2 from remix/marco/add_match_functionality

Add match functionality

Author: msecret

ampersand-history.js

@@ -1,6 +1,7 @@
 var Events = require('ampersand-events');
 var extend = require('lodash/assign');
 var bind = require('lodash/bind');
+var compact = require('lodash/compact');
 
 
 // Handles cross-browser history management, based on either
@@ -232,6 +233,15 @@ extend(History.prototype, Events, {
         if (options.trigger) return this.loadUrl(fragment);
     },
 
+    match(fragment) {
+      const handler = this.handlers.find(function (handler) {
+          if (handler.route.test(fragment)) {
+              return true;
+          }
+      });
+      return compact(handler.route.exec(fragment));
+    },
+
     // Update the hash location, either replacing the current entry, or adding
     // a new one to the browser history.
     _updateHash: function (location, fragment, replace) {

ampersand-router.js

@@ -69,6 +69,12 @@ extend(Router.prototype, Events, {
         return this;
     },
 
+    // Match a URL fragment with the routes, returning an array of results
+    // for the route. Return will include all the variables in the route.
+    match: function(fragment) {
+      return this.history.match(fragment);
+    },
+
     // Reload the current route as if it was navigated to from somewhere
     // else
     reload: function () {