Help Angular by taking a 1 minute survey!Go to surveyHome

LocationStrategy

LocationStrategy is responsible for representing and reading route state from the browser's URL. Angular provides two strategies: HashLocationStrategy and PathLocationStrategy.

See more...

      
      abstract class LocationStrategy {
  abstract path(includeHash?: boolean): string
  abstract prepareExternalUrl(internal: string): string
  abstract pushState(state: any, title: string, url: string, queryParams: string): void
  abstract replaceState(state: any, title: string, url: string, queryParams: string): void
  abstract forward(): void
  abstract back(): void
  abstract onPopState(fn: LocationChangeListener): void
  abstract getBaseHref(): string
}
    

Description

This is used under the hood of the Location service.

Applications should use the Router or Location services to interact with application route state.

For instance, HashLocationStrategy produces URLs like http://example.com#/foo, and PathLocationStrategy produces http://example.com/foo as an equivalent URL.

See these two classes for more.

Methods

abstract path(includeHash?: boolean): string
      
      abstract path(includeHash?: boolean): string
    
Parameters
includeHash boolean

Optional. Default is undefined.

Returns

string

abstract prepareExternalUrl(internal: string): string
      
      abstract prepareExternalUrl(internal: string): string
    
Parameters
internal string
Returns

string

abstract pushState(state: any, title: string, url: string, queryParams: string): void
      
      abstract pushState(state: any, title: string, url: string, queryParams: string): void
    
Parameters
state any
title string
url string
queryParams string
Returns

void

abstract replaceState(state: any, title: string, url: string, queryParams: string): void
      
      abstract replaceState(state: any, title: string, url: string, queryParams: string): void
    
Parameters
state any
title string
url string
queryParams string
Returns

void

abstract forward(): void
      
      abstract forward(): void
    
Parameters

There are no parameters.

Returns

void

abstract back(): void
      
      abstract back(): void
    
Parameters

There are no parameters.

Returns

void

abstract onPopState(fn: LocationChangeListener): void
      
      abstract onPopState(fn: LocationChangeListener): void
    
Parameters
fn LocationChangeListener
Returns

void

abstract getBaseHref(): string
      
      abstract getBaseHref(): string
    
Parameters

There are no parameters.

Returns

string