#ctx.location

Thông tin vị trí route hiện tại, tương đương với object location của React Router. Thường được dùng kết hợp với ctx.router, ctx.route để đọc path hiện tại, query string, hash và state được truyền qua route.

#Kịch bản áp dụng

Lưu ý: ctx.location chỉ khả dụng trong môi trường RunJS có ngữ cảnh route (như JSBlock trong page, luồng sự kiện, v.v.); trong các ngữ cảnh không route hoặc backend thuần túy (như workflow) có thể trống.

#Định nghĩa kiểu

location: Location;

Location đến từ react-router-dom, giống với giá trị trả về của useLocation() trong React Router.

#Trường thường dùng

#Quan hệ với ctx.router, ctx.urlSearchParams

ctx.urlSearchParams được parse từ ctx.location.search, nếu chỉ cần tham số query, sử dụng ctx.urlSearchParams tiện lợi hơn.

#Ví dụ

#Rẽ nhánh dựa trên path

if (ctx.location.pathname.startsWith('/admin/users')) {
  ctx.message.info('当前在用户管理页');
}

#Parse tham số query

// 方式 1：使用 ctx.urlSearchParams（推荐）
const page = ctx.urlSearchParams.page || 1;
const status = ctx.urlSearchParams.status;

// 方式 2：使用 URLSearchParams 解析 search
const params = new URLSearchParams(ctx.location.search);
const page = params.get('page') || '1';
const status = params.get('status');

#Nhận state được truyền qua điều hướng route

// 上一页跳转时：ctx.router.navigate('/users/123', { state: { from: 'dashboard' } })
const prevState = ctx.location.state;
if (prevState?.from === 'dashboard') {
  ctx.message.info('从仪表盘跳转而来');
}

#Định vị anchor theo hash

const hash = ctx.location.hash; // 如 "#edit"
if (hash === '#edit') {
  // 滚动到编辑区域或执行对应逻辑
}

#Liên quan

• ctx.router: Điều hướng route, state của ctx.router.navigate có thể lấy qua ctx.location.state ở page đích
• ctx.route: Thông tin match route hiện tại (tham số, cấu hình, v.v.), thường được dùng kết hợp với ctx.location