#ctx.location

Información de la ubicación de la ruta actual, equivalente al objeto location de React Router. Se utiliza habitualmente en conjunto con ctx.router y ctx.route para leer la ruta actual, la cadena de consulta (query string), el hash y el estado (state) pasado a través de la ruta.

#Escenarios de uso

Nota: ctx.location solo está disponible en entornos RunJS que cuenten con un contexto de enrutamiento (por ejemplo, JSBlock dentro de una página, flujos de eventos, etc.); puede estar vacío en contextos puramente de backend o sin enrutamiento (como en los flujos de trabajo).

#Definición de tipo

location: Location;

Location proviene de react-router-dom, y es consistente con el valor de retorno de useLocation() de React Router.

#Campos comunes

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

ctx.urlSearchParams se analiza a partir de ctx.location.search. Si solo necesita los parámetros de consulta, usar ctx.urlSearchParams es más conveniente.

#Ejemplos

#Ramificación basada en la ruta

if (ctx.location.pathname.startsWith('/admin/users')) {
  ctx.message.info('Se encuentra actualmente en la página de gestión de usuarios');
}

#Análisis de parámetros de consulta

// Método 1: Usando ctx.urlSearchParams (Recomendado)
const page = ctx.urlSearchParams.page || 1;
const status = ctx.urlSearchParams.status;

// Método 2: Usando URLSearchParams para analizar search
const params = new URLSearchParams(ctx.location.search);
const page = params.get('page') || '1';
const status = params.get('status');

#Recibir el estado pasado mediante la navegación de ruta

// Al navegar desde la página anterior: ctx.router.navigate('/users/123', { state: { from: 'dashboard' } })
const prevState = ctx.location.state;
if (prevState?.from === 'dashboard') {
  ctx.message.info('Navegado desde el tablero (dashboard)');
}

#Localizar anclas mediante hash

const hash = ctx.location.hash; // p. ej., "#edit"
if (hash === '#edit') {
  // Desplazarse al área de edición o ejecutar la lógica correspondiente
}

#Relacionado

• ctx.router: Navegación de rutas; el state de ctx.router.navigate puede recuperarse a través de ctx.location.state en la página de destino.
• ctx.route: Información de coincidencia de la ruta actual (parámetros, configuración, etc.), frecuentemente utilizado en conjunto con ctx.location.