#ctx.location

Informasi posisi route saat ini, setara dengan objek location di React Router. Biasanya digunakan dengan ctx.router, ctx.route, untuk membaca path saat ini, query string, hash, dan state yang dikirim melalui route.

#Skenario Penggunaan

Perhatian: ctx.location hanya tersedia pada environment RunJS yang memiliki konteks route (seperti JSBlock dalam halaman, event flow, dll.); pada konteks pure backend atau tanpa route (seperti workflow) mungkin kosong.

#Definisi Tipe

location: Location;

Location berasal dari react-router-dom, sama dengan return value useLocation() di React Router.

#Field Umum

#Hubungan dengan ctx.router, ctx.urlSearchParams

ctx.urlSearchParams di-parse dari ctx.location.search, jika hanya membutuhkan query parameter, menggunakan ctx.urlSearchParams lebih praktis.

#Contoh

#Membuat Cabang Berdasarkan Path

if (ctx.location.pathname.startsWith('/admin/users')) {
  ctx.message.info('Saat ini di halaman manajemen user');
}

#Mem-parsing Query Parameter

// Cara 1: menggunakan ctx.urlSearchParams (direkomendasikan)
const page = ctx.urlSearchParams.page || 1;
const status = ctx.urlSearchParams.status;

// Cara 2: menggunakan URLSearchParams untuk parse search
const params = new URLSearchParams(ctx.location.search);
const page = params.get('page') || '1';
const status = params.get('status');

#Menerima State yang Dikirim Saat Navigasi Route

// Saat halaman sebelumnya navigasi: ctx.router.navigate('/users/123', { state: { from: 'dashboard' } })
const prevState = ctx.location.state;
if (prevState?.from === 'dashboard') {
  ctx.message.info('Datang dari dashboard');
}

#Penempatan Anchor Berdasarkan Hash

const hash = ctx.location.hash; // seperti "#edit"
if (hash === '#edit') {
  // Scroll ke area edit atau eksekusi logika yang sesuai
}

#Terkait

• ctx.router: Navigasi route, state dari ctx.router.navigate dapat diperoleh di halaman target melalui ctx.location.state
• ctx.route: Informasi pencocokan route saat ini (parameter, konfigurasi, dll.), biasanya digunakan dengan ctx.location