mirror of
https://bitbucket.org/chromiumembedded/cef
synced 2024-12-14 02:24:03 +01:00
39aed35644
This change allows the client to directly send and receive DevTools protocol messages (send method calls, and receive method results and events) without requiring a DevTools front-end or remote-debugging session. This change includes additional supporting changes: - Add a new CefRequestHandler::OnDocumentAvailableInMainFrame callback (see issue #1454). - Add a CefParseJSON variant that accepts a UTF8-encoded buffer. - Add a `--devtools-protocol-log-file=<path>` command-line flag for logging protocol messages sent to/from the DevTools front-end while it is displayed. This is useful for understanding existing DevTools protocol usage. - Add a new "libcef_static_unittests" executable target to support light-weight unit tests of libcef_static internals (e.g. without requiring exposure via the CEF API). Files to be unittested are placed in the new "libcef_static_unittested" source_set which is then included by both the existing libcef_static library and the new unittests executable target. - Linux: Remove use_bundled_fontconfig=false, which is no longer required and causes unittest build errors (see issue #2424). This change also adds a cefclient demo for configuring offline mode using the DevTools protocol (fixes issue #245). This is controlled by the "Offline mode" context menu option and the `--offline` command-line switch which will launch cefclient in offline mode. When cefclient is offline all network requests will fail with ERR_INTERNET_DISCONNECTED and navigator.onLine will return false when called from JavaScript in any frame. This mode is per-browser so newly created browser windows will have the default mode. Note that configuring offline mode in this way will not update the Network tab UI ("Throtting" option) in a displayed DevTools front-end instance.
70 lines
2.3 KiB
C++
70 lines
2.3 KiB
C++
// Copyright (c) 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_DEVTOOLS_DEVTOOLS_MANAGER_H_
|
|
#define CEF_LIBCEF_BROWSER_DEVTOOLS_DEVTOOLS_MANAGER_H_
|
|
#pragma once
|
|
|
|
#include "include/cef_browser.h"
|
|
|
|
#include "base/memory/weak_ptr.h"
|
|
|
|
class CefBrowserHostImpl;
|
|
class CefDevToolsController;
|
|
class CefDevToolsFrontend;
|
|
|
|
namespace content {
|
|
class WebContents;
|
|
}
|
|
|
|
// Manages DevTools instances. Methods must be called on the UI thread unless
|
|
// otherwise indicated.
|
|
class CefDevToolsManager {
|
|
public:
|
|
// |inspected_browser| will outlive this object.
|
|
explicit CefDevToolsManager(CefBrowserHostImpl* inspected_browser);
|
|
~CefDevToolsManager();
|
|
|
|
// See CefBrowserHost methods of the same name for documentation.
|
|
void ShowDevTools(const CefWindowInfo& windowInfo,
|
|
CefRefPtr<CefClient> client,
|
|
const CefBrowserSettings& settings,
|
|
const CefPoint& inspect_element_at);
|
|
void CloseDevTools();
|
|
bool HasDevTools();
|
|
bool SendDevToolsMessage(const void* message, size_t message_size);
|
|
int ExecuteDevToolsMethod(int message_id,
|
|
const CefString& method,
|
|
CefRefPtr<CefDictionaryValue> param);
|
|
|
|
// These methods are used to implement
|
|
// CefBrowserHost::AddDevToolsMessageObserver. CreateRegistration is safe to
|
|
// call on any thread. InitializeRegistrationOnUIThread should be called
|
|
// immediately afterwards on the UI thread.
|
|
static CefRefPtr<CefRegistration> CreateRegistration(
|
|
CefRefPtr<CefDevToolsMessageObserver> observer);
|
|
void InitializeRegistrationOnUIThread(
|
|
CefRefPtr<CefRegistration> registration);
|
|
|
|
private:
|
|
void OnFrontEndDestroyed();
|
|
|
|
bool EnsureController();
|
|
|
|
CefBrowserHostImpl* const inspected_browser_;
|
|
|
|
// CefDevToolsFrontend will delete itself when the frontend WebContents is
|
|
// destroyed.
|
|
CefDevToolsFrontend* devtools_frontend_ = nullptr;
|
|
|
|
// Used for sending DevTools protocol messages without an active frontend.
|
|
std::unique_ptr<CefDevToolsController> devtools_controller_;
|
|
|
|
base::WeakPtrFactory<CefDevToolsManager> weak_ptr_factory_;
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(CefDevToolsManager);
|
|
};
|
|
|
|
#endif // CEF_LIBCEF_BROWSER_DEVTOOLS_DEVTOOLS_MANAGER_H_
|