cef/libcef_dll/ctocpp/browser_ctocpp.h
Marshall Greenblatt 241941a44a Move message routing from CefBrowser to CefFrame (see issue #2498).
This change moves the SendProcessMessage method from CefBrowser to CefFrame and
adds CefBrowser parameters to OnProcessMessageReceived and
OnDraggableRegionsChanged.

The internal implementation has changed as follows:
- Frame IDs are now a 64-bit combination of the 32-bit render_process_id and
  render_routing_id values that uniquely identify a RenderFrameHost (RFH).
- CefFrameHostImpl objects are now managed by CefBrowserInfo with life span tied
  to RFH expectations. Specifically, a CefFrameHostImpl object representing a
  sub-frame will be created when a RenderFrame is created in the renderer
  process and detached when the associated RenderFrame is deleted or the
  renderer process in which it runs has died.
- The CefFrameHostImpl object representing the main frame will always be valid
  but the underlying RFH (and associated frame ID) may change over time as a
  result of cross-origin navigations. Despite these changes calling LoadURL on
  the main frame object in the browser process will always navigate as expected.
- Speculative RFHs, which may be created as a result of a cross-origin
  navigation and discarded if that navigation is not committed, are now handled
  correctly (e.g. ignored in most cases until they're committed).
- It is less likely, but still possible, to receive a CefFrame object with an
  invalid frame ID (ID < 0). This can happen in cases where a RFH has not yet
  been created for a sub-frame. For example, when OnBeforeBrowse is called
  before initiating navigation in a previously nonexisting sub-frame.

To test: All tests pass with NetworkService enabled and disabled.
2019-05-29 17:44:56 +03:00

62 lines
2.1 KiB
C++

// Copyright (c) 2019 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.
//
// ---------------------------------------------------------------------------
//
// This file was generated by the CEF translator tool. If making changes by
// hand only do so within the body of existing method and function
// implementations. See the translator.README.txt file in the tools directory
// for more information.
//
// $hash=af9ed3cfda9c94f046f4f9b5c9c94b1b38ff2e64$
//
#ifndef CEF_LIBCEF_DLL_CTOCPP_BROWSER_CTOCPP_H_
#define CEF_LIBCEF_DLL_CTOCPP_BROWSER_CTOCPP_H_
#pragma once
#if !defined(WRAPPING_CEF_SHARED)
#error This file can be included wrapper-side only
#endif
#include <vector>
#include "include/capi/cef_browser_capi.h"
#include "include/capi/cef_client_capi.h"
#include "include/cef_browser.h"
#include "include/cef_client.h"
#include "libcef_dll/ctocpp/ctocpp_ref_counted.h"
// Wrap a C structure with a C++ class.
// This class may be instantiated and accessed wrapper-side only.
class CefBrowserCToCpp
: public CefCToCppRefCounted<CefBrowserCToCpp, CefBrowser, cef_browser_t> {
public:
CefBrowserCToCpp();
virtual ~CefBrowserCToCpp();
// CefBrowser methods.
CefRefPtr<CefBrowserHost> GetHost() OVERRIDE;
bool CanGoBack() OVERRIDE;
void GoBack() OVERRIDE;
bool CanGoForward() OVERRIDE;
void GoForward() OVERRIDE;
bool IsLoading() OVERRIDE;
void Reload() OVERRIDE;
void ReloadIgnoreCache() OVERRIDE;
void StopLoad() OVERRIDE;
int GetIdentifier() OVERRIDE;
bool IsSame(CefRefPtr<CefBrowser> that) OVERRIDE;
bool IsPopup() OVERRIDE;
bool HasDocument() OVERRIDE;
CefRefPtr<CefFrame> GetMainFrame() OVERRIDE;
CefRefPtr<CefFrame> GetFocusedFrame() OVERRIDE;
CefRefPtr<CefFrame> GetFrame(int64 identifier) OVERRIDE;
CefRefPtr<CefFrame> GetFrame(const CefString& name) OVERRIDE;
size_t GetFrameCount() OVERRIDE;
void GetFrameIdentifiers(std::vector<int64>& identifiers) OVERRIDE;
void GetFrameNames(std::vector<CefString>& names) OVERRIDE;
};
#endif // CEF_LIBCEF_DLL_CTOCPP_BROWSER_CTOCPP_H_