Limit user-agent interactions based on the touch-action property on iOS
[WebKit-https.git] / Source / WebCore / dom / Document.h
1 /*
2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
3  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
4  *           (C) 2001 Dirk Mueller (mueller@kde.org)
5  *           (C) 2006 Alexey Proskuryakov (ap@webkit.org)
6  * Copyright (C) 2004-2018 Apple Inc. All rights reserved.
7  * Copyright (C) 2008, 2009 Torch Mobile Inc. All rights reserved. (http://www.torchmobile.com/)
8  * Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies)
9  * Copyright (C) 2011 Google Inc. All rights reserved.
10  *
11  * This library is free software; you can redistribute it and/or
12  * modify it under the terms of the GNU Library General Public
13  * License as published by the Free Software Foundation; either
14  * version 2 of the License, or (at your option) any later version.
15  *
16  * This library is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
19  * Library General Public License for more details.
20  *
21  * You should have received a copy of the GNU Library General Public License
22  * along with this library; see the file COPYING.LIB.  If not, write to
23  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
24  * Boston, MA 02110-1301, USA.
25  *
26  */
27
28 #pragma once
29
30 #include "CSSRegisteredCustomProperty.h"
31 #include "Color.h"
32 #include "ContainerNode.h"
33 #include "DisabledAdaptations.h"
34 #include "DocumentEventQueue.h"
35 #include "DocumentIdentifier.h"
36 #include "DocumentTiming.h"
37 #include "FocusDirection.h"
38 #include "FontSelectorClient.h"
39 #include "FrameDestructionObserver.h"
40 #include "GenericTaskQueue.h"
41 #include "MediaProducer.h"
42 #include "MutationObserver.h"
43 #include "OrientationNotifier.h"
44 #include "PlatformEvent.h"
45 #include "ReferrerPolicy.h"
46 #include "Region.h"
47 #include "RenderPtr.h"
48 #include "ScriptExecutionContext.h"
49 #include "SecurityPolicyViolationEvent.h"
50 #include "StringWithDirection.h"
51 #include "StyleColor.h"
52 #include "Supplementable.h"
53 #include "TextResourceDecoder.h"
54 #include "Timer.h"
55 #include "TreeScope.h"
56 #include "UserActionElementSet.h"
57 #include "ViewportArguments.h"
58 #include "VisibilityState.h"
59 #include <pal/SessionID.h>
60 #include <wtf/Deque.h>
61 #include <wtf/Forward.h>
62 #include <wtf/HashCountedSet.h>
63 #include <wtf/HashSet.h>
64 #include <wtf/Logger.h>
65 #include <wtf/ObjectIdentifier.h>
66 #include <wtf/UniqueRef.h>
67 #include <wtf/WeakPtr.h>
68 #include <wtf/text/AtomicStringHash.h>
69
70 #if PLATFORM(IOS_FAMILY)
71 #include "EventTrackingRegions.h"
72 #endif
73
74 #if ENABLE(IOS_TOUCH_EVENTS)
75 #include <wtf/ThreadingPrimitives.h>
76 #endif
77
78 namespace JSC {
79 class ExecState;
80 class InputCursor;
81 }
82
83 namespace WebCore {
84
85 class ApplicationStateChangeListener;
86 class AXObjectCache;
87 class Attr;
88 class CDATASection;
89 class CSSCustomPropertyValue;
90 class CSSFontSelector;
91 class CSSStyleDeclaration;
92 class CSSStyleSheet;
93 class CachedCSSStyleSheet;
94 class CachedFrameBase;
95 class CachedResourceLoader;
96 class CachedScript;
97 class CanvasRenderingContext2D;
98 class CharacterData;
99 class Comment;
100 class ConstantPropertyMap;
101 class DOMImplementation;
102 class DOMSelection;
103 class DOMWindow;
104 class DOMWrapperWorld;
105 class Database;
106 class DatabaseThread;
107 class DeferredPromise;
108 class DocumentAnimationScheduler;
109 class DocumentFragment;
110 class DocumentLoader;
111 class DocumentMarkerController;
112 class DocumentParser;
113 class DocumentSharedObjectPool;
114 class DocumentTimeline;
115 class DocumentType;
116 class ExtensionStyleSheets;
117 class FloatQuad;
118 class FloatRect;
119 class FontFaceSet;
120 class FormController;
121 class Frame;
122 class FrameView;
123 class HTMLAllCollection;
124 class HTMLBodyElement;
125 class HTMLCanvasElement;
126 class HTMLCollection;
127 class HTMLDocument;
128 class HTMLElement;
129 class HTMLFrameOwnerElement;
130 class HTMLHeadElement;
131 class HTMLIFrameElement;
132 class HTMLImageElement;
133 class HTMLMapElement;
134 class HTMLMediaElement;
135 class HTMLPictureElement;
136 class HTMLScriptElement;
137 class HitTestRequest;
138 class HitTestResult;
139 class ImageBitmapRenderingContext;
140 class IntPoint;
141 class JSNode;
142 class LayoutPoint;
143 class LayoutRect;
144 class LiveNodeList;
145 class Locale;
146 class Location;
147 class MediaCanStartListener;
148 class MediaPlaybackTarget;
149 class MediaPlaybackTargetClient;
150 class MediaQueryList;
151 class MediaQueryMatcher;
152 class MouseEventWithHitTestResults;
153 class NodeFilter;
154 class NodeIterator;
155 class Page;
156 class PaintWorkletGlobalScope;
157 class PlatformMouseEvent;
158 class ProcessingInstruction;
159 class QualifiedName;
160 class Quirks;
161 class Range;
162 class RenderFullScreen;
163 class RenderTreeBuilder;
164 class RenderView;
165 class RequestAnimationFrameCallback;
166 class SVGDocumentExtensions;
167 class SVGSVGElement;
168 class SVGUseElement;
169 class SWClientConnection;
170 class ScriptElementData;
171 class ScriptModuleLoader;
172 class ScriptRunner;
173 class ScriptableDocumentParser;
174 class ScriptedAnimationController;
175 class SecurityOrigin;
176 class SegmentedString;
177 class SelectorQuery;
178 class SelectorQueryCache;
179 class SerializedScriptValue;
180 class Settings;
181 class StringCallback;
182 class StyleResolver;
183 class StyleSheet;
184 class StyleSheetContents;
185 class StyleSheetList;
186 class Text;
187 class TextResourceDecoder;
188 class TreeWalker;
189 class UndoManager;
190 class VisibilityChangeClient;
191 class VisitedLinkState;
192 class WebAnimation;
193 class WebGL2RenderingContext;
194 class WebGLRenderingContext;
195 class WebGPURenderingContext;
196 class WebMetalRenderingContext;
197 class WindowProxy;
198 class Worklet;
199 class XPathEvaluator;
200 class XPathExpression;
201 class XPathNSResolver;
202 class XPathResult;
203
204 template<typename> class ExceptionOr;
205
206 enum CollectionType;
207 enum class ShouldOpenExternalURLsPolicy : uint8_t;
208
209 enum class RouteSharingPolicy : uint8_t;
210
211 using PlatformDisplayID = uint32_t;
212
213 #if ENABLE(XSLT)
214 class TransformSource;
215 #endif
216
217 #if ENABLE(DASHBOARD_SUPPORT)
218 struct AnnotatedRegionValue;
219 #endif
220
221 #if ENABLE(TOUCH_EVENTS) || ENABLE(IOS_TOUCH_EVENTS)
222 class Touch;
223 class TouchList;
224 #endif
225
226 #if PLATFORM(IOS_FAMILY)
227 class DeviceMotionClient;
228 class DeviceMotionController;
229 class DeviceOrientationClient;
230 class DeviceOrientationController;
231 #endif
232
233 #if ENABLE(TEXT_AUTOSIZING)
234 class TextAutoSizing;
235 #endif
236
237 #if ENABLE(MEDIA_SESSION)
238 class MediaSession;
239 #endif
240
241 #if ENABLE(ATTACHMENT_ELEMENT)
242 class HTMLAttachmentElement;
243 #endif
244
245 #if ENABLE(INTERSECTION_OBSERVER)
246 class IntersectionObserver;
247 #endif
248
249 namespace Style {
250 class Scope;
251 };
252
253 const uint64_t HTMLMediaElementInvalidID = 0;
254
255 enum PageshowEventPersistence {
256     PageshowEventNotPersisted = 0,
257     PageshowEventPersisted = 1
258 };
259
260 enum NodeListInvalidationType {
261     DoNotInvalidateOnAttributeChanges = 0,
262     InvalidateOnClassAttrChange,
263     InvalidateOnIdNameAttrChange,
264     InvalidateOnNameAttrChange,
265     InvalidateOnForTypeAttrChange,
266     InvalidateForFormControls,
267     InvalidateOnHRefAttrChange,
268     InvalidateOnAnyAttrChange,
269 };
270 const int numNodeListInvalidationTypes = InvalidateOnAnyAttrChange + 1;
271
272 enum class EventHandlerRemoval { One, All };
273 typedef HashCountedSet<Node*> EventTargetSet;
274
275 enum DocumentClass {
276     DefaultDocumentClass = 0,
277     HTMLDocumentClass = 1,
278     XHTMLDocumentClass = 1 << 1,
279     ImageDocumentClass = 1 << 2,
280     PluginDocumentClass = 1 << 3,
281     MediaDocumentClass = 1 << 4,
282     SVGDocumentClass = 1 << 5,
283     TextDocumentClass = 1 << 6,
284     XMLDocumentClass = 1 << 7,
285 };
286
287 typedef unsigned char DocumentClassFlags;
288
289 enum class DocumentCompatibilityMode : unsigned char {
290     NoQuirksMode = 1,
291     QuirksMode = 1 << 1,
292     LimitedQuirksMode = 1 << 2
293 };
294
295 enum DimensionsCheck { WidthDimensionsCheck = 1 << 0, HeightDimensionsCheck = 1 << 1, AllDimensionsCheck = 1 << 2 };
296
297 enum class SelectionRestorationMode {
298     Restore,
299     SetDefault,
300 };
301
302 enum class HttpEquivPolicy {
303     Enabled,
304     DisabledBySettings,
305     DisabledByContentDispositionAttachmentSandbox
306 };
307
308 enum class CustomElementNameValidationStatus {
309     Valid,
310     FirstCharacterIsNotLowercaseASCIILetter,
311     ContainsNoHyphen,
312     ContainsUppercaseASCIILetter,
313     ContainsDisallowedCharacter,
314     ConflictsWithStandardElementName
315 };
316
317 using RenderingContext = Variant<
318 #if ENABLE(WEBGL)
319     RefPtr<WebGLRenderingContext>,
320 #endif
321 #if ENABLE(WEBGL2)
322     RefPtr<WebGL2RenderingContext>,
323 #endif
324 #if ENABLE(WEBGPU)
325     RefPtr<WebGPURenderingContext>,
326 #endif
327 #if ENABLE(WEBMETAL)
328     RefPtr<WebMetalRenderingContext>,
329 #endif
330     RefPtr<ImageBitmapRenderingContext>,
331     RefPtr<CanvasRenderingContext2D>
332 >;
333
334 class DocumentParserYieldToken {
335 public:
336     WEBCORE_EXPORT DocumentParserYieldToken(Document&);
337     WEBCORE_EXPORT ~DocumentParserYieldToken();
338
339 private:
340     WeakPtr<Document> m_document;
341 };
342
343 class Document
344     : public ContainerNode
345     , public TreeScope
346     , public ScriptExecutionContext
347     , public FontSelectorClient
348     , public CanMakeWeakPtr<Document>
349     , public FrameDestructionObserver
350     , public Supplementable<Document>
351     , public Logger::Observer {
352     WTF_MAKE_ISO_ALLOCATED(Document);
353 public:
354     static Ref<Document> create(Frame* frame, const URL& url)
355     {
356         return adoptRef(*new Document(frame, url));
357     }
358
359     static Ref<Document> createNonRenderedPlaceholder(Frame* frame, const URL& url)
360     {
361         return adoptRef(*new Document(frame, url, DefaultDocumentClass, NonRenderedPlaceholder));
362     }
363     static Ref<Document> create(Document&);
364
365     virtual ~Document();
366
367     // Nodes belonging to this document increase referencingNodeCount -
368     // these are enough to keep the document from being destroyed, but
369     // not enough to keep it from removing its children. This allows a
370     // node that outlives its document to still have a valid document
371     // pointer without introducing reference cycles.
372     void incrementReferencingNodeCount()
373     {
374         ASSERT(!m_deletionHasBegun);
375         ++m_referencingNodeCount;
376     }
377
378     void decrementReferencingNodeCount()
379     {
380         ASSERT(!m_deletionHasBegun || !m_referencingNodeCount);
381         --m_referencingNodeCount;
382         if (!m_referencingNodeCount && !refCount()) {
383 #if !ASSERT_DISABLED
384             m_deletionHasBegun = true;
385 #endif
386             delete this;
387         }
388     }
389
390     unsigned referencingNodeCount() const { return m_referencingNodeCount; }
391
392     void removedLastRef();
393
394     DocumentIdentifier identifier() const { return m_identifier; }
395
396     using DocumentsMap = HashMap<DocumentIdentifier, Document*>;
397     WEBCORE_EXPORT static DocumentsMap::ValuesIteratorRange allDocuments();
398     WEBCORE_EXPORT static DocumentsMap& allDocumentsMap();
399
400     MediaQueryMatcher& mediaQueryMatcher();
401
402     using ContainerNode::ref;
403     using ContainerNode::deref;
404     using TreeScope::rootNode;
405
406     bool canContainRangeEndPoint() const final { return true; }
407
408     Element* getElementByAccessKey(const String& key);
409     void invalidateAccessKeyMap();
410
411     ExceptionOr<SelectorQuery&> selectorQueryForString(const String&);
412     void clearSelectorQueryCache();
413
414     // DOM methods & attributes for Document
415
416     void setViewportArguments(const ViewportArguments& viewportArguments) { m_viewportArguments = viewportArguments; }
417     ViewportArguments viewportArguments() const { return m_viewportArguments; }
418
419     WEBCORE_EXPORT void setOverrideViewportArguments(const Optional<ViewportArguments>&);
420
421     OptionSet<DisabledAdaptations> disabledAdaptations() const { return m_disabledAdaptations; }
422 #ifndef NDEBUG
423     bool didDispatchViewportPropertiesChanged() const { return m_didDispatchViewportPropertiesChanged; }
424 #endif
425
426     void setReferrerPolicy(ReferrerPolicy);
427     ReferrerPolicy referrerPolicy() const { return m_referrerPolicy.valueOr(ReferrerPolicy::NoReferrerWhenDowngrade); }
428
429     WEBCORE_EXPORT DocumentType* doctype() const;
430
431     WEBCORE_EXPORT DOMImplementation& implementation();
432     
433     Element* documentElement() const
434     {
435         return m_documentElement.get();
436     }
437     static ptrdiff_t documentElementMemoryOffset() { return OBJECT_OFFSETOF(Document, m_documentElement); }
438
439     WEBCORE_EXPORT Element* activeElement();
440     WEBCORE_EXPORT bool hasFocus() const;
441
442     bool hasManifest() const;
443     
444     WEBCORE_EXPORT ExceptionOr<Ref<Element>> createElementForBindings(const AtomicString& tagName);
445     WEBCORE_EXPORT Ref<DocumentFragment> createDocumentFragment();
446     WEBCORE_EXPORT Ref<Text> createTextNode(const String& data);
447     WEBCORE_EXPORT Ref<Comment> createComment(const String& data);
448     WEBCORE_EXPORT ExceptionOr<Ref<CDATASection>> createCDATASection(const String& data);
449     WEBCORE_EXPORT ExceptionOr<Ref<ProcessingInstruction>> createProcessingInstruction(const String& target, const String& data);
450     WEBCORE_EXPORT ExceptionOr<Ref<Attr>> createAttribute(const String& name);
451     WEBCORE_EXPORT ExceptionOr<Ref<Attr>> createAttributeNS(const AtomicString& namespaceURI, const String& qualifiedName, bool shouldIgnoreNamespaceChecks = false);
452     WEBCORE_EXPORT ExceptionOr<Ref<Node>> importNode(Node& nodeToImport, bool deep);
453     WEBCORE_EXPORT ExceptionOr<Ref<Element>> createElementNS(const AtomicString& namespaceURI, const String& qualifiedName);
454     WEBCORE_EXPORT Ref<Element> createElement(const QualifiedName&, bool createdByParser);
455
456     static CustomElementNameValidationStatus validateCustomElementName(const AtomicString&);
457
458     WEBCORE_EXPORT RefPtr<Range> caretRangeFromPoint(int x, int y);
459     RefPtr<Range> caretRangeFromPoint(const LayoutPoint& clientPoint);
460
461     WEBCORE_EXPORT Element* scrollingElementForAPI();
462     Element* scrollingElement();
463
464     enum ReadyState {
465         Loading,
466         Interactive,
467         Complete
468     };
469     ReadyState readyState() const { return m_readyState; }
470
471     WEBCORE_EXPORT String defaultCharsetForLegacyBindings() const;
472
473     String charset() const { return Document::encoding(); }
474     WEBCORE_EXPORT String characterSetWithUTF8Fallback() const;
475     TextEncoding textEncoding() const;
476
477     AtomicString encoding() const { return textEncoding().domName(); }
478
479     WEBCORE_EXPORT void setCharset(const String&); // Used by ObjC / GOBject bindings only.
480
481     void setContent(const String&);
482
483     String suggestedMIMEType() const;
484
485     void overrideMIMEType(const String&);
486     WEBCORE_EXPORT String contentType() const;
487
488     String contentLanguage() const { return m_contentLanguage; }
489     void setContentLanguage(const String&);
490
491     String xmlEncoding() const { return m_xmlEncoding; }
492     String xmlVersion() const { return m_xmlVersion; }
493     enum class StandaloneStatus : uint8_t { Unspecified, Standalone, NotStandalone };
494     bool xmlStandalone() const { return m_xmlStandalone == StandaloneStatus::Standalone; }
495     StandaloneStatus xmlStandaloneStatus() const { return m_xmlStandalone; }
496     bool hasXMLDeclaration() const { return m_hasXMLDeclaration; }
497
498     void setXMLEncoding(const String& encoding) { m_xmlEncoding = encoding; } // read-only property, only to be set from XMLDocumentParser
499     WEBCORE_EXPORT ExceptionOr<void> setXMLVersion(const String&);
500     WEBCORE_EXPORT void setXMLStandalone(bool);
501     void setHasXMLDeclaration(bool hasXMLDeclaration) { m_hasXMLDeclaration = hasXMLDeclaration; }
502
503     String documentURI() const { return m_documentURI; }
504     WEBCORE_EXPORT void setDocumentURI(const String&);
505
506     WEBCORE_EXPORT VisibilityState visibilityState() const;
507     void visibilityStateChanged();
508     WEBCORE_EXPORT bool hidden() const;
509
510     void setTimerThrottlingEnabled(bool);
511     bool isTimerThrottlingEnabled() const { return m_isTimerThrottlingEnabled; }
512
513     WEBCORE_EXPORT ExceptionOr<Ref<Node>> adoptNode(Node& source);
514
515     WEBCORE_EXPORT Ref<HTMLCollection> images();
516     WEBCORE_EXPORT Ref<HTMLCollection> embeds();
517     WEBCORE_EXPORT Ref<HTMLCollection> plugins(); // an alias for embeds() required for the JS DOM bindings.
518     WEBCORE_EXPORT Ref<HTMLCollection> applets();
519     WEBCORE_EXPORT Ref<HTMLCollection> links();
520     WEBCORE_EXPORT Ref<HTMLCollection> forms();
521     WEBCORE_EXPORT Ref<HTMLCollection> anchors();
522     WEBCORE_EXPORT Ref<HTMLCollection> scripts();
523     Ref<HTMLCollection> all();
524     Ref<HTMLCollection> allFilteredByName(const AtomicString&);
525
526     Ref<HTMLCollection> windowNamedItems(const AtomicString&);
527     Ref<HTMLCollection> documentNamedItems(const AtomicString&);
528
529     // Other methods (not part of DOM)
530     bool isSynthesized() const { return m_isSynthesized; }
531     bool isHTMLDocument() const { return m_documentClasses & HTMLDocumentClass; }
532     bool isXHTMLDocument() const { return m_documentClasses & XHTMLDocumentClass; }
533     bool isXMLDocument() const { return m_documentClasses & XMLDocumentClass; }
534     bool isImageDocument() const { return m_documentClasses & ImageDocumentClass; }
535     bool isSVGDocument() const { return m_documentClasses & SVGDocumentClass; }
536     bool isPluginDocument() const { return m_documentClasses & PluginDocumentClass; }
537     bool isMediaDocument() const { return m_documentClasses & MediaDocumentClass; }
538     bool isTextDocument() const { return m_documentClasses & TextDocumentClass; }
539     bool hasSVGRootNode() const;
540     virtual bool isFrameSet() const { return false; }
541
542     static ptrdiff_t documentClassesMemoryOffset() { return OBJECT_OFFSETOF(Document, m_documentClasses); }
543     static uint32_t isHTMLDocumentClassFlag() { return HTMLDocumentClass; }
544
545     bool isSrcdocDocument() const { return m_isSrcdocDocument; }
546
547     bool sawElementsInKnownNamespaces() const { return m_sawElementsInKnownNamespaces; }
548
549     StyleResolver& userAgentShadowTreeStyleResolver();
550
551     CSSFontSelector& fontSelector() { return m_fontSelector; }
552
553     WEBCORE_EXPORT bool haveStylesheetsLoaded() const;
554     bool isIgnoringPendingStylesheets() const { return m_ignorePendingStylesheets; }
555
556     WEBCORE_EXPORT StyleSheetList& styleSheets();
557
558     Style::Scope& styleScope() { return *m_styleScope; }
559     const Style::Scope& styleScope() const { return *m_styleScope; }
560     ExtensionStyleSheets& extensionStyleSheets() { return *m_extensionStyleSheets; }
561     const ExtensionStyleSheets& extensionStyleSheets() const { return *m_extensionStyleSheets; }
562
563     bool gotoAnchorNeededAfterStylesheetsLoad() { return m_gotoAnchorNeededAfterStylesheetsLoad; }
564     void setGotoAnchorNeededAfterStylesheetsLoad(bool b) { m_gotoAnchorNeededAfterStylesheetsLoad = b; }
565
566     void evaluateMediaQueryList();
567
568     FormController& formController();
569     Vector<String> formElementsState() const;
570     void setStateForNewFormElements(const Vector<String>&);
571
572     WEBCORE_EXPORT FrameView* view() const; // can be NULL
573     WEBCORE_EXPORT Page* page() const; // can be NULL
574     const Settings& settings() const { return m_settings.get(); }
575     Settings& mutableSettings() { return m_settings.get(); }
576
577     const Quirks& quirks() const { return m_quirks; }
578
579     float deviceScaleFactor() const;
580
581     WEBCORE_EXPORT bool useSystemAppearance() const;
582     WEBCORE_EXPORT bool useDarkAppearance(const RenderStyle*) const;
583
584     OptionSet<StyleColor::Options> styleColorOptions(const RenderStyle*) const;
585
586     WEBCORE_EXPORT Ref<Range> createRange();
587
588     // The last bool parameter is for ObjC bindings.
589     WEBCORE_EXPORT Ref<NodeIterator> createNodeIterator(Node& root, unsigned long whatToShow = 0xFFFFFFFF, RefPtr<NodeFilter>&& = nullptr, bool = false);
590
591     // The last bool parameter is for ObjC bindings.
592     WEBCORE_EXPORT Ref<TreeWalker> createTreeWalker(Node& root, unsigned long whatToShow = 0xFFFFFFFF, RefPtr<NodeFilter>&& = nullptr, bool = false);
593
594     // Special support for editing
595     WEBCORE_EXPORT Ref<CSSStyleDeclaration> createCSSStyleDeclaration();
596     Ref<Text> createEditingTextNode(const String&);
597
598     enum class ResolveStyleType { Normal, Rebuild };
599     void resolveStyle(ResolveStyleType = ResolveStyleType::Normal);
600     WEBCORE_EXPORT bool updateStyleIfNeeded();
601     bool needsStyleRecalc() const;
602     unsigned lastStyleUpdateSizeForTesting() const { return m_lastStyleUpdateSizeForTesting; }
603
604     WEBCORE_EXPORT void updateLayout();
605     
606     // updateLayoutIgnorePendingStylesheets() forces layout even if we are waiting for pending stylesheet loads,
607     // so calling this may cause a flash of unstyled content (FOUC).
608     enum class RunPostLayoutTasks {
609         Asynchronously,
610         Synchronously,
611     };
612     WEBCORE_EXPORT void updateLayoutIgnorePendingStylesheets(RunPostLayoutTasks = RunPostLayoutTasks::Asynchronously);
613
614     std::unique_ptr<RenderStyle> styleForElementIgnoringPendingStylesheets(Element&, const RenderStyle* parentStyle, PseudoId = PseudoId::None);
615
616     // Returns true if page box (margin boxes and page borders) is visible.
617     WEBCORE_EXPORT bool isPageBoxVisible(int pageIndex);
618
619     // Returns the preferred page size and margins in pixels, assuming 96
620     // pixels per inch. pageSize, marginTop, marginRight, marginBottom,
621     // marginLeft must be initialized to the default values that are used if
622     // auto is specified.
623     WEBCORE_EXPORT void pageSizeAndMarginsInPixels(int pageIndex, IntSize& pageSize, int& marginTop, int& marginRight, int& marginBottom, int& marginLeft);
624
625     CachedResourceLoader& cachedResourceLoader() { return m_cachedResourceLoader; }
626
627     void didBecomeCurrentDocumentInFrame();
628     void destroyRenderTree();
629     void prepareForDestruction();
630
631     // Override ScriptExecutionContext methods to do additional work
632     WEBCORE_EXPORT bool shouldBypassMainWorldContentSecurityPolicy() const final;
633     void suspendActiveDOMObjects(ReasonForSuspension) final;
634     void resumeActiveDOMObjects(ReasonForSuspension) final;
635     void stopActiveDOMObjects() final;
636
637     void suspendDeviceMotionAndOrientationUpdates();
638     void resumeDeviceMotionAndOrientationUpdates();
639
640     RenderView* renderView() const { return m_renderView.get(); }
641
642     bool renderTreeBeingDestroyed() const { return m_renderTreeBeingDestroyed; }
643     bool hasLivingRenderTree() const { return renderView() && !renderTreeBeingDestroyed(); }
644     
645     bool updateLayoutIfDimensionsOutOfDate(Element&, DimensionsCheck = AllDimensionsCheck);
646     
647     AXObjectCache* existingAXObjectCache() const;
648     WEBCORE_EXPORT AXObjectCache* axObjectCache() const;
649     void clearAXObjectCache();
650
651     Optional<uint64_t> pageID() const;
652     // to get visually ordered hebrew and arabic pages right
653     void setVisuallyOrdered();
654     bool visuallyOrdered() const { return m_visuallyOrdered; }
655     
656     WEBCORE_EXPORT DocumentLoader* loader() const;
657
658     WEBCORE_EXPORT ExceptionOr<RefPtr<WindowProxy>> openForBindings(DOMWindow& activeWindow, DOMWindow& firstDOMWindow, const String& url, const AtomicString& name, const String& features);
659     WEBCORE_EXPORT ExceptionOr<Document&> openForBindings(Document* responsibleDocument, const String&, const String&);
660
661     // FIXME: We should rename this at some point and give back the name 'open' to the HTML specified ones.
662     WEBCORE_EXPORT ExceptionOr<void> open(Document* responsibleDocument = nullptr);
663     void implicitOpen();
664
665     WEBCORE_EXPORT ExceptionOr<void> closeForBindings();
666
667     // FIXME: We should rename this at some point and give back the name 'close' to the HTML specified one.
668     WEBCORE_EXPORT void close();
669     // In some situations (see the code), we ignore document.close().
670     // explicitClose() bypass these checks and actually tries to close the
671     // input stream.
672     void explicitClose();
673     // implicitClose() actually does the work of closing the input stream.
674     void implicitClose();
675
676     void cancelParsing();
677
678     ExceptionOr<void> write(Document* responsibleDocument, SegmentedString&&);
679     WEBCORE_EXPORT ExceptionOr<void> write(Document* responsibleDocument, Vector<String>&&);
680     WEBCORE_EXPORT ExceptionOr<void> writeln(Document* responsibleDocument, Vector<String>&&);
681
682     bool wellFormed() const { return m_wellFormed; }
683
684     const URL& url() const final { return m_url; }
685     void setURL(const URL&);
686     const URL& urlForBindings() const { return m_url.isEmpty() ? WTF::blankURL() : m_url; }
687
688     // To understand how these concepts relate to one another, please see the
689     // comments surrounding their declaration.
690     const URL& baseURL() const { return m_baseURL; }
691     void setBaseURLOverride(const URL&);
692     const URL& baseURLOverride() const { return m_baseURLOverride; }
693     const URL& baseElementURL() const { return m_baseElementURL; }
694     const String& baseTarget() const { return m_baseTarget; }
695     void processBaseElement();
696
697     WEBCORE_EXPORT URL completeURL(const String&) const final;
698     URL completeURL(const String&, const URL& baseURLOverride) const;
699     WEBCORE_EXPORT PAL::SessionID sessionID() const final;
700
701     String userAgent(const URL&) const final;
702
703     void disableEval(const String& errorMessage) final;
704     void disableWebAssembly(const String& errorMessage) final;
705
706 #if ENABLE(INDEXED_DATABASE)
707     IDBClient::IDBConnectionProxy* idbConnectionProxy() final;
708 #endif
709     SocketProvider* socketProvider() final;
710
711     bool canNavigate(Frame* targetFrame, const URL& destinationURL = URL());
712
713     bool usesStyleBasedEditability() const;
714     void setHasElementUsingStyleBasedEditability();
715     
716     virtual Ref<DocumentParser> createParser();
717     DocumentParser* parser() const { return m_parser.get(); }
718     ScriptableDocumentParser* scriptableDocumentParser() const;
719     
720     bool printing() const { return m_printing; }
721     void setPrinting(bool p) { m_printing = p; }
722
723     bool paginatedForScreen() const { return m_paginatedForScreen; }
724     void setPaginatedForScreen(bool p) { m_paginatedForScreen = p; }
725     
726     bool paginated() const { return printing() || paginatedForScreen(); }
727
728     void setCompatibilityMode(DocumentCompatibilityMode);
729     void lockCompatibilityMode() { m_compatibilityModeLocked = true; }
730     static ptrdiff_t compatibilityModeMemoryOffset() { return OBJECT_OFFSETOF(Document, m_compatibilityMode); }
731
732     WEBCORE_EXPORT String compatMode() const;
733
734     bool inQuirksMode() const { return m_compatibilityMode == DocumentCompatibilityMode::QuirksMode; }
735     bool inLimitedQuirksMode() const { return m_compatibilityMode == DocumentCompatibilityMode::LimitedQuirksMode; }
736     bool inNoQuirksMode() const { return m_compatibilityMode == DocumentCompatibilityMode::NoQuirksMode; }
737
738     void setReadyState(ReadyState);
739     void setParsing(bool);
740     bool parsing() const { return m_bParsing; }
741     Seconds minimumLayoutDelay();
742
743     bool shouldScheduleLayout();
744     bool isLayoutTimerActive();
745     Seconds timeSinceDocumentCreation() const;
746     
747     void setTextColor(const Color& color) { m_textColor = color; }
748     const Color& textColor() const { return m_textColor; }
749
750     const Color& linkColor() const { return m_linkColor; }
751     const Color& visitedLinkColor() const { return m_visitedLinkColor; }
752     const Color& activeLinkColor() const { return m_activeLinkColor; }
753     void setLinkColor(const Color& c) { m_linkColor = c; }
754     void setVisitedLinkColor(const Color& c) { m_visitedLinkColor = c; }
755     void setActiveLinkColor(const Color& c) { m_activeLinkColor = c; }
756     void resetLinkColor();
757     void resetVisitedLinkColor();
758     void resetActiveLinkColor();
759     VisitedLinkState& visitedLinkState() const { return *m_visitedLinkState; }
760
761     MouseEventWithHitTestResults prepareMouseEvent(const HitTestRequest&, const LayoutPoint&, const PlatformMouseEvent&);
762
763     enum class FocusRemovalEventsMode { Dispatch, DoNotDispatch };
764     WEBCORE_EXPORT bool setFocusedElement(Element*, FocusDirection = FocusDirectionNone,
765         FocusRemovalEventsMode = FocusRemovalEventsMode::Dispatch);
766     Element* focusedElement() const { return m_focusedElement.get(); }
767     UserActionElementSet& userActionElements()  { return m_userActionElements; }
768     const UserActionElementSet& userActionElements() const { return m_userActionElements; }
769
770     void setFocusNavigationStartingNode(Node*);
771     Element* focusNavigationStartingNode(FocusDirection) const;
772
773     enum class NodeRemoval { Node, ChildrenOfNode };
774     void adjustFocusedNodeOnNodeRemoval(Node&, NodeRemoval = NodeRemoval::Node);
775     void adjustFocusNavigationNodeOnNodeRemoval(Node&, NodeRemoval = NodeRemoval::Node);
776
777     void hoveredElementDidDetach(Element&);
778     void elementInActiveChainDidDetach(Element&);
779
780     void updateHoverActiveState(const HitTestRequest&, Element*);
781
782     // Updates for :target (CSS3 selector).
783     void setCSSTarget(Element*);
784     Element* cssTarget() const { return m_cssTarget; }
785     static ptrdiff_t cssTargetMemoryOffset() { return OBJECT_OFFSETOF(Document, m_cssTarget); }
786
787     WEBCORE_EXPORT void scheduleFullStyleRebuild();
788     void scheduleStyleRecalc();
789     void unscheduleStyleRecalc();
790     bool hasPendingStyleRecalc() const;
791     bool hasPendingFullStyleRebuild() const;
792
793     void registerNodeListForInvalidation(LiveNodeList&);
794     void unregisterNodeListForInvalidation(LiveNodeList&);
795     WEBCORE_EXPORT void registerCollection(HTMLCollection&);
796     void unregisterCollection(HTMLCollection&);
797     void collectionCachedIdNameMap(const HTMLCollection&);
798     void collectionWillClearIdNameMap(const HTMLCollection&);
799     bool shouldInvalidateNodeListAndCollectionCaches() const;
800     bool shouldInvalidateNodeListAndCollectionCachesForAttribute(const QualifiedName& attrName) const;
801
802     template <typename InvalidationFunction>
803     void invalidateNodeListAndCollectionCaches(InvalidationFunction);
804
805     void attachNodeIterator(NodeIterator&);
806     void detachNodeIterator(NodeIterator&);
807     void moveNodeIteratorsToNewDocument(Node& node, Document& newDocument)
808     {
809         if (!m_nodeIterators.isEmpty())
810             moveNodeIteratorsToNewDocumentSlowCase(node, newDocument);
811     }
812
813     void attachRange(Range&);
814     void detachRange(Range&);
815
816     void updateRangesAfterChildrenChanged(ContainerNode&);
817     // nodeChildrenWillBeRemoved is used when removing all node children at once.
818     void nodeChildrenWillBeRemoved(ContainerNode&);
819     // nodeWillBeRemoved is only safe when removing one node at a time.
820     void nodeWillBeRemoved(Node&);
821
822     enum class AcceptChildOperation { Replace, InsertOrAdd };
823     bool canAcceptChild(const Node& newChild, const Node* refChild, AcceptChildOperation) const;
824
825     void textInserted(Node&, unsigned offset, unsigned length);
826     void textRemoved(Node&, unsigned offset, unsigned length);
827     void textNodesMerged(Text& oldNode, unsigned offset);
828     void textNodeSplit(Text& oldNode);
829
830     void createDOMWindow();
831     void takeDOMWindowFrom(Document&);
832
833     DOMWindow* domWindow() const { return m_domWindow.get(); }
834     // In DOM Level 2, the Document's DOMWindow is called the defaultView.
835     WEBCORE_EXPORT WindowProxy* windowProxy() const;
836
837     bool hasBrowsingContext() const { return !!frame(); }
838
839     Document& contextDocument() const;
840     void setContextDocument(Document& document) { m_contextDocument = makeWeakPtr(document); }
841
842     // Helper functions for forwarding DOMWindow event related tasks to the DOMWindow if it exists.
843     void setWindowAttributeEventListener(const AtomicString& eventType, const QualifiedName& attributeName, const AtomicString& value, DOMWrapperWorld&);
844     void setWindowAttributeEventListener(const AtomicString& eventType, RefPtr<EventListener>&&, DOMWrapperWorld&);
845     EventListener* getWindowAttributeEventListener(const AtomicString& eventType, DOMWrapperWorld&);
846     WEBCORE_EXPORT void dispatchWindowEvent(Event&, EventTarget* = nullptr);
847     void dispatchWindowLoadEvent();
848
849     WEBCORE_EXPORT ExceptionOr<Ref<Event>> createEvent(const String& eventType);
850
851     // keep track of what types of event listeners are registered, so we don't
852     // dispatch events unnecessarily
853     enum ListenerType {
854         DOMSUBTREEMODIFIED_LISTENER          = 1,
855         DOMNODEINSERTED_LISTENER             = 1 << 1,
856         DOMNODEREMOVED_LISTENER              = 1 << 2,
857         DOMNODEREMOVEDFROMDOCUMENT_LISTENER  = 1 << 3,
858         DOMNODEINSERTEDINTODOCUMENT_LISTENER = 1 << 4,
859         DOMCHARACTERDATAMODIFIED_LISTENER    = 1 << 5,
860         OVERFLOWCHANGED_LISTENER             = 1 << 6,
861         ANIMATIONEND_LISTENER                = 1 << 7,
862         ANIMATIONSTART_LISTENER              = 1 << 8,
863         ANIMATIONITERATION_LISTENER          = 1 << 9,
864         TRANSITIONEND_LISTENER               = 1 << 10,
865         BEFORELOAD_LISTENER                  = 1 << 11,
866         SCROLL_LISTENER                      = 1 << 12,
867         FORCEWILLBEGIN_LISTENER              = 1 << 13,
868         FORCECHANGED_LISTENER                = 1 << 14,
869         FORCEDOWN_LISTENER                   = 1 << 15,
870         FORCEUP_LISTENER                     = 1 << 16,
871         RESIZE_LISTENER                      = 1 << 17
872     };
873
874     bool hasListenerType(ListenerType listenerType) const { return (m_listenerTypes & listenerType); }
875     bool hasListenerTypeForEventType(PlatformEvent::Type) const;
876     void addListenerTypeIfNeeded(const AtomicString& eventType);
877
878     bool hasMutationObserversOfType(MutationObserver::MutationType type) const
879     {
880         return m_mutationObserverTypes & type;
881     }
882     bool hasMutationObservers() const { return m_mutationObserverTypes; }
883     void addMutationObserverTypes(MutationObserverOptions types) { m_mutationObserverTypes |= types; }
884
885     WEBCORE_EXPORT CSSStyleDeclaration* getOverrideStyle(Element*, const String& pseudoElt);
886
887     // Handles an HTTP header equivalent set by a meta tag using <meta http-equiv="..." content="...">. This is called
888     // when a meta tag is encountered during document parsing, and also when a script dynamically changes or adds a meta
889     // tag. This enables scripts to use meta tags to perform refreshes and set expiry dates in addition to them being
890     // specified in an HTML file.
891     void processHttpEquiv(const String& equiv, const String& content, bool isInDocumentHead);
892
893 #if PLATFORM(IOS_FAMILY)
894     void processFormatDetection(const String&);
895
896     // Called when <meta name="apple-mobile-web-app-orientations"> changes.
897     void processWebAppOrientations();
898 #endif
899     
900     void processViewport(const String& features, ViewportArguments::Type origin);
901     void processDisabledAdaptations(const String& adaptations);
902     void updateViewportArguments();
903     void processReferrerPolicy(const String& policy, ReferrerPolicySource);
904
905 #if ENABLE(DARK_MODE_CSS)
906     void processSupportedColorSchemes(const String& colorSchemes);
907 #endif
908
909     // Returns the owning element in the parent document.
910     // Returns nullptr if this is the top level document.
911     HTMLFrameOwnerElement* ownerElement() const;
912
913     // Used by DOM bindings; no direction known.
914     const String& title() const { return m_title.string; }
915     WEBCORE_EXPORT void setTitle(const String&);
916
917     WEBCORE_EXPORT const AtomicString& dir() const;
918     WEBCORE_EXPORT void setDir(const AtomicString&);
919
920     void titleElementAdded(Element& titleElement);
921     void titleElementRemoved(Element& titleElement);
922     void titleElementTextChanged(Element& titleElement);
923
924     WEBCORE_EXPORT ExceptionOr<String> cookie();
925     WEBCORE_EXPORT ExceptionOr<void> setCookie(const String&);
926
927     WEBCORE_EXPORT String referrer() const;
928
929     WEBCORE_EXPORT String origin() const final;
930
931     WEBCORE_EXPORT String domain() const;
932     ExceptionOr<void> setDomain(const String& newDomain);
933
934     void overrideLastModified(const Optional<WallTime>&);
935     WEBCORE_EXPORT String lastModified() const;
936
937     // The cookieURL is used to query the cookie database for this document's
938     // cookies. For example, if the cookie URL is http://example.com, we'll
939     // use the non-Secure cookies for example.com when computing
940     // document.cookie.
941     //
942     // Q: How is the cookieURL different from the document's URL?
943     // A: The two URLs are the same almost all the time.  However, if one
944     //    document inherits the security context of another document, it
945     //    inherits its cookieURL but not its URL.
946     //
947     const URL& cookieURL() const { return m_cookieURL; }
948     void setCookieURL(const URL&);
949
950     // The firstPartyForCookies is used to compute whether this document
951     // appears in a "third-party" context for the purpose of third-party
952     // cookie blocking.  The document is in a third-party context if the
953     // cookieURL and the firstPartyForCookies are from different hosts.
954     //
955     // Note: Some ports (including possibly Apple's) only consider the
956     //       document in a third-party context if the cookieURL and the
957     //       firstPartyForCookies have a different registry-controlled
958     //       domain.
959     //
960     const URL& firstPartyForCookies() const { return m_firstPartyForCookies; }
961     void setFirstPartyForCookies(const URL& url) { m_firstPartyForCookies = url; }
962
963     bool isFullyActive() const;
964
965     // The full URL corresponding to the "site for cookies" in the Same-Site Cookies spec.,
966     // <https://tools.ietf.org/html/draft-ietf-httpbis-cookie-same-site-00>. It is either
967     // the URL of the top-level document or the null URL depending on whether the registrable
968     // domain of this document's URL matches the registrable domain of its parent's/opener's
969     // URL. For the top-level document, it is set to the document's URL.
970     const URL& siteForCookies() const { return m_siteForCookies; }
971     void setSiteForCookies(const URL& url) { m_siteForCookies = url; }
972     
973     // The following implements the rule from HTML 4 for what valid names are.
974     // To get this right for all the XML cases, we probably have to improve this or move it
975     // and make it sensitive to the type of document.
976     static bool isValidName(const String&);
977
978     // The following breaks a qualified name into a prefix and a local name.
979     // It also does a validity check, and returns an error if the qualified name is invalid.
980     static ExceptionOr<std::pair<AtomicString, AtomicString>> parseQualifiedName(const String& qualifiedName);
981     static ExceptionOr<QualifiedName> parseQualifiedName(const AtomicString& namespaceURI, const String& qualifiedName);
982
983     // Checks to make sure prefix and namespace do not conflict (per DOM Core 3)
984     static bool hasValidNamespaceForElements(const QualifiedName&);
985     static bool hasValidNamespaceForAttributes(const QualifiedName&);
986
987     // This is the "HTML body element" as defined by CSSOM View spec, the first body child of the
988     // document element. See http://dev.w3.org/csswg/cssom-view/#the-html-body-element.
989     WEBCORE_EXPORT HTMLBodyElement* body() const;
990
991     // This is the "body element" as defined by HTML5, the first body or frameset child of the
992     // document element. See https://html.spec.whatwg.org/multipage/dom.html#the-body-element-2.
993     WEBCORE_EXPORT HTMLElement* bodyOrFrameset() const;
994     WEBCORE_EXPORT ExceptionOr<void> setBodyOrFrameset(RefPtr<HTMLElement>&&);
995
996     Location* location() const;
997
998     WEBCORE_EXPORT HTMLHeadElement* head();
999
1000     DocumentMarkerController& markers() const { return *m_markers; }
1001
1002     WEBCORE_EXPORT bool execCommand(const String& command, bool userInterface = false, const String& value = String());
1003     WEBCORE_EXPORT bool queryCommandEnabled(const String& command);
1004     WEBCORE_EXPORT bool queryCommandIndeterm(const String& command);
1005     WEBCORE_EXPORT bool queryCommandState(const String& command);
1006     WEBCORE_EXPORT bool queryCommandSupported(const String& command);
1007     WEBCORE_EXPORT String queryCommandValue(const String& command);
1008
1009     UndoManager& undoManager() const { return m_undoManager.get(); }
1010
1011     // designMode support
1012     enum InheritedBool { off = false, on = true, inherit };    
1013     void setDesignMode(InheritedBool value);
1014     InheritedBool getDesignMode() const;
1015     bool inDesignMode() const;
1016     WEBCORE_EXPORT String designMode() const;
1017     WEBCORE_EXPORT void setDesignMode(const String&);
1018
1019     Document* parentDocument() const;
1020     WEBCORE_EXPORT Document& topDocument() const;
1021     
1022     ScriptRunner& scriptRunner() { return *m_scriptRunner; }
1023     ScriptModuleLoader& moduleLoader() { return *m_moduleLoader; }
1024
1025     HTMLScriptElement* currentScript() const { return !m_currentScriptStack.isEmpty() ? m_currentScriptStack.last().get() : nullptr; }
1026     void pushCurrentScript(HTMLScriptElement*);
1027     void popCurrentScript();
1028
1029     bool shouldDeferAsynchronousScriptsUntilParsingFinishes() const;
1030
1031 #if ENABLE(XSLT)
1032     void scheduleToApplyXSLTransforms();
1033     void applyPendingXSLTransformsNowIfScheduled();
1034     RefPtr<Document> transformSourceDocument() { return m_transformSourceDocument; }
1035     void setTransformSourceDocument(Document* document) { m_transformSourceDocument = document; }
1036
1037     void setTransformSource(std::unique_ptr<TransformSource>);
1038     TransformSource* transformSource() const { return m_transformSource.get(); }
1039 #endif
1040
1041     void incDOMTreeVersion() { m_domTreeVersion = ++s_globalTreeVersion; }
1042     uint64_t domTreeVersion() const { return m_domTreeVersion; }
1043
1044     WEBCORE_EXPORT String originIdentifierForPasteboard();
1045
1046     // XPathEvaluator methods
1047     WEBCORE_EXPORT ExceptionOr<Ref<XPathExpression>> createExpression(const String& expression, RefPtr<XPathNSResolver>&&);
1048     WEBCORE_EXPORT Ref<XPathNSResolver> createNSResolver(Node* nodeResolver);
1049     WEBCORE_EXPORT ExceptionOr<Ref<XPathResult>> evaluate(const String& expression, Node* contextNode, RefPtr<XPathNSResolver>&&, unsigned short type, XPathResult*);
1050
1051     bool hasNodesWithNonFinalStyle() const { return m_hasNodesWithNonFinalStyle; }
1052     void setHasNodesWithNonFinalStyle() { m_hasNodesWithNonFinalStyle = true; }
1053     bool hasNodesWithMissingStyle() const { return m_hasNodesWithMissingStyle; }
1054     void setHasNodesWithMissingStyle() { m_hasNodesWithMissingStyle = true; }
1055
1056     // Extension for manipulating canvas drawing contexts for use in CSS
1057     Optional<RenderingContext> getCSSCanvasContext(const String& type, const String& name, int width, int height);
1058     HTMLCanvasElement* getCSSCanvasElement(const String& name);
1059     String nameForCSSCanvasElement(const HTMLCanvasElement&) const;
1060
1061     bool isDNSPrefetchEnabled() const { return m_isDNSPrefetchEnabled; }
1062     void parseDNSPrefetchControlHeader(const String&);
1063
1064     WEBCORE_EXPORT void postTask(Task&&) final; // Executes the task on context's thread asynchronously.
1065
1066     ScriptedAnimationController* scriptedAnimationController() { return m_scriptedAnimationController.get(); }
1067     void suspendScriptedAnimationControllerCallbacks();
1068     void resumeScriptedAnimationControllerCallbacks();
1069     
1070     void windowScreenDidChange(PlatformDisplayID);
1071
1072     void finishedParsing();
1073
1074     enum PageCacheState { NotInPageCache, AboutToEnterPageCache, InPageCache };
1075
1076     PageCacheState pageCacheState() const { return m_pageCacheState; }
1077     void setPageCacheState(PageCacheState);
1078
1079     void registerForDocumentSuspensionCallbacks(Element&);
1080     void unregisterForDocumentSuspensionCallbacks(Element&);
1081
1082     void documentWillBecomeInactive();
1083     void suspend(ReasonForSuspension);
1084     void resume(ReasonForSuspension);
1085
1086     void registerForMediaVolumeCallbacks(Element&);
1087     void unregisterForMediaVolumeCallbacks(Element&);
1088     void mediaVolumeDidChange();
1089
1090     bool audioPlaybackRequiresUserGesture() const;
1091     bool videoPlaybackRequiresUserGesture() const;
1092
1093 #if ENABLE(MEDIA_SESSION)
1094     MediaSession& defaultMediaSession();
1095 #endif
1096
1097     void registerForPrivateBrowsingStateChangedCallbacks(Element&);
1098     void unregisterForPrivateBrowsingStateChangedCallbacks(Element&);
1099     void storageBlockingStateDidChange();
1100     void privateBrowsingStateDidChange();
1101
1102 #if ENABLE(VIDEO_TRACK)
1103     void registerForCaptionPreferencesChangedCallbacks(Element&);
1104     void unregisterForCaptionPreferencesChangedCallbacks(Element&);
1105     void captionPreferencesChanged();
1106 #endif
1107
1108 #if ENABLE(MEDIA_CONTROLS_SCRIPT)
1109     void registerForPageScaleFactorChangedCallbacks(HTMLMediaElement&);
1110     void unregisterForPageScaleFactorChangedCallbacks(HTMLMediaElement&);
1111     void pageScaleFactorChangedAndStable();
1112     void registerForUserInterfaceLayoutDirectionChangedCallbacks(HTMLMediaElement&);
1113     void unregisterForUserInterfaceLayoutDirectionChangedCallbacks(HTMLMediaElement&);
1114     void userInterfaceLayoutDirectionChanged();
1115 #endif
1116
1117     void registerForVisibilityStateChangedCallbacks(VisibilityChangeClient&);
1118     void unregisterForVisibilityStateChangedCallbacks(VisibilityChangeClient&);
1119
1120 #if ENABLE(VIDEO)
1121     void registerForAllowsMediaDocumentInlinePlaybackChangedCallbacks(HTMLMediaElement&);
1122     void unregisterForAllowsMediaDocumentInlinePlaybackChangedCallbacks(HTMLMediaElement&);
1123     void allowsMediaDocumentInlinePlaybackChanged();
1124
1125     void stopAllMediaPlayback();
1126     void suspendAllMediaPlayback();
1127     void resumeAllMediaPlayback();
1128 #endif
1129
1130     WEBCORE_EXPORT void setShouldCreateRenderers(bool);
1131     bool shouldCreateRenderers();
1132
1133     void setDecoder(RefPtr<TextResourceDecoder>&&);
1134     TextResourceDecoder* decoder() const { return m_decoder.get(); }
1135
1136     WEBCORE_EXPORT String displayStringModifiedByEncoding(const String&) const;
1137
1138 #if ENABLE(DASHBOARD_SUPPORT)
1139     void setHasAnnotatedRegions(bool f) { m_hasAnnotatedRegions = f; }
1140     WEBCORE_EXPORT const Vector<AnnotatedRegionValue>& annotatedRegions() const;
1141 #endif
1142
1143     enum class AnnotationsAction { Invalidate, Update };
1144     void invalidateRenderingDependentRegions(AnnotationsAction = AnnotationsAction::Invalidate);
1145     void invalidateScrollbarDependentRegions();
1146     void updateZOrderDependentRegions();
1147
1148     void removeAllEventListeners() final;
1149
1150     WEBCORE_EXPORT const SVGDocumentExtensions* svgExtensions();
1151     WEBCORE_EXPORT SVGDocumentExtensions& accessSVGExtensions();
1152
1153     void addSVGUseElement(SVGUseElement&);
1154     void removeSVGUseElement(SVGUseElement&);
1155     HashSet<SVGUseElement*> const svgUseElements() const { return m_svgUseElements; }
1156
1157     void initSecurityContext();
1158     void initContentSecurityPolicy();
1159
1160     void updateURLForPushOrReplaceState(const URL&);
1161     void statePopped(Ref<SerializedScriptValue>&&);
1162
1163     bool processingLoadEvent() const { return m_processingLoadEvent; }
1164     bool loadEventFinished() const { return m_loadEventFinished; }
1165
1166     bool isContextThread() const final;
1167     bool isSecureContext() const final;
1168     bool isJSExecutionForbidden() const final { return false; }
1169
1170     void enqueueWindowEvent(Ref<Event>&&);
1171     void enqueueDocumentEvent(Ref<Event>&&);
1172     void enqueueOverflowEvent(Ref<Event>&&);
1173     void dispatchPageshowEvent(PageshowEventPersistence);
1174     WEBCORE_EXPORT void enqueueSecurityPolicyViolationEvent(SecurityPolicyViolationEvent::Init&&);
1175     void enqueueHashchangeEvent(const String& oldURL, const String& newURL);
1176     void dispatchPopstateEvent(RefPtr<SerializedScriptValue>&& stateObject);
1177     DocumentEventQueue& eventQueue() const final { return m_eventQueue; }
1178
1179     WEBCORE_EXPORT void addMediaCanStartListener(MediaCanStartListener&);
1180     WEBCORE_EXPORT void removeMediaCanStartListener(MediaCanStartListener&);
1181     MediaCanStartListener* takeAnyMediaCanStartListener();
1182
1183 #if ENABLE(FULLSCREEN_API)
1184     bool webkitIsFullScreen() const { return m_fullScreenElement.get(); }
1185     bool webkitFullScreenKeyboardInputAllowed() const { return m_fullScreenElement.get() && m_areKeysEnabledInFullScreen; }
1186     Element* webkitCurrentFullScreenElement() const { return m_fullScreenElement.get(); }
1187     Element* webkitCurrentFullScreenElementForBindings() const { return ancestorElementInThisScope(webkitCurrentFullScreenElement()); }
1188
1189     enum FullScreenCheckType {
1190         EnforceIFrameAllowFullScreenRequirement,
1191         ExemptIFrameAllowFullScreenRequirement,
1192     };
1193
1194     void requestFullScreenForElement(Element*, FullScreenCheckType);
1195     WEBCORE_EXPORT void webkitCancelFullScreen();
1196     
1197     WEBCORE_EXPORT void webkitWillEnterFullScreen(Element&);
1198     WEBCORE_EXPORT void webkitDidEnterFullScreen();
1199     WEBCORE_EXPORT void webkitWillExitFullScreen();
1200     WEBCORE_EXPORT void webkitDidExitFullScreen();
1201     
1202     void setFullScreenRenderer(RenderTreeBuilder&, RenderFullScreen&);
1203     RenderFullScreen* fullScreenRenderer() const { return m_fullScreenRenderer.get(); }
1204
1205     void dispatchFullScreenChangeEvents();
1206     bool fullScreenIsAllowedForElement(Element&) const;
1207     void fullScreenElementRemoved();
1208     void adjustFullScreenElementOnNodeRemoval(Node&, NodeRemoval = NodeRemoval::Node);
1209
1210     WEBCORE_EXPORT bool isAnimatingFullScreen() const;
1211     WEBCORE_EXPORT void setAnimatingFullScreen(bool);
1212
1213     WEBCORE_EXPORT bool areFullscreenControlsHidden() const;
1214     WEBCORE_EXPORT void setFullscreenControlsHidden(bool);
1215
1216     WEBCORE_EXPORT bool webkitFullscreenEnabled() const;
1217     Element* webkitFullscreenElement() const { return !m_fullScreenElementStack.isEmpty() ? m_fullScreenElementStack.last().get() : nullptr; }
1218     Element* webkitFullscreenElementForBindings() const { return ancestorElementInThisScope(webkitFullscreenElement()); }
1219     WEBCORE_EXPORT void webkitExitFullscreen();
1220 #endif
1221
1222 #if ENABLE(POINTER_LOCK)
1223     WEBCORE_EXPORT void exitPointerLock();
1224 #endif
1225
1226     // Used to allow element that loads data without going through a FrameLoader to delay the 'load' event.
1227     void incrementLoadEventDelayCount() { ++m_loadEventDelayCount; }
1228     void decrementLoadEventDelayCount();
1229     bool isDelayingLoadEvent() const { return m_loadEventDelayCount; }
1230     void checkCompleted();
1231
1232 #if ENABLE(IOS_TOUCH_EVENTS)
1233 #include <WebKitAdditions/DocumentIOS.h>
1234 #endif
1235
1236 #if ENABLE(DEVICE_ORIENTATION) && PLATFORM(IOS_FAMILY)
1237     DeviceMotionController& deviceMotionController() const;
1238     DeviceOrientationController& deviceOrientationController() const;
1239     WEBCORE_EXPORT void simulateDeviceOrientationChange(double alpha, double beta, double gamma);
1240 #endif
1241
1242     const DocumentTiming& timing() const { return m_documentTiming; }
1243
1244     WEBCORE_EXPORT double monotonicTimestamp() const;
1245
1246     int requestAnimationFrame(Ref<RequestAnimationFrameCallback>&&);
1247     void cancelAnimationFrame(int id);
1248
1249     EventTarget* errorEventTarget() final;
1250     void logExceptionToConsole(const String& errorMessage, const String& sourceURL, int lineNumber, int columnNumber, RefPtr<Inspector::ScriptCallStack>&&) final;
1251
1252     void initDNSPrefetch();
1253
1254     void didAddWheelEventHandler(Node&);
1255     void didRemoveWheelEventHandler(Node&, EventHandlerRemoval = EventHandlerRemoval::One);
1256
1257     MonotonicTime lastHandledUserGestureTimestamp() const { return m_lastHandledUserGestureTimestamp; }
1258     bool hasHadUserInteraction() const { return static_cast<bool>(m_lastHandledUserGestureTimestamp); }
1259     void updateLastHandledUserGestureTimestamp(MonotonicTime);
1260     bool processingUserGestureForMedia() const;
1261
1262     void setUserDidInteractWithPage(bool userDidInteractWithPage) { ASSERT(&topDocument() == this); m_userDidInteractWithPage = userDidInteractWithPage; }
1263     bool userDidInteractWithPage() const { ASSERT(&topDocument() == this); return m_userDidInteractWithPage; }
1264
1265     // Used for testing. Count handlers in the main document, and one per frame which contains handlers.
1266     WEBCORE_EXPORT unsigned wheelEventHandlerCount() const;
1267     WEBCORE_EXPORT unsigned touchEventHandlerCount() const;
1268
1269     WEBCORE_EXPORT void startTrackingStyleRecalcs();
1270     WEBCORE_EXPORT unsigned styleRecalcCount() const;
1271
1272 #if ENABLE(TOUCH_EVENTS)
1273     bool hasTouchEventHandlers() const { return (m_touchEventTargets.get()) ? m_touchEventTargets->size() : false; }
1274     bool touchEventTargetsContain(Node& node) const { return m_touchEventTargets ? m_touchEventTargets->contains(&node) : false; }
1275 #else
1276     bool hasTouchEventHandlers() const { return false; }
1277     bool touchEventTargetsContain(Node&) const { return false; }
1278 #endif
1279 #if ENABLE(POINTER_EVENTS)
1280     void updateTouchActionElements(Element&, const RenderStyle&);
1281     const HashSet<Element*>* touchActionElements() const { return m_touchActionElements.get(); }
1282 #endif
1283
1284     void didAddTouchEventHandler(Node&);
1285     void didRemoveTouchEventHandler(Node&, EventHandlerRemoval = EventHandlerRemoval::One);
1286
1287     void didRemoveEventTargetNode(Node&);
1288
1289     const EventTargetSet* touchEventTargets() const
1290     {
1291 #if ENABLE(TOUCH_EVENTS)
1292         return m_touchEventTargets.get();
1293 #else
1294         return nullptr;
1295 #endif
1296     }
1297
1298     const EventTargetSet* wheelEventTargets() const { return m_wheelEventTargets.get(); }
1299
1300     typedef std::pair<Region, bool> RegionFixedPair;
1301     RegionFixedPair absoluteEventRegionForNode(Node&);
1302     RegionFixedPair absoluteRegionForEventTargets(const EventTargetSet*);
1303
1304     LayoutRect absoluteEventHandlerBounds(bool&) final;
1305
1306     bool visualUpdatesAllowed() const { return m_visualUpdatesAllowed; }
1307
1308     bool isInDocumentWrite() { return m_writeRecursionDepth > 0; }
1309
1310     void suspendScheduledTasks(ReasonForSuspension);
1311     void resumeScheduledTasks(ReasonForSuspension);
1312
1313 #if ENABLE(CSS_DEVICE_ADAPTATION)
1314     IntSize initialViewportSize() const;
1315 #endif
1316
1317     void convertAbsoluteToClientQuads(Vector<FloatQuad>&, const RenderStyle&);
1318     void convertAbsoluteToClientRects(Vector<FloatRect>&, const RenderStyle&);
1319     void convertAbsoluteToClientRect(FloatRect&, const RenderStyle&);
1320
1321     bool hasActiveParser();
1322     void incrementActiveParserCount() { ++m_activeParserCount; }
1323     void decrementActiveParserCount();
1324
1325     std::unique_ptr<DocumentParserYieldToken> createParserYieldToken()
1326     {
1327         return std::make_unique<DocumentParserYieldToken>(*this);
1328     }
1329
1330     bool hasActiveParserYieldToken() const { return m_parserYieldTokenCount; }
1331
1332     DocumentSharedObjectPool* sharedObjectPool() { return m_sharedObjectPool.get(); }
1333
1334     void invalidateMatchedPropertiesCacheAndForceStyleRecalc();
1335
1336     void didRemoveAllPendingStylesheet();
1337     void didClearStyleResolver();
1338
1339     bool inStyleRecalc() const { return m_inStyleRecalc; }
1340     bool inRenderTreeUpdate() const { return m_inRenderTreeUpdate; }
1341     bool isResolvingTreeStyle() const { return m_isResolvingTreeStyle; }
1342     void setIsResolvingTreeStyle(bool);
1343
1344     void updateTextRenderer(Text&, unsigned offsetOfReplacedText, unsigned lengthOfReplacedText);
1345
1346     // Return a Locale for the default locale if the argument is null or empty.
1347     Locale& getCachedLocale(const AtomicString& locale = nullAtom());
1348
1349     const Document* templateDocument() const;
1350     Document& ensureTemplateDocument();
1351     void setTemplateDocumentHost(Document* templateDocumentHost) { m_templateDocumentHost = templateDocumentHost; }
1352     Document* templateDocumentHost() { return m_templateDocumentHost; }
1353
1354     void didAssociateFormControl(Element*);
1355     bool hasDisabledFieldsetElement() const { return m_disabledFieldsetElementsCount; }
1356     void addDisabledFieldsetElement() { m_disabledFieldsetElementsCount++; }
1357     void removeDisabledFieldsetElement() { ASSERT(m_disabledFieldsetElementsCount); m_disabledFieldsetElementsCount--; }
1358
1359     WEBCORE_EXPORT void addConsoleMessage(std::unique_ptr<Inspector::ConsoleMessage>&&) final;
1360
1361     // The following addConsoleMessage function is deprecated.
1362     // Callers should try to create the ConsoleMessage themselves.
1363     WEBCORE_EXPORT void addConsoleMessage(MessageSource, MessageLevel, const String& message, unsigned long requestIdentifier = 0) final;
1364
1365     // The following addMessage function is deprecated.
1366     // Callers should try to create the ConsoleMessage themselves.
1367     void addMessage(MessageSource, MessageLevel, const String& message, const String& sourceURL, unsigned lineNumber, unsigned columnNumber, RefPtr<Inspector::ScriptCallStack>&&, JSC::ExecState* = nullptr, unsigned long requestIdentifier = 0) final;
1368
1369     SecurityOrigin& securityOrigin() const { return *SecurityContext::securityOrigin(); }
1370     SecurityOrigin& topOrigin() const final { return topDocument().securityOrigin(); }
1371
1372     Ref<FontFaceSet> fonts();
1373
1374     void ensurePlugInsInjectedScript(DOMWrapperWorld&);
1375
1376     void setVisualUpdatesAllowedByClient(bool);
1377
1378 #if ENABLE(WEB_CRYPTO)
1379     bool wrapCryptoKey(const Vector<uint8_t>& key, Vector<uint8_t>& wrappedKey) final;
1380     bool unwrapCryptoKey(const Vector<uint8_t>& wrappedKey, Vector<uint8_t>& key) final;
1381 #endif
1382
1383     void setHasStyleWithViewportUnits() { m_hasStyleWithViewportUnits = true; }
1384     bool hasStyleWithViewportUnits() const { return m_hasStyleWithViewportUnits; }
1385     void updateViewportUnitsOnResize();
1386
1387     WEBCORE_EXPORT void addAudioProducer(MediaProducer&);
1388     WEBCORE_EXPORT void removeAudioProducer(MediaProducer&);
1389     MediaProducer::MediaStateFlags mediaState() const { return m_mediaState; }
1390     void noteUserInteractionWithMediaElement();
1391     bool isCapturing() const { return MediaProducer::isCapturing(m_mediaState); }
1392     WEBCORE_EXPORT void updateIsPlayingMedia(uint64_t = HTMLMediaElementInvalidID);
1393     void pageMutedStateDidChange();
1394
1395 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
1396     void addPlaybackTargetPickerClient(MediaPlaybackTargetClient&);
1397     void removePlaybackTargetPickerClient(MediaPlaybackTargetClient&);
1398     void showPlaybackTargetPicker(MediaPlaybackTargetClient&, bool, RouteSharingPolicy, const String&);
1399     void playbackTargetPickerClientStateDidChange(MediaPlaybackTargetClient&, MediaProducer::MediaStateFlags);
1400
1401     void setPlaybackTarget(uint64_t, Ref<MediaPlaybackTarget>&&);
1402     void playbackTargetAvailabilityDidChange(uint64_t, bool);
1403     void setShouldPlayToPlaybackTarget(uint64_t, bool);
1404 #endif
1405
1406     ShouldOpenExternalURLsPolicy shouldOpenExternalURLsPolicyToPropagate() const;
1407     bool shouldEnforceContentDispositionAttachmentSandbox() const;
1408     void applyContentDispositionAttachmentSandbox();
1409
1410     void addViewportDependentPicture(HTMLPictureElement&);
1411     void removeViewportDependentPicture(HTMLPictureElement&);
1412
1413     void addAppearanceDependentPicture(HTMLPictureElement&);
1414     void removeAppearanceDependentPicture(HTMLPictureElement&);
1415
1416 #if ENABLE(INTERSECTION_OBSERVER)
1417     void addIntersectionObserver(IntersectionObserver&);
1418     void removeIntersectionObserver(IntersectionObserver&);
1419     unsigned numberOfIntersectionObservers() const { return m_intersectionObservers.size(); }
1420     void scheduleForcedIntersectionObservationUpdate();
1421     void updateIntersectionObservations();
1422 #endif
1423
1424 #if ENABLE(MEDIA_STREAM)
1425     void setHasCaptureMediaStreamTrack() { m_hasHadCaptureMediaStreamTrack = true; }
1426     bool hasHadCaptureMediaStreamTrack() const { return m_hasHadCaptureMediaStreamTrack; }
1427     void setDeviceIDHashSalt(const String&);
1428     String deviceIDHashSalt() const { return m_idHashSalt; }
1429     void stopMediaCapture();
1430     void registerForMediaStreamStateChangeCallbacks(HTMLMediaElement&);
1431     void unregisterForMediaStreamStateChangeCallbacks(HTMLMediaElement&);
1432     void mediaStreamCaptureStateChanged();
1433 #endif
1434
1435 // FIXME: Find a better place for this functionality.
1436 #if ENABLE(TELEPHONE_NUMBER_DETECTION)
1437     // These functions provide a two-level setting:
1438     //    - A user-settable wantsTelephoneNumberParsing (at the Page / WebView level)
1439     //    - A read-only telephoneNumberParsingAllowed which is set by the
1440     //      document if it has the appropriate meta tag.
1441     //    - isTelephoneNumberParsingEnabled() == isTelephoneNumberParsingAllowed() && page()->settings()->isTelephoneNumberParsingEnabled()
1442     WEBCORE_EXPORT bool isTelephoneNumberParsingAllowed() const;
1443     WEBCORE_EXPORT bool isTelephoneNumberParsingEnabled() const;
1444 #endif
1445
1446     using ContainerNode::setAttributeEventListener;
1447     void setAttributeEventListener(const AtomicString& eventType, const QualifiedName& attributeName, const AtomicString& value, DOMWrapperWorld& isolatedWorld);
1448
1449     DOMSelection* getSelection();
1450
1451     void didInsertInDocumentShadowRoot(ShadowRoot&);
1452     void didRemoveInDocumentShadowRoot(ShadowRoot&);
1453     const HashSet<ShadowRoot*>& inDocumentShadowRoots() const { return m_inDocumentShadowRoots; }
1454
1455     void attachToCachedFrame(CachedFrameBase&);
1456     void detachFromCachedFrame(CachedFrameBase&);
1457
1458     ConstantPropertyMap& constantProperties() const { return *m_constantPropertyMap; }
1459
1460     void orientationChanged(int orientation);
1461     OrientationNotifier& orientationNotifier() { return m_orientationNotifier; }
1462
1463     WEBCORE_EXPORT const AtomicString& bgColor() const;
1464     WEBCORE_EXPORT void setBgColor(const String&);
1465     WEBCORE_EXPORT const AtomicString& fgColor() const;
1466     WEBCORE_EXPORT void setFgColor(const String&);
1467     WEBCORE_EXPORT const AtomicString& alinkColor() const;
1468     WEBCORE_EXPORT void setAlinkColor(const String&);
1469     WEBCORE_EXPORT const AtomicString& linkColorForBindings() const;
1470     WEBCORE_EXPORT void setLinkColorForBindings(const String&);
1471     WEBCORE_EXPORT const AtomicString& vlinkColor() const;
1472     WEBCORE_EXPORT void setVlinkColor(const String&);
1473
1474     // Per https://html.spec.whatwg.org/multipage/obsolete.html#dom-document-clear, this method does nothing.
1475     void clear() { }
1476     // Per https://html.spec.whatwg.org/multipage/obsolete.html#dom-document-captureevents, this method does nothing.
1477     void captureEvents() { }
1478     // Per https://html.spec.whatwg.org/multipage/obsolete.html#dom-document-releaseevents, this method does nothing.
1479     void releaseEvents() { }
1480
1481 #if ENABLE(TEXT_AUTOSIZING)
1482     TextAutoSizing& textAutoSizing();
1483 #endif
1484
1485     Logger& logger();
1486
1487     void hasStorageAccess(Ref<DeferredPromise>&& passedPromise);
1488     void requestStorageAccess(Ref<DeferredPromise>&& passedPromise);
1489     void setUserGrantsStorageAccessOverride(bool value) { m_grantStorageAccessOverride = value; }
1490
1491     WEBCORE_EXPORT void setConsoleMessageListener(RefPtr<StringCallback>&&); // For testing.
1492
1493 #if USE(REQUEST_ANIMATION_FRAME_DISPLAY_MONITOR)
1494     DocumentAnimationScheduler& animationScheduler();
1495 #endif
1496
1497     WEBCORE_EXPORT DocumentTimeline& timeline();
1498     DocumentTimeline* existingTimeline() const { return m_timeline.get(); }
1499     Vector<RefPtr<WebAnimation>> getAnimations();
1500         
1501 #if ENABLE(ATTACHMENT_ELEMENT)
1502     void registerAttachmentIdentifier(const String&);
1503     void didInsertAttachmentElement(HTMLAttachmentElement&);
1504     void didRemoveAttachmentElement(HTMLAttachmentElement&);
1505     WEBCORE_EXPORT RefPtr<HTMLAttachmentElement> attachmentForIdentifier(const String&) const;
1506     const HashMap<String, Ref<HTMLAttachmentElement>>& attachmentElementsByIdentifier() const { return m_attachmentIdentifierToElementMap; }
1507 #endif
1508
1509 #if ENABLE(SERVICE_WORKER)
1510     void setServiceWorkerConnection(SWClientConnection*);
1511 #endif
1512
1513     void addApplicationStateChangeListener(ApplicationStateChangeListener&);
1514     void removeApplicationStateChangeListener(ApplicationStateChangeListener&);
1515     void forEachApplicationStateChangeListener(const Function<void(ApplicationStateChangeListener&)>&);
1516
1517 #if ENABLE(IOS_TOUCH_EVENTS)
1518     bool handlingTouchEvent() const { return m_handlingTouchEvent; }
1519 #endif
1520
1521 #if ENABLE(RESOURCE_LOAD_STATISTICS)
1522     bool hasRequestedPageSpecificStorageAccessWithUserInteraction(const String& primaryDomain);
1523     void setHasRequestedPageSpecificStorageAccessWithUserInteraction(const String& primaryDomain);
1524 #endif
1525
1526     String signedPublicKeyAndChallengeString(unsigned keySizeIndex, const String& challengeString, const URL&);
1527
1528     void consumeTemporaryTimeUserGesture();
1529
1530     void registerArticleElement(Element&);
1531     void unregisterArticleElement(Element&);
1532     void updateMainArticleElementAfterLayout();
1533     bool hasMainArticleElement() const { return !!m_mainArticleElement; }
1534
1535     const CSSRegisteredCustomPropertySet& getCSSRegisteredCustomPropertySet() const { return m_CSSRegisteredPropertySet; }
1536     bool registerCSSProperty(CSSRegisteredCustomProperty&&);
1537
1538 #if ENABLE(CSS_PAINTING_API)
1539     Worklet& ensurePaintWorklet();
1540     PaintWorkletGlobalScope* paintWorkletGlobalScopeForName(const String& name);
1541     void setPaintWorkletGlobalScopeForName(const String& name, Ref<PaintWorkletGlobalScope>&&);
1542 #endif
1543
1544     void setAsRunningUserScripts() { m_isRunningUserScripts = true; }
1545     bool isRunningUserScripts() const { return m_isRunningUserScripts; }
1546
1547     void frameWasDisconnectedFromOwner();
1548
1549     // Used in webarchive loading tests.
1550     void setAlwaysAllowLocalWebarchive() { m_alwaysAllowLocalWebarchive = true; }
1551     bool alwaysAllowLocalWebarchive() const { return m_alwaysAllowLocalWebarchive; }
1552
1553 protected:
1554     enum ConstructionFlags { Synthesized = 1, NonRenderedPlaceholder = 1 << 1 };
1555     Document(Frame*, const URL&, unsigned = DefaultDocumentClass, unsigned constructionFlags = 0);
1556
1557     void clearXMLVersion() { m_xmlVersion = String(); }
1558
1559     virtual Ref<Document> cloneDocumentWithoutChildren() const;
1560
1561 private:
1562     friend class DocumentParserYieldToken;
1563     friend class Node;
1564     friend class ThrowOnDynamicMarkupInsertionCountIncrementer;
1565     friend class IgnoreOpensDuringUnloadCountIncrementer;
1566     friend class IgnoreDestructiveWriteCountIncrementer;
1567
1568     bool shouldInheritContentSecurityPolicyFromOwner() const;
1569
1570     void updateTitleElement(Element& changingTitleElement);
1571     void willDetachPage() final;
1572     void frameDestroyed() final;
1573
1574     void commonTeardown();
1575
1576     RenderObject* renderer() const = delete;
1577     void setRenderer(RenderObject*) = delete;
1578
1579     void createRenderTree();
1580     void detachParser();
1581
1582     // FontSelectorClient
1583     void fontsNeedUpdate(FontSelector&) final;
1584
1585     bool isDocument() const final { return true; }
1586
1587     void childrenChanged(const ChildChange&) final;
1588
1589     String nodeName() const final;
1590     NodeType nodeType() const final;
1591     bool childTypeAllowed(NodeType) const final;
1592     Ref<Node> cloneNodeInternal(Document&, CloningOperation) final;
1593     void cloneDataFromDocument(const Document&);
1594
1595     void refScriptExecutionContext() final { ref(); }
1596     void derefScriptExecutionContext() final { deref(); }
1597
1598     Seconds minimumDOMTimerInterval() const final;
1599
1600     Seconds domTimerAlignmentInterval(bool hasReachedMaxNestingLevel) const final;
1601
1602     void updateTitleFromTitleElement();
1603     void updateTitle(const StringWithDirection&);
1604     void updateBaseURL();
1605
1606     void buildAccessKeyMap(TreeScope&);
1607
1608     void moveNodeIteratorsToNewDocumentSlowCase(Node&, Document&);
1609
1610     void loadEventDelayTimerFired();
1611
1612     void pendingTasksTimerFired();
1613     bool isCookieAverse() const;
1614
1615     void detachFromFrame();
1616
1617     template<CollectionType> Ref<HTMLCollection> ensureCachedCollection();
1618
1619 #if ENABLE(FULLSCREEN_API)
1620     void dispatchFullScreenChangeOrErrorEvent(Deque<RefPtr<Node>>&, const AtomicString& eventName, bool shouldNotifyMediaElement);
1621     void clearFullscreenElementStack();
1622     void popFullscreenElementStack();
1623     void pushFullscreenElementStack(Element&);
1624     void addDocumentToFullScreenChangeEventQueue(Document&);
1625 #endif
1626
1627     void dispatchDisabledAdaptationsDidChangeForMainFrame();
1628
1629 #if ENABLE(TELEPHONE_NUMBER_DETECTION)
1630     friend void setParserFeature(const String& key, const String& value, Document*, void* userData);
1631     void setIsTelephoneNumberParsingAllowed(bool);
1632 #endif
1633
1634     void setVisualUpdatesAllowed(ReadyState);
1635     void setVisualUpdatesAllowed(bool);
1636     void visualUpdatesSuppressionTimerFired();
1637
1638     void addListenerType(ListenerType listenerType) { m_listenerTypes |= listenerType; }
1639
1640     void didAssociateFormControlsTimerFired();
1641
1642     void wheelEventHandlersChanged();
1643
1644 #if ENABLE(DASHBOARD_SUPPORT)
1645     void setAnnotatedRegionsDirty(bool f = true) { m_annotatedRegionsDirty = f; }
1646     bool annotatedRegionsDirty() const { return m_annotatedRegionsDirty; }
1647     bool hasAnnotatedRegions () const { return m_hasAnnotatedRegions; }
1648     void setAnnotatedRegions(const Vector<AnnotatedRegionValue>&);
1649     void updateAnnotatedRegions();
1650 #endif
1651
1652     HttpEquivPolicy httpEquivPolicy() const;
1653     AXObjectCache* existingAXObjectCacheSlow() const;
1654
1655     // DOM Cookies caching.
1656     const String& cachedDOMCookies() const { return m_cachedDOMCookies; }
1657     void setCachedDOMCookies(const String&);
1658     bool isDOMCookieCacheValid() const { return m_cookieCacheExpiryTimer.isActive(); }
1659     void invalidateDOMCookieCache();
1660     void didLoadResourceSynchronously() final;
1661
1662     void checkViewportDependentPictures();
1663     void checkAppearanceDependentPictures();
1664
1665     bool canNavigateInternal(Frame& targetFrame);
1666     bool isNavigationBlockedByThirdPartyIFrameRedirectBlocking(Frame& targetFrame, const URL& destinationURL);
1667
1668 #if ENABLE(INTERSECTION_OBSERVER)
1669     void notifyIntersectionObserversTimerFired();
1670 #endif
1671
1672 #if USE(QUICK_LOOK)
1673     bool shouldEnforceQuickLookSandbox() const;
1674     void applyQuickLookSandbox();
1675 #endif
1676
1677     bool shouldEnforceHTTP09Sandbox() const;
1678
1679     void platformSuspendOrStopActiveDOMObjects();
1680
1681     bool domainIsRegisterable(const String&) const;
1682
1683     void enableTemporaryTimeUserGesture();
1684
1685     bool isBodyPotentiallyScrollable(HTMLBodyElement&);
1686
1687     const Ref<Settings> m_settings;
1688
1689     UniqueRef<Quirks> m_quirks;
1690
1691     std::unique_ptr<StyleResolver> m_userAgentShadowTreeStyleResolver;
1692
1693     RefPtr<DOMWindow> m_domWindow;
1694     WeakPtr<Document> m_contextDocument;
1695
1696     Ref<CachedResourceLoader> m_cachedResourceLoader;
1697     RefPtr<DocumentParser> m_parser;
1698
1699     unsigned m_parserYieldTokenCount { 0 };
1700
1701     // Document URLs.
1702     URL m_url; // Document.URL: The URL from which this document was retrieved.
1703     URL m_baseURL; // Node.baseURI: The URL to use when resolving relative URLs.
1704     URL m_baseURLOverride; // An alternative base URL that takes precedence over m_baseURL (but not m_baseElementURL).
1705     URL m_baseElementURL; // The URL set by the <base> element.
1706     URL m_cookieURL; // The URL to use for cookie access.
1707     URL m_firstPartyForCookies; // The policy URL for third-party cookie blocking.
1708     URL m_siteForCookies; // The policy URL for Same-Site cookies.
1709
1710     // Document.documentURI:
1711     // Although URL-like, Document.documentURI can actually be set to any
1712     // string by content.  Document.documentURI affects m_baseURL unless the
1713     // document contains a <base> element, in which case the <base> element
1714     // takes precedence.
1715     //
1716     // This property is read-only from JavaScript, but writable from Objective C.
1717     String m_documentURI;
1718
1719     String m_baseTarget;
1720
1721     // MIME type of the document in case it was cloned or created by XHR.
1722     String m_overriddenMIMEType;
1723
1724     std::unique_ptr<DOMImplementation> m_implementation;
1725
1726     RefPtr<Node> m_focusNavigationStartingNode;
1727     RefPtr<Element> m_focusedElement;
1728     RefPtr<Element> m_hoveredElement;
1729     RefPtr<Element> m_activeElement;
1730     RefPtr<Element> m_documentElement;
1731     UserActionElementSet m_userActionElements;
1732
1733     uint64_t m_domTreeVersion;
1734     static uint64_t s_globalTreeVersion;
1735
1736     String m_uniqueIdentifier;
1737
1738     HashSet<NodeIterator*> m_nodeIterators;
1739     HashSet<Range*> m_ranges;
1740
1741     std::unique_ptr<Style::Scope> m_styleScope;
1742     std::unique_ptr<ExtensionStyleSheets> m_extensionStyleSheets;
1743     RefPtr<StyleSheetList> m_styleSheetList;
1744
1745     std::unique_ptr<FormController> m_formController;
1746
1747     Color m_textColor { Color::black };
1748     Color m_linkColor;
1749     Color m_visitedLinkColor;
1750     Color m_activeLinkColor;
1751     const std::unique_ptr<VisitedLinkState> m_visitedLinkState;
1752
1753     StringWithDirection m_title;
1754     StringWithDirection m_rawTitle;
1755     RefPtr<Element> m_titleElement;
1756
1757     std::unique_ptr<AXObjectCache> m_axObjectCache;
1758     const std::unique_ptr<DocumentMarkerController> m_markers;
1759     
1760     Timer m_styleRecalcTimer;
1761
1762     Element* m_cssTarget { nullptr };
1763
1764     RefPtr<SerializedScriptValue> m_pendingStateObject;
1765     MonotonicTime m_documentCreationTime;
1766     bool m_overMinimumLayoutThreshold { false };
1767     
1768     std::unique_ptr<ScriptRunner> m_scriptRunner;
1769     std::unique_ptr<ScriptModuleLoader> m_moduleLoader;
1770
1771     Vector<RefPtr<HTMLScriptElement>> m_currentScriptStack;
1772
1773 #if ENABLE(XSLT)
1774     void applyPendingXSLTransformsTimerFired();
1775
1776     std::unique_ptr<TransformSource> m_transformSource;
1777     RefPtr<Document> m_transformSourceDocument;
1778     Timer m_applyPendingXSLTransformsTimer;
1779     bool m_hasPendingXSLTransforms { false };
1780 #endif
1781
1782     String m_xmlEncoding;
1783     String m_xmlVersion;
1784     StandaloneStatus m_xmlStandalone { StandaloneStatus::Unspecified };
1785     bool m_hasXMLDeclaration { false };
1786
1787     String m_contentLanguage;
1788
1789     RefPtr<TextResourceDecoder> m_decoder;
1790
1791     HashSet<LiveNodeList*> m_listsInvalidatedAtDocument;
1792     HashSet<HTMLCollection*> m_collectionsInvalidatedAtDocument;
1793     unsigned m_nodeListAndCollectionCounts[numNodeListInvalidationTypes];
1794
1795     RefPtr<XPathEvaluator> m_xpathEvaluator;
1796
1797     std::unique_ptr<SVGDocumentExtensions> m_svgExtensions;
1798     HashSet<SVGUseElement*> m_svgUseElements;
1799
1800 #if ENABLE(DARK_MODE_CSS)
1801     OptionSet<ColorSchemes> m_supportedColorSchemes;
1802     bool m_allowsColorSchemeTransformations { true };
1803 #endif
1804
1805 #if ENABLE(DASHBOARD_SUPPORT)
1806     Vector<AnnotatedRegionValue> m_annotatedRegions;
1807     bool m_hasAnnotatedRegions { false };
1808     bool m_annotatedRegionsDirty { false };
1809 #endif
1810
1811     HashMap<String, RefPtr<HTMLCanvasElement>> m_cssCanvasElements;
1812
1813     HashSet<Element*> m_documentSuspensionCallbackElements;
1814     HashSet<Element*> m_mediaVolumeCallbackElements;
1815     HashSet<Element*> m_privateBrowsingStateChangedElements;
1816 #if ENABLE(VIDEO_TRACK)
1817     HashSet<Element*> m_captionPreferencesChangedElements;
1818 #endif
1819
1820     Element* m_mainArticleElement { nullptr };
1821     HashSet<Element*> m_articleElements;
1822
1823 #if ENABLE(MEDIA_CONTROLS_SCRIPT)
1824     HashSet<HTMLMediaElement*> m_pageScaleFactorChangedElements;
1825     HashSet<HTMLMediaElement*> m_userInterfaceLayoutDirectionChangedElements;
1826 #endif
1827
1828     HashSet<VisibilityChangeClient*> m_visibilityStateCallbackClients;
1829 #if ENABLE(VIDEO)
1830     HashSet<HTMLMediaElement*> m_allowsMediaDocumentInlinePlaybackElements;
1831 #endif
1832
1833     HashMap<StringImpl*, Element*, ASCIICaseInsensitiveHash> m_elementsByAccessKey;
1834
1835     std::unique_ptr<ConstantPropertyMap> m_constantPropertyMap;
1836
1837     std::unique_ptr<SelectorQueryCache> m_selectorQueryCache;
1838
1839     DocumentClassFlags m_documentClasses;
1840
1841     RenderPtr<RenderView> m_renderView;
1842     mutable DocumentEventQueue m_eventQueue;
1843
1844     HashSet<MediaCanStartListener*> m_mediaCanStartListeners;
1845
1846 #if ENABLE(FULLSCREEN_API)
1847     RefPtr<Element> m_fullScreenElement;
1848     Vector<RefPtr<Element>> m_fullScreenElementStack;
1849     WeakPtr<RenderFullScreen> m_fullScreenRenderer { nullptr };
1850     GenericTaskQueue<Timer> m_fullScreenTaskQueue;
1851     Deque<RefPtr<Node>> m_fullScreenChangeEventTargetQueue;
1852     Deque<RefPtr<Node>> m_fullScreenErrorEventTargetQueue;
1853     LayoutRect m_savedPlaceholderFrameRect;
1854     std::unique_ptr<RenderStyle> m_savedPlaceholderRenderStyle;
1855
1856     bool m_areKeysEnabledInFullScreen { false };
1857     bool m_isAnimatingFullScreen { false };
1858     bool m_areFullscreenControlsHidden { false };
1859 #endif
1860
1861     HashSet<HTMLPictureElement*> m_viewportDependentPictures;
1862     HashSet<HTMLPictureElement*> m_appearanceDependentPictures;
1863
1864 #if ENABLE(INTERSECTION_OBSERVER)
1865     Vector<WeakPtr<IntersectionObserver>> m_intersectionObservers;
1866     Vector<WeakPtr<IntersectionObserver>> m_intersectionObserversWithPendingNotifications;
1867     Timer m_intersectionObserversNotifyTimer;
1868 #endif
1869
1870     Timer m_loadEventDelayTimer;
1871
1872     ViewportArguments m_viewportArguments;
1873     Optional<ViewportArguments> m_overrideViewportArguments;
1874     OptionSet<DisabledAdaptations> m_disabledAdaptations;
1875
1876     DocumentTiming m_documentTiming;
1877
1878     RefPtr<MediaQueryMatcher> m_mediaQueryMatcher;
1879     
1880 #if ENABLE(TOUCH_EVENTS)
1881     std::unique_ptr<EventTargetSet> m_touchEventTargets;
1882 #endif
1883 #if ENABLE(POINTER_EVENTS)
1884     std::unique_ptr<HashSet<Element*>> m_touchActionElements;
1885 #endif
1886     std::unique_ptr<EventTargetSet> m_wheelEventTargets;
1887
1888     MonotonicTime m_lastHandledUserGestureTimestamp;
1889
1890     void clearScriptedAnimationController();
1891     RefPtr<ScriptedAnimationController> m_scriptedAnimationController;
1892
1893     void notifyMediaCaptureOfVisibilityChanged();
1894
1895     void didLogMessage(const WTFLogChannel&, WTFLogLevel, Vector<JSONLogValue>&&) final;
1896
1897 #if ENABLE(RESOURCE_LOAD_STATISTICS)
1898     bool hasFrameSpecificStorageAccess() const;
1899     void setHasFrameSpecificStorageAccess(bool);
1900 #endif
1901
1902 #if ENABLE(DEVICE_ORIENTATION) && PLATFORM(IOS_FAMILY)
1903     std::unique_ptr<DeviceMotionClient> m_deviceMotionClient;
1904     std::unique_ptr<DeviceMotionController> m_deviceMotionController;
1905     std::unique_ptr<DeviceOrientationClient> m_deviceOrientationClient;
1906     std::unique_ptr<DeviceOrientationController> m_deviceOrientationController;
1907 #endif
1908
1909     GenericTaskQueue<Timer> m_logMessageTaskQueue;
1910
1911     Timer m_pendingTasksTimer;
1912     Vector<Task> m_pendingTasks;
1913
1914 #if ENABLE(TEXT_AUTOSIZING)
1915     std::unique_ptr<TextAutoSizing> m_textAutoSizing;
1916 #endif
1917
1918     Timer m_visualUpdatesSuppressionTimer;
1919
1920     void clearSharedObjectPool();
1921     Timer m_sharedObjectPoolClearTimer;
1922
1923     std::unique_ptr<DocumentSharedObjectPool> m_sharedObjectPool;
1924
1925     typedef HashMap<AtomicString, std::unique_ptr<Locale>> LocaleIdentifierToLocaleMap;
1926     LocaleIdentifierToLocaleMap m_localeCache;
1927
1928     RefPtr<Document> m_templateDocument;
1929     Document* m_templateDocumentHost { nullptr }; // Manually managed weakref (backpointer from m_templateDocument).
1930
1931     Ref<CSSFontSelector> m_fontSelector;
1932
1933     HashSet<MediaProducer*> m_audioProducers;
1934
1935     HashSet<ShadowRoot*> m_inDocumentShadowRoots;
1936
1937 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
1938     typedef HashMap<uint64_t, WebCore::MediaPlaybackTargetClient*> TargetIdToClientMap;
1939     TargetIdToClientMap m_idToClientMap;
1940     typedef HashMap<WebCore::MediaPlaybackTargetClient*, uint64_t> TargetClientToIdMap;
1941     TargetClientToIdMap m_clientToIDMap;
1942 #endif
1943
1944 #if ENABLE(MEDIA_SESSION)
1945     RefPtr<MediaSession> m_defaultMediaSession;
1946 #endif
1947
1948 #if ENABLE(INDEXED_DATABASE)
1949     RefPtr<IDBClient::IDBConnectionProxy> m_idbConnectionProxy;
1950 #endif
1951
1952 #if ENABLE(ATTACHMENT_ELEMENT)
1953     HashMap<String, Ref<HTMLAttachmentElement>> m_attachmentIdentifierToElementMap;
1954 #endif
1955
1956     Timer m_didAssociateFormControlsTimer;
1957     Timer m_cookieCacheExpiryTimer;
1958
1959     RefPtr<SocketProvider> m_socketProvider;
1960
1961     String m_cachedDOMCookies;
1962
1963     Optional<WallTime> m_overrideLastModified;
1964
1965     HashSet<RefPtr<Element>> m_associatedFormControls;
1966     unsigned m_disabledFieldsetElementsCount { 0 };
1967
1968     unsigned m_listenerTypes { 0 };
1969     unsigned m_referencingNodeCount { 0 };
1970     int m_loadEventDelayCount { 0 };
1971     unsigned m_lastStyleUpdateSizeForTesting { 0 };
1972
1973     // https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html#throw-on-dynamic-markup-insertion-counter
1974     unsigned m_throwOnDynamicMarkupInsertionCount { 0 };
1975
1976     // https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html#ignore-opens-during-unload-counter
1977     unsigned m_ignoreOpensDuringUnloadCount { 0 };
1978
1979     // https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html#ignore-destructive-writes-counter
1980     unsigned m_ignoreDestructiveWriteCount { 0 };
1981
1982     unsigned m_activeParserCount { 0 };
1983     unsigned m_styleRecalcCount { 0 };
1984
1985     unsigned m_writeRecursionDepth { 0 };
1986
1987     InheritedBool m_designMode { inherit };
1988     MediaProducer::MediaStateFlags m_mediaState { MediaProducer::IsNotPlaying };
1989     bool m_userHasInteractedWithMediaElement { false };
1990     PageCacheState m_pageCacheState { NotInPageCache };
1991     Optional<ReferrerPolicy> m_referrerPolicy;
1992     ReadyState m_readyState { Complete };
1993
1994     MutationObserverOptions m_mutationObserverTypes { 0 };
1995
1996     bool m_writeRecursionIsTooDeep { false };
1997     bool m_wellFormed { false };
1998     bool m_createRenderers { true };
1999
2000     bool m_hasNodesWithNonFinalStyle { false };
2001     bool m_hasNodesWithMissingStyle { false };
2002     // But sometimes you need to ignore pending stylesheet count to
2003     // force an immediate layout when requested by JS.
2004     bool m_ignorePendingStylesheets { false };
2005
2006     bool m_hasElementUsingStyleBasedEditability { false };
2007     bool m_focusNavigationStartingNodeIsRemoved { false };
2008
2009     bool m_printing { false };
2010     bool m_paginatedForScreen { false };
2011
2012     DocumentCompatibilityMode m_compatibilityMode { DocumentCompatibilityMode::NoQuirksMode };
2013     bool m_compatibilityModeLocked { false }; // This is cheaper than making setCompatibilityMode virtual.
2014
2015     // FIXME: Merge these 2 variables into an enum. Also, FrameLoader::m_didCallImplicitClose
2016     // is almost a duplication of this data, so that should probably get merged in too.
2017     // FIXME: Document::m_processingLoadEvent and DocumentLoader::m_wasOnloadDispatched are roughly the same
2018     // and should be merged.
2019     bool m_processingLoadEvent { false };
2020     bool m_loadEventFinished { false };
2021
2022     bool m_visuallyOrdered { false };
2023     bool m_bParsing { false }; // FIXME: rename
2024
2025     bool m_needsFullStyleRebuild { false };
2026     bool m_inStyleRecalc { false };
2027     bool m_closeAfterStyleRecalc { false };
2028     bool m_inRenderTreeUpdate { false };
2029     bool m_isResolvingTreeStyle { false };
2030
2031     bool m_gotoAnchorNeededAfterStylesheetsLoad { false };
2032     bool m_isDNSPrefetchEnabled { false };
2033     bool m_haveExplicitlyDisabledDNSPrefetch { false };
2034
2035     bool m_accessKeyMapValid { false };
2036     bool m_isSynthesized { false };
2037     bool m_isNonRenderedPlaceholder { false };
2038
2039     bool m_sawElementsInKnownNamespaces { false };
2040     bool m_isSrcdocDocument { false };
2041
2042     bool m_hasInjectedPlugInsScript { false };
2043     bool m_renderTreeBeingDestroyed { false };
2044     bool m_hasPreparedForDestruction { false };
2045
2046     bool m_hasStyleWithViewportUnits { false };
2047     bool m_isTimerThrottlingEnabled { false };
2048     bool m_isSuspended { false };
2049
2050     bool m_scheduledTasksAreSuspended { false };
2051     bool m_visualUpdatesAllowed { true };
2052
2053     bool m_areDeviceMotionAndOrientationUpdatesSuspended { false };
2054     bool m_userDidInteractWithPage { false };
2055
2056 #if ENABLE(TELEPHONE_NUMBER_DETECTION)
2057     bool m_isTelephoneNumberParsingAllowed { true };
2058 #endif
2059
2060 #if ENABLE(INTERSECTION_OBSERVER)
2061     bool m_needsForcedIntersectionObservationUpdate { false };
2062 #endif
2063
2064 #if ENABLE(MEDIA_STREAM)
2065     HashSet<HTMLMediaElement*> m_mediaStreamStateChangeElements;
2066     String m_idHashSalt;
2067     bool m_hasHadCaptureMediaStreamTrack { false };
2068 #endif
2069
2070 #ifndef NDEBUG
2071     bool m_didDispatchViewportPropertiesChanged { false };
2072 #endif
2073
2074     OrientationNotifier m_orientationNotifier;
2075     mutable PAL::SessionID m_sessionID;
2076     mutable RefPtr<Logger> m_logger;
2077     RefPtr<StringCallback> m_consoleMessageListener;
2078
2079     static bool hasEverCreatedAnAXObjectCache;
2080
2081     bool m_grantStorageAccessOverride { false };
2082
2083 #if USE(REQUEST_ANIMATION_FRAME_DISPLAY_MONITOR)
2084     RefPtr<DocumentAnimationScheduler> m_animationScheduler;
2085 #endif
2086     RefPtr<DocumentTimeline> m_timeline;
2087     DocumentIdentifier m_identifier;
2088
2089 #if ENABLE(SERVICE_WORKER)
2090     RefPtr<SWClientConnection> m_serviceWorkerConnection;
2091 #endif
2092
2093     HashSet<ApplicationStateChangeListener*> m_applicationStateChangeListeners;
2094     
2095 #if ENABLE(RESOURCE_LOAD_STATISTICS)
2096     String m_primaryDomainRequestedPageSpecificStorageAccessWithUserInteraction { };
2097 #endif
2098     
2099     std::unique_ptr<UserGestureIndicator> m_temporaryUserGesture;
2100
2101     CSSRegisteredCustomPropertySet m_CSSRegisteredPropertySet;
2102
2103 #if ENABLE(CSS_PAINTING_API)
2104     RefPtr<Worklet> m_paintWorklet;
2105     HashMap<String, Ref<PaintWorkletGlobalScope>> m_paintWorkletGlobalScopes;
2106 #endif
2107
2108     bool m_isRunningUserScripts { false };
2109
2110     bool m_alwaysAllowLocalWebarchive { false };
2111
2112     Ref<UndoManager> m_undoManager;
2113 };
2114
2115 Element* eventTargetElementForDocument(Document*);
2116
2117 inline TextEncoding Document::textEncoding() const
2118 {
2119     if (auto* decoder = this->decoder())
2120         return decoder->encoding();
2121     return TextEncoding();
2122 }
2123
2124 inline const Document* Document::templateDocument() const
2125 {
2126     return m_templateDocumentHost ? this : m_templateDocument.get();
2127 }
2128
2129 inline AXObjectCache* Document::existingAXObjectCache() const
2130 {
2131     if (!hasEverCreatedAnAXObjectCache)
2132         return nullptr;
2133     return existingAXObjectCacheSlow();
2134 }
2135
2136 // These functions are here because they require the Document class definition and we want to inline them.
2137
2138 inline ScriptExecutionContext* Node::scriptExecutionContext() const
2139 {
2140     return &document().contextDocument();
2141 }
2142
2143 } // namespace WebCore
2144
2145 SPECIALIZE_TYPE_TRAITS_BEGIN(WebCore::Document)
2146     static bool isType(const WebCore::ScriptExecutionContext& context) { return context.isDocument(); }
2147     static bool isType(const WebCore::Node& node) { return node.isDocumentNode(); }
2148 SPECIALIZE_TYPE_TRAITS_END()