parallel

parallel expressions allows you to do things in parallel, and then do things with their results.

A parallel expression is built up from multiple parts:

  • expressions or statements that return a Promise or a Result

  • an optional then branch

  • catch branches

  • an optional finally branch

An example:

parallel {
articles =
loadImages()
‚Äč
users =
loadUsers()
} then {
next {
articles = articles,
users = users,
}
} catch {
/* errors are catched here. */
} finally {
/* Clean things up here. */
}

Keep in mind that you need to handle all possible errors that can be returned from a statement, although the compiler has your back here and will show an error if you forget one.

The return value of a parallel expression is always a Promise(error, result) :

  • If the value of the then branch is a Promise then it will be returned as is

  • If the value of the then branch is not a Promise then it will return a promise which never fails Promise(Never, result) where the result is the value of the then branch

  • If there is no then branch then the return value is Promise(Never, Void)

A few notable things to keep in mind:

  • All of the catches must match the return value of the last statement

  • Results and unwrapped into variables

  • Promises are await -ed and unwrapped into variables