Contact Free trial Login

fail

fail(String): Nothing

Produces a failure with the specified message.

Parameters

Name Description

message

An error message (String).

Example

This example returns a failure message Data was empty instead of the desiredResult ([1,2,3]) because the expression (sizeOf(emptyArray) ⇐ 0) is true.

Source

%dw 2.0
import * from dw::Runtime
var emptyArray = []
var desiredResult = [1,2,3]
output application/json
---
if(sizeOf(emptyArray) <= 0) fail('Data was empty') else desiredResult

Output

Data was empty
Trace:
  at fail (Unknown)
  at main (line: 6, column: 25)

In the Studio console component, the output looks something like this:

ERROR 2018-07-29 11:47:44,983 ...
*********************************
Message               : "Data was empty
...