Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

LogExceptionsAndForget()

Configures the async method to log exceptions without an explicit result check.
Read time 1 minuteLast updated 11 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.CoreModule
public void LogExceptionsAndForget()

Remarks

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.

Examples

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;    }}