feat(ngRoute): add method for changing url params

src/ngRoute/route.js

@@ -436,6 +436,21 @@ function $RouteProvider(){
           reload: function() {
             forceReload = true;
             $rootScope.$evalAsync(updateRoute);
+          },
+
+          /**
+           * @ngdoc method
+           * @name $route#update
+           *
+           * @description
+           * Causes `$route` service to update the current URL, replacing
+           * current route parameters with those specified in `newParams`.
+           *
+           * @param {Object} newParams mapping of URL parameter names to values
+           */
+          update: function(newParams) {
+            newParams = defaults(newParams, this.current.params);
+            $location.path(interpolate(this.current.$$route.originalPath, newParams));
           }
         };
 
@@ -589,5 +604,22 @@ function $RouteProvider(){
       });
       return result.join('');
     }
+
+    /**
+     * @returns {Object} object composed of all keys in `object` and `defaults`,
+     *                   where keys missing in `object` have the value from the
+     *                   same key in `defaults`
+     */
+    function defaults(object, other) {
+      var o = angular.copy(object);
+
+      for (var key in other) {
+        if (other.hasOwnProperty(key)) {
+          o[key] = o[key] || other[key];
+        }
+      }
+
+      return o;
+    }
   }];
 }

test/ngRoute/routeSpec.js

@@ -1046,6 +1046,73 @@ describe('$route', function() {
       });
     });
 
+    describe('update', function() {
+      it('should support single-parameter route updating', function() {
+        var routeChangeSpy = jasmine.createSpy('route change');
+
+        module(function($routeProvider) {
+          $routeProvider.when('/bar/:barId', {controller: angular.noop});
+        });
+
+        inject(function($route, $routeParams, $location, $rootScope) {
+          $rootScope.$on('$routeChangeSuccess', routeChangeSpy);
+
+          $location.path('/bar/1');
+          $rootScope.$digest();
+          routeChangeSpy.reset();
+
+          $route.update({barId: '2'});
+          $rootScope.$digest();
+
+          expect($routeParams).toEqual({barId: '2'});
+          expect(routeChangeSpy).toHaveBeenCalledOnce();
+        });
+      });
+
+      it('should support total multi-parameter route updating', function() {
+        var routeChangeSpy = jasmine.createSpy('route change');
+
+        module(function($routeProvider) {
+          $routeProvider.when('/bar/:barId/:fooId/:spamId/:eggId', {controller: angular.noop});
+        });
+
+        inject(function($route, $routeParams, $location, $rootScope) {
+          $rootScope.$on('$routeChangeSuccess', routeChangeSpy);
+
+          $location.path('/bar/1/1/1/1');
+          $rootScope.$digest();
+          routeChangeSpy.reset();
+
+          $route.update({barId: '2', fooId: '2', spamId: '2', eggId: '2'});
+          $rootScope.$digest();
+
+          expect($routeParams).toEqual({barId: '2', fooId: '2', spamId: '2', eggId: '2'});
+          expect(routeChangeSpy).toHaveBeenCalledOnce();
+        });
+      });
+
+      it('should support partial multi-parameter route updating', function() {
+        var routeChangeSpy = jasmine.createSpy('route change');
+
+        module(function($routeProvider) {
+          $routeProvider.when('/bar/:barId/:fooId/:spamId/:eggId', {controller: angular.noop});
+        });
+
+        inject(function($route, $routeParams, $location, $rootScope) {
+          $rootScope.$on('$routeChangeSuccess', routeChangeSpy);
+
+          $location.path('/bar/1/1/1/1');
+          $rootScope.$digest();
+          routeChangeSpy.reset();
+
+          $route.update({barId: '2', fooId: '2'});
+          $rootScope.$digest();
+
+          expect($routeParams).toEqual({barId: '2', fooId: '2', spamId: '1', eggId: '1'});
+          expect(routeChangeSpy).toHaveBeenCalledOnce();
+        });
+      });
+    });
 
     describe('reload', function() {