Praman — Agent-First SAP UI5 Test Automation Plugin - v1.2.0
    Preparing search index...

    Function navigateToSpace

    • Ai

      Navigates to an FLP Space Tab by its visible title text.

      Parameters

      • page: SpaceNavigationPage

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

      • spaceTitle: string

        Visible title text of the FLP Space Tab.

      • Optionaloptions: SpaceNavigationOptions

        Navigation options including timeout and exact match control.

      Returns Promise<void>

      ui5Navigation.navigateToApp

      Navigate to a specific Space Tab in the modern FLP layout. Use when the SAP FLP uses Space-based navigation (IconTabFilter tabs at the top).

      On success, the Space Tab is clicked and UI5 stability is reached.

      The FLP must be loaded and use a Space/Section layout (BTP Work Zone or modern S/4HANA FLP).

      Uses Playwright-native getByText() because sap.m.IconTabFilter extends sap.ui.core.Item and does NOT have press(), firePress(), fireSelect(), or fireTap() methods. The UI5-native strategy fallback (getDomRef().click()) does NOT reliably switch Space Tabs. Playwright DOM click is the ONLY reliable approach.

      sap.m.IconTabFilter — FLP Space Tab (no press/firePress methods)

      Navigate between FLP Spaces in modern SAP BTP Work Zone or S/4HANA FLP.

      NavigationError if spaceTitle is empty.

      // Navigate to the "Procurement" space tab (exact match, default)
      await navigateToSpace(page, 'Procurement');

      // Navigate with partial match (e.g., "Procure" matches "Procurement")
      await navigateToSpace(page, 'Procure', { exact: false });

      // Navigate with custom timeout
      await navigateToSpace(page, 'Procurement', { timeout: 15_000 });