org.robolectric.junit.rules

Class ExpectedLogMessagesRule

java.lang.Object

org.robolectric.junit.rules.ExpectedLogMessagesRule

All Implemented Interfaces:

org.junit.rules.TestRule

public final class ExpectedLogMessagesRule
extends java.lang.Object
implements org.junit.rules.TestRule

Allows tests to assert about the presence of log messages, and turns logged errors that are not explicitly expected into test failures.

Constructor Summary

Constructors

Constructor and Description
ExpectedLogMessagesRule()

Method Summary

Modifier and Type	Method and Description
org.junit.runners.model.Statement	apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)
void	expectErrorsForTag(java.lang.String tag) Blanket suppress test failures due to errors from a tag.
void	expectLogMessage(int level, java.lang.String tag, java.lang.String message) Adds an expected log statement.
void	ignoreMissingLoggedTags(boolean shouldIgnore) If set true, tests that call #expectErrorsForTag() but do not log errors for the given tag will not fail.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExpectedLogMessagesRule

public ExpectedLogMessagesRule()

Method Detail

apply

public org.junit.runners.model.Statement apply(org.junit.runners.model.Statement base,
                                               org.junit.runner.Description description)

Specified by:

apply in interface org.junit.rules.TestRule

expectLogMessage

public void expectLogMessage(int level,
                             java.lang.String tag,
                             java.lang.String message)

Adds an expected log statement. If this log is not printed during test execution, the test case will fail. Do not use this to suppress failures. Use this to test that expected error cases in your code cause log messages to be printed.

expectErrorsForTag

public void expectErrorsForTag(java.lang.String tag)

Blanket suppress test failures due to errors from a tag. If this tag is not printed at Log.ERROR during test execution, the test case will fail (unless #ignoreMissingLoggedTags() is used).

Avoid using this method when possible. Prefer to assert on the presence of a specific message using expectLogMessage(int, java.lang.String, java.lang.String) in test cases that intentionally trigger an error.

ignoreMissingLoggedTags

public void ignoreMissingLoggedTags(boolean shouldIgnore)

If set true, tests that call #expectErrorsForTag() but do not log errors for the given tag will not fail. By default this is false.

Avoid using this method when possible. Prefer tests that print (or do not print) log messages deterministically.