async-execution.md

layout	title
default	Async Execution

Async Execution

{: .no_toc }

1. TOC {:toc}

Failsafe-go can execute a func asynchronously via a goroutine. Async executions return an [ExecutionResult] which can be used to detect when the execution is done and get the result or error, waiting if needed.

Executing a func asynchronously with a policy is simple:

// Run with retries asynchronously
result := failsafe.RunAsync(SendMessage, retryPolicy)
err := result.Error()

// Get with retries asynchronously
result := failsafe.GetAsync(Connect, retryPolicy)
connection, err := result.Get()

The Error() and Get() methods block until the execution is done. You can also use IsDone() or the Done() channel to detect when the execution is done:

select {
case <-result.Done():
  connection, err := result.Get()
}

{% include common-links.html %}