Angular2 router keep query string

AngularAngular2 Routing

Angular Problem Overview


I wrote an Angular2 (v2.0.1) application that makes use of the router. The website is loaded with several query string parameters, so the full URL initially looks like this:

https://my.application.com/?param1=val1&param2=val2&param3=val3

In my route configuration, I have an entry which redirects an empty route:

const appRoutes: Routes = [
    {
		path: '',
		redirectTo: '/comp1',
		pathMatch: 'full'
	},
	{
		path: 'comp1',
		component: FirstComponent
	},
	{
		path: 'comp2',
		component: SecondComponent
	}
];

My problem is, that after the app has been bootstrapped, the URL does not contain the query parameters anymore, instead it looks like this:

https://my.application.com/comp1

Is there any way I can configure the router so that it keeps the initial query string when navigating?

Thank you
Lukas

Angular Solutions


Solution 1 - Angular

I don't think there is a way to define that in the routes configuration.

Currently it is supported for routerLinks and imperative navigation to enable

You can add a guard to the empty path route, where in the guard navigation to the /comp1 route is done.

router.navigate(['/comp1'], { preserveQueryParams: true }); //deprecated. see update note

router.navigate(['/comp1'], { queryParamsHandling: "merge" });

There is a PR to allow to configure preserveQueryParams globally.

Update note: from https://angular.io/api/router/NavigationExtras, preserveQueryParams is deprecated, use queryParamsHandling instead

Solution 2 - Angular

If you are navigating using HTML template then you can use

<a [routerLink]="['/page-2']" [routerLinkActive]="['is-active']" queryParamsHandling="merge">

Something to watch out for is that queryParamsHandling param is without the square brackets.

Solution 3 - Angular

It turns out the undocumented way to do this without other hacks is to simply remove the leading slash in the "redirectTo" field. Since you are matching the full path you can have the certainty that it'll do what you want (i.e. no surprise url segments) and since it's no longer an absolute target, Angular will preserve the current query parameters.

So in this case

{
  path: '',
  redirectTo: '/comp1',
  pathMatch: 'full'
}

becomes:

{
  path: '',
  redirectTo: 'comp1',
  pathMatch: 'full'
}

Source: https://github.com/angular/angular/issues/13315

Solution 4 - Angular

Günter Zöchbauer's answer should work properly but, for some reason, it is not working for me at all. What did end up working was passing the queryParams directly instead of 'preserving' them.

This is what my guard looks like:

canActivate(route: ActivatedRouteSnapshot, state: RouterStateSnapshot) {
    (...)
    this.router.navigate(['login'], { queryParams: route.queryParams });
}

Solution 5 - Angular

You may want to search https://github.com/angular/angular/issues for a feature request similar to this. If none exists, submit a feature request.

In the mean time: I believe you will need to create a component, on the path: '', with the sole purpose of then redirecting to '/comp1' while preserving the QueryString params.

Solution 6 - Angular

In Angular 10 now you can use as follows:

    import { ActivatedRoute, Router } from '@angular/router';

class Component {
    constructor(private route: ActivatedRoute, private router: Router) {}

    someMethod() {
        //You can use either merge or preserve to keep the query params
        this.router.navigate(['/'], { queryParamsHandling: 'preserve' })

    }
}

 

Solution 7 - Angular

After having had a go at most answers, I found that

  • Günter Zöchbauer's answer doesn't work for me at all
  • Christopher's suggestion of removing the leading / didn't do it either
  • AArias' answer did work but lead to the adding of two urls in the history:
    1. https://my.application.com/comp1?param=val <= ( ಠ 益ಠ )
    2. https://my.application.com/comp1;param=val

So here's yet another approach, that eventually behaved as per my expectations:

import { ActivatedRoute, Router } from '@angular/router';

class Component {
    constructor(private route: ActivatedRoute, private router: Router) {}

    someMethod() {
        router.navigate(['/comp1', this.route.snapshot.params]);
    }
}

Solution 8 - Angular

There is a workaround using secondary routes as Angular will persist these across primary route navigation.

First, add a named router outlet in your top component:

<router-outlet name="params"><router-outlet>

Next, create a dummy component to route to:

@Component({
    template: ""
})
export class ParamsComponent {}

and define a route to instantiate this component into the named outlet:

{
    path: ':val1',
    component: ParamsComponent,
    outlet: "params"
}

Change you app navigation to:

https://my.application.com/(params:val1)

If you look at any ActivatedRoute, you can find the "params" route using:

  var paramsRoute = this.activatedRoute.route.children.find(r => r.outlet == "params");

If paramsRoute is null, the url doesn't contain the (params:val1).

This next part gets a bit "hacky" as the secondary route is instantiated after the primary route on initial load. Because of this, until your app is fully loaded, you may find paramsRoute.snapshot to be null. There is a private property "_futureSnapshot" which will contain the route params on initial startup...and persists through the life of the app. You can get to these by using:

var queryParams = 
      paramsRoute
      ? paramsRoute["_futureSnapshot"].params
      : {};
var val1 = queryParams["val1"];

Given that _futureSnapshot is not part of the public API, this is probably a field we're not supposed to use. If you feel icky using it, you could probably subscribe to paramsRoute.params, but this will probably complicate your components.

if (paramsRoute) {
    paramsRoute.params.subscribe(params => {
        this.queryParams = params;
        this.loadData();
    });
} else {
    this.queryParams = {};
    this.loadData();
}

========= AMENDMENT =============

I found an even better way to pull the query parameters which is definitely NOT icky... In a component or service which is instantiated before routing occurs, add the following logic:

    const routeRecognizedSubscription = this.router.events
        .filter(e => e instanceof RoutesRecognized)
        .subscribe((e: RoutesRecognized) => {
            const paramsRoute = e.state.root.children.find(r => r.outlet == "params");
            if (paramsRoute) {
                // capture or use paramsRoute.params 
            }
            routeRecognizedSubscription.unsubscribe();
        });

This code temporarily subscribes to RoutesRecognized events which occur before navigation. After it receives the first event, it will automatically unsubscribe as we only need to do this when the app starts.

On the first event, we look for the state corresponding to "params" outlet. If found, the params property will contain the data we need. No need to access private properties.

Solution 9 - Angular

If you are navigating using HTML template, you can also use preserveQueryParams="true"

Notice that preserveQueryParams is without a square bracket.

Eg:

<a [routerLink]="['/navigate-to']" preserveQueryParams="true">

Solution 10 - Angular

capture the original url in -base href-

https://example.com/order?id=123

then it will presist

https://example.com/order?id=123#/product

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionLukas KolletzkiView Question on Stackoverflow
Solution 1 - AngularGünter ZöchbauerView Answer on Stackoverflow
Solution 2 - AngularKamalpreetView Answer on Stackoverflow
Solution 3 - AngularChristopherView Answer on Stackoverflow
Solution 4 - AngularAAriasView Answer on Stackoverflow
Solution 5 - AngularMartinView Answer on Stackoverflow
Solution 6 - AngularBaluView Answer on Stackoverflow
Solution 7 - AngularArnaud PView Answer on Stackoverflow
Solution 8 - AngularGreg PetritesView Answer on Stackoverflow
Solution 9 - AngularVandeshView Answer on Stackoverflow
Solution 10 - Angulardot52View Answer on Stackoverflow