Skip to main content
Version: 1.x

Function: navigateToSectionLink()

navigateToSectionLink(page, linkName, options?): Promise<void>

Ai

Navigates via an FLP Section Link in a Space-based layout.

Parameters

page

SpaceNavigationPage

Playwright Page (or compatible subset with getByRole()).

linkName

string

Accessible name (visible text) of the section link.

options?

SectionLinkNavigationOptions

Navigation options including timeout.

Returns

Promise<void>

Intent

Click a section link within a Space to navigate to a specific area. Use after navigating to a Space when the target content is in a specific section.

Guarantee

On success, the section link is clicked and UI5 stability is reached.

Prerequisite

A Space must be active and the section link must be visible in the current FLP view.

Ai Context

Uses Playwright-native getByRole('link') to locate the section link by its accessible name. Section links in FLP are standard HTML anchor elements, not UI5 controls, so Playwright-native interaction is the correct approach.

Sap Module

sap.ushell — FLP section-based navigation within Spaces

Business Context

Navigate within FLP Space sections in modern SAP BTP Work Zone layouts.

Throws

NavigationError if linkName is empty.

Example

// Navigate to a section link within the current space
await navigateToSectionLink(page, 'Purchase Orders');

// Navigate with custom timeout
await navigateToSectionLink(page, 'Manage Suppliers', { timeout: 10_000 });