Basil Language Documentation

Basil (Browser Automation Script Intermediary Language) is a programming language for creating web browser automation tests.

Basil defines:

• actions to be performed to get a browser into a desired state
• assertions to verify the browser state
• steps, tests and test suites to arrange collections of actions and assertions
• page models to de-couple tests from the pages being tested
• data providers to de-couple parameterised tests from the data driving them

Goals:

• concise when compared to equivalent WebDriver-powered code
• human-readable, understandable by non-developers
• transpilable to a target language for execution

Tutorial

• Tutorial Overview
• Get To Know the Terminology
• Creating a Test
• Understanding Actions and Assertions
• Importing Steps Into Your Test
• Creating a Page Model
• Creating and Using Parameterised Tests
• Using a Data Provider
• Using Test Suites
• Using Environment Variables

Examples

• Examples Overview
• Simple Test
• Simple Test With Descendant Selectors
• Import a Step Into a Test
• Define Page Properties in a Page Model
• Parameterise a Test
• Test Suite
• Define Data Externally In a Data Provider
• Using Data Within Environment Variables

Reference

• Variable Types
• Browser Properties
• Page Properties
• Environment Variables
• Parameters

Syntax

• Syntax Notation
• Actions
• Assertions
• Identifiers
• Selectors
• Descendant Selectors
• Page Model
• Test Steps
• Tests
• Tests Suites
• Data Providers