unity-unitask-design

UniTask is a struct whose backing source is recycled after the first await, so awaiting the same variable twice throws InvalidOperationException. Call .Preserve() once to obtain a memoized copy that can be awaited multiple times, or invoke the async method again for a fresh UniTask.

Use this.GetCancellationTokenOnDestroy(), available on MonoBehaviour, GameObject, and Component, and pass the token into every async UniTask call. Plain C# classes must own and dispose their own CancellationTokenSource instead.

No. SwitchToThreadPool and UniTask.RunOnThreadPool throw NotSupportedException on WebGL because the platform is single-threaded. Guard such calls with #if UNITY_WEBGL && !UNITY_EDITOR and fall back to synchronous or Yield-based cooperative work.

Yield may resume on the same frame if awaited from an earlier PlayerLoop phase than the target timing, while NextFrame guarantees continuation on a subsequent frame. Use NextFrame to split work across frames and Yield(timing) to target a specific phase.

A returned UniTask that is neither awaited nor .Forget()ed drops its result, routing exceptions only to UniTaskScheduler.UnobservedTaskException. Always await the task or call .Forget() with an exception handler for fire-and-forget work.

Call .ToUniTask() on AsyncOperation, UnityWebRequestAsyncOperation, or a started Coroutine to get typed results, progress callbacks, and cancellation support. Plain await on an AsyncOperation compiles but skips progress and cancellation wiring.