praman-sap-cli

SAP UI5 Test Automation via Playwright CLI

Package: playwright-praman v1.1.2 CLI Requirement: @playwright/cli v0.1.3+ and playwright v1.59+ Purpose: Discover SAP UI5 controls, debug Praman tests, and automate SAP Fiori workflows using the Playwright CLI. Agents use CLI commands for live discovery, then produce Praman fixture code as output.

Setup: Create Config File

Create .playwright/praman-cli.config.json in your project root:

mkdir -p .playwright
cat > .playwright/praman-cli.config.json << 'PRAMAN_EOF'
{
  "browser": {
    "browserName": "chromium",
    "initScript": ["./node_modules/playwright-praman/dist/browser/praman-bridge-init.js"]
  },
  "timeouts": {
    "navigation": 120000
  }
}
PRAMAN_EOF

Without --config: Browser opens fine, page loads fine, but window.__praman_bridge is undefined. All discovery scripts will fail.

eval vs run-code

CRITICAL: eval requires a function wrapper () => expr. Bare expressions will fail.

# ✅ CORRECT
playwright-cli eval "() => window.__praman_bridge?.ready"

# ❌ WRONG — fails silently
playwright-cli eval "window.__praman_bridge?.ready"

run-code rules:

• Only page is in scope — no process.env, no require()
• console.log() is invisible — always use return to get data
• Return ONLY serializable values: strings, numbers, booleans, null, plain objects, arrays
• Do NOT return: functions, DOM nodes, Symbols, circular references

Discover Controls with Methods

Pre-built Script (recommended)

playwright-cli -s=sap run-code "$(cat node_modules/playwright-praman/dist/scripts/discover-all.js)"

Returns up to 100 controls with IDs, types, properties, and method names.

Inline Alternative

playwright-cli -s=sap run-code "async page => {
  return await page.evaluate(() => {
    const bridge = window.__praman_bridge;
    if (!bridge || !bridge.ready) return { error: 'Bridge not ready' };
    return Object.values(sap.ui.require('sap/ui/core/ElementRegistry').all()).slice(0, 100).map(c => ({
      id: c.getId(),
      type: c.getMetadata().getName(),
      methods: bridge.utils.retrieveControlMethods(c.getId())
    }));
  });
}"