System tests for web browser extension Javascript Restrictor (JSR) automatically checks how JSR affets tested websites.

It is necessary to partially set up manually a test environment before the first test run!

SET UP TEST ENVIRONMENT

Install required programs and tools

These programs and tools are required to be installed:

• Python 3.5+
• Python package numpy
• Python package selenium
• Visual C++ build tools - required by python-Levenshtein on Windows. More information.
• Python package python-Levenshtein
• Python package sklearn
• Python package nltk
• Nltk stopwords - install them by running the command python -m nltk.downloader stopwords
• Google Chrome - Install really Google Chrome, Chromium is not supported.

Download Selenium server

Download the Selenium server (Grid) standalone from the download page. Save it to the folder ./get_data/selenium/ with the name selenium-server-standalone.jar.

Download top sites list

Download the latest TRANCO top sites list from download page. Save it to folder ./get_data/top_sites/ with the name tranco.csv.

Download Chrome driver

Download Chrome driver from download page. Select the version coresponding to the version of your Google Chrome web browser. If you download an incompatible version, you will see an error during starting tests. Download the correct ChromeDriver to folder ../common_files/webbrowser_drivers with name chromedriver.exe (for Windows) or chromedriver (for Linux).

RUN TESTS

Open file ./get_data/configuration.py and check if all paths and other properities are right.

The results of system tests will be stored in folder ./data after finishing tests.

on Windows OS

Open PowerShell in folder system_tests and run command: .\setup_buildJSR_runTests.ps1.

When script execution starts for the first time, OS Windows may ask you to allow Firewall Exception for this script (for Python). Click Allow.

on Linux OS

Open Terminal in folder system_tests and run command: ./setup_buildJSR_runTests.sh