mirror of
				https://bitbucket.org/chromiumembedded/cef
				synced 2025-06-05 21:39:12 +02:00 
			
		
		
		
	With same-site BFCache enabled every navigation can now potentially be served via the BFCache. To support this internally a new top-level RenderFrame object may be created for each new navigation. As a result, OnBrowserCreated may now be called multiple times with the same browser ID in a given renderer process (a behavior previously only seen with cross-site navigations and different renderer processes). BFCache navigations do not trigger the same Chromium notifications as a normal load. To avoid breaking CEF API usage expectations we now synthetically generate the load-related callbacks that would otherwise be missing (OnLoadingStateChange with isLoading=true, OnLoadStart, OnLoadEnd). The |httpStatusCode| argument to OnLoadEnd will be 0 in this case. To test: - Run `FrameHandlerTest.*:MessageRouterTest.*:NavigationTest.*` - Run `NavigationTest.LoadSameOriginLoadURL` for OnBrowserCreated behavior. - Run `NavigationTest.History` for load-related callback behavior.
		
			
				
	
	
		
			140 lines
		
	
	
		
			4.4 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			140 lines
		
	
	
		
			4.4 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
// Copyright (c) 2012 The Chromium Embedded Framework Authors.
 | 
						|
// Portions copyright (c) 2011 The Chromium 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_RENDERER_BLINK_GLUE_H_
 | 
						|
#define CEF_LIBCEF_RENDERER_BLINK_GLUE_H_
 | 
						|
 | 
						|
#include <stdint.h>
 | 
						|
 | 
						|
#include <memory>
 | 
						|
#include <string>
 | 
						|
 | 
						|
#include "include/internal/cef_types.h"
 | 
						|
 | 
						|
#include "third_party/blink/public/mojom/frame/lifecycle.mojom-blink-forward.h"
 | 
						|
#include "third_party/blink/public/platform/web_common.h"
 | 
						|
#include "v8/include/v8.h"
 | 
						|
 | 
						|
namespace blink {
 | 
						|
class WebElement;
 | 
						|
class WebLocalFrame;
 | 
						|
class WebNode;
 | 
						|
class WebString;
 | 
						|
class WebURLRequest;
 | 
						|
class WebURLResponse;
 | 
						|
class WebView;
 | 
						|
 | 
						|
namespace scheduler {
 | 
						|
class WebResourceLoadingTaskRunnerHandle;
 | 
						|
}
 | 
						|
}  // namespace blink
 | 
						|
 | 
						|
namespace blink_glue {
 | 
						|
 | 
						|
BLINK_EXPORT extern const int64_t kInvalidFrameId;
 | 
						|
 | 
						|
BLINK_EXPORT bool CanGoBack(blink::WebView* view);
 | 
						|
BLINK_EXPORT bool CanGoForward(blink::WebView* view);
 | 
						|
BLINK_EXPORT void GoBack(blink::WebView* view);
 | 
						|
BLINK_EXPORT void GoForward(blink::WebView* view);
 | 
						|
 | 
						|
BLINK_EXPORT bool IsInBackForwardCache(blink::WebLocalFrame* frame);
 | 
						|
 | 
						|
// Returns the text of the document element.
 | 
						|
BLINK_EXPORT blink::WebString DumpDocumentText(blink::WebLocalFrame* frame);
 | 
						|
// Returns the markup of the document element.
 | 
						|
BLINK_EXPORT blink::WebString DumpDocumentMarkup(blink::WebLocalFrame* frame);
 | 
						|
 | 
						|
// Expose additional actions on WebNode.
 | 
						|
BLINK_EXPORT cef_dom_node_type_t GetNodeType(const blink::WebNode& node);
 | 
						|
BLINK_EXPORT blink::WebString GetNodeName(const blink::WebNode& node);
 | 
						|
BLINK_EXPORT blink::WebString CreateNodeMarkup(const blink::WebNode& node);
 | 
						|
BLINK_EXPORT bool SetNodeValue(blink::WebNode& node,
 | 
						|
                               const blink::WebString& value);
 | 
						|
 | 
						|
BLINK_EXPORT bool IsTextControlElement(const blink::WebElement& element);
 | 
						|
 | 
						|
BLINK_EXPORT v8::MaybeLocal<v8::Value> CallV8Function(
 | 
						|
    v8::Local<v8::Context> context,
 | 
						|
    v8::Local<v8::Function> function,
 | 
						|
    v8::Local<v8::Object> receiver,
 | 
						|
    int argc,
 | 
						|
    v8::Local<v8::Value> args[],
 | 
						|
    v8::Isolate* isolate);
 | 
						|
 | 
						|
BLINK_EXPORT v8::Local<v8::Value> ExecuteV8ScriptAndReturnValue(
 | 
						|
    const blink::WebString& source,
 | 
						|
    const blink::WebString& source_url,
 | 
						|
    int start_line,
 | 
						|
    v8::Local<v8::Context> context,
 | 
						|
    v8::TryCatch& tryCatch);
 | 
						|
 | 
						|
BLINK_EXPORT bool IsScriptForbidden();
 | 
						|
 | 
						|
class BLINK_EXPORT CefObserverRegistration {
 | 
						|
 public:
 | 
						|
  CefObserverRegistration() = default;
 | 
						|
 | 
						|
  CefObserverRegistration(const CefObserverRegistration&) = delete;
 | 
						|
  CefObserverRegistration& operator=(const CefObserverRegistration&) = delete;
 | 
						|
 | 
						|
  virtual ~CefObserverRegistration() = default;
 | 
						|
};
 | 
						|
 | 
						|
class BLINK_EXPORT CefExecutionContextLifecycleStateObserver {
 | 
						|
 public:
 | 
						|
  virtual void ContextLifecycleStateChanged(
 | 
						|
      blink::mojom::blink::FrameLifecycleState state) {}
 | 
						|
 | 
						|
 protected:
 | 
						|
  virtual ~CefExecutionContextLifecycleStateObserver() = default;
 | 
						|
};
 | 
						|
 | 
						|
// Register an ExecutionContextLifecycleStateObserver. Remains registered until
 | 
						|
// the returned object is destroyed.
 | 
						|
BLINK_EXPORT std::unique_ptr<CefObserverRegistration>
 | 
						|
RegisterExecutionContextLifecycleStateObserver(
 | 
						|
    v8::Local<v8::Context> context,
 | 
						|
    CefExecutionContextLifecycleStateObserver* observer);
 | 
						|
 | 
						|
BLINK_EXPORT void RegisterURLSchemeAsSupportingFetchAPI(
 | 
						|
    const blink::WebString& scheme);
 | 
						|
 | 
						|
// Wrapper for blink::ScriptForbiddenScope.
 | 
						|
class BLINK_EXPORT CefScriptForbiddenScope final {
 | 
						|
 public:
 | 
						|
  CefScriptForbiddenScope();
 | 
						|
 | 
						|
  CefScriptForbiddenScope(const CefScriptForbiddenScope&) = delete;
 | 
						|
  CefScriptForbiddenScope& operator=(const CefScriptForbiddenScope&) = delete;
 | 
						|
 | 
						|
  ~CefScriptForbiddenScope();
 | 
						|
 | 
						|
 private:
 | 
						|
  struct Impl;
 | 
						|
  std::unique_ptr<Impl> impl_;
 | 
						|
};
 | 
						|
 | 
						|
BLINK_EXPORT bool ResponseWasCached(const blink::WebURLResponse& response);
 | 
						|
 | 
						|
// Returns true if the frame owner is a plugin.
 | 
						|
BLINK_EXPORT bool HasPluginFrameOwner(blink::WebLocalFrame* frame);
 | 
						|
 | 
						|
BLINK_EXPORT void StartNavigation(blink::WebLocalFrame* frame,
 | 
						|
                                  const blink::WebURLRequest& request);
 | 
						|
 | 
						|
// Used by CefFrameImpl::CreateURLLoader.
 | 
						|
BLINK_EXPORT
 | 
						|
std::unique_ptr<blink::scheduler::WebResourceLoadingTaskRunnerHandle>
 | 
						|
CreateResourceLoadingTaskRunnerHandle(blink::WebLocalFrame* frame);
 | 
						|
BLINK_EXPORT
 | 
						|
std::unique_ptr<blink::scheduler::WebResourceLoadingTaskRunnerHandle>
 | 
						|
CreateResourceLoadingMaybeUnfreezableTaskRunnerHandle(
 | 
						|
    blink::WebLocalFrame* frame);
 | 
						|
 | 
						|
}  // namespace blink_glue
 | 
						|
 | 
						|
#endif  // CEF_LIBCEF_RENDERER_BLINK_GLUE_H_
 |