#ctx.location

Aktuelle Informationen zum Routen-Standort, äquivalent zum location-Objekt von React Router. Es wird normalerweise in Verbindung mit ctx.router und ctx.route verwendet, um den aktuellen Pfad, den Abfragestring (Query String), den Hash und den über die Route übergebenen Status (State) zu lesen.

#Anwendungsfälle

Hinweis: ctx.location ist nur in RunJS-Umgebungen mit einem Routing-Kontext verfügbar (z. B. JSBlock innerhalb einer Seite, Ereignisfluss usw.); in reinen Backend- oder Nicht-Routing-Kontexten (wie Workflows) kann es null sein.

#Typdefinition

location: Location;

Location stammt aus react-router-dom und entspricht dem Rückgabewert von useLocation() in React Router.

#Gängige Felder

#Beziehung zu ctx.router und ctx.urlSearchParams

ctx.urlSearchParams wird aus ctx.location.search analysiert. Wenn Sie nur Abfrageparameter benötigen, ist die Verwendung von ctx.urlSearchParams bequemer.

#Beispiele

#Verzweigung basierend auf dem Pfad

if (ctx.location.pathname.startsWith('/admin/users')) {
  ctx.message.info('Aktuell auf der Benutzerverwaltungsseite');
}

#Abfrageparameter analysieren

// Methode 1: Verwendung von ctx.urlSearchParams (Empfohlen)
const page = ctx.urlSearchParams.page || 1;
const status = ctx.urlSearchParams.status;

// Methode 2: Verwendung von URLSearchParams zum Analysieren von search
const params = new URLSearchParams(ctx.location.search);
const page = params.get('page') || '1';
const status = params.get('status');

#Empfangen von Status-Daten aus der Routen-Navigation

// Beim Navigieren von der vorherigen Seite: ctx.router.navigate('/users/123', { state: { from: 'dashboard' } })
const prevState = ctx.location.state;
if (prevState?.from === 'dashboard') {
  ctx.message.info('Vom Dashboard navigiert');
}

#Anker über Hash lokalisieren

const hash = ctx.location.hash; // z. B. "#edit"
if (hash === '#edit') {
  // Zum Bearbeitungsbereich scrollen oder entsprechende Logik ausführen
}

#Verwandte Themen

• ctx.router: Routen-Navigation; der state von ctx.router.navigate kann über ctx.location.state auf der Zielseite abgerufen werden.
• ctx.route: Informationen zur aktuellen Routen-Übereinstimmung (Parameter, Konfiguration usw.), oft in Verbindung mit ctx.location verwendet.