Scope and downloads

This assumes that you’ve set up your web application and that there is an SeLite framework for it. You’ll need packages mentioned at Overview > Install. If you haven’t downloaded SeLite Components yet, getting them from source (which you’ll need anyway) may be faster.

Regardless of how you install Components, either

If your web application uses SQLite, you’ll get full SeLite functionality and smoother script data life cycle. You’ll be able to copy/restore appDB, scriptDB and vanillaDB from within SeLite (via SettingsInterface). Otherwise you need to apply DataImport.

The following instructions are generic. For any application-specific steps see documentation of the respective framework.


Areas, methods and stages of configuration

You need to configure two main areas

There are two methods for this. The simpler one manages it through text file(s), as per SettingsManifests > Values manifests. Such configuration is easier to share and replicate than one administered through GUI. It also involves less steps and only one stage. You can still use GUI to review effect of values manifests (though it involves some extra steps).

An alternative method is Firefox profile-based configuration set(s), controlled through GUI. It can also override any values manifests. It’s done through SettingsManifests > Associations manifests. However, using GUI (for any part of configuration) usually requires the whole configuration to be in two stages.

Configure loading the framework

Through values manifests

This is already done for scripts that come with SeLite frameworks. If you’re using one of those frameworks, you can copy its values manifest SeLiteSettingsValues.txt. Otherwise create it as a plain text file. Either way, you then need to adjust/enter value of field extensions.selite-settings.common.bootstrappedCoreExtensions, so it points to location of the framework Javascript file. See also SettingsManifests > Values manifests and SettingsManifests > Literals for special values.

Through GUI

See SettingsInterface > Managing mode. Select ‘Add a new value’ next to bootstrapCoreExtensions. Point it to where you downloaded the framework JS file.

Edit or review configuration of the framework

Edit through values manifests

Add values for applicable following fields and for any custom fields/keys to SeLiteSettingsValues.txt from the above

extensions.selite-settings.common.roles:abc pqrs
extensions.selite-settings.common.roles:def ijkl

See descriptions below.

Edit or review through GUI

This has a dual purpose: to maintain profile-based configuration set(s), and to review effect of configuration set(s) or values manifest(s). If you want to use configuration set(s), create them if you haven’t done so (see above).

Before you use GUI, you need to load the bootstrapped framework. Start Selenium IDE and run any single command, e.g. getEval | true. That has effect only for the current run of Firefox (so next time you start the browser you’ll need to repeat it in order to use GUI). Then you can configure roles and any framework-specific fields.

If you’d like to review configuration, open chrome:// URL chrome://selite-settings/content/tree.xul?selectFolder (or chrome://selite-settings/content/tree.xul?folder=/full/path/to/folder).

If you’d like to edit profile-based configuration set(s), open chrome://selite-settings/content/tree.xul. Then follow SettingsInterface and edit the following fields (if they apply to your framework):

Run scripts

Unless you are using GUI to maintain or review configuration, you can run scripts (cases or suites) right after you start Selenium IDE. You don’t need to run any single Selenese command first.

Locate, open and run a suite as per PackagedScripts.

No hot switching between frameworks

If you have two or more frameworks, don’t switch between them during the same Firefox run. You need to restart Firefox (not just Selenium IDE). Reasons: