#ctx.route

Informations de correspondance de la route actuelle, correspondant au concept de route dans React Router. Utilisé pour obtenir la configuration de la route correspondante, les paramètres, etc. Généralement utilisé en conjonction avec ctx.router et ctx.location.

#Scénarios d'utilisation

Note : ctx.route est uniquement disponible dans les environnements RunJS disposant d'un contexte de routage (comme les JSBlock dans une page, les pages de flux, etc.). Il peut être nul dans des contextes purement backend ou sans routage (comme les flux de travail en arrière-plan).

#Définition du type

type RouteOptions = {
  name?: string;   // Identifiant unique de la route
  path?: string;   // Modèle de route (ex: /admin/:name)
  params?: Record<string, any>;  // Paramètres de route (ex: { name: 'users' })
  pathname?: string;  // Chemin complet de la route actuelle (ex: /admin/users)
};

#Champs communs

#Relation avec ctx.router et ctx.location

ctx.route se concentre sur la « configuration de la route correspondante », tandis que ctx.location se concentre sur « l'emplacement URL actuel ». Ensemble, ils fournissent une description complète de l'état du routage actuel.

#Exemples

#Lecture du pathname

// Afficher le chemin actuel
ctx.message.info('Page actuelle : ' + ctx.route.pathname);

#Branchement basé sur params

// params.name est généralement l'UID de la page actuelle (ex: identifiant de page de flux)
if (ctx.route.params?.name === 'users') {
  // Exécuter une logique spécifique sur la page de gestion des utilisateurs
}

#Affichage dans une page de flux (Flow)

<div>
  <h1>Page actuelle - {ctx.route.pathname}</h1>
  <p>Identifiant de route : {ctx.route.params?.name}</p>
</div>

#Relatif

• ctx.router : Navigation de route. Lorsque ctx.router.navigate() modifie le chemin, ctx.route est mis à jour en conséquence.
• ctx.location : Emplacement URL actuel (pathname, search, hash, state), utilisé en conjonction avec ctx.route.