Source/WebCore/page/Frame.h - WebKit - Git at Google

 /*
  * Copyright (C) 1998, 1999 Torben Weis <weis@kde.org>
  *                     1999-2001 Lars Knoll <knoll@kde.org>
  *                     1999-2001 Antti Koivisto <koivisto@kde.org>
  *                     2000-2001 Simon Hausmann <hausmann@kde.org>
  *                     2000-2001 Dirk Mueller <mueller@kde.org>
  *                     2000 Stefan Schimanski <1Stein@gmx.de>
  * Copyright (C) 2004-2018 Apple Inc. All rights reserved.
  * Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies)
  * Copyright (C) 2008 Eric Seidel <eric@webkit.org>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public
  * License as published by the Free Software Foundation; either
  * version 2 of the License, or (at your option) any later version.
  *
  * This library is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Library General Public License for more details.
  *
  * You should have received a copy of the GNU Library General Public License
  * along with this library; see the file COPYING.LIB.  If not, write to
  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  * Boston, MA 02110-1301, USA.
  */

 #pragma once

 #include "AbstractFrame.h"
 #include "AdjustViewSizeOrNot.h"
 #include "Document.h"
 #include "FrameIdentifier.h"
 #include "FrameTree.h"
 #include "PageIdentifier.h"
 #include "ScrollTypes.h"
 #include "UserScriptTypes.h"
 #include <wtf/HashSet.h>
 #include <wtf/UniqueRef.h>

 #if PLATFORM(IOS_FAMILY)
 #include "Timer.h"
 #include "ViewportArguments.h"
 #include "VisibleSelection.h"
 #endif

 #if PLATFORM(WIN)
 #include "FrameWin.h"
 #endif

 #if PLATFORM(COCOA)
 OBJC_CLASS NSArray;
 #endif

 #if PLATFORM(WIN)
 typedef struct HBITMAP__* HBITMAP;
 #endif

 typedef const struct OpaqueJSContext* JSContextRef;
 typedef const struct OpaqueJSValue* JSValueRef;

 namespace JSC { namespace Yarr {
 class RegularExpression;
 } }

 namespace WTF {
 class TextStream;
 }

 namespace WebCore {

 class Color;
 class DOMWindow;
 class DataDetectionResultsStorage;
 class Document;
 class Editor;
 class Element;
 class EventHandler;
 class FloatSize;
 class FrameDestructionObserver;
 class FrameLoader;
 class FrameLoaderClient;
 class FrameSelection;
 class FrameView;
 class HTMLFrameOwnerElement;
 class HTMLTableCellElement;
 class HitTestResult;
 class ImageBuffer;
 class IntPoint;
 class IntRect;
 class IntSize;
 class NavigationScheduler;
 class Node;
 class Page;
 class RenderLayer;
 class RenderView;
 class RenderWidget;
 class ScriptController;
 class SecurityOrigin;
 class Settings;
 class VisiblePosition;
 class Widget;

 struct SimpleRange;

 #if PLATFORM(IOS_FAMILY)
 enum {
     OverflowScrollNone = 0,
     OverflowScrollLeft = 1 << 0,
     OverflowScrollRight = 1 << 1,
     OverflowScrollUp = 1 << 2,
     OverflowScrollDown = 1 << 3
 };

 enum OverflowScrollAction { DoNotPerformOverflowScroll, PerformOverflowScroll };
 using NodeQualifier = Function<Node* (const HitTestResult&, Node* terminationNode, IntRect* nodeBounds)>;
 #endif

 // FIXME: Rename Frame to LocalFrame and AbstractFrame to Frame.
 class Frame final : public AbstractFrame {
 public:
     WEBCORE_EXPORT static Ref<Frame> create(Page*, HTMLFrameOwnerElement*, UniqueRef<FrameLoaderClient>&&);

     WEBCORE_EXPORT void init();
 #if PLATFORM(IOS_FAMILY)
     // Creates <html><body style="..."></body></html> doing minimal amount of work.
     WEBCORE_EXPORT void initWithSimpleHTMLDocument(const AtomString& style, const URL&);
 #endif
     WEBCORE_EXPORT void setView(RefPtr<FrameView>&&);
     WEBCORE_EXPORT void createView(const IntSize&, const std::optional<Color>& backgroundColor,
         const IntSize& fixedLayoutSize, const IntRect& fixedVisibleContentRect,
         bool useFixedLayout = false, ScrollbarMode = ScrollbarMode::Auto, bool horizontalLock = false,
         ScrollbarMode = ScrollbarMode::Auto, bool verticalLock = false);

     WEBCORE_EXPORT ~Frame();

     WEBCORE_EXPORT DOMWindow* window() const;

     void addDestructionObserver(FrameDestructionObserver&);
     void removeDestructionObserver(FrameDestructionObserver&);

     WEBCORE_EXPORT void willDetachPage();
     void detachFromPage();
     void disconnectOwnerElement();

     Frame& mainFrame() const;
     bool isMainFrame() const { return this == static_cast<void*>(&m_mainFrame); }

     WEBCORE_EXPORT Page* page() const;
     WEBCORE_EXPORT HTMLFrameOwnerElement* ownerElement() const;

     Document* document() const;
     FrameView* view() const;

     Editor& editor() { return document()->editor(); }
     const Editor& editor() const { return document()->editor(); }
     EventHandler& eventHandler() { return m_eventHandler; }
     const EventHandler& eventHandler() const { return m_eventHandler; }
     const FrameLoader& loader() const { return m_loader.get(); }
     FrameLoader& loader() { return m_loader.get(); }
     NavigationScheduler& navigationScheduler() const;
     FrameSelection& selection() { return document()->selection(); }
     const FrameSelection& selection() const { return document()->selection(); }
     FrameTree& tree() const;
     ScriptController& script() { return m_script; }
     const ScriptController& script() const { return m_script; }
     void resetScript();

     WEBCORE_EXPORT std::optional<PageIdentifier> pageID() const;
     WEBCORE_EXPORT std::optional<FrameIdentifier> frameID() const;

     WEBCORE_EXPORT RenderView* contentRenderer() const; // Root of the render tree for the document contained in this frame.
     WEBCORE_EXPORT RenderWidget* ownerRenderer() const; // Renderer for the element that contains this frame.

     bool documentIsBeingReplaced() const { return m_documentIsBeingReplaced; }

     bool hasHadUserInteraction() const { return m_hasHadUserInteraction; }
     void setHasHadUserInteraction() { m_hasHadUserInteraction = true; }

     bool requestDOMPasteAccess(DOMPasteAccessCategory = DOMPasteAccessCategory::General);

     String debugDescription() const;

     WEBCORE_EXPORT static Frame* fromJSContext(JSContextRef);
     WEBCORE_EXPORT static Frame* contentFrameFromWindowOrFrameElement(JSContextRef, JSValueRef);

 // ======== All public functions below this point are candidates to move out of Frame into another class. ========

     WEBCORE_EXPORT void injectUserScripts(UserScriptInjectionTime);
     WEBCORE_EXPORT void injectUserScriptImmediately(DOMWrapperWorld&, const UserScript&);

     void injectUserScriptsAwaitingNotification();
     void addUserScriptAwaitingNotification(DOMWrapperWorld&, const UserScript&);

     WEBCORE_EXPORT String trackedRepaintRectsAsText() const;

     WEBCORE_EXPORT static Frame* frameForWidget(const Widget&);

     Settings& settings() const { return *m_settings; }

     void setPrinting(bool printing, const FloatSize& pageSize, const FloatSize& originalPageSize, float maximumShrinkRatio, AdjustViewSizeOrNot);
     bool shouldUsePrintingLayout() const;
     WEBCORE_EXPORT FloatSize resizePageRectsKeepingRatio(const FloatSize& originalSize, const FloatSize& expectedSize);

     void setDocument(RefPtr<Document>&&);

     WEBCORE_EXPORT void setPageZoomFactor(float);
     float pageZoomFactor() const { return m_pageZoomFactor; }
     WEBCORE_EXPORT void setTextZoomFactor(float);
     float textZoomFactor() const { return m_textZoomFactor; }
     WEBCORE_EXPORT void setPageAndTextZoomFactors(float pageZoomFactor, float textZoomFactor);

     // Scale factor of this frame with respect to the container.
     WEBCORE_EXPORT float frameScaleFactor() const;

     void deviceOrPageScaleFactorChanged();

 #if ENABLE(DATA_DETECTION)
     DataDetectionResultsStorage* dataDetectionResultsIfExists() const { return m_dataDetectionResults.get(); }
     WEBCORE_EXPORT DataDetectionResultsStorage& dataDetectionResults();
 #endif

 #if PLATFORM(IOS_FAMILY)
     const ViewportArguments& viewportArguments() const;
     WEBCORE_EXPORT void setViewportArguments(const ViewportArguments&);

     WEBCORE_EXPORT Node* deepestNodeAtLocation(const FloatPoint& viewportLocation);
     WEBCORE_EXPORT Node* nodeRespondingToClickEvents(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation, SecurityOrigin* = nullptr);
     WEBCORE_EXPORT Node* nodeRespondingToDoubleClickEvent(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation);
     WEBCORE_EXPORT Node* nodeRespondingToInteraction(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation);
     WEBCORE_EXPORT Node* nodeRespondingToScrollWheelEvents(const FloatPoint& viewportLocation);
     WEBCORE_EXPORT Node* approximateNodeAtViewportLocationLegacy(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation);

     WEBCORE_EXPORT NSArray *wordsInCurrentParagraph() const;
     WEBCORE_EXPORT CGRect renderRectForPoint(CGPoint, bool* isReplaced, float* fontSize) const;

     WEBCORE_EXPORT void setSelectionChangeCallbacksDisabled(bool = true);
     bool selectionChangeCallbacksDisabled() const;

     enum ViewportOffsetChangeType { IncrementalScrollOffset, CompletedScrollOffset };
     WEBCORE_EXPORT void viewportOffsetChanged(ViewportOffsetChangeType);
     bool containsTiledBackingLayers() const;

     WEBCORE_EXPORT void overflowScrollPositionChangedForNode(const IntPoint&, Node*, bool isUserScroll);

     WEBCORE_EXPORT void resetAllGeolocationPermission();
 #endif

 #if ENABLE(ORIENTATION_EVENTS)
     // Orientation is the interface orientation in degrees. Some examples are:
     //  0 is straight up; -90 is when the device is rotated 90 clockwise;
     //  90 is when rotated counter clockwise.
     WEBCORE_EXPORT void orientationChanged();
     int orientation() const;
 #endif

     void clearTimers();
     static void clearTimers(FrameView*, Document*);

     WEBCORE_EXPORT String displayStringModifiedByEncoding(const String&) const;

     WEBCORE_EXPORT VisiblePosition visiblePositionForPoint(const IntPoint& framePoint) const;
     Document* documentAtPoint(const IntPoint& windowPoint);
     WEBCORE_EXPORT std::optional<SimpleRange> rangeForPoint(const IntPoint& framePoint);

     WEBCORE_EXPORT String searchForLabelsAboveCell(const JSC::Yarr::RegularExpression&, HTMLTableCellElement*, size_t* resultDistanceFromStartOfCell);
     String searchForLabelsBeforeElement(const Vector<String>& labels, Element*, size_t* resultDistance, bool* resultIsInCellAbove);
     String matchLabelsAgainstElement(const Vector<String>& labels, Element*);

 #if PLATFORM(IOS_FAMILY)
     WEBCORE_EXPORT int preferredHeight() const;
     WEBCORE_EXPORT void updateLayout() const;
     WEBCORE_EXPORT NSRect caretRect();
     WEBCORE_EXPORT NSRect rectForScrollToVisible();

     // This function is used by Legacy WebKit.
     WEBCORE_EXPORT void setTimersPaused(bool);

     WEBCORE_EXPORT void dispatchPageHideEventBeforePause();
     WEBCORE_EXPORT void dispatchPageShowEventBeforeResume();
     WEBCORE_EXPORT void setRangedSelectionBaseToCurrentSelection();
     WEBCORE_EXPORT void setRangedSelectionBaseToCurrentSelectionStart();
     WEBCORE_EXPORT void setRangedSelectionBaseToCurrentSelectionEnd();
     WEBCORE_EXPORT void clearRangedSelectionInitialExtent();
     WEBCORE_EXPORT void setRangedSelectionInitialExtentToCurrentSelectionStart();
     WEBCORE_EXPORT void setRangedSelectionInitialExtentToCurrentSelectionEnd();
     WEBCORE_EXPORT VisibleSelection rangedSelectionBase() const;
     WEBCORE_EXPORT VisibleSelection rangedSelectionInitialExtent() const;
     WEBCORE_EXPORT void recursiveSetUpdateAppearanceEnabled(bool);
     WEBCORE_EXPORT NSArray *interpretationsForCurrentRoot() const;
 #endif
     void suspendActiveDOMObjectsAndAnimations();
     void resumeActiveDOMObjectsAndAnimations();
     bool activeDOMObjectsAndAnimationsSuspended() const { return m_activeDOMObjectsAndAnimationsSuspendedCount > 0; }

     enum class InvalidateContentEventRegionsReason { Layout, EventHandlerChange };
     void invalidateContentEventRegionsIfNeeded(InvalidateContentEventRegionsReason);

     WEBCORE_EXPORT FloatSize screenSize() const;
     void setOverrideScreenSize(FloatSize&&);

     void selfOnlyRef();
     void selfOnlyDeref();

     WEBCORE_EXPORT bool arePluginsEnabled();

 private:
     friend class NavigationDisabler;

     Frame(Page&, HTMLFrameOwnerElement*, UniqueRef<FrameLoaderClient>&&);

     void dropChildren();

     bool isLocalFrame() const final { return true; }
     bool isRemoteFrame() const final { return false; }

     AbstractDOMWindow* virtualWindow() const final;

     HashSet<FrameDestructionObserver*> m_destructionObservers;

     Vector<std::pair<Ref<DOMWrapperWorld>, UniqueRef<UserScript>>> m_userScriptsAwaitingNotification;

     Frame& m_mainFrame;
     WeakPtr<Page> m_page;
     const RefPtr<Settings> m_settings;
     mutable FrameTree m_treeNode;
     UniqueRef<FrameLoader> m_loader;
     mutable UniqueRef<NavigationScheduler> m_navigationScheduler;

     WeakPtr<HTMLFrameOwnerElement> m_ownerElement;
     RefPtr<FrameView> m_view;
     RefPtr<Document> m_doc;

     UniqueRef<ScriptController> m_script;

 #if ENABLE(DATA_DETECTION)
     std::unique_ptr<DataDetectionResultsStorage> m_dataDetectionResults;
 #endif
 #if PLATFORM(IOS_FAMILY)
     void betterApproximateNode(const IntPoint& testPoint, const NodeQualifier&, Node*& best, Node* failedNode, IntPoint& bestPoint, IntRect& bestRect, const IntRect& testRect);
     bool hitTestResultAtViewportLocation(const FloatPoint& viewportLocation, HitTestResult&, IntPoint& center);

     enum class ShouldApproximate : bool { No, Yes };
     enum class ShouldFindRootEditableElement : bool { No, Yes };
     Node* qualifyingNodeAtViewportLocation(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation, const NodeQualifier&, ShouldApproximate, ShouldFindRootEditableElement = ShouldFindRootEditableElement::Yes);

     void setTimersPausedInternal(bool);

     ViewportArguments m_viewportArguments;
     bool m_selectionChangeCallbacksDisabled { false };
     VisibleSelection m_rangedSelectionBase;
     VisibleSelection m_rangedSelectionInitialExtent;
 #endif

     float m_pageZoomFactor;
     float m_textZoomFactor;

     int m_activeDOMObjectsAndAnimationsSuspendedCount { 0 };
     bool m_documentIsBeingReplaced { false };
     unsigned m_navigationDisableCount { 0 };
     unsigned m_selfOnlyRefCount { 0 };
     bool m_hasHadUserInteraction { false };

     FloatSize m_overrideScreenSize;

     UniqueRef<EventHandler> m_eventHandler;
 };

 inline NavigationScheduler& Frame::navigationScheduler() const
 {
     return m_navigationScheduler.get();
 }

 inline FrameView* Frame::view() const
 {
     return m_view.get();
 }

 inline Document* Frame::document() const
 {
     return m_doc.get();
 }

 inline FrameTree& Frame::tree() const
 {
     return m_treeNode;
 }

 inline void Frame::detachFromPage()
 {
     m_page = nullptr;
 }

 inline Frame& Frame::mainFrame() const
 {
     return m_mainFrame;
 }

 WTF::TextStream& operator<<(WTF::TextStream&, const Frame&);

 } // namespace WebCore

 SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::Frame)
     static bool isType(const WebCore::AbstractFrame& frame) { return frame.isLocalFrame(); }
 SPECIALIZE_TYPE_TRAITS_END()
	/*
	* Copyright (C) 1998, 1999 Torben Weis <weis@kde.org>
	* 1999-2001 Lars Knoll <knoll@kde.org>
	* 1999-2001 Antti Koivisto <koivisto@kde.org>
	* 2000-2001 Simon Hausmann <hausmann@kde.org>
	* 2000-2001 Dirk Mueller <mueller@kde.org>
	* 2000 Stefan Schimanski <1Stein@gmx.de>
	* Copyright (C) 2004-2018 Apple Inc. All rights reserved.
	* Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies)
	* Copyright (C) 2008 Eric Seidel <eric@webkit.org>
	*
	* This library is free software; you can redistribute it and/or
	* modify it under the terms of the GNU Library General Public
	* License as published by the Free Software Foundation; either
	* version 2 of the License, or (at your option) any later version.
	*
	* This library is distributed in the hope that it will be useful,
	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	* Library General Public License for more details.
	*
	* You should have received a copy of the GNU Library General Public License
	* along with this library; see the file COPYING.LIB. If not, write to
	* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
	* Boston, MA 02110-1301, USA.
	*/

	#pragma once

	#include "AbstractFrame.h"
	#include "AdjustViewSizeOrNot.h"
	#include "Document.h"
	#include "FrameIdentifier.h"
	#include "FrameTree.h"
	#include "PageIdentifier.h"
	#include "ScrollTypes.h"
	#include "UserScriptTypes.h"
	#include <wtf/HashSet.h>
	#include <wtf/UniqueRef.h>

	#if PLATFORM(IOS_FAMILY)
	#include "Timer.h"
	#include "ViewportArguments.h"
	#include "VisibleSelection.h"
	#endif

	#if PLATFORM(WIN)
	#include "FrameWin.h"
	#endif

	#if PLATFORM(COCOA)
	OBJC_CLASS NSArray;
	#endif

	#if PLATFORM(WIN)
	typedef struct HBITMAP__* HBITMAP;
	#endif

	typedef const struct OpaqueJSContext* JSContextRef;
	typedef const struct OpaqueJSValue* JSValueRef;

	namespace JSC { namespace Yarr {
	class RegularExpression;
	} }

	namespace WTF {
	class TextStream;
	}

	namespace WebCore {

	class Color;
	class DOMWindow;
	class DataDetectionResultsStorage;
	class Document;
	class Editor;
	class Element;
	class EventHandler;
	class FloatSize;
	class FrameDestructionObserver;
	class FrameLoader;
	class FrameLoaderClient;
	class FrameSelection;
	class FrameView;
	class HTMLFrameOwnerElement;
	class HTMLTableCellElement;
	class HitTestResult;
	class ImageBuffer;
	class IntPoint;
	class IntRect;
	class IntSize;
	class NavigationScheduler;
	class Node;
	class Page;
	class RenderLayer;
	class RenderView;
	class RenderWidget;
	class ScriptController;
	class SecurityOrigin;
	class Settings;
	class VisiblePosition;
	class Widget;

	struct SimpleRange;

	#if PLATFORM(IOS_FAMILY)
	enum {
	OverflowScrollNone = 0,
	OverflowScrollLeft = 1 << 0,
	OverflowScrollRight = 1 << 1,
	OverflowScrollUp = 1 << 2,
	OverflowScrollDown = 1 << 3
	};

	enum OverflowScrollAction { DoNotPerformOverflowScroll, PerformOverflowScroll };
	using NodeQualifier = Function<Node* (const HitTestResult&, Node* terminationNode, IntRect* nodeBounds)>;
	#endif

	// FIXME: Rename Frame to LocalFrame and AbstractFrame to Frame.
	class Frame final : public AbstractFrame {
	public:
	WEBCORE_EXPORT static Ref<Frame> create(Page, HTMLFrameOwnerElement, UniqueRef<FrameLoaderClient>&&);

	WEBCORE_EXPORT void init();
	#if PLATFORM(IOS_FAMILY)
	// Creates <html><body style="..."></body></html> doing minimal amount of work.
	WEBCORE_EXPORT void initWithSimpleHTMLDocument(const AtomString& style, const URL&);
	#endif
	WEBCORE_EXPORT void setView(RefPtr<FrameView>&&);
	WEBCORE_EXPORT void createView(const IntSize&, const std::optional<Color>& backgroundColor,
	const IntSize& fixedLayoutSize, const IntRect& fixedVisibleContentRect,
	bool useFixedLayout = false, ScrollbarMode = ScrollbarMode::Auto, bool horizontalLock = false,
	ScrollbarMode = ScrollbarMode::Auto, bool verticalLock = false);

	WEBCORE_EXPORT ~Frame();

	WEBCORE_EXPORT DOMWindow* window() const;

	void addDestructionObserver(FrameDestructionObserver&);
	void removeDestructionObserver(FrameDestructionObserver&);

	WEBCORE_EXPORT void willDetachPage();
	void detachFromPage();
	void disconnectOwnerElement();

	Frame& mainFrame() const;
	bool isMainFrame() const { return this == static_cast<void*>(&m_mainFrame); }

	WEBCORE_EXPORT Page* page() const;
	WEBCORE_EXPORT HTMLFrameOwnerElement* ownerElement() const;

	Document* document() const;
	FrameView* view() const;

	Editor& editor() { return document()->editor(); }
	const Editor& editor() const { return document()->editor(); }
	EventHandler& eventHandler() { return m_eventHandler; }
	const EventHandler& eventHandler() const { return m_eventHandler; }
	const FrameLoader& loader() const { return m_loader.get(); }
	FrameLoader& loader() { return m_loader.get(); }
	NavigationScheduler& navigationScheduler() const;
	FrameSelection& selection() { return document()->selection(); }
	const FrameSelection& selection() const { return document()->selection(); }
	FrameTree& tree() const;
	ScriptController& script() { return m_script; }
	const ScriptController& script() const { return m_script; }
	void resetScript();

	WEBCORE_EXPORT std::optional<PageIdentifier> pageID() const;
	WEBCORE_EXPORT std::optional<FrameIdentifier> frameID() const;

	WEBCORE_EXPORT RenderView* contentRenderer() const; // Root of the render tree for the document contained in this frame.
	WEBCORE_EXPORT RenderWidget* ownerRenderer() const; // Renderer for the element that contains this frame.

	bool documentIsBeingReplaced() const { return m_documentIsBeingReplaced; }

	bool hasHadUserInteraction() const { return m_hasHadUserInteraction; }
	void setHasHadUserInteraction() { m_hasHadUserInteraction = true; }

	bool requestDOMPasteAccess(DOMPasteAccessCategory = DOMPasteAccessCategory::General);

	String debugDescription() const;

	WEBCORE_EXPORT static Frame* fromJSContext(JSContextRef);
	WEBCORE_EXPORT static Frame* contentFrameFromWindowOrFrameElement(JSContextRef, JSValueRef);

	// ======== All public functions below this point are candidates to move out of Frame into another class. ========

	WEBCORE_EXPORT void injectUserScripts(UserScriptInjectionTime);
	WEBCORE_EXPORT void injectUserScriptImmediately(DOMWrapperWorld&, const UserScript&);

	void injectUserScriptsAwaitingNotification();
	void addUserScriptAwaitingNotification(DOMWrapperWorld&, const UserScript&);

	WEBCORE_EXPORT String trackedRepaintRectsAsText() const;

	WEBCORE_EXPORT static Frame* frameForWidget(const Widget&);

	Settings& settings() const { return *m_settings; }

	void setPrinting(bool printing, const FloatSize& pageSize, const FloatSize& originalPageSize, float maximumShrinkRatio, AdjustViewSizeOrNot);
	bool shouldUsePrintingLayout() const;
	WEBCORE_EXPORT FloatSize resizePageRectsKeepingRatio(const FloatSize& originalSize, const FloatSize& expectedSize);

	void setDocument(RefPtr<Document>&&);

	WEBCORE_EXPORT void setPageZoomFactor(float);
	float pageZoomFactor() const { return m_pageZoomFactor; }
	WEBCORE_EXPORT void setTextZoomFactor(float);
	float textZoomFactor() const { return m_textZoomFactor; }
	WEBCORE_EXPORT void setPageAndTextZoomFactors(float pageZoomFactor, float textZoomFactor);

	// Scale factor of this frame with respect to the container.
	WEBCORE_EXPORT float frameScaleFactor() const;

	void deviceOrPageScaleFactorChanged();

	#if ENABLE(DATA_DETECTION)
	DataDetectionResultsStorage* dataDetectionResultsIfExists() const { return m_dataDetectionResults.get(); }
	WEBCORE_EXPORT DataDetectionResultsStorage& dataDetectionResults();
	#endif

	#if PLATFORM(IOS_FAMILY)
	const ViewportArguments& viewportArguments() const;
	WEBCORE_EXPORT void setViewportArguments(const ViewportArguments&);

	WEBCORE_EXPORT Node* deepestNodeAtLocation(const FloatPoint& viewportLocation);
	WEBCORE_EXPORT Node* nodeRespondingToClickEvents(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation, SecurityOrigin* = nullptr);
	WEBCORE_EXPORT Node* nodeRespondingToDoubleClickEvent(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation);
	WEBCORE_EXPORT Node* nodeRespondingToInteraction(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation);
	WEBCORE_EXPORT Node* nodeRespondingToScrollWheelEvents(const FloatPoint& viewportLocation);
	WEBCORE_EXPORT Node* approximateNodeAtViewportLocationLegacy(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation);

	WEBCORE_EXPORT NSArray *wordsInCurrentParagraph() const;
	WEBCORE_EXPORT CGRect renderRectForPoint(CGPoint, bool* isReplaced, float* fontSize) const;

	WEBCORE_EXPORT void setSelectionChangeCallbacksDisabled(bool = true);
	bool selectionChangeCallbacksDisabled() const;

	enum ViewportOffsetChangeType { IncrementalScrollOffset, CompletedScrollOffset };
	WEBCORE_EXPORT void viewportOffsetChanged(ViewportOffsetChangeType);
	bool containsTiledBackingLayers() const;

	WEBCORE_EXPORT void overflowScrollPositionChangedForNode(const IntPoint&, Node*, bool isUserScroll);

	WEBCORE_EXPORT void resetAllGeolocationPermission();
	#endif

	#if ENABLE(ORIENTATION_EVENTS)
	// Orientation is the interface orientation in degrees. Some examples are:
	// 0 is straight up; -90 is when the device is rotated 90 clockwise;
	// 90 is when rotated counter clockwise.
	WEBCORE_EXPORT void orientationChanged();
	int orientation() const;
	#endif

	void clearTimers();
	static void clearTimers(FrameView, Document);

	WEBCORE_EXPORT String displayStringModifiedByEncoding(const String&) const;

	WEBCORE_EXPORT VisiblePosition visiblePositionForPoint(const IntPoint& framePoint) const;
	Document* documentAtPoint(const IntPoint& windowPoint);
	WEBCORE_EXPORT std::optional<SimpleRange> rangeForPoint(const IntPoint& framePoint);

	WEBCORE_EXPORT String searchForLabelsAboveCell(const JSC::Yarr::RegularExpression&, HTMLTableCellElement, size_t resultDistanceFromStartOfCell);
	String searchForLabelsBeforeElement(const Vector<String>& labels, Element, size_t resultDistance, bool* resultIsInCellAbove);
	String matchLabelsAgainstElement(const Vector<String>& labels, Element*);

	#if PLATFORM(IOS_FAMILY)
	WEBCORE_EXPORT int preferredHeight() const;
	WEBCORE_EXPORT void updateLayout() const;
	WEBCORE_EXPORT NSRect caretRect();
	WEBCORE_EXPORT NSRect rectForScrollToVisible();

	// This function is used by Legacy WebKit.
	WEBCORE_EXPORT void setTimersPaused(bool);

	WEBCORE_EXPORT void dispatchPageHideEventBeforePause();
	WEBCORE_EXPORT void dispatchPageShowEventBeforeResume();
	WEBCORE_EXPORT void setRangedSelectionBaseToCurrentSelection();
	WEBCORE_EXPORT void setRangedSelectionBaseToCurrentSelectionStart();
	WEBCORE_EXPORT void setRangedSelectionBaseToCurrentSelectionEnd();
	WEBCORE_EXPORT void clearRangedSelectionInitialExtent();
	WEBCORE_EXPORT void setRangedSelectionInitialExtentToCurrentSelectionStart();
	WEBCORE_EXPORT void setRangedSelectionInitialExtentToCurrentSelectionEnd();
	WEBCORE_EXPORT VisibleSelection rangedSelectionBase() const;
	WEBCORE_EXPORT VisibleSelection rangedSelectionInitialExtent() const;
	WEBCORE_EXPORT void recursiveSetUpdateAppearanceEnabled(bool);
	WEBCORE_EXPORT NSArray *interpretationsForCurrentRoot() const;
	#endif
	void suspendActiveDOMObjectsAndAnimations();
	void resumeActiveDOMObjectsAndAnimations();
	bool activeDOMObjectsAndAnimationsSuspended() const { return m_activeDOMObjectsAndAnimationsSuspendedCount > 0; }

	enum class InvalidateContentEventRegionsReason { Layout, EventHandlerChange };
	void invalidateContentEventRegionsIfNeeded(InvalidateContentEventRegionsReason);

	WEBCORE_EXPORT FloatSize screenSize() const;
	void setOverrideScreenSize(FloatSize&&);

	void selfOnlyRef();
	void selfOnlyDeref();

	WEBCORE_EXPORT bool arePluginsEnabled();

	private:
	friend class NavigationDisabler;

	Frame(Page&, HTMLFrameOwnerElement*, UniqueRef<FrameLoaderClient>&&);

	void dropChildren();

	bool isLocalFrame() const final { return true; }
	bool isRemoteFrame() const final { return false; }

	AbstractDOMWindow* virtualWindow() const final;

	HashSet<FrameDestructionObserver*> m_destructionObservers;

	Vector<std::pair<Ref<DOMWrapperWorld>, UniqueRef<UserScript>>> m_userScriptsAwaitingNotification;

	Frame& m_mainFrame;
	WeakPtr<Page> m_page;
	const RefPtr<Settings> m_settings;
	mutable FrameTree m_treeNode;
	UniqueRef<FrameLoader> m_loader;
	mutable UniqueRef<NavigationScheduler> m_navigationScheduler;

	WeakPtr<HTMLFrameOwnerElement> m_ownerElement;
	RefPtr<FrameView> m_view;
	RefPtr<Document> m_doc;

	UniqueRef<ScriptController> m_script;

	#if ENABLE(DATA_DETECTION)
	std::unique_ptr<DataDetectionResultsStorage> m_dataDetectionResults;
	#endif
	#if PLATFORM(IOS_FAMILY)
	void betterApproximateNode(const IntPoint& testPoint, const NodeQualifier&, Node& best, Node failedNode, IntPoint& bestPoint, IntRect& bestRect, const IntRect& testRect);
	bool hitTestResultAtViewportLocation(const FloatPoint& viewportLocation, HitTestResult&, IntPoint& center);

	enum class ShouldApproximate : bool { No, Yes };
	enum class ShouldFindRootEditableElement : bool { No, Yes };
	Node* qualifyingNodeAtViewportLocation(const FloatPoint& viewportLocation, FloatPoint& adjustedViewportLocation, const NodeQualifier&, ShouldApproximate, ShouldFindRootEditableElement = ShouldFindRootEditableElement::Yes);

	void setTimersPausedInternal(bool);

	ViewportArguments m_viewportArguments;
	bool m_selectionChangeCallbacksDisabled { false };
	VisibleSelection m_rangedSelectionBase;
	VisibleSelection m_rangedSelectionInitialExtent;
	#endif

	float m_pageZoomFactor;
	float m_textZoomFactor;

	int m_activeDOMObjectsAndAnimationsSuspendedCount { 0 };
	bool m_documentIsBeingReplaced { false };
	unsigned m_navigationDisableCount { 0 };
	unsigned m_selfOnlyRefCount { 0 };
	bool m_hasHadUserInteraction { false };

	FloatSize m_overrideScreenSize;

	UniqueRef<EventHandler> m_eventHandler;
	};

	inline NavigationScheduler& Frame::navigationScheduler() const
	{
	return m_navigationScheduler.get();
	}

	inline FrameView* Frame::view() const
	{
	return m_view.get();
	}

	inline Document* Frame::document() const
	{
	return m_doc.get();
	}

	inline FrameTree& Frame::tree() const
	{
	return m_treeNode;
	}

	inline void Frame::detachFromPage()
	{
	m_page = nullptr;
	}

	inline Frame& Frame::mainFrame() const
	{
	return m_mainFrame;
	}

	WTF::TextStream& operator<<(WTF::TextStream&, const Frame&);

	} // namespace WebCore

	SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::Frame)
	static bool isType(const WebCore::AbstractFrame& frame) { return frame.isLocalFrame(); }
	SPECIALIZE_TYPE_TRAITS_END()