435 lines
17 KiB
C++
435 lines
17 KiB
C++
// Copyright (c) 2011 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_TESTS_CEFCLIENT_BROWSER_CLIENT_HANDLER_H_
|
|
#define CEF_TESTS_CEFCLIENT_BROWSER_CLIENT_HANDLER_H_
|
|
#pragma once
|
|
|
|
#include <set>
|
|
#include <string>
|
|
|
|
#include "include/cef_client.h"
|
|
#include "include/wrapper/cef_helpers.h"
|
|
#include "tests/cefclient/browser/base_client_handler.h"
|
|
#include "tests/cefclient/browser/client_types.h"
|
|
#include "tests/cefclient/browser/test_runner.h"
|
|
|
|
#if defined(OS_LINUX)
|
|
#include "tests/cefclient/browser/dialog_handler_gtk.h"
|
|
#include "tests/cefclient/browser/print_handler_gtk.h"
|
|
#endif
|
|
|
|
namespace client {
|
|
|
|
class ClientDownloadImageCallback;
|
|
|
|
// Client handler abstract base class. Provides common functionality shared by
|
|
// all concrete client handler implementations.
|
|
class ClientHandler : public BaseClientHandler,
|
|
public CefCommandHandler,
|
|
public CefContextMenuHandler,
|
|
public CefDisplayHandler,
|
|
public CefDownloadHandler,
|
|
public CefDragHandler,
|
|
public CefFocusHandler,
|
|
public CefKeyboardHandler,
|
|
public CefLoadHandler,
|
|
public CefPermissionHandler {
|
|
public:
|
|
// Implement this interface to receive notification of ClientHandler
|
|
// events. The methods of this class will be called on the main thread unless
|
|
// otherwise indicated.
|
|
class Delegate {
|
|
public:
|
|
// Returns true if the window should use Views. Safe to call on any thread.
|
|
virtual bool UseViews() const = 0;
|
|
|
|
// Returns true if the window should use Alloy style. Safe to call on any
|
|
// thread.
|
|
virtual bool UseAlloyStyle() const = 0;
|
|
|
|
// Called when the browser is created.
|
|
virtual void OnBrowserCreated(CefRefPtr<CefBrowser> browser) = 0;
|
|
|
|
// Called when the browser is closing.
|
|
virtual void OnBrowserClosing(CefRefPtr<CefBrowser> browser) = 0;
|
|
|
|
// Called when the browser has been closed.
|
|
virtual void OnBrowserClosed(CefRefPtr<CefBrowser> browser) = 0;
|
|
|
|
// Set the window URL address.
|
|
virtual void OnSetAddress(const std::string& url) = 0;
|
|
|
|
// Set the window title.
|
|
virtual void OnSetTitle(const std::string& title) = 0;
|
|
|
|
// Set the Favicon image.
|
|
virtual void OnSetFavicon(CefRefPtr<CefImage> image) {}
|
|
|
|
// Set fullscreen mode.
|
|
virtual void OnSetFullscreen(bool fullscreen) = 0;
|
|
|
|
// Auto-resize contents.
|
|
virtual void OnAutoResize(const CefSize& new_size) = 0;
|
|
|
|
// Set the loading state.
|
|
virtual void OnSetLoadingState(bool isLoading,
|
|
bool canGoBack,
|
|
bool canGoForward) = 0;
|
|
|
|
// Set the draggable regions.
|
|
virtual void OnSetDraggableRegions(
|
|
const std::vector<CefDraggableRegion>& regions) = 0;
|
|
|
|
// Set focus to the next/previous control.
|
|
virtual void OnTakeFocus(bool next) {}
|
|
|
|
// Called on the UI thread before a context menu is displayed.
|
|
virtual void OnBeforeContextMenu(CefRefPtr<CefMenuModel> model) {}
|
|
|
|
protected:
|
|
virtual ~Delegate() = default;
|
|
};
|
|
|
|
// Constructor may be called on any thread.
|
|
// |delegate| must outlive this object or DetachDelegate() must be called.
|
|
ClientHandler(Delegate* delegate,
|
|
bool is_osr,
|
|
bool with_controls,
|
|
const std::string& startup_url);
|
|
|
|
// This object may outlive the Delegate object so it's necessary for the
|
|
// Delegate to detach itself before destruction.
|
|
void DetachDelegate();
|
|
|
|
// CefClient methods
|
|
CefRefPtr<CefCommandHandler> GetCommandHandler() override { return this; }
|
|
CefRefPtr<CefContextMenuHandler> GetContextMenuHandler() override {
|
|
return this;
|
|
}
|
|
CefRefPtr<CefDisplayHandler> GetDisplayHandler() override { return this; }
|
|
CefRefPtr<CefDownloadHandler> GetDownloadHandler() override { return this; }
|
|
CefRefPtr<CefDragHandler> GetDragHandler() override { return this; }
|
|
CefRefPtr<CefFocusHandler> GetFocusHandler() override { return this; }
|
|
CefRefPtr<CefKeyboardHandler> GetKeyboardHandler() override { return this; }
|
|
CefRefPtr<CefLoadHandler> GetLoadHandler() override { return this; }
|
|
CefRefPtr<CefPermissionHandler> GetPermissionHandler() override {
|
|
return this;
|
|
}
|
|
bool OnProcessMessageReceived(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
CefProcessId source_process,
|
|
CefRefPtr<CefProcessMessage> message) override;
|
|
|
|
#if defined(OS_LINUX)
|
|
CefRefPtr<CefDialogHandler> GetDialogHandler() override {
|
|
return file_dialog_handler_;
|
|
}
|
|
CefRefPtr<CefJSDialogHandler> GetJSDialogHandler() override {
|
|
return js_dialog_handler_;
|
|
}
|
|
CefRefPtr<CefPrintHandler> GetPrintHandler() override {
|
|
return print_handler_;
|
|
}
|
|
#endif
|
|
|
|
// CefCommandHandler methods
|
|
bool OnChromeCommand(CefRefPtr<CefBrowser> browser,
|
|
int command_id,
|
|
cef_window_open_disposition_t disposition) override;
|
|
bool IsChromeAppMenuItemVisible(CefRefPtr<CefBrowser> browser,
|
|
int command_id) override;
|
|
bool IsChromePageActionIconVisible(
|
|
cef_chrome_page_action_icon_type_t icon_type) override;
|
|
bool IsChromeToolbarButtonVisible(
|
|
cef_chrome_toolbar_button_type_t button_type) override;
|
|
|
|
// CefContextMenuHandler methods
|
|
void OnBeforeContextMenu(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
CefRefPtr<CefContextMenuParams> params,
|
|
CefRefPtr<CefMenuModel> model) override;
|
|
bool OnContextMenuCommand(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
CefRefPtr<CefContextMenuParams> params,
|
|
int command_id,
|
|
EventFlags event_flags) override;
|
|
|
|
// CefDisplayHandler methods
|
|
void OnAddressChange(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
const CefString& url) override;
|
|
void OnTitleChange(CefRefPtr<CefBrowser> browser,
|
|
const CefString& title) override;
|
|
void OnFaviconURLChange(CefRefPtr<CefBrowser> browser,
|
|
const std::vector<CefString>& icon_urls) override;
|
|
void OnFullscreenModeChange(CefRefPtr<CefBrowser> browser,
|
|
bool fullscreen) override;
|
|
bool OnConsoleMessage(CefRefPtr<CefBrowser> browser,
|
|
cef_log_severity_t level,
|
|
const CefString& message,
|
|
const CefString& source,
|
|
int line) override;
|
|
bool OnAutoResize(CefRefPtr<CefBrowser> browser,
|
|
const CefSize& new_size) override;
|
|
bool OnCursorChange(CefRefPtr<CefBrowser> browser,
|
|
CefCursorHandle cursor,
|
|
cef_cursor_type_t type,
|
|
const CefCursorInfo& custom_cursor_info) override;
|
|
|
|
// CefDownloadHandler methods
|
|
bool CanDownload(CefRefPtr<CefBrowser> browser,
|
|
const CefString& url,
|
|
const CefString& request_method) override;
|
|
bool OnBeforeDownload(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefDownloadItem> download_item,
|
|
const CefString& suggested_name,
|
|
CefRefPtr<CefBeforeDownloadCallback> callback) override;
|
|
void OnDownloadUpdated(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefDownloadItem> download_item,
|
|
CefRefPtr<CefDownloadItemCallback> callback) override;
|
|
|
|
// CefDragHandler methods
|
|
bool OnDragEnter(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefDragData> dragData,
|
|
CefDragHandler::DragOperationsMask mask) override;
|
|
void OnDraggableRegionsChanged(
|
|
CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
const std::vector<CefDraggableRegion>& regions) override;
|
|
|
|
// CefFocusHandler methods
|
|
void OnTakeFocus(CefRefPtr<CefBrowser> browser, bool next) override;
|
|
bool OnSetFocus(CefRefPtr<CefBrowser> browser, FocusSource source) override;
|
|
|
|
// CefKeyboardHandler methods
|
|
bool OnPreKeyEvent(CefRefPtr<CefBrowser> browser,
|
|
const CefKeyEvent& event,
|
|
CefEventHandle os_event,
|
|
bool* is_keyboard_shortcut) override;
|
|
|
|
// CefLifeSpanHandler methods
|
|
bool OnBeforePopup(
|
|
CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
const CefString& target_url,
|
|
const CefString& target_frame_name,
|
|
CefLifeSpanHandler::WindowOpenDisposition target_disposition,
|
|
bool user_gesture,
|
|
const CefPopupFeatures& popupFeatures,
|
|
CefWindowInfo& windowInfo,
|
|
CefRefPtr<CefClient>& client,
|
|
CefBrowserSettings& settings,
|
|
CefRefPtr<CefDictionaryValue>& extra_info,
|
|
bool* no_javascript_access) override;
|
|
void OnBeforeDevToolsPopup(CefRefPtr<CefBrowser> browser,
|
|
CefWindowInfo& windowInfo,
|
|
CefRefPtr<CefClient>& client,
|
|
CefBrowserSettings& settings,
|
|
CefRefPtr<CefDictionaryValue>& extra_info,
|
|
bool* use_default_window) override;
|
|
void OnAfterCreated(CefRefPtr<CefBrowser> browser) override;
|
|
bool DoClose(CefRefPtr<CefBrowser> browser) override;
|
|
void OnBeforeClose(CefRefPtr<CefBrowser> browser) override;
|
|
|
|
// CefLoadHandler methods
|
|
void OnLoadingStateChange(CefRefPtr<CefBrowser> browser,
|
|
bool isLoading,
|
|
bool canGoBack,
|
|
bool canGoForward) override;
|
|
void OnLoadError(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
ErrorCode errorCode,
|
|
const CefString& errorText,
|
|
const CefString& failedUrl) override;
|
|
|
|
// CefPermissionHandler methods
|
|
bool OnRequestMediaAccessPermission(
|
|
CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
const CefString& requesting_origin,
|
|
uint32_t requested_permissions,
|
|
CefRefPtr<CefMediaAccessCallback> callback) override;
|
|
|
|
// CefRequestHandler methods
|
|
bool OnOpenURLFromTab(
|
|
CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
const CefString& target_url,
|
|
CefRequestHandler::WindowOpenDisposition target_disposition,
|
|
bool user_gesture) override;
|
|
CefRefPtr<CefResourceRequestHandler> GetResourceRequestHandler(
|
|
CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
CefRefPtr<CefRequest> request,
|
|
bool is_navigation,
|
|
bool is_download,
|
|
const CefString& request_initiator,
|
|
bool& disable_default_handling) override;
|
|
bool GetAuthCredentials(CefRefPtr<CefBrowser> browser,
|
|
const CefString& origin_url,
|
|
bool isProxy,
|
|
const CefString& host,
|
|
int port,
|
|
const CefString& realm,
|
|
const CefString& scheme,
|
|
CefRefPtr<CefAuthCallback> callback) override;
|
|
bool OnCertificateError(CefRefPtr<CefBrowser> browser,
|
|
ErrorCode cert_error,
|
|
const CefString& request_url,
|
|
CefRefPtr<CefSSLInfo> ssl_info,
|
|
CefRefPtr<CefCallback> callback) override;
|
|
bool OnSelectClientCertificate(
|
|
CefRefPtr<CefBrowser> browser,
|
|
bool isProxy,
|
|
const CefString& host,
|
|
int port,
|
|
const X509CertificateList& certificates,
|
|
CefRefPtr<CefSelectClientCertificateCallback> callback) override;
|
|
void OnRenderProcessTerminated(CefRefPtr<CefBrowser> browser,
|
|
TerminationStatus status,
|
|
int error_code,
|
|
const CefString& error_string) override;
|
|
void OnDocumentAvailableInMainFrame(CefRefPtr<CefBrowser> browser) override;
|
|
|
|
// CefResourceRequestHandler methods
|
|
void OnProtocolExecution(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefFrame> frame,
|
|
CefRefPtr<CefRequest> request,
|
|
bool& allow_os_execution) override;
|
|
|
|
// Show a new DevTools popup window.
|
|
void ShowDevTools(CefRefPtr<CefBrowser> browser,
|
|
const CefPoint& inspect_element_at);
|
|
|
|
// Close the existing DevTools popup window, if any.
|
|
void CloseDevTools(CefRefPtr<CefBrowser> browser);
|
|
|
|
// Test if the current site has SSL information available.
|
|
bool HasSSLInformation(CefRefPtr<CefBrowser> browser);
|
|
|
|
// Show SSL information for the current site.
|
|
void ShowSSLInformation(CefRefPtr<CefBrowser> browser);
|
|
|
|
// Returns the Delegate.
|
|
Delegate* delegate() const { return delegate_; }
|
|
|
|
// Returns the startup URL.
|
|
std::string startup_url() const { return startup_url_; }
|
|
|
|
// Set/get whether the client should download favicon images. Only safe to
|
|
// call immediately after client creation or on the browser process UI thread.
|
|
bool download_favicon_images() const { return download_favicon_images_; }
|
|
void set_download_favicon_images(bool allow) {
|
|
download_favicon_images_ = allow;
|
|
}
|
|
|
|
private:
|
|
friend class ClientDownloadImageCallback;
|
|
|
|
// Create a new popup window using the specified information. |is_devtools|
|
|
// will be true if the window will be used for DevTools. Returns true if a
|
|
// RootWindow was created for the popup.
|
|
bool CreatePopupWindow(CefRefPtr<CefBrowser> browser,
|
|
bool is_devtools,
|
|
const CefPopupFeatures& popupFeatures,
|
|
CefWindowInfo& windowInfo,
|
|
CefRefPtr<CefClient>& client,
|
|
CefBrowserSettings& settings);
|
|
|
|
// Execute Delegate notifications on the main thread.
|
|
void NotifyBrowserCreated(CefRefPtr<CefBrowser> browser);
|
|
void NotifyBrowserClosing(CefRefPtr<CefBrowser> browser);
|
|
void NotifyBrowserClosed(CefRefPtr<CefBrowser> browser);
|
|
void NotifyAddress(const CefString& url);
|
|
void NotifyTitle(const CefString& title);
|
|
void NotifyFavicon(CefRefPtr<CefImage> image);
|
|
void NotifyFullscreen(bool fullscreen);
|
|
void NotifyAutoResize(const CefSize& new_size);
|
|
void NotifyLoadingState(bool isLoading, bool canGoBack, bool canGoForward);
|
|
void NotifyDraggableRegions(const std::vector<CefDraggableRegion>& regions);
|
|
void NotifyTakeFocus(bool next);
|
|
|
|
// Test context menu creation.
|
|
void BuildTestMenu(CefRefPtr<CefBrowser> browser,
|
|
CefRefPtr<CefMenuModel> model);
|
|
bool ExecuteTestMenu(CefRefPtr<CefBrowser> browser, int command_id);
|
|
|
|
void SetOfflineState(CefRefPtr<CefBrowser> browser, bool offline);
|
|
|
|
// THREAD SAFE MEMBERS
|
|
// The following members may be accessed from any thread.
|
|
|
|
// True if this handler uses Views.
|
|
const bool use_views_;
|
|
|
|
// True if this handler uses Alloy style.
|
|
const bool use_alloy_style_;
|
|
|
|
// True if this handler uses off-screen rendering.
|
|
const bool is_osr_;
|
|
|
|
// True if this handler shows controls.
|
|
const bool with_controls_;
|
|
|
|
// The startup URL.
|
|
const std::string startup_url_;
|
|
|
|
// True if mouse cursor change is disabled.
|
|
bool mouse_cursor_change_disabled_;
|
|
|
|
// True if media handling is disabled.
|
|
bool media_handling_disabled_ = true;
|
|
|
|
// True if the browser is currently offline.
|
|
bool offline_;
|
|
|
|
// True if the Chrome toolbar and menu contents/commands should be filtered.
|
|
bool filter_chrome_commands_;
|
|
|
|
// True if Favicon images should be downloaded.
|
|
bool download_favicon_images_ = false;
|
|
|
|
#if defined(OS_LINUX)
|
|
// Custom dialog handlers for GTK.
|
|
CefRefPtr<ClientDialogHandlerGtk> file_dialog_handler_;
|
|
CefRefPtr<ClientDialogHandlerGtk> js_dialog_handler_;
|
|
CefRefPtr<ClientPrintHandlerGtk> print_handler_;
|
|
#endif
|
|
|
|
// MAIN THREAD MEMBERS
|
|
// The following members will only be accessed on the main thread. This will
|
|
// be the same as the CEF UI thread except when using multi-threaded message
|
|
// loop mode on Windows.
|
|
|
|
Delegate* delegate_;
|
|
|
|
// UI THREAD MEMBERS
|
|
// The following members will only be accessed on the CEF UI thread.
|
|
|
|
// Track state information for the test context menu.
|
|
struct TestMenuState {
|
|
TestMenuState() = default;
|
|
bool check_item = true;
|
|
int radio_item = 0;
|
|
int chrome_theme_mode_item = -1;
|
|
int chrome_theme_color_item = -1;
|
|
} test_menu_state_;
|
|
|
|
// Console logging state.
|
|
const std::string console_log_file_;
|
|
|
|
// True if an editable field currently has focus.
|
|
bool focus_on_editable_field_ = false;
|
|
|
|
// True for the initial navigation after browser creation.
|
|
bool initial_navigation_ = true;
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(ClientHandler);
|
|
};
|
|
|
|
} // namespace client
|
|
|
|
#endif // CEF_TESTS_CEFCLIENT_BROWSER_CLIENT_HANDLER_H_
|