Robotframework-recorder

About

# Robot Framework Recorder

This open source Chrome/Chromium extension allows you to record clicks/keyboard entries/… within your browser, and export them as a Robot Framework script (supporting both the Browser and Selenium libraries, even if Selenium is more experimental), like:

```
*** Settings ***
Library    Browser

*** Test Cases ***
My first test
    New Browser    chromium    headless=false
    New Page  https://yourwebsite
    Click  [name='username']
    Fill Text  [name='username']  me
    Click  [name='password']
    Fill Text  [name='password']  my password
    Click  "Login"
```

Full instructions are described in the page of the project (https://github.com/leo-colisson/robotframework-recorder), but for readers in hurry, you can follow these steps:

1. Install this extension
2. Open DevTools (F12, or Ctrl-Shift-I, or via the menu…)
3. Go to the "Recorder" tab, if it does not appear you can also open it via the `3 dots > More tools > Recorder`.
4. Click "Create a new recording"
5. Give it a name, and we also **recommend to set `name` in the "selector attribute" field** to get more stable locator (see the "Know issues and workarounds" section below for details)
6. Click "Start recording"
7. Perform in the browser the actions you want to record (fill form, click buttons…)
8. Click "End recording"
9. You can then get the generated script either by clicking `Show Code` at the top right of the recording (to copy/paste), or via the `Export` button (to download a file). You have a list of available exporters, and this library adds (for now) 2 exporters:
   - `RobotFrameworkRecorder (Browser, no aria)`
   - `RobotFrameworkRecorder (Browser, aria as text)`
   - `RobotFrameworkRecorder (Selenium)`
   The first two exporters target the `Browser` library, the main differences between them is that the `aria as text` variant will try to generate when possible things like `Click  "your text"` instead of `Click  label:nth-of-type(1) > input`. This is of course more readable, but we sadly cannot guarantee here that the selector will always work (though it should fail quite rarely, see "Know issues and workarounds" for details). The exporter `RobotFrameworkRecorder (Selenium)` targets the `SeleniumLibrary` library. Since, to the best of our knowledge, it does not support selecting by text, only CSS and XPath selectors are supported.
   
This script can then simply be called by robot framework, after installing the corresponding library: robotframework-browser (https://robotframework-browser.org/) or SeleniumLibrary (https://robotframework.org/SeleniumLibrary/SeleniumLibrary.html).

Donations: https://github.com/sponsors/tobiasBora