Running a Test Plan

Guidance

• Only use commands defined in the test case procedures.
• Copy all speech output after pressing the "Run Test Settings" button in the test window.
• Copy text from the relevant speech history feature of the screen reader, rather than trying to recreate what the synthesizer actually says.
• Output not related to the assertions should be identified as an "additional undesirable behaviors".

Copying Screen Reader Output

JAWS

You can use the Speech History function built into JAWS during a test. The recommended process is as follows:

1. Press the "Run Test Setup" button at the bottom of the test page.
2. Clear the existing JAWS speech history by pressing Insert+Space followed by Shift+H.
3. Carry out the exact command or command sequence indicated for the test.
4. Copy the JAWS speech history to the clipboard by pressing Insert+Space followed by Control+H.

NVDA

NVDA includes a built-in Speech Viewer from which you can copy spoken output. However, you may find it more convenient to use the Speech History add-on during testing, as it includes a speech recording function driven by convenient hotkeys.

Speech Viewer

If using the NVDA Speech Viewer during a test, the recommended process is as follows:

1. Ensure that the NVDA Speech Viewer is closed by toggling it off in the NVDA menu -> Tools.
2. Press the "Run Test Setup" button at the bottom of the test page.
3. Toggle the Speech Viewer on using the same item in the Tools menu.
4. Carry out the exact command or command sequence indicated for the test.
5. Press Alt+Shift+Tab to reach the Speech Viewer window, or click inside it.
6. Copy the relevant output to the clipboard from the Speech Viewer's read-only text area.

Speech History

If the Speech History add-on isn't currently installed, you can obtain it from the "Available add-ons" tab of the Add-On Store (reachable via the NVDA menu under "Tools").

If you prefer to install it manually, download the latest NVDA add-on package from the Speech History releases page.

Once installed, the recommended process is as follows:

1. Press the "Run Test Setup" button at the bottom of the test page.
2. Activate speech recording by pressing Insert+Shift+F11.
3. Carry out the exact command or command sequence indicated for the test.
4. End speech recording by pressing Insert+Shift+F12, which will copy the captured speech output to the clipboard.

Note that the referenced shortcuts can be changed under the NVDA menu -> Preferences -> Input gestures... -> Speech category.

VoiceOver

The Control+Option+Shift+C command built into VoiceOver only copies the last spoken utterance to the clipboard. As such, the VoiceOver Recorder application developed as part of the ARIA-AT project is recommended as a more convenient alternative.

To build and install it, follow the instructions in the README of the linked GitHub repository. Once the application is successfully running, the recommended process is as follows:

1. Press the "Run Test Setup" button at the bottom of the test page.
2. Activate speech recording by pressing Command+Shift+R.
3. Carry out the exact command or command sequence indicated for the test.
4. End speech recording by pressing Command+Shift+R again, which will copy the captured speech output to the clipboard.