From 43fe98eda8ff1f1b45b4fb62c0755c892cb0c247 Mon Sep 17 00:00:00 2001 From: Farhanah Sheets Date: Thu, 3 May 2018 10:27:21 -0400 Subject: [PATCH] Add VNC info to testing docs --- docs/testing.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/testing.rst b/docs/testing.rst index 731d84614b..dd63e242e5 100644 --- a/docs/testing.rst +++ b/docs/testing.rst @@ -139,6 +139,28 @@ Note - paver -h +Connecting to Browser +~~~~~~~~~~~~~~~~~~~~~ + +If you want to see the browser being automated for JavaScript or bok-choy tests, +you can connect to the container running it via VNC. + ++------------------------+----------------------+ +| Browser | VNC connection | ++========================+======================+ +| Firefox (Default) | vnc://0.0.0.0:25900 | ++------------------------+----------------------+ +| Chrome (via Selenium) | vnc://0.0.0.0:15900 | ++------------------------+----------------------+ + +On macOS, enter the VNC connection string in Safari to connect via VNC. The VNC +passwords for both browsers are randomly generated and logged at container +startup, and can be found by running ``make vnc-passwords``. + +Most tests are run in Firefox by default. To use Chrome for tests that normally +use Firefox instead, prefix the test command with +``SELENIUM_BROWSER=chrome SELENIUM_HOST=edx.devstack.chrome``. + Running Python Unit tests -------------------------