#ctx.route

Información de coincidencia de la ruta actual, correspondiente al concepto route de React Router. Se utiliza para obtener la configuración de la ruta coincidente actual, parámetros, etc. Generalmente se usa en conjunto con ctx.router y ctx.location.

#Escenarios de uso

Nota: ctx.route solo está disponible en entornos RunJS que contienen un contexto de enrutamiento (como JSBlock dentro de una página, páginas de flujo, etc.); puede ser nulo en contextos puramente de backend o sin enrutamiento (como flujos de trabajo).

#Definición de tipos

type RouteOptions = {
  name?: string;   // Identificador único de la ruta
  path?: string;   // Plantilla de la ruta (ej. /admin/:name)
  params?: Record<string, any>;  // Parámetros de la ruta (ej. { name: 'users' })
  pathname?: string;  // Ruta completa de la ruta actual (ej. /admin/users)
};

#Campos comunes

#Relación con ctx.router y ctx.location

ctx.route se centra en la "configuración de la ruta coincidente", mientras que ctx.location se centra en la "ubicación de la URL actual". Juntos proporcionan una descripción completa del estado de enrutamiento actual.

#Ejemplos

#Leer pathname

// Mostrar la ruta actual
ctx.message.info('Página actual: ' + ctx.route.pathname);

#Ramificación basada en params

// params.name suele ser el UID de la página actual (ej. identificador de página de flujo)
if (ctx.route.params?.name === 'users') {
  // Ejecutar lógica específica en la página de gestión de usuarios
}

#Mostrar en una página de flujo (Flow)

<div>
  <h1>Página actual - {ctx.route.pathname}</h1>
  <p>Identificador de ruta: {ctx.route.params?.name}</p>
</div>

#Relacionado

• ctx.router: Navegación de rutas. Cuando ctx.router.navigate() cambia la ruta, ctx.route se actualizará en consecuencia.
• ctx.location: Ubicación de la URL actual (pathname, search, hash, state), utilizado en conjunto con ctx.route.