Adding run_at to chrome.tabs.executeScript/insertCss.

chrome/renderer/extensions/user_script_idle_scheduler.h

-// Copyright (c) 2011 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 CHROME_RENDERER_EXTENSIONS_USER_SCRIPT_IDLE_SCHEDULER_H_
-#define CHROME_RENDERER_EXTENSIONS_USER_SCRIPT_IDLE_SCHEDULER_H_
-#pragma once
-
-#include <queue>
-#include <vector>
-
-#include "base/memory/linked_ptr.h"
-#include "base/memory/weak_ptr.h"
-
-class ExtensionDispatcher;
-class RenderView;
-struct ExtensionMsg_ExecuteCode_Params;
-
-namespace WebKit {
-class WebFrame;
-}
-
-// Implements support for injecting scripts at "document idle". Currently,
-// determining idleness is simple: it is whichever of the following happens
-// first:
-//
-// a) When the initial DOM for a page is complete + kUserScriptIdleTimeout,
-// b) or when the page has completely loaded including all subresources.
-//
-// The intent of this mechanism is to prevent user scripts from slowing down
-// fast pages (run after load), while still allowing them to run relatively
-// timely for pages with lots of slow subresources.
-//
-// NOTE: this class does not inherit from RenderViewObserver on purpose.  The
-// reason is that this object is per frame, and a frame can move across
-// RenderViews thanks to adoptNode.  So we have each RenderView's
-// ExtensionHelper proxy these calls to the renderer process'
-// ExtensionDispatcher, which contains the mapping from WebFrame to us.
-class UserScriptIdleScheduler {
- public:
-  UserScriptIdleScheduler(WebKit::WebFrame* frame,
-                          ExtensionDispatcher* extension_dispatcher);
-  ~UserScriptIdleScheduler();
-
-  void ExecuteCode(const ExtensionMsg_ExecuteCode_Params& params);
-  void DidFinishDocumentLoad();
-  void DidFinishLoad();
-  void DidStartProvisionalLoad();
-
- private:
-  // Run user scripts, except if they've already run for this frame, or the
-  // frame has been destroyed.
-  void MaybeRun();
-
-  // Backend for the IPC Message ExecuteCode in addition to being used
-  // internally.
-  void ExecuteCodeImpl(const ExtensionMsg_ExecuteCode_Params& params);
-
-  // Get all child frames of parent_frame, returned by frames_vector.
-  bool GetAllChildFrames(WebKit::WebFrame* parent_frame,
-                         std::vector<WebKit::WebFrame*>* frames_vector) const;
-
-  base::WeakPtrFactory<UserScriptIdleScheduler> weak_factory_;
-
-  // The Frame we will run scripts in.
-  WebKit::WebFrame* frame_;
-
-  // Whether we have already run scripts.
-  bool has_run_;
-
-  // This is only used if we're for the main frame.
-  std::queue<linked_ptr<ExtensionMsg_ExecuteCode_Params> >
-      pending_code_execution_queue_;
-
-  ExtensionDispatcher* extension_dispatcher_;
-};
-
-#endif  // CHROME_RENDERER_EXTENSIONS_USER_SCRIPT_IDLE_SCHEDULER_H_