Playwright Plugin for SAP Testing — Praman Documentation

Open-source Playwright plugin for SAP S/4HANA, Fiori, and UI5 test automation.

Praman extends Playwright with deep SAP UI5 awareness — typed control proxies, UI5 stability synchronization, FLP navigation, OData testing, and AI-powered test generation.

Get Started

npm install playwright-praman
npx playwright-praman init

That's it. init handles everything — Chromium, configs, SAP credentials, IDE detection, and AI agent installation. Then generate tests:

/praman-sap-coverage
# Then enter: "Test creating a purchase order with vendor 1000, material MAT-001, quantity 10"

The plan → generate → heal pipeline runs 3 agents autonomously:

Agent	What it does
Planner	Explores your live SAP system, discovers UI5 controls, produces a test plan
Generator	Converts the plan into Playwright + Praman code with typed control proxies
Healer	Runs the test, fixes failures, ensures compliance — repeats until green

The result is a production-ready .spec.ts file — no manual test scripting required.

See the full Getting Started guide for details and Running Your Agent for prompt templates.

import { test, expect } from 'playwright-praman';

test('discover a UI5 control', async ({ ui5, ui5Navigation }) => {
  await ui5Navigation.navigateToApp('PurchaseOrder-manage');
  const button = await ui5.control({ controlType: 'sap.m.Button', properties: { text: 'Create' } });
  const text = await button.getText();
  expect(text).toBe('Create');
});

Documentation

Setup & Onboarding

• Getting Started — install, configure, write your first test
• Authentication Guide — 6 SAP auth strategies
• Agent & IDE Setup — AI agents, seed file, and IDE configs installed by init

Your Background — start from what you already know: From Playwright | From Selenium | From wdi5 | From Tosca | For Business Analysts

Core References

• Configuration Reference — all config options with defaults
• Fixture Reference — all 13 fixture modules
• Selector Reference — UI5Selector fields and examples
• Error Reference — 66 error codes with recovery suggestions
• Feature Inventory — complete feature overview

Not sure where to start? Visit the Personas page to find your role-specific entry point.

API documentation is auto-generated from source code TSDoc comments — see the API Reference in the navbar.

LLM-Friendly Docs

Praman publishes documentation in the llmstxt.org standard for AI agents, RAG pipelines, and LLM tools:

File	Content
llms.txt	Link index — all docs with descriptions
llms-full.txt	Complete documentation in a single file
llms-quickstart.txt	Setup, fixtures, selectors, matchers
llms-sap-testing.txt	Auth, FLP, OData, Fiori Elements, cookbook
llms-migration.txt	Migration from Playwright, wdi5, Tosca
llms-architecture.txt	Architecture, bridge, proxy, ADRs

These files are regenerated on every build and deployed alongside the site.