Article - How Squish looks up Real Names from Symbolic Names

Skip to end of metadata
Go to start of metadata

Table of Contents

Real Names

  • Real names always start and end with a curly brace, for example "{type='CMainWindow' visible='1' windowTitle='xyz'}".
  • Real names contain the type and any number of properties and their values of the object that they are meant to identify; so "{type='CMainWindow' visible='1' windowTitle='xyz'}" describes an object of type "CMainWindow", which must be visible and which has a window title of "xyz".
  • You can assemble real names at script runtime easily and without limitation.
  • Real name inside of a test script:
test.js

Symbolic Names

  • Symbolic names always have a colon as first character, for example ":xyz_CMainWindow".
  • Symbolic names are always only ever used to look up their associated real names in the object map. Once the real name has been looked up it is being used to find the object (and not the symbolic name!).
  • If a symbolic name cannot be found in the object map a runtime error will occur.
  • The contents of symbolic names are without any meaning (!). Their only purpose is to uniquely identify an entry/line inside the file "<TEST_SUITE_DIR>/objects.map".
  • You can assemble symbolic names at script runtime, but the assembled symbolic object name must already exist in the object map file (!).
  • Symbolic name inside of a test script:
test.js

Example "<SQUISH_DIR>/objects.map" content with an entry for ":xyz_CMainWindow":

:xyz_CMainWindow	{type='CMainWindow' visible='1' windowTitle='xyz'}

Object lookup from symbolic name to real name to GUI object

Related Information

Labels:
object object Delete
symbolic symbolic Delete
names names Delete
real real Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.