TestNavHostController

Kotlin |Java

class TestNavHostController : NavHostController

kotlin.Any
↳	androidx.navigation.NavController
	↳	androidx.navigation.NavHostController
		↳	androidx.navigation.testing.TestNavHostController

Subclass of NavHostController that offers additional APIs for testing Navigation.

Summary

Inherited constants

From class NavController

String

KEY_DEEP_LINK_INTENT

The Intent that triggered a deep link to the current destination.

Public constructors
`<init>(context: Context)` Subclass of NavHostController that offers additional APIs for testing Navigation.

Public methods
Unit	`setCurrentDestination(@IdRes destId: Int, args: Bundle = Bundle())` Navigate directly to any destination on the current androidx.navigation.NavGraph via an explicit deep link.

Inherited functions

From class NavController

`Unit`	`addOnDestinationChangedListener(@NonNull listener: NavController.OnDestinationChangedListener)` Adds an `OnDestinationChangedListener` to this controller to receive a callback whenever the `getCurrentDestination()` or its arguments change. The current destination, if any, will be immediately sent to your listener.
`NavDeepLinkBuilder`	`createDeepLink()` Create a deep link to a destination within this NavController.
`NavBackStackEntry`	`getBackStackEntry(@IdRes destinationId: Int)` Gets the topmost `NavBackStackEntry` for a destination id. This is always safe to use with `the current destination` or `its parent` or grandparent navigation graphs as these destinations are guaranteed to be on the back stack.
`NavBackStackEntry?`	`getCurrentBackStackEntry()` Gets the topmost `NavBackStackEntry`.
`NavDestination?`	`getCurrentDestination()` Gets the current destination.
`NavGraph`	`getGraph()` Gets the topmost navigation graph associated with this NavController.
`NavInflater`	`getNavInflater()` Returns the `inflater` for this controller.
`NavigatorProvider`	`getNavigatorProvider()` Retrieve the NavController's `NavigatorProvider`. All `Navigators` used to construct the `navigation graph` for this nav controller should be added to this navigator provider before the graph is constructed. Generally, the Navigators are set for you by the `NavHost` hosting this NavController and you do not need to manually interact with the navigator provider.
`NavBackStackEntry?`	`getPreviousBackStackEntry()` Gets the previous visible `NavBackStackEntry`. This skips over any `NavBackStackEntry` that is associated with a `NavGraph`.
`ViewModelStoreOwner`	`getViewModelStoreOwner(@IdRes navGraphId: Int)` Gets the `ViewModelStoreOwner` for a NavGraph. This can be passed to `androidx.lifecycle.ViewModelProvider` to retrieve a ViewModel that is scoped to the navigation graph - it will be cleared when the navigation graph is popped off the back stack.
`Boolean`	`handleDeepLink(@Nullable intent: Intent?)` Checks the given Intent for a Navigation deep link and navigates to the deep link if present. This is called automatically for you the first time you set the graph if you've passed in an `Activity` as the context when constructing this NavController, but should be manually called if your Activity receives new Intents in `Activity#onNewIntent(Intent)`. The types of Intents that are supported include: Intents created by `NavDeepLinkBuilder` or `createDeepLink()`. This assumes that the current graph shares the same hierarchy to get to the deep linked destination as when the deep link was constructed. Intents that include a `data Uri`. This Uri will be checked against the Uri patterns in the `NavDeepLinks` added via `NavDestination#addDeepLink(NavDeepLink)`. The `navigation graph` should be set before calling this method.
`Unit`	`navigate(@IdRes resId: Int)` Navigate to a destination from the current navigation graph. This supports both navigating via an `action` and directly navigating to a destination.
`Unit`	`navigate(@IdRes resId: Int, @Nullable args: Bundle?)` Navigate to a destination from the current navigation graph. This supports both navigating via an `action` and directly navigating to a destination.
`Unit`	`navigate(@IdRes resId: Int, @Nullable args: Bundle?, @Nullable navOptions: NavOptions?)` Navigate to a destination from the current navigation graph. This supports both navigating via an `action` and directly navigating to a destination.
`Unit`	`navigate(@IdRes resId: Int, @Nullable args: Bundle?, @Nullable navOptions: NavOptions?, @Nullable navigatorExtras: Navigator.Extras?)` Navigate to a destination from the current navigation graph. This supports both navigating via an `action` and directly navigating to a destination.
`Unit`	`navigate(@NonNull deepLink: Uri)` Navigate to a destination via the given deep link `Uri`. `NavDestination#hasDeepLink(Uri)` should be called on `the navigation graph` prior to calling this method to check if the deep link is valid. If an invalid deep link is given, an `IllegalArgumentException` will be thrown.
`Unit`	`navigate(@NonNull deepLink: Uri, @Nullable navOptions: NavOptions?)` Navigate to a destination via the given deep link `Uri`. `NavDestination#hasDeepLink(Uri)` should be called on `the navigation graph` prior to calling this method to check if the deep link is valid. If an invalid deep link is given, an `IllegalArgumentException` will be thrown.
`Unit`	`navigate(@NonNull deepLink: Uri, @Nullable navOptions: NavOptions?, @Nullable navigatorExtras: Navigator.Extras?)` Navigate to a destination via the given deep link `Uri`. `NavDestination#hasDeepLink(Uri)` should be called on `the navigation graph` prior to calling this method to check if the deep link is valid. If an invalid deep link is given, an `IllegalArgumentException` will be thrown.
`Unit`	`navigate(@NonNull request: NavDeepLinkRequest)` Navigate to a destination via the given `NavDeepLinkRequest`. `NavDestination#hasDeepLink(NavDeepLinkRequest)` should be called on `the navigation graph` prior to calling this method to check if the deep link is valid. If an invalid deep link is given, an `IllegalArgumentException` will be thrown.
`Unit`	`navigate(@NonNull request: NavDeepLinkRequest, @Nullable navOptions: NavOptions?)` Navigate to a destination via the given `NavDeepLinkRequest`. `NavDestination#hasDeepLink(NavDeepLinkRequest)` should be called on `the navigation graph` prior to calling this method to check if the deep link is valid. If an invalid deep link is given, an `IllegalArgumentException` will be thrown.
`Unit`	`navigate(@NonNull request: NavDeepLinkRequest, @Nullable navOptions: NavOptions?, @Nullable navigatorExtras: Navigator.Extras?)` Navigate to a destination via the given `NavDeepLinkRequest`. `NavDestination#hasDeepLink(NavDeepLinkRequest)` should be called on `the navigation graph` prior to calling this method to check if the deep link is valid. If an invalid deep link is given, an `IllegalArgumentException` will be thrown.
`Unit`	`navigate(@NonNull directions: NavDirections)` Navigate via the given `NavDirections`
`Unit`	`navigate(@NonNull directions: NavDirections, @Nullable navOptions: NavOptions?)` Navigate via the given `NavDirections`
`Unit`	`navigate(@NonNull directions: NavDirections, @NonNull navigatorExtras: Navigator.Extras)` Navigate via the given `NavDirections`
`Boolean`	`navigateUp()` Attempts to navigate up in the navigation hierarchy. Suitable for when the user presses the "Up" button marked with a left (or start)-facing arrow in the upper left (or starting) corner of the app UI. The intended behavior of Up differs from `Back` when the user did not reach the current destination from the application's own task. e.g. if the user is viewing a document or link in the current app in an activity hosted on another app's task where the user clicked the link. In this case the current activity (determined by the context used to create this NavController) will be `finished` and the user will be taken to an appropriate destination in this app on its own task.
`Boolean`	`popBackStack()` Attempts to pop the controller's back stack. Analogous to when the user presses the system `Back` button when the associated navigation host has focus.
`Boolean`	`popBackStack(@IdRes destinationId: Int, inclusive: Boolean)` Attempts to pop the controller's back stack back to a specific destination.
`Unit`	`removeOnDestinationChangedListener(@NonNull listener: NavController.OnDestinationChangedListener)` Removes an `OnDestinationChangedListener` from this controller. It will no longer receive callbacks.
`Unit`	`restoreState(@Nullable navState: Bundle?)` Restores all navigation controller state from a bundle. This should be called before any call to #setGraph. State may be saved to a bundle by calling `saveState()`. Restoring controller state is the responsibility of a `NavHost`.
`Bundle?`	`saveState()` Saves all navigation controller state to a Bundle. State may be restored from a bundle returned from this method by calling `restoreState(Bundle)`. Saving controller state is the responsibility of a `NavHost`.
`Unit`	`setGraph(@NavigationRes graphResId: Int)` Sets the `navigation graph` to the specified resource. Any current navigation graph data (including back stack) will be replaced. The inflated graph can be retrieved via `getGraph()`.
`Unit`	`setGraph(@NavigationRes graphResId: Int, @Nullable startDestinationArgs: Bundle?)` Sets the `navigation graph` to the specified resource. Any current navigation graph data (including back stack) will be replaced. The inflated graph can be retrieved via `getGraph()`.
`Unit`	`setGraph(@NonNull graph: NavGraph)` Sets the `navigation graph` to the specified graph. Any current navigation graph data (including back stack) will be replaced. The graph can be retrieved later via `getGraph()`.
`Unit`	`setGraph(@NonNull graph: NavGraph, @Nullable startDestinationArgs: Bundle?)` Sets the `navigation graph` to the specified graph. Any current navigation graph data (including back stack) will be replaced. The graph can be retrieved later via `getGraph()`.

From class NavHostController

`Unit`	`enableOnBackPressed(enabled: Boolean)` Set whether the NavController should handle the system Back button events via the registered `OnBackPressedDispatcher`.
`Unit`	`setLifecycleOwner(@NonNull owner: LifecycleOwner)` Sets the host's `LifecycleOwner`.
`Unit`	`setOnBackPressedDispatcher(@NonNull dispatcher: OnBackPressedDispatcher)` Sets the host's `OnBackPressedDispatcher`. If set, NavController will register a `OnBackPressedCallback` to handle system Back button events. You must explicitly called `setLifecycleOwner(LifecycleOwner)` before calling this method as the owner set there will be used as the `LifecycleOwner` for registering the `OnBackPressedCallback`. You can dynamically enable and disable whether the NavController should handle the system Back button events by calling `enableOnBackPressed(boolean)`.
`Unit`	`setViewModelStore(@NonNull viewModelStore: ViewModelStore)` Sets the host's ViewModelStore used by the NavController to store ViewModels at the navigation graph level. This is required to call `getViewModelStoreOwner` and should generally be called for you by your `NavHost`. You must call this method before `setGraph(int)` or similar methods, because the `ViewModelStore` set here will be used by the created `NavBackStackEntry` items.

Inherited extension functions

From androidx.navigation

NavGraph

NavController.createGraph(@IdRes id: Int = 0, @IdRes startDestination: Int, builder: NavGraphBuilder.() -> Unit)

Construct a new NavGraph

From androidx.navigation.dynamicfeatures

NavGraph

NavController.createGraph(@IdRes id: Int = 0, @IdRes startDestination: Int, builder: DynamicNavGraphBuilder.() -> Unit)

Construct a new androidx.navigation.NavGraph that supports dynamic navigation destinations

From androidx.navigation.ui

Boolean	`NavController.navigateUp(drawerLayout: Openable?)` Handles the Up button by delegating its behavior to the given NavController.
Boolean	`NavController.navigateUp(appBarConfiguration: AppBarConfiguration)` Handles the Up button by delegating its behavior to the given NavController.

Properties
List<NavBackStackEntry>	`backStack` Gets an immutable copy of the elements currently on the back stack.

Public constructors

<init>

TestNavHostController(context: Context)

Subclass of NavHostController that offers additional APIs for testing Navigation.

Public methods

setCurrentDestination

@JvmOverloads fun setCurrentDestination(
    @IdRes destId: Int, 
    args: Bundle = Bundle()
): Unit

Navigate directly to any destination on the current androidx.navigation.NavGraph via an explicit deep link. If an implicit deep link exists for this destination use #navigateUri instead.

Parameters
destId: Int	The destination id to navigate to.
args: Bundle = Bundle()	The arguments to pass to the destination.

Exceptions
`IllegalArgumentException`	If the destination does not exist on the NavGraph.

Properties

backStack

val backStack: List<NavBackStackEntry>

Gets an immutable copy of the elements currently on the back stack.