Basic Examples

Throw and catch a generic
Failure
:

ResourceFunction["CatchFailure"]
○
ThrowFailure
["There was an error!",myFunc];Print["goodbye"]
Failure

MessageTemplate: General::There was an error!
MessageParameters: {myFunc}
Tag: General
Out[]=

Throw and catch a
Failure
using the specified message template and tag:

ResourceFunction["CatchFailure"]
○
ThrowFailure
[myFunc::argx,Pi,2.9];Print["goodbye"]
Failure

Message:
π called with 2.9 arguments; 1 argument is expected.
Tag:
myFunc
Out[]=

Throw and catch
$Failed
:

ResourceFunction["CatchFailure"]
○
ThrowFailure
[];Print["goodbye"]
$Failed
Out[]=

Possible Issues

Calling
ThrowFailure
without an enclosing
CatchFailure
prints a message and returns
$Aborted
:

○
ThrowFailure
[]
In[]:=
General
:An unknown internal error occurred. Consult Internal`$LastInternalFailure for potential information.
$Aborted
Out[]=