theia-extension-tester
TypeScript icon, indicating that this package has built-in type declarations

0.1.4 • Public • Published

Theia Extension Tester

Theia Extension Tester is a package designed for testing graphical user interfaces of Theia/VS Code extensions integrated to Eclipse Che and other Eclipse Theia based editors.

Writing new user interface tests consists of using page objects which represent specific part of the editor user interface. Page objects are designed to follow VSCode Extension Tester page objects as close as possible. Therefore existing user interface tests for VS Code extensions can be reused fo Eclipse Theia based editors.

Installation process

The fastest way to get started is to install starter package theia-extension-tester through npm or yarn.

npm

To install package with npm execute npm install theia-extension-tester --save-dev.

yarn

To install package using yarn execute yarn add theia-extension-tester --dev.

Selenium WebDriver

The project is using Selenium WebDriver library underneath. The library requires user to download specific Selenium WebDriver from web browser vendor. This step has not been automatized yet so it must be completed manually. Some of the most used Selenium WebDriver can be found in the following table:

Browser name Location
Chromium https://chromedriver.chromium.org/
Firefox https://github.com/mozilla/geckodriver/releases
Microsoft Edge https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/

After downloading and extracting any Selenium WebDriver make it executable by executing chmod 755 <webdriver binary> in command line. The driver does not have to be placed in PATH variable.

Getting started

After successful installation of the package and Selenium WebDriver minor configuration steps are required to be performed which depend on selected editor:

Migration from VSCode Extension Tester limitation

Some features and page objects are not fully compatible in term of user interface with Eclipse Theia based editors. Also some tests may libraries such as fs, child_process and other system specific libraries. It is advised not to use system libraries when testing VS Code extensions to make tests less dependent on system / editor.

Versioning

This project follows Semantic Versioning 2.0.0 but until the project reaches 100% compatibility with VSCode Extension Tester it will stay on 0.y.z and every change should be taken as breaking.

Package Sidebar

Install

npm i theia-extension-tester

Weekly Downloads

1

Version

0.1.4

License

Apache-2.0

Unpacked Size

63.4 kB

Total Files

18

Last publish

Collaborators

  • mlorinc