testExpectMessage

Indicates that a message with the given @log_domain and @log_level, with text matching @pattern, is expected to be logged.

When this message is logged, it will not be printed, and the test case will not abort.

This API may only be used with the old logging API (func@GLib.log without G_LOG_USE_STRUCTURED defined). It will not work with the structured logging API. See logging.html#testing-for-messages.

Use func@GLib.test_assert_expected_messages to assert that all previously-expected messages have been seen and suppressed.

You can call this multiple times in a row, if multiple messages are expected as a result of a single call. (The messages must appear in the same order as the calls to func@GLib.test_expect_message.)

For example:

// g_main_context_push_thread_default() should fail if the
// context is already owned by another thread.
g_test_expect_message (G_LOG_DOMAIN,
                       G_LOG_LEVEL_CRITICAL,
                       "assertion*acquired_context*failed");
g_main_context_push_thread_default (bad_context);
g_test_assert_expected_messages ();

Note that you cannot use this to test func@GLib.error messages, since func@GLib.error intentionally never returns even if the program doesn’t abort; use func@GLib.test_trap_subprocess in this case.

If messages at flags@GLib.LogLevelFlags.LEVEL_DEBUG are emitted, but not explicitly expected via func@GLib.test_expect_message then they will be ignored.

Parameters