theia-browser

Eclipse Theia browser implementation for Eclipse Theia / Eclipse Che testers. Browser objects are responsible for Selenium WebDriver creation, loading locators and attaching to workspace. Currently two versions are primarily used @theia-extension-tester/che-browser and @theia-extension-tester/theia-browser.

Usage

Install via npm

npm install @theia-extension-tester/theia-browser

Install via yarn

yarn add @theia-extension-tester/theia-browser

This example demonstrates how to create Eclipse Theia browser.

import { TheiaBrowser, BrowserOptions, ITimeouts } from "@theia-extension-tester/theia-browser";
import { logging } from 'extension-tester-page-objects';

// It is recommended to use more specific browser mentioned above.
const browser = new TheiaBrowser("chrome"), {
    // Optional path to browser binary. 
    // If not specified PATH variable is used.
    browserLocation: "/path/to/browser",
    // Clean session after window is closed.
    cleanSession: true,
    // Optional path to Selenium WebDriver binary.
    // If not specified PATH variable is used.
    driverLocation: "/path/to/webdriver",
    // Selenium WebDriver log level.
    logLevel: logging.Level.INFO,
    // Timeouts used when testing.
    timeouts: {
        // Timeout after browser is attached to Eclipse Theia editor.
        implicit: 30000,
        // Timeout before browser is attached to the editor.
        pageLoad: 120000
    }
});

Then it is possible to start new session with:

await browser.start();

Wait until the workbench is loaded and the editor ready for use.

await browser.waitForWorkbench(myTimeout);

And to properly destroy running session use:

await browser.quit();