Skip to main content
Version: 1.x

Function: navigateToIntent()

navigateToIntent(page, intent, params?, options?): Promise<void>

Ai

Navigates to an SAP intent with optional parameters.

Parameters

page

NavigationPage

Playwright Page (or compatible subset).

intent

NavigationIntent

Semantic object and action descriptor.

params?

Readonly<Record<string, string>>

Optional query parameters for the intent.

options?

NavigationOptions

Navigation options.

Returns

Promise<void>

Capability

ui5Navigation.navigateToIntent

Intent

Navigate using a structured semantic object + action pair with optional query params. Prefer this over navigateToApp() when parameters need to be passed to the target app.

Guarantee

On success, the FLP hash is set to the intent with parameters and UI5 is stable.

Ai Context

Build the intent from the app's cross-navigation inbound config. Parameters are appended as URL query string (e.g., #PurchaseOrder-manage?PurchaseOrder=4500001234).

Sap Module

sap.ushell.Container — FLP intent-based navigation with parameters

Business Context

Cross-app navigation with context parameters in SAP Fiori.

Example

await navigateToIntent(page, { semanticObject: 'PurchaseOrder', action: 'manage' });