Home | History | Annotate | Download | only in extensions 
      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 "extensions/browser/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_
     78