Bitmap checkpoints

Relevant for: GUI tests and components

UFT enables you to check that the visible parts of your application are displayed correctly by comparing bitmaps of objects in your application to bitmaps captured previously and stored with the test or component.

You can create bitmap checkpoints for all supported testing environments (as long as the appropriate add-ins are loaded).

Bitmap checkpoints enable you to do the following:

  • Compare an entire object or areas within an object. For example, suppose you have a Web site that can display a map of a city that the user specifies. The map has control keys for zooming. You can zoom in on a map, and then insert a bitmap checkpoint on the zoomed-in map to check that the map zooms in correctly.

  • Locate a specified image within an object. For example, suppose you want to check that your company logo is displayed on your Web page. You can either select the logo in the actual Web page, or load a bitmap file containing the logo from your computer.

When you create a bitmap checkpoint, UFT captures the visible part of the specified object as a bitmap and inserts a checkpoint in the test or component. (UFT does not capture any part that is scrolled off the screen, or hidden by another object, for example.)

You can specify areas of the object to ignore or include in the checkpoint. For example, if your Web page includes a dynamic counter that may cause the checkpoint to fail, you can instruct UFT to ignore it during the run session by excluding the area in which it is located from the comparison.

When you run the test or component, UFT captures a bitmap of the actual object in the application and compares this runtime bitmap (or the selected areas within it) with the bitmap stored in the checkpoint. You can fine-tune this comparison by defining tolerance settings in the checkpoint. For details, see Fine-tuning the bitmap comparison.

If there are differences, UFT saves the runtime bitmap and displays it next to the expected bitmap in the run results. You can also view a bitmap that reflects the difference between the two bitmaps, to assist you in identifying the nature of the discrepancy.