summaryrefslogtreecommitdiffstats
path: root/third_party/libwebrtc/api/sequence_checker_unittest.cc
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 17:32:43 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 17:32:43 +0000
commit6bf0a5cb5034a7e684dcc3500e841785237ce2dd (patch)
treea68f146d7fa01f0134297619fbe7e33db084e0aa /third_party/libwebrtc/api/sequence_checker_unittest.cc
parentInitial commit. (diff)
downloadthunderbird-upstream.tar.xz
thunderbird-upstream.zip
Adding upstream version 1:115.7.0.upstream/1%115.7.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'third_party/libwebrtc/api/sequence_checker_unittest.cc')
-rw-r--r--third_party/libwebrtc/api/sequence_checker_unittest.cc224
1 files changed, 224 insertions, 0 deletions
diff --git a/third_party/libwebrtc/api/sequence_checker_unittest.cc b/third_party/libwebrtc/api/sequence_checker_unittest.cc
new file mode 100644
index 0000000000..f117926d73
--- /dev/null
+++ b/third_party/libwebrtc/api/sequence_checker_unittest.cc
@@ -0,0 +1,224 @@
+/*
+ * Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
+ *
+ * Use of this source code is governed by a BSD-style license
+ * that can be found in the LICENSE file in the root of the source
+ * tree. An additional intellectual property rights grant can be found
+ * in the file PATENTS. All contributing project authors may
+ * be found in the AUTHORS file in the root of the source tree.
+ */
+
+#include "api/sequence_checker.h"
+
+#include <memory>
+#include <utility>
+
+#include "api/function_view.h"
+#include "api/units/time_delta.h"
+#include "rtc_base/event.h"
+#include "rtc_base/platform_thread.h"
+#include "rtc_base/task_queue_for_test.h"
+#include "test/gmock.h"
+#include "test/gtest.h"
+
+using testing::HasSubstr;
+
+namespace webrtc {
+namespace {
+
+// This class is dead code, but its purpose is to make sure that
+// SequenceChecker is compatible with the RTC_GUARDED_BY and RTC_RUN_ON
+// attributes that are checked at compile-time.
+class CompileTimeTestForGuardedBy {
+ public:
+ int CalledOnSequence() RTC_RUN_ON(sequence_checker_) { return guarded_; }
+
+ void CallMeFromSequence() {
+ RTC_DCHECK_RUN_ON(&sequence_checker_);
+ guarded_ = 41;
+ }
+
+ private:
+ int guarded_ RTC_GUARDED_BY(sequence_checker_);
+ ::webrtc::SequenceChecker sequence_checker_;
+};
+
+void RunOnDifferentThread(rtc::FunctionView<void()> run) {
+ rtc::Event thread_has_run_event;
+ rtc::PlatformThread::SpawnJoinable(
+ [&] {
+ run();
+ thread_has_run_event.Set();
+ },
+ "thread");
+ EXPECT_TRUE(thread_has_run_event.Wait(TimeDelta::Seconds(1)));
+}
+
+} // namespace
+
+TEST(SequenceCheckerTest, CallsAllowedOnSameThread) {
+ SequenceChecker sequence_checker;
+ EXPECT_TRUE(sequence_checker.IsCurrent());
+}
+
+TEST(SequenceCheckerTest, DestructorAllowedOnDifferentThread) {
+ auto sequence_checker = std::make_unique<SequenceChecker>();
+ RunOnDifferentThread([&] {
+ // Verify that the destructor doesn't assert when called on a different
+ // thread.
+ sequence_checker.reset();
+ });
+}
+
+TEST(SequenceCheckerTest, Detach) {
+ SequenceChecker sequence_checker;
+ sequence_checker.Detach();
+ RunOnDifferentThread([&] { EXPECT_TRUE(sequence_checker.IsCurrent()); });
+}
+
+TEST(SequenceCheckerTest, DetachFromThreadAndUseOnTaskQueue) {
+ SequenceChecker sequence_checker;
+ sequence_checker.Detach();
+ TaskQueueForTest queue;
+ queue.SendTask([&] { EXPECT_TRUE(sequence_checker.IsCurrent()); });
+}
+
+TEST(SequenceCheckerTest, DetachFromTaskQueueAndUseOnThread) {
+ TaskQueueForTest queue;
+ queue.SendTask([] {
+ SequenceChecker sequence_checker;
+ sequence_checker.Detach();
+ RunOnDifferentThread([&] { EXPECT_TRUE(sequence_checker.IsCurrent()); });
+ });
+}
+
+TEST(SequenceCheckerTest, MethodNotAllowedOnDifferentThreadInDebug) {
+ SequenceChecker sequence_checker;
+ RunOnDifferentThread(
+ [&] { EXPECT_EQ(sequence_checker.IsCurrent(), !RTC_DCHECK_IS_ON); });
+}
+
+#if RTC_DCHECK_IS_ON
+TEST(SequenceCheckerTest, OnlyCurrentOnOneThread) {
+ SequenceChecker sequence_checker(SequenceChecker::kDetached);
+ RunOnDifferentThread([&] {
+ EXPECT_TRUE(sequence_checker.IsCurrent());
+ // Spawn a new thread from within the first one to guarantee that we have
+ // two concurrently active threads (and that there's no chance of the
+ // thread ref being reused).
+ RunOnDifferentThread([&] { EXPECT_FALSE(sequence_checker.IsCurrent()); });
+ });
+}
+#endif
+
+TEST(SequenceCheckerTest, MethodNotAllowedOnDifferentTaskQueueInDebug) {
+ SequenceChecker sequence_checker;
+ TaskQueueForTest queue;
+ queue.SendTask(
+ [&] { EXPECT_EQ(sequence_checker.IsCurrent(), !RTC_DCHECK_IS_ON); });
+}
+
+TEST(SequenceCheckerTest, DetachFromTaskQueueInDebug) {
+ SequenceChecker sequence_checker;
+ sequence_checker.Detach();
+
+ TaskQueueForTest queue1;
+ queue1.SendTask([&] { EXPECT_TRUE(sequence_checker.IsCurrent()); });
+
+ // IsCurrent should return false in debug builds after moving to
+ // another task queue.
+ TaskQueueForTest queue2;
+ queue2.SendTask(
+ [&] { EXPECT_EQ(sequence_checker.IsCurrent(), !RTC_DCHECK_IS_ON); });
+}
+
+TEST(SequenceCheckerTest, ExpectationToString) {
+ TaskQueueForTest queue1;
+
+ SequenceChecker sequence_checker(SequenceChecker::kDetached);
+
+ rtc::Event blocker;
+ queue1.PostTask([&blocker, &sequence_checker]() {
+ (void)sequence_checker.IsCurrent();
+ blocker.Set();
+ });
+
+ blocker.Wait(rtc::Event::kForever);
+
+#if RTC_DCHECK_IS_ON
+
+ EXPECT_THAT(ExpectationToString(&sequence_checker),
+ HasSubstr("# Expected: TQ:"));
+
+ // Test for the base class
+ webrtc_sequence_checker_internal::SequenceCheckerImpl* sequence_checker_base =
+ &sequence_checker;
+ EXPECT_THAT(ExpectationToString(sequence_checker_base),
+ HasSubstr("# Expected: TQ:"));
+
+#else
+ GTEST_ASSERT_EQ(ExpectationToString(&sequence_checker), "");
+#endif
+}
+
+TEST(SequenceCheckerTest, InitiallyDetached) {
+ TaskQueueForTest queue1;
+
+ SequenceChecker sequence_checker(SequenceChecker::kDetached);
+
+ rtc::Event blocker;
+ queue1.PostTask([&blocker, &sequence_checker]() {
+ EXPECT_TRUE(sequence_checker.IsCurrent());
+ blocker.Set();
+ });
+
+ blocker.Wait(rtc::Event::kForever);
+
+#if RTC_DCHECK_IS_ON
+ EXPECT_FALSE(sequence_checker.IsCurrent());
+#endif
+}
+
+class TestAnnotations {
+ public:
+ TestAnnotations() : test_var_(false) {}
+
+ void ModifyTestVar() {
+ RTC_DCHECK_RUN_ON(&checker_);
+ test_var_ = true;
+ }
+
+ private:
+ bool test_var_ RTC_GUARDED_BY(&checker_);
+ SequenceChecker checker_;
+};
+
+TEST(SequenceCheckerTest, TestAnnotations) {
+ TestAnnotations annotations;
+ annotations.ModifyTestVar();
+}
+
+#if GTEST_HAS_DEATH_TEST && !defined(WEBRTC_ANDROID)
+
+void TestAnnotationsOnWrongQueue() {
+ TestAnnotations annotations;
+ TaskQueueForTest queue;
+ queue.SendTask([&] { annotations.ModifyTestVar(); });
+}
+
+#if RTC_DCHECK_IS_ON
+// Note: Ending the test suite name with 'DeathTest' is important as it causes
+// gtest to order this test before any other non-death-tests, to avoid potential
+// global process state pollution such as shared worker threads being started
+// (e.g. a side effect of calling InitCocoaMultiThreading() on Mac causes one or
+// two additional threads to be created).
+TEST(SequenceCheckerDeathTest, TestAnnotationsOnWrongQueueDebug) {
+ ASSERT_DEATH({ TestAnnotationsOnWrongQueue(); }, "");
+}
+#else
+TEST(SequenceCheckerTest, TestAnnotationsOnWrongQueueRelease) {
+ TestAnnotationsOnWrongQueue();
+}
+#endif
+#endif // GTEST_HAS_DEATH_TEST
+} // namespace webrtc