Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

5. Asserting and expecting logs

Test and verify code that writes to the console log.
Read time 2 minutesLast updated 13 days ago

Learning objectives

How to test and verify code that writes to the console log.

Intro and motivation

At Unity, we have many packages and modules that communicate with the user through logging messages and exceptions to the console log. This can be both for the normal workflows and for error cases.
We have extended the test framework to be aware of the console log. This means that by default, any error or exception that is logged while running a test will result in that test failing. If such failures are expected, then it is possible to use 
LogAssert.Expect(logtype, message)
to ensure that a given message is logged. This can be used to expect normal messages and warnings as well. The 
LogAssert.Expect
can be placed both before and after the message happens. When the test is done (or next time it yields), it will fail if the expected message is not present.
[Test]public void LogAssertExample(){ // Expect a regular log message LogAssert.Expect(LogType.Log, "Log message"); // The test fails without the following expected log message Debug.Log("Log message"); // An error log Debug.LogError("Error message"); // Without expecting an error log, the test would fail LogAssert.Expect(LogType.Error, "Error message");}
The 
LogAssert.Expect
also takes a regex as an argument, as sometimes it is not possible to know the precise string. For example, if the logged message has time duration in the string.

Exercise

In the sample 
5_AssertingLogs
there is a class called 
MyLoggingClass
.
The class has two methods with the following behavior:
  • DoSomething();
    logs the message "Doing something".
  • DoSomethingElse();
    logs an error "An error happened. Code: #" where # is a random number from 0 to 9.
Write tests that verify the above behavior using 
LogAssert.Expect
. You can experiment by seeing what happens if 
DoSomethingElse();
is called without the expect and what happens if you expect e.g. a message of type warning.

Hints

  • You will need to use a regular expression together with 
    LogAssert.Expect
    in order to expect the error message.
  • In Unity, there is a difference between a logged error and a logged exception.

Solution

A full solution to the exercise can be found in the sample 
5_AssertingLogs_Solution
.
One possible implementation of the tests is as follows:
[Test]public void DoSomethingLogsMessage(){ var loggingClassUnderTest = new MyLoggingClass();  loggingClassUnderTest.DoSomething();  LogAssert.Expect(LogType.Log, "Doing something");}[Test]public void DoSomethingElseLogsError(){ var loggingClassUnderTest = new MyLoggingClass();  loggingClassUnderTest.DoSomethingElse();  LogAssert.Expect(LogType.Error, new Regex("An error happened. Code: \\d"));}

Additional resources

API reference for 
LogAssert