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