fl_accessibility_handler_test.cc File Reference

#include <atk/atk.h>
#include "flutter/shell/platform/linux/fl_accessibility_handler.h"
#include "flutter/shell/platform/linux/fl_binary_messenger_private.h"
#include "flutter/shell/platform/linux/fl_engine_private.h"
#include "flutter/shell/platform/linux/fl_view_private.h"
#include "flutter/shell/platform/linux/testing/fl_mock_binary_messenger.h"
#include "flutter/shell/platform/linux/testing/fl_test_gtk_logs.h"
#include "flutter/testing/testing.h"
#include "gmock/gmock.h"
#include "gtest/gtest.h"

Go to the source code of this file.

Enumerations
enum	FlAtkLive {   FL_ATK_LIVE_NONE ,   FL_ATK_LIVE_POLITE ,   FL_ATK_LIVE_ASSERTIVE }

Functions
static void	announcement_cb (FlViewAccessible *accessible, const gchar *message, gpointer user_data)
static void	notification_polite_cb (FlViewAccessible *accessible, const gchar *message, FlAtkLive politeness, gpointer user_data)
static void	notification_assertive_cb (FlViewAccessible *accessible, const gchar *message, FlAtkLive politeness, gpointer user_data)
static gboolean	atk_supports_announce ()
static void	subscribe_signal (FlViewAccessible *accessible, gboolean *signalled, gboolean assertive)
	TEST (FlAccessibilityHandlerTest, Announce)
	TEST (FlAccessibilityHandlerTest, AnnounceAssertive)
	TEST (FlAccessibilityHandlerTest, AnnounceUnknownView)
	TEST (FlAccessibilityHandlerTest, UnknownType)

Variables
static constexpr int64_t	kTextDirectionLtr = 0
static constexpr int64_t	kAssertivenessAssertive = 1

Enumeration Type Documentation

FlAtkLive

enum FlAtkLive

Enumerator
FL_ATK_LIVE_NONE
FL_ATK_LIVE_POLITE
FL_ATK_LIVE_ASSERTIVE

Definition at line 27 of file fl_accessibility_handler_test.cc.

             {
  FL_ATK_LIVE_NONE,
  FL_ATK_LIVE_POLITE,
  FL_ATK_LIVE_ASSERTIVE
} FlAtkLive;

Function Documentation

announcement_cb()

static void announcement_cb ( FlViewAccessible *  accessible, const gchar *  message, gpointer  user_data  )

static

Definition at line 33 of file fl_accessibility_handler_test.cc.

                                                {
  EXPECT_STREQ(message, "MESSAGE");
  gboolean* signalled = static_cast<gboolean*>(user_data);
  *signalled = TRUE;
}

References message, TRUE, and user_data.

Referenced by subscribe_signal().

atk_supports_announce()

static gboolean atk_supports_announce ( )

static

Definition at line 61 of file fl_accessibility_handler_test.cc.

                                        {
  return atk_get_major_version() == 2 && atk_get_minor_version() >= 46;
}

Referenced by subscribe_signal(), TEST(), and TEST().

notification_assertive_cb()

static void notification_assertive_cb ( FlViewAccessible *  accessible, const gchar *  message, FlAtkLive  politeness, gpointer  user_data  )

static

Definition at line 51 of file fl_accessibility_handler_test.cc.

                                                          {
  EXPECT_STREQ(message, "MESSAGE");
  EXPECT_EQ(politeness, FL_ATK_LIVE_ASSERTIVE);
  gboolean* signalled = static_cast<gboolean*>(user_data);
  *signalled = TRUE;
}

References FL_ATK_LIVE_ASSERTIVE, message, TRUE, and user_data.

Referenced by subscribe_signal().

notification_polite_cb()

static void notification_polite_cb ( FlViewAccessible *  accessible, const gchar *  message, FlAtkLive  politeness, gpointer  user_data  )

static

Definition at line 41 of file fl_accessibility_handler_test.cc.

                                                       {
  EXPECT_STREQ(message, "MESSAGE");
  EXPECT_EQ(politeness, FL_ATK_LIVE_POLITE);
  gboolean* signalled = static_cast<gboolean*>(user_data);
  *signalled = TRUE;
}

References FL_ATK_LIVE_POLITE, message, TRUE, and user_data.

Referenced by subscribe_signal().

subscribe_signal()

static void subscribe_signal ( FlViewAccessible *  accessible, gboolean *  signalled, gboolean  assertive  )

static

Definition at line 65 of file fl_accessibility_handler_test.cc.

                                                 {
  if (!atk_supports_announce()) {
    return;
  }
 
  if (atk_get_major_version() == 2 && atk_get_minor_version() < 50) {
    g_signal_connect(accessible, "announcement", G_CALLBACK(announcement_cb),
                     signalled);
  } else {
    g_signal_connect(accessible, "notification",
                     G_CALLBACK(assertive ? notification_assertive_cb
                                          : notification_polite_cb),
                     signalled);
  }
}

References accessible, announcement_cb(), atk_supports_announce(), notification_assertive_cb(), and notification_polite_cb().

Referenced by TEST(), TEST(), TEST(), and TEST().

TEST() [1/4]

TEST	(	FlAccessibilityHandlerTest	,
		Announce
	)

Definition at line 83 of file fl_accessibility_handler_test.cc.

                                           {
  flutter::testing::fl_ensure_gtk_init();
 
  g_autoptr(FlMockBinaryMessenger) messenger = fl_mock_binary_messenger_new();
  g_autoptr(FlEngine) engine =
      fl_engine_new_with_binary_messenger(FL_BINARY_MESSENGER(messenger));
  FlView* view = fl_view_new_for_engine(engine);
 
  gboolean signalled = FALSE;
  subscribe_signal(fl_view_get_accessible(view), &signalled, FALSE);
 
  g_autoptr(FlValue) message = fl_value_new_map();
  fl_value_set_string_take(message, "type", fl_value_new_string("announce"));
  g_autoptr(FlValue) data = fl_value_new_map();
  fl_value_set_string(message, "data", data);
  fl_value_set_string_take(data, "viewId",
                           fl_value_new_int(fl_view_get_id(view)));
  fl_value_set_string_take(data, "message", fl_value_new_string("MESSAGE"));
  fl_value_set_string_take(data, "textDirection",
                           fl_value_new_int(kTextDirectionLtr));
 
  gboolean called = FALSE;
  fl_mock_binary_messenger_send_standard_message(
      messenger, "flutter/accessibility", message,
      [](FlMockBinaryMessenger* messenger, FlValue* response,
         gpointer user_data) {
        EXPECT_EQ(fl_value_get_type(response), FL_VALUE_TYPE_NULL);
        gboolean* called = static_cast<gboolean*>(user_data);
        *called = TRUE;
      },
      &called);
  EXPECT_TRUE(called);
  if (atk_supports_announce()) {
    EXPECT_TRUE(signalled);
  }
 
  fl_binary_messenger_shutdown(FL_BINARY_MESSENGER(messenger));
}

References atk_supports_announce(), data, engine, fl_binary_messenger_shutdown(), fl_engine_new_with_binary_messenger(), flutter::testing::fl_ensure_gtk_init(), fl_mock_binary_messenger_new(), fl_mock_binary_messenger_send_standard_message(), fl_value_get_type(), fl_value_new_int(), fl_value_new_map(), fl_value_new_string(), fl_value_set_string(), fl_value_set_string_take(), FL_VALUE_TYPE_NULL, fl_view_get_accessible(), fl_view_get_id(), fl_view_new_for_engine(), g_autoptr(), kTextDirectionLtr, message, subscribe_signal(), TRUE, user_data, and view.

TEST() [2/4]

TEST	(	FlAccessibilityHandlerTest	,
		AnnounceAssertive
	)

Definition at line 122 of file fl_accessibility_handler_test.cc.

                                                    {
  flutter::testing::fl_ensure_gtk_init();
 
  g_autoptr(FlMockBinaryMessenger) messenger = fl_mock_binary_messenger_new();
  g_autoptr(FlEngine) engine =
      fl_engine_new_with_binary_messenger(FL_BINARY_MESSENGER(messenger));
  FlView* view = fl_view_new_for_engine(engine);
 
  gboolean signalled = FALSE;
  subscribe_signal(fl_view_get_accessible(view), &signalled, TRUE);
 
  g_autoptr(FlValue) message = fl_value_new_map();
  fl_value_set_string_take(message, "type", fl_value_new_string("announce"));
  g_autoptr(FlValue) data = fl_value_new_map();
  fl_value_set_string(message, "data", data);
  fl_value_set_string_take(data, "viewId",
                           fl_value_new_int(fl_view_get_id(view)));
  fl_value_set_string_take(data, "message", fl_value_new_string("MESSAGE"));
  fl_value_set_string_take(data, "textDirection",
                           fl_value_new_int(kTextDirectionLtr));
  // Add optional assertiveness (not used in ATK)
  fl_value_set_string_take(data, "assertiveness",
                           fl_value_new_int(kAssertivenessAssertive));
 
  gboolean called = FALSE;
  fl_mock_binary_messenger_send_standard_message(
      messenger, "flutter/accessibility", message,
      [](FlMockBinaryMessenger* messenger, FlValue* response,
         gpointer user_data) {
        EXPECT_EQ(fl_value_get_type(response), FL_VALUE_TYPE_NULL);
        gboolean* called = static_cast<gboolean*>(user_data);
        *called = TRUE;
      },
      &called);
  EXPECT_TRUE(called);
  if (atk_supports_announce()) {
    EXPECT_TRUE(signalled);
  }
 
  fl_binary_messenger_shutdown(FL_BINARY_MESSENGER(messenger));
}

References atk_supports_announce(), data, engine, fl_binary_messenger_shutdown(), fl_engine_new_with_binary_messenger(), flutter::testing::fl_ensure_gtk_init(), fl_mock_binary_messenger_new(), fl_mock_binary_messenger_send_standard_message(), fl_value_get_type(), fl_value_new_int(), fl_value_new_map(), fl_value_new_string(), fl_value_set_string(), fl_value_set_string_take(), FL_VALUE_TYPE_NULL, fl_view_get_accessible(), fl_view_get_id(), fl_view_new_for_engine(), g_autoptr(), kAssertivenessAssertive, kTextDirectionLtr, message, subscribe_signal(), TRUE, user_data, and view.

TEST() [3/4]

TEST	(	FlAccessibilityHandlerTest	,
		AnnounceUnknownView
	)

Definition at line 164 of file fl_accessibility_handler_test.cc.

                                                      {
  flutter::testing::fl_ensure_gtk_init();
 
  g_autoptr(FlMockBinaryMessenger) messenger = fl_mock_binary_messenger_new();
  g_autoptr(FlEngine) engine =
      fl_engine_new_with_binary_messenger(FL_BINARY_MESSENGER(messenger));
  FlView* view = fl_view_new_for_engine(engine);
 
  gboolean signalled = FALSE;
  subscribe_signal(fl_view_get_accessible(view), &signalled, FALSE);
 
  g_autoptr(FlValue) message = fl_value_new_map();
  fl_value_set_string_take(message, "type", fl_value_new_string("announce"));
  g_autoptr(FlValue) data = fl_value_new_map();
  fl_value_set_string(message, "data", data);
  fl_value_set_string_take(data, "viewId", fl_value_new_int(999));
  fl_value_set_string_take(data, "message", fl_value_new_string("MESSAGE"));
  fl_value_set_string_take(data, "textDirection",
                           fl_value_new_int(kTextDirectionLtr));
  // Add optional assertiveness (not used in ATK)
  fl_value_set_string_take(data, "assertiveness",
                           fl_value_new_int(kAssertivenessAssertive));
 
  gboolean called = FALSE;
  fl_mock_binary_messenger_send_standard_message(
      messenger, "flutter/accessibility", message,
      [](FlMockBinaryMessenger* messenger, FlValue* response,
         gpointer user_data) {
        EXPECT_EQ(fl_value_get_type(response), FL_VALUE_TYPE_NULL);
        gboolean* called = static_cast<gboolean*>(user_data);
        *called = TRUE;
      },
      &called);
  EXPECT_TRUE(called);
  EXPECT_FALSE(signalled);
 
  fl_binary_messenger_shutdown(FL_BINARY_MESSENGER(messenger));
}

References data, engine, fl_binary_messenger_shutdown(), fl_engine_new_with_binary_messenger(), flutter::testing::fl_ensure_gtk_init(), fl_mock_binary_messenger_new(), fl_mock_binary_messenger_send_standard_message(), fl_value_get_type(), fl_value_new_int(), fl_value_new_map(), fl_value_new_string(), fl_value_set_string(), fl_value_set_string_take(), FL_VALUE_TYPE_NULL, fl_view_get_accessible(), fl_view_new_for_engine(), g_autoptr(), kAssertivenessAssertive, kTextDirectionLtr, message, subscribe_signal(), TRUE, user_data, and view.

TEST() [4/4]

TEST	(	FlAccessibilityHandlerTest	,
		UnknownType
	)

Definition at line 203 of file fl_accessibility_handler_test.cc.

                                              {
  flutter::testing::fl_ensure_gtk_init();
 
  g_autoptr(FlMockBinaryMessenger) messenger = fl_mock_binary_messenger_new();
  g_autoptr(FlEngine) engine =
      fl_engine_new_with_binary_messenger(FL_BINARY_MESSENGER(messenger));
  FlView* view = fl_view_new_for_engine(engine);
 
  gboolean signalled = FALSE;
  subscribe_signal(fl_view_get_accessible(view), &signalled, FALSE);
 
  // Unknown type, ignored by embedder.
  g_autoptr(FlValue) message = fl_value_new_map();
  fl_value_set_string_take(message, "type", fl_value_new_string("UNKNOWN"));
  fl_value_set_string_take(message, "data", fl_value_new_map());
 
  gboolean called = FALSE;
  fl_mock_binary_messenger_send_standard_message(
      messenger, "flutter/accessibility", message,
      [](FlMockBinaryMessenger* messenger, FlValue* response,
         gpointer user_data) {
        EXPECT_EQ(fl_value_get_type(response), FL_VALUE_TYPE_NULL);
        gboolean* called = static_cast<gboolean*>(user_data);
        *called = TRUE;
      },
      &called);
  EXPECT_TRUE(called);
  EXPECT_FALSE(signalled);
 
  fl_binary_messenger_shutdown(FL_BINARY_MESSENGER(messenger));
}

References engine, fl_binary_messenger_shutdown(), fl_engine_new_with_binary_messenger(), flutter::testing::fl_ensure_gtk_init(), fl_mock_binary_messenger_new(), fl_mock_binary_messenger_send_standard_message(), fl_value_get_type(), fl_value_new_map(), fl_value_new_string(), fl_value_set_string_take(), FL_VALUE_TYPE_NULL, fl_view_get_accessible(), fl_view_new_for_engine(), g_autoptr(), message, subscribe_signal(), TRUE, user_data, and view.

Variable Documentation

kAssertivenessAssertive

constexpr int64_t kAssertivenessAssertive = 1

staticconstexpr

Definition at line 23 of file fl_accessibility_handler_test.cc.

Referenced by TEST(), and TEST().

kTextDirectionLtr

constexpr int64_t kTextDirectionLtr = 0

staticconstexpr

Definition at line 22 of file fl_accessibility_handler_test.cc.

Referenced by TEST(), TEST(), and TEST().