extensions/renderer/script_injector.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef EXTENSIONS_RENDERER_SCRIPT_INJECTOR_H_
   6 #define EXTENSIONS_RENDERER_SCRIPT_INJECTOR_H_
   7
   8 #include <vector>
   9
  10 #include "base/memory/scoped_ptr.h"
  11 #include "extensions/common/permissions/permissions_data.h"
  12 #include "extensions/common/user_script.h"
  13 #include "third_party/WebKit/public/web/WebScriptSource.h"
  14
  15 class GURL;
  16 class InjectionHost;
  17
  18 namespace blink {
  19 class WebLocalFrame;
  20 }
  21
  22 namespace extensions {
  23 struct ScriptsRunInfo;
  24
  25 // The pseudo-delegate class for a ScriptInjection that provides all necessary
  26 // information about how to inject the script, including what code to inject,
  27 // when (run location), and where (world), but without any injection logic.
  28 class ScriptInjector {
  29  public:
  30   // The possible reasons for not injecting the script.
  31   enum InjectFailureReason {
  32     EXTENSION_REMOVED,  // The extension was removed before injection.
  33     NOT_ALLOWED,        // The script is not allowed to inject.
  34     WONT_INJECT         // The injection won't inject because the user rejected
  35                         // (or just did not accept) the injection.
  36   };
  37
  38   virtual ~ScriptInjector() {}
  39
  40   // Returns the script type of this particular injection.
  41   virtual UserScript::InjectionType script_type() const = 0;
  42
  43   // Returns true if the script should execute in the main world.
  44   virtual bool ShouldExecuteInMainWorld() const = 0;
  45
  46   // Returns true if the script is running inside a user gesture.
  47   virtual bool IsUserGesture() const = 0;
  48
  49   // Returns true if the script expects results.
  50   virtual bool ExpectsResults() const = 0;
  51
  52   // Returns true if the script should inject JS source at the given
  53   // |run_location|.
  54   virtual bool ShouldInjectJs(UserScript::RunLocation run_location) const = 0;
  55
  56   // Returns true if the script should inject CSS at the given |run_location|.
  57   virtual bool ShouldInjectCss(UserScript::RunLocation run_location) const = 0;
  58
  59   // Returns true if the script should execute on the given |frame|.
  60   virtual PermissionsData::AccessType CanExecuteOnFrame(
  61       const InjectionHost* injection_host,
  62       blink::WebLocalFrame* web_frame,
  63       int tab_id) const = 0;
  64
  65   // Returns the javascript sources to inject at the given |run_location|.
  66   // Only called if ShouldInjectJs() is true.
  67   virtual std::vector<blink::WebScriptSource> GetJsSources(
  68       UserScript::RunLocation run_location) const = 0;
  69
  70   // Returns the css to inject at the given |run_location|.
  71   // Only called if ShouldInjectCss() is true.
  72   virtual std::vector<std::string> GetCssSources(
  73       UserScript::RunLocation run_location) const = 0;
  74
  75   // Fill scriptrs run info based on information about injection.
  76   virtual void GetRunInfo(
  77       ScriptsRunInfo* scripts_run_info,
  78       UserScript::RunLocation run_location) const = 0;
  79
  80   // Notifies the script that injection has completed, with a possibly-populated
  81   // list of results (depending on whether or not ExpectsResults() was true).
  82   virtual void OnInjectionComplete(
  83       scoped_ptr<base::Value> execution_result,
  84       UserScript::RunLocation run_location) = 0;
  85
  86   // Notifies the script that injection will never occur.
  87   virtual void OnWillNotInject(InjectFailureReason reason) = 0;
  88 };
  89
  90 }  // namespace extensions
  91
  92 #endif  // EXTENSIONS_RENDERER_SCRIPT_INJECTOR_H_