Enhanced error handling with error(True) to raise exception on error [done]

[kensoh]

user query from Telegram group chat on function hook error handling - https://t.me/rpa_chat/5886

---

Thanks for raising this! i open a new issue to explore this - #299

Will take some time, because I maintain the Python version in my personal free time. There are generally 2 ideas, 1 is a function hook. 1 is an option to raise error so that users can do a try-catch design.

For the time being, you can do -

if r.click() and r.type() and etc etc:
    print('SUCCESS')
   # do success actions

if not r.click() and not r.type() and ...:
    print('FAIL')
    # do fail actions

Above works because each function call will return True or False depending on whether it is successful.

You can also split into multiple lines if you want the Python script to be neater -

if r.click() and \
    r.type() and \
    ...:
    print('SUCCESS')

[kensoh]

Between the 2 ideas of having a function hook or raising exception for user-handling with try-catch, I would think the 2nd method is more accessible to users (more commonly known design pattern), and also gives more flexibility what to be done (calling some user-defined function, or do something else depending on the section of the script).

[kensoh]

Done in v1.47 and available with pip install rpa --upgrade

To handle errors during automation, use error(True) and Python try-except

1. Example to error-handle a specific step by checking value of Exception e

r.error(True)

try:
    r.click('element 1')
    r.dclick('element 2')
    r.type('element 3', 'abc')

except Exception as e:
    print(e) # show specific error message
    # do something to handle that error

2. Example to error-handle a series of steps without concern of failed step

r.error(True)

try:
    r.click('element 1')
    r.dclick('element 2')
    r.type('element 3', 'abc')

except:
    # the step that failed is not known
    # do something to deal with error

PS - default setting on initialising is error(False), so Python exceptions will not be raised on error