This directory contains semi-automated tests of Chrome with NVDA (NonVisual Desktop Access), a popular open-source screen reader for visually impaired users on Windows. It works by launching Chrome in a subprocess, then launching NVDA in a special environment that simulates speech rather than actually speaking, and ignores all events coming from processes other than a specific Chrome process ID. Each test automates Chrome with a series of actions and asserts that NVDA gives the expected feedback in response.

Instructions for running these tests:

1. Install Python 2.7, 32-bit: http://www.python.org/

   Note - the version of Python installed by Chrome's depot_tools will not work, it's 64-bit.

2. Download pywinauto here: https://code.google.com/p/pywinauto/downloads/list

   Unzip it, then install it by running this from a cmd shell in that directory: python setup.py install

   If you get an error, make sure you're using the 32-bit version of Python.

3. Install the latest NVDA "next" snapshot from: http://community.nvda-project.org/wiki/Snapshots

   In the installer, choose "Create Portable copy" rather than "Install...". From the Browse dialog, create an new folder called nvdaPortable inside this folder.

   Note: after NVDA 2014.3 stable is released, just use the stable version instead, from http://www.nvaccess.org/download/

   • if you do this, you need to run NVDA, then from the NVDA menu, choose Tools > Create Portable Copy. From the Browse dialog, create an new folder called nvdaPortable inside this folder. You should now have something like this: d:\src\nvda_chrome_tests\nvdaPortable\nvda.exe You can now exit NVDA.

4. Install Chrome Canary. The binary is typically installed in: c:\Users\USERNAME\AppData\Local\Google\Chrome SxS\Application\chrome.exe ...if not, edit nvda_chrome_tests.py to point to it.

5. Clone the nvda-proctest environment into this directory: git clone https://bitbucket.org/nvaccess/nvda-proctest.git

6. Run the tests:

   First make sure NVDA is not already running.

   Open a cmd console, change to the nvda_chrome_tests directory, and run: python nvda_chrome_tests.py

   If you get an error, open the Windows task manager and make sure NVDA isn't running, kill it if necessary.