#ctx.location

Informações de localização da rota atual, equivalente ao objeto location do React Router. Geralmente é usado em conjunto com ctx.router e ctx.route para ler o caminho atual, string de consulta (query string), hash e o estado (state) passado através da rota.

#Cenários de uso

Nota: ctx.location está disponível apenas em ambientes RunJS com um contexto de roteamento (ex: JSBlock dentro de uma página, fluxos de eventos, etc.); pode ser nulo em contextos puramente de backend ou sem roteamento (ex: fluxos de trabalho).

#Definição de tipo

location: Location;

Location vem de react-router-dom, consistente com o valor de retorno de useLocation() do React Router.

#Campos comuns

#Relação com ctx.router e ctx.urlSearchParams

ctx.urlSearchParams é analisado a partir de ctx.location.search. Se você precisar apenas dos parâmetros de consulta, usar ctx.urlSearchParams é mais conveniente.

#Exemplos

#Ramificação com base no caminho

if (ctx.location.pathname.startsWith('/admin/users')) {
  ctx.message.info('Atualmente na página de gerenciamento de usuários');
}

#Analisando 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 analisar a busca
const params = new URLSearchParams(ctx.location.search);
const page = params.get('page') || '1';
const status = params.get('status');

#Recebendo estado passado via navegação de rota

// Ao navegar da página anterior: ctx.router.navigate('/users/123', { state: { from: 'dashboard' } })
const prevState = ctx.location.state;
if (prevState?.from === 'dashboard') {
  ctx.message.info('Navegou a partir do painel (dashboard)');
}

#Localizando âncoras via hash

const hash = ctx.location.hash; // ex: "#edit"
if (hash === '#edit') {
  // Rolar para a área de edição ou executar a lógica correspondente
}

#Relacionado

• ctx.router: Navegação de rota; o state de ctx.router.navigate pode ser recuperado via ctx.location.state na página de destino.
• ctx.route: Informações de correspondência da rota atual (parâmetros, configuração, etc.), frequentemente usado em conjunto com ctx.location.