// Copyright 2020 The Chromium Embedded Framework 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 CEF_LIBCEF_BROWSER_CHROME_CHROME_BROWSER_DELEGATE_H_ #define CEF_LIBCEF_BROWSER_CHROME_CHROME_BROWSER_DELEGATE_H_ #pragma once #include #include #include "base/memory/raw_ptr.h" #include "cef/libcef/browser/browser_host_base.h" #include "cef/libcef/browser/browser_info.h" #include "cef/libcef/browser/chrome/browser_delegate.h" class CefBrowserContentsDelegate; class CefRequestContextImpl; class CefWindowImpl; class CefWindowView; class ChromeBrowserHostImpl; // Implementation of the cef::BrowserDelegate interface. Lifespan is controlled // by the Browser object. Only accessed on the UI thread. // // The Browser object represents the top-level Chrome browser window. One or // more tabs (WebContents) are then owned by the Browser object via // TabStripModel. A new Browser object can be created programmatically using // "new Browser" or Browser::Create, or as a result of user action such as // dragging a tab out of an existing window. New or existing tabs can also be // added to an already existing Browser object. // // The Browser object acts as the WebContentsDelegate for all attached tabs. CEF // integration requires WebContentsDelegate callbacks and notification of tab // attach/detach. To support this integration a cef::BrowserDelegate // (ChromeBrowserDelegate) member is created in the Browser constructor and // receives delegation for the Browser callbacks. ChromeBrowserDelegate creates // a new ChromeBrowserHostImpl when a tab is added to a Browser for the first // time, and that ChromeBrowserHostImpl continues to exist until the tab's // WebContents is destroyed. The associated WebContents object does not change, // but the Browser object will change when the tab is dragged between windows. class ChromeBrowserDelegate : public cef::BrowserDelegate { public: // The |create_params| and |opener| values are specified via the // Browser::CreateParams passed to Browser::Create. |opener| will only be // specified for certain special Browser types. ChromeBrowserDelegate(Browser* browser, const CefBrowserCreateParams& create_params, const Browser* opener); ChromeBrowserDelegate(const ChromeBrowserDelegate&) = delete; ChromeBrowserDelegate& operator=(const ChromeBrowserDelegate&) = delete; ~ChromeBrowserDelegate() override; static Browser* CreateDevToolsBrowser( Profile* profile, Browser* opener, content::WebContents* inspected_web_contents, std::unique_ptr& devtools_contents); // cef::BrowserDelegate methods: std::unique_ptr AddWebContents( std::unique_ptr new_contents) override; void OnWebContentsCreated(content::WebContents* new_contents) override; void SetAsDelegate(content::WebContents* web_contents, bool set_delegate) override; bool ShowStatusBubble(bool show_by_default) override; bool HandleCommand(int command_id, WindowOpenDisposition disposition) override; bool IsAppMenuItemVisible(int command_id) override; bool IsAppMenuItemEnabled(int command_id) override; bool IsPageActionIconVisible(PageActionIconType icon_type) override; bool IsToolbarButtonVisible(ToolbarButtonType button_type) override; void UpdateFindBarBoundingBox(gfx::Rect* bounds) override; void UpdateDialogTopInset(int* dialog_top_y) override; [[nodiscard]] content::MediaResponseCallback RequestMediaAccessPermissionEx( content::WebContents* web_contents, const content::MediaStreamRequest& request, content::MediaResponseCallback callback) override; bool RendererUnresponsiveEx( content::WebContents* source, content::RenderWidgetHost* render_widget_host, base::RepeatingClosure hang_monitor_restarter) override; bool RendererResponsiveEx( content::WebContents* source, content::RenderWidgetHost* render_widget_host) override; std::optional SupportsWindowFeature(int feature) const override; bool SupportsDraggableRegion() const override; const std::optional GetDraggableRegion() const override; void WindowFullscreenStateChanged() override; bool HasViewsHostedOpener() const override; content::WebContents* OpenURLFromTabEx( content::WebContents* source, const content::OpenURLParams& params, base::OnceCallback& navigation_handle_callback) override; // WebContentsDelegate methods: void WebContentsCreated(content::WebContents* source_contents, int opener_render_process_id, int opener_render_frame_id, const std::string& frame_name, const GURL& target_url, content::WebContents* new_contents) override; void LoadingStateChanged(content::WebContents* source, bool should_show_loading_ui) override; void UpdateTargetURL(content::WebContents* source, const GURL& url) override; bool DidAddMessageToConsole(content::WebContents* source, blink::mojom::ConsoleMessageLevel log_level, const std::u16string& message, int32_t line_no, const std::u16string& source_id) override; void EnterFullscreenModeForTab( content::RenderFrameHost* requesting_frame, const blink::mojom::FullscreenOptions& options) override; void ExitFullscreenModeForTab(content::WebContents* web_contents) override; void CanDownload(const GURL& url, const std::string& request_method, base::OnceCallback callback) override; content::JavaScriptDialogManager* GetJavaScriptDialogManager( content::WebContents* source) override; content::KeyboardEventProcessingResult PreHandleKeyboardEvent( content::WebContents* source, const input::NativeWebKeyboardEvent& event) override; bool HandleKeyboardEvent(content::WebContents* source, const input::NativeWebKeyboardEvent& event) override; void DraggableRegionsChanged( const std::vector& regions, content::WebContents* contents) override; Browser* browser() const { return browser_; } private: static CefRefPtr CreateBrowserHost( Browser* browser, content::WebContents* web_contents, const CefBrowserSettings& settings, CefRefPtr client, std::unique_ptr platform_delegate, scoped_refptr browser_info, bool is_devtools_popup, CefRefPtr opener, CefRefPtr request_context_impl); static CefRefPtr CreateBrowserHostForPopup( content::WebContents* web_contents, const CefBrowserSettings& settings, CefRefPtr client, CefRefPtr extra_info, std::unique_ptr platform_delegate, bool is_devtools_popup, CefRefPtr opener); CefBrowserContentsDelegate* GetDelegateForWebContents( content::WebContents* web_contents) const; bool SupportsFramelessPictureInPicture() const; bool IsViewsHosted() const; // Will return nullptr if the Browser is not Views-hosted. CefWindowImpl* GetCefWindowImpl() const; CefWindowView* GetCefWindowView() const; const raw_ptr browser_; base::WeakPtr opener_host_; // Used when creating a new browser host. const CefBrowserCreateParams create_params_; std::optional show_status_bubble_; std::optional draggable_region_; mutable std::optional frameless_pip_; }; #endif // CEF_LIBCEF_BROWSER_CHROME_CHROME_BROWSER_DELEGATE_H_