Class Router

micro router

const router = new Router( );

router.get( "/detail/:id", ( params: any ) => {
    this._showDetail( detail );
} );

router.get( "/:id", ( params: any ) => {
  if( params.id==0 )
        router.navigate( '/home' );
     }
});

router.on( "error", ( ) => {
    router.navigate( '/home' );
})

router.init( );

Hierarchy

EventSource<RouterEventMap>
- Router

Index

Constructors

constructor

new Router(useHash?): Router
Parameters
- useHash: boolean = true
Returns Router
Overrides EventSource.constructor
- Defined in src/router.ts:128

Properties

`Private` m_routes

m_routes: Route[]

`Private` m_useHash

m_useHash: boolean

Methods

_emit

_emit(eventName, e): void
Parameters
- eventName: string
- e: BasicEvent
Returns void
Inherited from EventSource._emit
- Defined in src/x4events.ts:291

`Private` _find

_find(url): {
handlers: RouteHandler[];
params: any;
}
Parameters
- url: string
Returns {
handlers: RouteHandler[];
params: any;
}
- handlers: RouteHandler[]
- params: any
- Defined in src/router.ts:194

`Private` _getLocation

_getLocation(): string
Returns string
- Defined in src/router.ts:153

_off

_off(eventName, callback): void
Parameters
- eventName: string
- callback: EventCallback<BasicEvent>
Returns void
Inherited from EventSource._off
- Defined in src/x4events.ts:550

_on

_on(eventName, callback, capturing?): EventDisposer
Parameters
- eventName: string
- callback: EventCallback<BasicEvent>
- capturing: boolean = false
Returns EventDisposer
Inherited from EventSource._on
- Defined in src/x4events.ts:513

_once

_once(eventName, callback): Promise<unknown>
Parameters
- eventName: string
- callback: EventCallback<BasicEvent>
Returns Promise<unknown>
Inherited from EventSource._once
- Defined in src/x4events.ts:412

_signal

_signal(eventName, e, delay?): void
Parameters
- eventName: string
- e: BasicEvent
- delay: number = -1
Returns void
Inherited from EventSource._signal
- Defined in src/x4events.ts:348

defaults

defaults(events): void
define a set of default handlers in one call
Parameters
- events: MapEvents<RouterEventMap>
Returns void
Inherited from EventSource.defaults
- Defined in src/x4events.ts:495

emit

emit<K>(type, event?): void
emit an event you can stop propagation of event or prevent default
Type Parameters
- K extends "error"
Parameters
- type: K
- Optional event: RouterEventMap[K]
  
  event data
Returns void
Inherited from EventSource.emit
- Defined in src/x4events.ts:287

get

get(uri, handler): void
Parameters
- uri: string | RegExp
- handler: RouteHandler
Returns void
- Defined in src/router.ts:144

init

init(): void
Returns void
- Defined in src/router.ts:149

listen

listen(events): void
define a set of listeners in one call
Parameters
- events: MapEvents<RouterEventMap>
Returns void
Inherited from EventSource.listen
- Defined in src/x4events.ts:484

navigate

navigate(uri, notify?, replace?): void
Parameters
- uri: string
- notify: boolean = true
- replace: boolean = false
Returns void
- Defined in src/router.ts:157

off

off<K>(type, callback): void
stop listening to an event
Type Parameters
- K extends "error"
Parameters
- type: K
- callback: ((ev) => any)
  
  callback to remove (must be the same as in on )
  - - (ev): any
    - Parameters
      
      ev: RouterEventMap[K]
      
      Returns any
Returns void
Inherited from EventSource.off
- Defined in src/x4events.ts:545

on

on<K>(type, callback): EventDisposer
listen for an event
Type Parameters
- K extends "error"
Parameters
- type: K
- callback: ((ev) => any)
  
  callback to call
  - - (ev): any
    - Parameters
      
      ev: RouterEventMap[K]
      
      Returns any
Returns EventDisposer
Inherited from EventSource.on
- Defined in src/x4events.ts:508

once

once<K>(type, callback): void
handle an event one time
Type Parameters
- K extends "error"
Parameters
- type: K
- callback: ((ev) => any)
  
  callback to call when event is signaled
  - - (ev): any
    - Parameters
      
      ev: RouterEventMap[K]
      
      Returns any
Returns void
Promise if callback is null

take care with that because if the event is never fired and you await it, the system may overflow
Inherited from EventSource.once
- Defined in src/x4events.ts:407

removeAllListeners

removeAllListeners(eventName): void
remove all listeners for an event
Parameters
- eventName: string
  
  event name
Returns void
Inherited from EventSource.removeAllListeners
- Defined in src/x4events.ts:571

removeDefaultHandler

removeDefaultHandler(eventName, callback): void
remove the previous default handler installed for an event
Parameters
- eventName: string
  
  event name
- callback: EventCallback<BasicEvent>
  
  callback handler to remove (must be the same as in setDefaultHandler)
Returns void
Inherited from EventSource.removeDefaultHandler
- Defined in src/x4events.ts:464

setDefaultHandler

setDefaultHandler(eventName, callback): void
set the event default handler
Parameters
- eventName: string
  
  name of the event
- callback: EventCallback<BasicEvent>
  
  callback to call when the event is not handled (and preventDeault has not been called)
Returns void
Inherited from EventSource.setDefaultHandler
- Defined in src/x4events.ts:434

signal

signal<K>(type, event, delay?): void
signal en event signaled event are notification : no way to prevent default not stop propagation
Type Parameters
- K extends "error"
Parameters
- type: K
- event: RouterEventMap[K]
  
  event data
- delay: number = -1
Returns void
Inherited from EventSource.signal
- Defined in src/x4events.ts:344

Class Router

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

useHash: boolean = true

Returns Router

Properties

Private m_routes

Private m_useHash

Methods

_emit

Parameters

eventName: string

e: BasicEvent

Returns void

Private _find

Parameters

url: string

Returns { handlers: RouteHandler[]; params: any; }

handlers: RouteHandler[]

params: any

Private _getLocation

Returns string

_off

Parameters

eventName: string

callback: EventCallback<BasicEvent>

Returns void

_on

Parameters

eventName: string

callback: EventCallback<BasicEvent>

capturing: boolean = false

Returns EventDisposer

_once

Parameters

eventName: string

callback: EventCallback<BasicEvent>

Returns Promise<unknown>

_signal

Parameters

eventName: string

e: BasicEvent

delay: number = -1

Returns void

defaults

Parameters

events: MapEvents<RouterEventMap>

Returns void

emit

Type Parameters

K extends "error"

Parameters

type: K

Optional event: RouterEventMap[K]

Returns void

get

Parameters

uri: string | RegExp

handler: RouteHandler

Returns void

init

Returns void

listen

Parameters

events: MapEvents<RouterEventMap>

Returns void

navigate

Parameters

uri: string

notify: boolean = true

replace: boolean = false

Returns void

off

Type Parameters

`Private` m_routes

`Private` m_useHash

`Private` _find

Returns {
handlers: RouteHandler[];
params: any;
}

`Private` _getLocation

`Optional` event: RouterEventMap[K]