#ctx.route

Die aktuellen Informationen zur Routenübereinstimmung entsprechen dem route-Konzept in React Router. Sie werden verwendet, um die aktuell übereinstimmende Routenkonfiguration, Parameter usw. abzurufen. In der Regel wird dies zusammen mit ctx.router und ctx.location verwendet.

#Anwendungsbereiche

Hinweis: ctx.route ist nur in RunJS-Umgebungen verfügbar, die einen Routenkontext enthalten (z. B. JS-Blöcke innerhalb einer Seite, Flow-Seiten usw.). In reinen Backend-Umgebungen oder Kontexten ohne Routing (wie Workflows) kann dieser Wert leer sein.

#Typdefinition

type RouteOptions = {
  name?: string;   // Eindeutige Routenkennung
  path?: string;   // Routenvorlage (z. B. /admin/:name)
  params?: Record<string, any>;  // Routenparameter (z. B. { name: 'users' })
  pathname?: string;  // Vollständiger Pfad der aktuellen Route (z. B. /admin/users)
};

#Häufig genutzte Felder

#Beziehung zu ctx.router und ctx.location

ctx.route konzentriert sich auf die „übereinstimmende Routenkonfiguration“, während ctx.location den Fokus auf die „aktuelle URL-Position“ legt. Zusammen beschreiben sie den aktuellen Routing-Status vollständig.

#Beispiele

#Pathname lesen

// Aktuellen Pfad anzeigen
ctx.message.info('Aktuelle Seite: ' + ctx.route.pathname);

#Verzweigung basierend auf params

// params.name ist normalerweise die UID der aktuellen Seite (z. B. Kennung einer Flow-Seite)
if (ctx.route.params?.name === 'users') {
  // Spezifische Logik auf der Benutzerverwaltungsseite ausführen
}

#Anzeige auf einer Flow-Seite

<div>
  <h1>Aktuelle Seite - {ctx.route.pathname}</h1>
  <p>Routenkennung: {ctx.route.params?.name}</p>
</div>

#Verwandte Themen

• ctx.router: Routennavigation. Wenn ctx.router.navigate() den Pfad ändert, wird ctx.route entsprechend aktualisiert.
• ctx.location: Aktuelle URL-Position (pathname, search, hash, state), wird in Verbindung mit ctx.route verwendet.