Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Performing actions before setup or after tear down

Use the IOuterUnityTestAction API to do work outside the test before setup and after tear down.
Read time 2 minutesLast updated 13 days ago
OuterUnityTestAction
 is a wrapper outside of the tests, which allows for any tests with this attribute to run code before and after the tests. This method allows for yielding commands in the same way as 
UnityTest
. The attribute must inherit the 
NUnit
attribute and implement 
IOuterUnityTestAction
.

OuterUnityTestAction example

using System.Collections;using NUnit.Framework;using NUnit.Framework.Interfaces;using UnityEngine;using UnityEngine.TestTools;public class MyTestClass{    [UnityTest, MyOuterActionAttribute]    public IEnumerator MyTestInsidePlaymode()    {        Assert.IsTrue(Application.isPlaying);        yield return null;    }}public class MyOuterActionAttribute : NUnitAttribute, IOuterUnityTestAction{    public IEnumerator BeforeTest(ITest test)    {        yield return new EnterPlayMode();    }    public IEnumerator AfterTest(ITest test)    {        yield return new ExitPlayMode();    }}

Execution order

Unity outer test action is not rerun on domain reload but non-Unity action attributes are:

The order of execution for outer test action callbacks, with those that re-run on domain reload differentiated from those that don't.

Test actions with domain reload example

using NUnit.Framework.Interfaces;public class TestActionOnSuiteAttribute : NUnitAttribute, ITestAction{    public void BeforeTest(ITest test)    {        Debug.Log("TestAction OnSuite BeforeTest");    }    public void AfterTest(ITest test)    {    }    public ActionTargets Targets { get { return ActionTargets.Suite; } }}public class TestActionOnTestAttribute : NUnitAttribute, ITestAction{    public void BeforeTest(ITest test)    {        Debug.Log("TestAction OnTest BeforeTest");    }    public void AfterTest(ITest test)    {        Debug.Log("TestAction OnTest AfterTest");    }    public ActionTargets Targets { get { return ActionTargets.Test; } }}public class OuterTestAttribute : NUnitAttribute, IOuterUnityTestAction{    public IEnumerator BeforeTest(ITest test)    {        Debug.Log("OuterTestAttribute BeforeTest");        yield return null;    }    public IEnumerator AfterTest(ITest test)    {        Debug.Log("OuterTestAttribute AfterTest");        yield return null;    }}[TestActionOnSuite]public class ActionOrderTestBase{    [Test, OuterTest, TestActionOnTest]       public void UnitTest()    {        Debug.Log("Test");    }    [UnityTest, OuterTest, TestActionOnTest]    public IEnumerator UnityTestWithDomainReload()    {        Log("Test part 1");        yield return new EnterPlayMode();         //Domain reload        yield return new ExitPlayMode();        Log("Test part 2");    }}

Additional resources