User Guide
The Squish User's Guide explains the most commonly used Squish features and provides examples of using Squish.
Most of the User Guide is devoted to Squish's scripting support, the different scripting languages Squish supports, and the script APIs which are available when working with test scripts. Many examples are presented to show how to do things in practice. For a complete reference to the Squish APIs see the API Reference and for coverage of Squish's tools see the Tools Reference and the IDE Reference.
Unicode UTF-8 File Encoding
The Squish IDE loads and saves test scripts (e.g., files with names matching test.*
), as Unicode text using the UTF-8 encoding. All the Squish tools assume that UTF-8 is used for all the scripts they execute. See the Editor view. If you don't edit your test scripts using the Squish IDE, make sure that the editor you use loads and saves the scripts using UTF-8; or, if your editor is not Unicode-capable, then the most sensible alternative is to restrict your code to 7-bit ASCII—which all modern editors support—since this is a subset of UTF-8.
Some characters, most notably double quotes ("
) and backslashes (\
), must be quoted in string literals. For example, "C:\\My Documents"
. This requirement is shared by all the scripting languages that Squish supports.
How Tos
- How to Identify and Access Objects
- How to Use the Qt API
- How to Use the Web API
- How to Find and Query Web Objects
- How to Use XPath
- How to Access Web Object Properties
- How to Call Web Object Functions
- How to Use evalJS
- How to Use retrieveJSObject
- How to Use the Web Convenience API
- How to Synchronize Web Page Loading for Testing
- How to Test Web Elements
- How to Do Web Application Load Testing
- How to Use the Java API
- How to Use the Windows nativeObject API
- How to Use the Tk API
- How to Use the Android API
- How to Use the iOS API
- How to Use Test Statements
- How to Use Event Handlers
- How to Create and Use Synchronization Points
- How to Test Multiple AUTs from a Single Test Script, Using ApplicationContext
- How to Automate Native Browser Dialogs, ActiveX, and more
- How to Create Semi-Automatic Tests that Query for User Input
- How to Create Automatic Screenshots on Test Failures and Errors
- How to Do Keyword-Driven Testing
- How to Interact with Files and with the Environment in Test Scripts
- How to Access Databases from Squish Test Scripts
- How to Handle Exceptions Raised in Test Scripts
- How to Modify Squish Functions
- How to Edit and Debug Test Scripts
- How to Create and Use Verification Points
- How to Create and Use Shared Data and Shared Scripts
- How to Do Image-Based Testing
- How to Communicate With CAN bus Devices
- How to Do Automated Batch Testing
- How to Create and Access Application Bindings
- How to Create Cross-Platform Tests
- How to Analyze Test Results