API de navegación

Estas funciones activan actualizaciones de estado en la sesión del historial del navegador, lo que le permite realizar la transición entre páginas mediante programación.

goToPage

Agrega una nueva entrada a la pila del historial del navegador.

function goToPage(
    pathname: string,
    pageData: Record<string, unknown> = {},
    title: string = document.title
): Promise<void>

Ejemplo

import { goToPage } from '@beforesemicolon/router'

await goToPage(
    '/users/42',
    { role: 'admin', scrollPosition: 0 },
    'User Profile'
)

replacePage

Actualiza la entrada actual en la pila del historial en lugar de crear una nueva. Esto es ideal para redirecciones, de modo que hacer clic en el botón Atrás del navegador no atrapa al usuario en un bucle de redireccionamiento.

function replacePage(
    pathname: string,
    pageData: Record<string, unknown> = {},
    title: string = document.title
): Promise<void>

Ejemplo

import { replacePage } from '@beforesemicolon/router'

if (!isAuthenticated) {
    await replacePage('/login', { from: '/dashboard' }, 'Please Login')
}

previousPage

Vuelve a la entrada anterior en la sesión del navegador. Idéntico a hacer clic en el botón Atrás del navegador.

function previousPage(): void

nextPage

Avanza hasta la siguiente entrada en la sesión del navegador. Idéntico a hacer clic en el botón de avance del navegador.

function nextPage(): void