What is it
UIVeri5 is an E2E testing framework for UI5-based applications. It uses WebDriverJS to drive a real browser and interacts with your application as a real user would. UIVeri5 is heavily inspired by Protractor and brings most (and more) of its benefits to UI5 applications.
- Automatic synchronization with UI5 app rendering so there is no need to add waits and sleeps to your test. Tests are reliable by design.
- Tests are written in synchronous manner, no callbacks, no promise chaining so are really simple to write and maintain.
- Full power of webdriverjs, protractor and jasmine - deferred selectors, custom matchers, custom locators.
- Control locators (OPA5 declarative matchers) allow locating and interacting with UI5 controls.
- Does not depend on testability support in applications - works with autorefreshing views, resizing elements, animated transitions.
- Declarative authentications - authentication flow over OAuth2 providers, etc.
- Console operation, CI ready, fully configurable, no need for java (comming soon) or IDE.
- Covers full UI5 browser matrix: Chrome, Firefox, IE, Edge, Safari, iOS, Android.
- Open-source, modify to suite your specific neeeds.
- NodeJS, version 8.0 or higher
UIVeri5 accepts a declarative configuration in a conf.js file. Configuration could be overriten with command-line arguments. All configuration options are explained in Configuration
$ npm install @ui5/uiveri5 -g
Create a test
Create a clean folder that will contain your test and configuration files. UIVeri5 uses Jasmine as a test runner so the test resides in a spec.js file. Put the declarative configuration in the conf.js file.
exportsconfig =profile: 'integration'baseUrl: '';
Run the test
Open console in the test folder and execute:
You will see the test execution in the console and an overview when the test completes. Check the target folder for a visual report with screenshots.
By default uiveri5 will discover all tests in current folder and execute them on localy started Chrome. All of those defaults could be modified either in conf.js or by providing command-line arguments.
- Enable verbose logging
- Run tests on different browser
- Run tests against app deployed on a specific system
- Run tests against a remote selenium server
Learn how to build your tests in our Testing Guide.
No major bugs known.
See how we plan to continue in our TODO .
Here we gather few projects that build on UIVeri5 and tailor it for specific usecases.
- Docker container with UIVeri5, Chrome, Jenkins: Link
By default, when running locally, UIVeri5 downloads selenium.jar and/or the respective webdrivers - chromedriver, geckodriver,InternetExplorerDriver from their official locations. You can disable the downloading or change the locations in profile.conf.js. When using --seleniumAddress, nothing is downloaded.
Copyright (c) 2018 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file.