Updating trunk VERSION from 2139.0 to 2140.0
[chromium-blink-merge.git] / extensions / browser / extension_web_contents_observer.h
blob5cb797b9bf2d4ba93c2fc41489f230c849c03f96
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.
5 #ifndef EXTENSIONS_BROWSER_EXTENSION_WEB_CONTENTS_OBSERVER_H_
6 #define EXTENSIONS_BROWSER_EXTENSION_WEB_CONTENTS_OBSERVER_H_
8 #include <string>
10 #include "base/compiler_specific.h"
11 #include "base/macros.h"
12 #include "content/public/browser/web_contents_observer.h"
14 namespace content {
15 class BrowserContext;
16 class RenderViewHost;
17 class WebContents;
20 namespace extensions {
21 class Extension;
23 // A web contents observer used for renderer and extension processes. Grants the
24 // renderer access to certain URL scheme patterns for extensions and notifies
25 // the renderer that the extension was loaded.
27 // Extension system embedders must create an instance for every extension
28 // WebContents. It must be a subclass so that creating an instance via
29 // content::WebContentsUserData::CreateForWebContents() provides an object of
30 // the correct type. For an example, see ChromeExtensionWebContentsObserver.
31 class ExtensionWebContentsObserver : public content::WebContentsObserver {
32 protected:
33 explicit ExtensionWebContentsObserver(content::WebContents* web_contents);
34 virtual ~ExtensionWebContentsObserver();
36 content::BrowserContext* browser_context() { return browser_context_; }
38 // content::WebContentsObserver overrides.
40 // A subclass should invoke this method to finish extension process setup.
41 virtual void RenderViewCreated(content::RenderViewHost* render_view_host)
42 OVERRIDE;
44 // Returns the extension or app associated with a render view host. Returns
45 // NULL if the render view host is not for a valid extension.
46 const Extension* GetExtension(content::RenderViewHost* render_view_host);
48 // Updates ViewType for RenderViewHost based on GetViewType(web_contents()).
49 void NotifyRenderViewType(content::RenderViewHost* render_view_host);
51 // Returns the extension or app ID associated with a render view host. Returns
52 // the empty string if the render view host is not for a valid extension.
53 static std::string GetExtensionId(content::RenderViewHost* render_view_host);
55 private:
56 // The BrowserContext associated with the WebContents being observed.
57 content::BrowserContext* browser_context_;
59 DISALLOW_COPY_AND_ASSIGN(ExtensionWebContentsObserver);
62 } // namespace extensions
64 #endif // EXTENSIONS_BROWSER_EXTENSION_WEB_CONTENTS_OBSERVER_H_