chrome/browser/extensions/chrome_extension_function.h

   1 // Copyright 2013 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 CHROME_BROWSER_EXTENSIONS_CHROME_EXTENSION_FUNCTION_H_
   6 #define CHROME_BROWSER_EXTENSIONS_CHROME_EXTENSION_FUNCTION_H_
   7
   8 #include "chrome/browser/extensions/extension_function.h"
   9
  10 class Browser;
  11 class Profile;
  12
  13 namespace content {
  14 class WebContents;
  15 }
  16
  17 namespace extensions {
  18 class WindowController;
  19 }
  20
  21 // A chrome specific analog to AsyncExtensionFunction. This has access
  22 // the a chrome Profile.
  23 class ChromeAsyncExtensionFunction : public UIThreadExtensionFunction {
  24  public:
  25   ChromeAsyncExtensionFunction();
  26
  27   Profile* GetProfile() const;
  28
  29   // Returns true if this function (and the profile and extension that it was
  30   // invoked from) can operate on the window wrapped by |window_controller|.
  31   bool CanOperateOnWindow(const extensions::WindowController* window_controller)
  32       const;
  33
  34   // Gets the "current" browser, if any.
  35   //
  36   // Many extension APIs operate relative to the current browser, which is the
  37   // browser the calling code is running inside of. For example, popups, tabs,
  38   // and infobars all have a containing browser, but background pages and
  39   // notification bubbles do not.
  40   //
  41   // If there is no containing window, the current browser defaults to the
  42   // foremost one.
  43   //
  44   // Incognito browsers are not considered unless the calling extension has
  45   // incognito access enabled.
  46   //
  47   // This method can return NULL if there is no matching browser, which can
  48   // happen if only incognito windows are open, or early in startup or shutdown
  49   // shutdown when there are no active windows.
  50   //
  51   // TODO(stevenjb): Replace this with GetExtensionWindowController().
  52   Browser* GetCurrentBrowser();
  53
  54   // Same as above but uses WindowControllerList instead of BrowserList.
  55   extensions::WindowController* GetExtensionWindowController();
  56
  57   // Gets the "current" web contents if any. If there is no associated web
  58   // contents then defaults to the foremost one.
  59   virtual content::WebContents* GetAssociatedWebContents() OVERRIDE;
  60
  61  protected:
  62   virtual ~ChromeAsyncExtensionFunction();
  63 };
  64
  65 // A chrome specific analog to SyncExtensionFunction. This has access
  66 // the a chrome Profile.
  67 class ChromeSyncExtensionFunction : public ChromeAsyncExtensionFunction {
  68  public:
  69   ChromeSyncExtensionFunction();
  70
  71   virtual void Run() OVERRIDE;
  72
  73  protected:
  74   virtual ~ChromeSyncExtensionFunction();
  75 };
  76
  77 #endif  // CHROME_BROWSER_EXTENSIONS_CHROME_EXTENSION_FUNCTION_H_