@angular/router 12.0.0 → 12.0.4

package/bundles/router-testing.umd.js

@@ -1,5 +1,5 @@
 /**
- * @license Angular v12.0.0
+ * @license Angular v12.0.4
  * (c) 2010-2021 Google LLC. https://angular.io/
  * License: MIT
  */

package/bundles/router-upgrade.umd.js

@@ -1,5 +1,5 @@
 /**
- * @license Angular v12.0.0
+ * @license Angular v12.0.4
  * (c) 2010-2021 Google LLC. https://angular.io/
  * License: MIT
  */

package/bundles/router.umd.js

@@ -1,5 +1,5 @@
 /**
- * @license Angular v12.0.0
+ * @license Angular v12.0.4
  * (c) 2010-2021 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -348,7 +348,7 @@
      * ```
      *
      * @see `Event`
-     * @see [Router events summary](guide/router#router-events)
+     * @see [Router events summary](guide/router-reference#router-events)
      * @publicApi
      */
     var RouterEvent = /** @class */ (function () {
@@ -421,7 +421,7 @@
     }(RouterEvent));
     /**
      * An event triggered when a navigation is canceled, directly or indirectly.
-     * This can happen when a route guard
+     * This can happen for several reasons including when a route guard
      * returns `false` or initiates a redirect by returning a `UrlTree`.
      *
      * @see `NavigationStart`
@@ -1339,12 +1339,14 @@
             .join('');
     }
     function serializeQueryParams(params) {
-        var strParams = Object.keys(params).map(function (name) {
+        var strParams = Object.keys(params)
+            .map(function (name) {
             var value = params[name];
             return Array.isArray(value) ?
                 value.map(function (v) { return encodeUriQuery(name) + "=" + encodeUriQuery(v); }).join('&') :
                 encodeUriQuery(name) + "=" + encodeUriQuery(value);
-        });
+        })
+            .filter(function (s) { return !!s; });
         return strParams.length ? "?" + strParams.join('&') : '';
     }
     var SEGMENT_RE = /^[^\/()?;=#]+/;
@@ -1723,6 +1725,10 @@
      * The following example shows how to construct a component using information from a
      * currently activated route.
      *
+     * Note: the observables in this class only emit when the current and previous values differ based
+     * on shallow equality. For example, changing deeply nested properties in resolved `data` will not
+     * cause the `ActivatedRoute.data` `Observable` to emit a new value.
+     *
      * {@example router/activated-route/module.ts region="activated-route"
      *     header="activated-route.component.ts"}
      *
@@ -3083,7 +3089,8 @@
             }));
             return urlTrees$.pipe(operators.catchError(function (e) {
                 if (e instanceof AbsoluteRedirect) {
-                    // after an absolute redirect we do not apply any more redirects!
+                    // After an absolute redirect we do not apply any more redirects!
+                    // If this implementation changes, update the documentation note in `redirectTo`.
                     _this.allowRedirects = false;
                     // we need to run matching, so we can fetch all lazy-loaded modules
                     return _this.match(e.urlTree);
@@ -4208,7 +4215,12 @@
      */
     /**
      * The [DI token](guide/glossary/#di-token) for a router configuration.
-     * @see `ROUTES`
+     *
+     * `ROUTES` is a low level API for router configuration via dependency injection.
+     *
+     * We recommend that in almost all cases to use higher level APIs such as `RouterModule.forRoot()`,
+     * `RouterModule.forChild()`, `provideRoutes`, or `Router.resetConfig()`.
+     *
      * @publicApi
      */
     var ROUTES = new core.InjectionToken('ROUTES');
@@ -4492,8 +4504,16 @@
             this.routeReuseStrategy = new DefaultRouteReuseStrategy();
             /**
              * How to handle a navigation request to the current URL. One of:
+             *
              * - `'ignore'` :  The router ignores the request.
              * - `'reload'` : The router reloads the URL. Use to implement a "refresh" feature.
+             *
+             * Note that this only configures whether the Route reprocesses the URL and triggers related
+             * action and events like redirects, guards, and resolvers. By default, the router re-uses a
+             * component instance when it re-navigates to the same component type without visiting a different
+             * component first. This behavior is configured by the `RouteReuseStrategy`. In order to reload
+             * routed components on same url navigation, you need to set `onSameUrlNavigation` to `'reload'`
+             * _and_ provide a `RouteReuseStrategy` which returns `false` for `shouldReuseRoute`.
              */
             this.onSameUrlNavigation = 'ignore';
             /**
@@ -6545,7 +6565,7 @@
     /**
      * @publicApi
      */
-    var VERSION = new core.Version('12.0.0');
+    var VERSION = new core.Version('12.0.4');
 
     /**
      * @license