Suspend frame schedulers on a page suspension

third_party/WebKit/public/platform/WebFrameScheduler.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 WebFrameScheduler_h
 #define WebFrameScheduler_h
 
 #include "WebCommon.h"
 
 #include <string>
 
 namespace blink {
 
 class WebSecurityOrigin;
 class WebTaskRunner;
 class WebViewScheduler;
 
 class BLINK_PLATFORM_EXPORT WebFrameScheduler {
  public:
   virtual ~WebFrameScheduler() {}
 
   // The scheduler may throttle tasks associated with offscreen frames.
   virtual void setFrameVisible(bool) {}
 
   // Tells the scheduler that the page this frame belongs to is not visible.
   // The scheduler may throttle tasks associated with pages that are not
   // visible.
   virtual void setPageVisible(bool) {}
 
+  // Set whether this frame is suspended. The scheduler runs
+  // unthrottledTaskRunner only on a suspended frame.

[Sami, 2016/11/30 17:16:19]

nit: this makes it sound like unthrottledTaskRunner only runs when the frame is
suspended. How about:

"Only unthrottledTaskRunner tasks are allowed to run on a suspended frame."

[tzik, 2016/12/01 06:39:02]

Done.

+  virtual void setSuspended(bool) {}
+
   // Set whether this frame is cross origin w.r.t. the top level frame. Cross
   // origin frames may use a different scheduling policy from same origin
   // frames.
   virtual void setCrossOrigin(bool) {}
 
   // Returns the WebTaskRunner for loading tasks.
   // WebFrameScheduler owns the returned WebTaskRunner.
   virtual WebTaskRunner* loadingTaskRunner() { return nullptr; }
 
   // Returns the WebTaskRunner for timer tasks.
@@ skipping 21 matching lines @@
 
   // Tells the scheduler if we are parsing a document on another thread. This
   // tells the scheduler not to advance virtual time if it's using the
   // DETERMINISTIC_LOADING policy.
   virtual void setDocumentParsingInBackground(bool) {}
 };
 
 }  // namespace blink
 
 #endif  // WebFrameScheduler_h