Adds test updates to #1874

src/pjax/js/pjax-base.js

@@ -135,6 +135,13 @@ PjaxBase.prototype = {
 
         if (!this._hasSameOrigin(url)) {
             Y.error('Security error: The new URL must be of the same origin as the current URL.');
+            return false;
+        }
+
+        if (this.get('allowFallThrough')) {
+            // Send paths with the same origin but no matching routes to window.location if specified.
+            win.location = url;
+            return true;
         }
 
         return false;
@@ -413,7 +420,20 @@ PjaxBase.ATTRS = {
     **/
     scrollToTop: {
         value: true
+    },
+
+    /**
+    Whether to set `window.location` when calling `navigate()`
+    if no routes match the specified URL.
+
+    @attribute allowFallThrough
+    @type Boolean
+    @default true
+    @since @SINCE@
+    **/
+    allowFallThrough: {
+        value: true
     }
 };
 
-Y.PjaxBase = PjaxBase;
+Y.PjaxBase = PjaxBase;

src/pjax/tests/unit/assets/pjax-test.js

@@ -215,7 +215,7 @@ suite.add(new Y.Test.Case({
             '`navigate` event should not fire when a modifier key is pressed': !html5,
             '`navigate` event should not fire when a click element is not an anchor': !html5,
             '`navigate` event should not fire when a link is clicked with a URL from another origin': !html5,
-            '`navigate` event should not fire for a hash URL that resolves to the current page': !html5,
+            '`navigate` event should not fire for a hash URL that resolves to the current page when allowFallThrough is set to `false`': !html5,
             '`navigate` event should fire for a hash-less URL that resolves to the current page': !html5,
             '`navigate` event should fire for a hash URL that resolves to the current page when `navigateOnHash` is `true`': !html5
         }
@@ -427,7 +427,8 @@ suite.add(new Y.Test.Case({
         });
     },
 
-    '`navigate` event should not fire for a hash URL that resolves to the current page': function () {
+    '`navigate` event should not fire for a hash URL that resolves to the current page when allowFallThrough is set to `false`': function () {
+        this.pjax.set("allowFallThrough", false); 
         this.pjax.on('navigate', function (e) {
             Assert.fail();
         });
@@ -569,6 +570,13 @@ suite.add(new Y.Test.Case({
 
         didNavigate = this.pjax.navigate('http://some.random.host.example.com/foo/bar/');
         Assert.areSame(false, didNavigate, '`navigate()` did not return `false`');
+    },
+
+    '`navigate()` should fall through to window.location with no matching route': function() {
+        var currentLocation = win.location;
+
+        Assert.isTrue(this.pjax.navigate('#unmatched-route'), 'navigate() did not return `true`');
+        Assert.areEqual(currentLocation, win.location, 'The current `window.location` does not match the `window.location` before `navigate()`.');
     }
 }));
 

src/pjax/tests/unit/pjax.html

@@ -12,6 +12,7 @@
     <a href="assets/page-full.html" id="link-full" class="yui3-pjax">full page</a>
     <a href="assets/page-minimal.html" id="link-minimal" class="yui3-pjax">minimal page</a>
     <a href="assets/page-text.html" id="link-text" class="yui3-pjax">text page</a>
+    <a href="assets/missing/pagedoesnotexist.html" id="unmatched-route" class="yui-pjax">missing page</a>
     <a href="#log" id="link-in-page" class="yui3-pjax">in-page</a>
     <a href="" id="link-current" class="yui3-pjax">current page</a>
     <span id="link-fake" class="yui3-pjax">fake</span>