[scheduler] Add TaskQueue::Observer

third_party/WebKit/public/platform/scheduler/base/task_queue.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef THIRD_PARTY_WEBKIT_PUBLIC_PLATFORM_SCHEDULER_BASE_TASK_QUEUE_H_
 #define THIRD_PARTY_WEBKIT_PUBLIC_PLATFORM_SCHEDULER_BASE_TASK_QUEUE_H_
 
 #include "base/macros.h"
 #include "base/message_loop/message_loop.h"
 #include "base/optional.h"
 #include "base/single_thread_task_runner.h"
 #include "base/time/time.h"
 #include "public/platform/WebCommon.h"
 
 namespace base {
 namespace trace_event {
 class BlameContext;
 }
 }
 
 namespace blink {
 namespace scheduler {
 
 class TimeDomain;
 
 class BLINK_PLATFORM_EXPORT TaskQueue : public base::SingleThreadTaskRunner {
  public:
   TaskQueue() {}
 
+  class BLINK_PLATFORM_EXPORT Observer {
+   public:
+    virtual ~Observer() {}
+
+    // Notify observer that wake_up has changed. |next_wakeup| can be in the

[Sami, 2017/04/05 13:16:52]

s/wake_up/the time at which this queue wants to run the next task/

[altimin, 2017/04/05 13:55:18]

Done.

+    // past (e.g. base::TimeTicks() can be used to notify about immediate

[Sami, 2017/04/05 13:16:51]

Missing ')'

[altimin, 2017/04/05 13:55:18]

Done.

+    // work.
+    // Can be called on any thread
+    // All methods but SetObserver, SetTimeDomain and GetTimeDomain can be
+    // called on |queue|.
+    virtual void OnQueueNextWakeUpChanged(TaskQueue* queue,
+                                          base::TimeTicks next_wake_up) = 0;
+  };
+
   // Unregisters the task queue after which no tasks posted to it will run and
   // the TaskQueueManager's reference to it will be released soon.
   virtual void UnregisterTaskQueue() = 0;
 
   enum QueuePriority {
     // Queues with control priority will run before any other queue, and will
     // explicitly starve other queues. Typically this should only be used for
     // private queues which perform control operations.
     CONTROL_PRIORITY,
     // Queues with high priority will be selected preferentially over normal or
@@ skipping 103 matching lines @@
   // Returns true if the queue is completely empty.
   virtual bool IsEmpty() const = 0;
 
   // Returns the number of pending tasks in the queue.
   virtual size_t GetNumberOfPendingTasks() const = 0;
 
   // Returns true if the queue has work that's ready to execute now.
   // NOTE: this must be called on the thread this TaskQueue was created by.
   virtual bool HasPendingImmediateWork() const = 0;
 
-  // Returns requested run time of next scheduled wakeup for a delayed task
+  // Returns requested run time of next scheduled wake_up for a delayed task

[Sami, 2017/04/05 13:16:52]

nit: no underscore

[altimin, 2017/04/05 13:55:18]

Done.

   // which is not ready to run. If there are no such tasks or the queue is
   // disabled (by a QueueEnabledVoter) it returns base::nullopt.
   // NOTE: this must be called on the thread this TaskQueue was created by.
   virtual base::Optional<base::TimeTicks> GetNextScheduledWakeUp() = 0;
 
   // Can be called on any thread.
   virtual QueueType GetQueueType() const = 0;
 
   // Can be called on any thread.
   virtual const char* GetName() const = 0;
@@ skipping 37 matching lines @@
   // Note: delayed tasks get their enqueue order set once their delay has
   // expired, and non-delayed tasks get their enqueue order set when posted.
   virtual void InsertFence(InsertFencePosition position) = 0;
 
   // Removes any previously added fence and unblocks execution of any tasks
   // blocked by it.
   virtual void RemoveFence() = 0;
 
   virtual bool BlockedByFence() const = 0;
 
+  virtual void SetObserver(Observer* observer) = 0;
+
  protected:
   ~TaskQueue() override {}
 
   DISALLOW_COPY_AND_ASSIGN(TaskQueue);
 };
 
 }  // namespace scheduler
 }  // namespace blink
 
 #endif  // THIRD_PARTY_WEBKIT_PUBLIC_PLATFORM_SCHEDULER_BASE_TASK_QUEUE_H_