Catch
Used within the try tag. This tag is what allows us to define what to catch and even specify different behavior for different types of errors.
Children Tags
(sequence | parallel | for | parallelloop | switch | distribute | try | timer | if | local | component | fail | choices | while | assert | result | testsuite | testscript | testproperty | record | event | query | nextresult | resetcursor | iterate | compare | filter | sort | log | stats | function | call | sleep | property | replace | diffproperty | createrange | unset | sleep | echo | fail | break | log | cat | monitor_create | monitor_destroy | monitor_grep | monitor_diff | event | attribute | http_get | http_post | http_put | http_head | http_delete | http_request | http_server | http_response | urlencode | replace | add | mod | abs | subtract | multiply | divide | share_create | share_destroy | share_get | share_set | share_wait | rendezvous_create | rendezvous_destroy | rendezvous_check | rendezvous_visit | rendezvous_reset | printf | scanf | headergroup | cookiegroup | http_config | read_image | seleniumopen | openwindow | close | type | submit | runscript | select | selectframe | selectwindow | click | clickat | doubleclick | doubleclickat | draganddrop | draganddroptoobject | mousedown | mousedownat | mousemove | mousemoveat | mouseout | mouseover | mouseup | mouseupat | createcookie | deletecookie | answeronnextprompt | choosecancelonnextconfirmation | chooseokonnextconfirmation | altkeydown | altkeyup | controlkeydown | controlkeyup | shiftkeydown | shiftkeyup | metakeydown | metakeyup | keydown | keyup | refresh | goback | windowmaximize | getalert | getallbuttons | getallfields | getalllinks | getallwindowids | getallwindownames | getallwindowtitles | getattribute | getattributefromallwindows | getbodytext | getconfirmation | getcookie | getcursorposition | getelementheight | getelementindex | getelementpositionleft | getelementpositiontop | getelementwidth | geteval | getexpression | gethtmlsource | getlocation | getmousespeed | getprompt | getselectedid | getselectedids | getselectedindex | getselectedlabel | getselectedlabels | getselectedvalue | getselectedvalues | getselectoptions | gettable | gettext | gettitle | getvalue | getwhetherthisframematchframeexpression | getwhetherthiswindowmatchwindowexpression | getxpathcount | setcontext | setcursorposition | setextensionjs | setmousespeed | setspeed | settimeout | addselection | removeselection | removeallselections | check | uncheck | waitforcondition | waitforframetoload | waitforpagetoload | waitforpopup)
Optional Attributes
exception
Default to nothing which matches any and all exceptions. Otherwise defines the regular expression that will match with the expected exception name. This name is the full package of the exception like so: java.io.IOException
property
Default to nothing. Otherwise if specified this property will contain the message from the exception caught.
Usage Examples
Example #1
<try>
   
<sequence>
      
<echo>This will naturally succeed.</echo>
   
</sequence>
   
<catch exception="com.yahoo.dtf.exception.*">
      
<fail message="This part should never be executed." />
   
</catch>
</try>
Example #2
<try>
   
<catch exception="com.yahoo.dtf.exception.MySpecialException">
      
<fail message="This part should never be executed." />
   
</catch>
</try>