Awaitable.LogExceptionsAndForget

Description

Configures the async method to log exceptions without an explicit result check.

Use for fire and forget Awaitable methods to ensure that any exceptions are logged to the Unity Editor once the operation is complete. For example, you can use it to log exceptions to the Console for methods which Unity calls and you can't await.

Important: LogExceptionsAndForget does not modify the execution, cancellation, or lifetime of the Awaitable. It only logs exceptions that occur. Exiting Play mode or quitting the application does not automatically cancel Awaitables. Use appropriate cancellation (for example, destroy tokens or CancellationToken) to ensure operations terminate when objects are destroyed, Play mode ends, or the application quits. For more information, refer to Awaitable completion and continuation.

using UnityEditor;
using UnityEngine;

public class Sample
{
    [MenuItem("Test/AsyncTest")]
    static void MyAsyncTest()
    {
        MyAsyncMethod().LogExceptionsAndForget();
    }

    private static async Awaitable MyAsyncMethod()
    {
        await Awaitable.NextFrameAsync();

        // Cause NullReferenceException
        string[] array = null;
        int length = array.Length;
    }
}