View Source Phoenix.LiveView.AsyncResult (Phoenix LiveView v1.0.0-rc.0)

Provides a data structure for tracking the state of an async assign.

See the Async Operations section of the Phoenix.LiveView docs for more information.

Fields

  • :ok? - When true, indicates the :result has been set successfully at least once.
  • :loading - The current loading state
  • :failed - The current failed state
  • :result - The successful result of the async task

Summary

Functions

Updates the failed state.

Creates an async result in loading state.

Updates the loading state.

Updates the loading state of an existing async_result.

Creates a successful result.

Updates the successful result.

Functions

Updates the failed state.

When failed, the loading state will be reset to nil. If the result was previously ok?, both result and failed will be set.

Examples

iex> result = AsyncResult.loading()
iex> result = AsyncResult.failed(result, {:exit, :boom})
iex> result.failed
{:exit, :boom}
iex> result.loading
nil

Creates an async result in loading state.

Examples

iex> result = AsyncResult.loading()
iex> result.loading
true
iex> result.ok?
false

Updates the loading state.

When loading, the failed state will be reset to nil.

Examples

iex> result = AsyncResult.loading(%{my: :loading_state})
iex> result.loading
%{my: :loading_state}
iex> result = AsyncResult.loading(result)
iex> result.loading
true
Link to this function

loading(result, loading_state)

View Source

Updates the loading state of an existing async_result.

When loading, the failed state will be reset to nil. If the result was previously ok?, both result and loading will be set.

Examples

iex> result = AsyncResult.loading()
iex> result = AsyncResult.loading(result, %{my: :other_state})
iex> result.loading
%{my: :other_state}

Creates a successful result.

The :ok? field will also be set to true to indicate this result has completed successfully at least once, regardless of future state changes.

Examples

iex> result = AsyncResult.ok("initial result")
iex> result.ok?
true
iex> result.result
"initial result"

Updates the successful result.

The :ok? field will also be set to true to indicate this result has completed successfully at least once, regardless of future state changes.

When ok'd, the loading and failed state will be reset to nil.

Examples

iex> result = AsyncResult.loading()
iex> result = AsyncResult.ok(result, "completed")
iex> result.ok?
true
iex> result.result
"completed"
iex> result.loading
nil