Registry / testing / ui5-middleware-iasync

ui5-middleware-iasync

library3.0.0-alpha.10jsnpmunverified

A UI5 CLI middleware that syncs browser interactions across multiple instances to ease manual testing. Current stable version is 3.0.0-alpha.10, released as an alpha with active community maintenance. It uses BrowserSync under the hood to transmit UI interactions via a WebSocket pool, and injects custom HTML to override UI5 control event handlers (e.g., Button click becomes tap). Requires @ui5/cli@3.0.0+ and specVersion "3.0". Key differentiators: browser interaction synchronization for UI5 apps, configurable port/debug/logging, and SSL support via https option.

testing

npm install ui5-middleware-iasync

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · UI5-MIDDLEWARE-IAS

ui5-middleware-iasync

testingjavascriptv3.0.0-alpha.10

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ui5-middleware-iasync

✓ // No code import needed; configured in ui5.yaml under customMiddleware

✗ Attempting to import like a library: import iasync from 'ui5-middleware-iasync'

This is a UI5 middleware extension, not a library. It is loaded by the UI5 server via YAML configuration.

Shows how to install and configure the middleware in a UI5 project's ui5.yaml. The middleware syncs interactions across browsers.

// Install the middleware npm install ui5-middleware-iasync --save-dev // In ui5.yaml: // server: // customMiddleware: // - name: ui5-middleware-iasync // beforeMiddleware: serveResources // configuration: // https: false // debug: false // logConnections: true // port: 4711 // Then run: ui5 serve

Debug

Known issues

breakingMiddleware v3 requires @ui5/cli@3.0.0+ and specVersion "3.0". Older UI5 CLI versions are incompatible.

fix

Upgrade UI5 CLI to v3 and set specVersion: "3.0" in your ui5.yaml.

affects: >=3.0.0

gotchaDue to manipulation of UI5 controls (e.g., Button click overwritten with tap), interactions may behave unexpectedly.

fix

Only use for manual testing; avoid relying on this middleware in production or critical testing scenarios.

affects: all

deprecatedVersion 3.x is currently alpha. API may change before stable release.

fix

Pin to a specific version and watch for breaking changes in future releases.

affects: 3.0.0-alpha.*

Errors

Common errors & fixes

Error: Cannot find module 'ui5-middleware-iasync'

Middleware not installed as devDependency or missing from node_modules.

fix

Run `npm install ui5-middleware-iasync --save-dev`.

Middleware ui5-middleware-iasync: beforeMiddleware not found: serveResources

The middleware's 'beforeMiddleware' references a non-existent middleware, often due to incorrect UI5 configuration.

fix

Ensure 'serveResources' is available or adjust the beforeMiddleware value in ui5.yaml.

Invalid configuration: port must be a number

Port value provided as string or omitted causing type error.

fix

Set port to an integer in the configuration: e.g., port: 4711

Upgrade

Version history

3.0.0-alpha.10latest on npm

Audit

Dependencies

@ui5/clirequiredPeer dependency: requires UI5 CLI V3 with specVersion "3.0"

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/ui5-community/ui5-ecosystem-showcase ↗

packageui5-middleware-iasync ↗

homepagehttps://github.com/ui5-community/ui5-ecosystem-showcase/tree/main/packages/ui5-middleware-iasync#readme ↗