app — Navigation
Read navigation state and move between Emberly app routes.
Table of content
Capability: app · Available in: workspace and live preview.
Main methods
| Method | Purpose |
|---|---|
this.app.getNavigation() |
Get a navigation handle |
navigation.pathname |
Read the current path |
navigation.push(path) |
Navigate and add a history entry |
navigation.replace(path) |
Navigate and replace the current history entry |
navigation.destroy() |
Release the navigation handle |
const navigation = await this.app.getNavigation();
const path = navigation.pathname;
Limits
Navigation is restricted to Emberly paths beginning with /app or /map. External URLs are not allowed. Leaving the workspace or changing the preview's map can stop the current plugin session.
The current bridge supplies route-level state. Selected topic and resource IDs are not populated yet; do not depend on the historical API's richer selection state.