[css-grid] Remove compilation flag ENABLE_CSS_GRID_LAYOUT
[WebKit-https.git] / Source / WebCore / dom / Document.cpp
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-2017 Apple Inc. All rights reserved.
7  * Copyright (C) 2008, 2009 Torch Mobile Inc. All rights reserved. (http://www.torchmobile.com/)
8  * Copyright (C) 2008, 2009, 2011, 2012 Google Inc. All rights reserved.
9  * Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies)
10  * Copyright (C) Research In Motion Limited 2010-2011. All rights reserved.
11  *
12  * This library is free software; you can redistribute it and/or
13  * modify it under the terms of the GNU Library General Public
14  * License as published by the Free Software Foundation; either
15  * version 2 of the License, or (at your option) any later version.
16  *
17  * This library is distributed in the hope that it will be useful,
18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
20  * Library General Public License for more details.
21  *
22  * You should have received a copy of the GNU Library General Public License
23  * along with this library; see the file COPYING.LIB.  If not, write to
24  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
25  * Boston, MA 02110-1301, USA.
26  */
27
28 #include "config.h"
29 #include "Document.h"
30
31 #include "AXObjectCache.h"
32 #include "Attr.h"
33 #include "CDATASection.h"
34 #include "CSSAnimationController.h"
35 #include "CSSFontSelector.h"
36 #include "CSSStyleDeclaration.h"
37 #include "CSSStyleSheet.h"
38 #include "CachedCSSStyleSheet.h"
39 #include "CachedFrame.h"
40 #include "CachedResourceLoader.h"
41 #include "Chrome.h"
42 #include "ChromeClient.h"
43 #include "Comment.h"
44 #include "CommonVM.h"
45 #include "CompositionEvent.h"
46 #include "ContentSecurityPolicy.h"
47 #include "CookieJar.h"
48 #include "CustomElementReactionQueue.h"
49 #include "CustomElementRegistry.h"
50 #include "CustomEvent.h"
51 #include "DOMImplementation.h"
52 #include "DOMNamedFlowCollection.h"
53 #include "DOMWindow.h"
54 #include "DateComponents.h"
55 #include "DebugPageOverlays.h"
56 #include "DocumentLoader.h"
57 #include "DocumentMarkerController.h"
58 #include "DocumentSharedObjectPool.h"
59 #include "DocumentType.h"
60 #include "Editor.h"
61 #include "ElementIterator.h"
62 #include "EventHandler.h"
63 #include "ExtensionStyleSheets.h"
64 #include "FocusController.h"
65 #include "FontFaceSet.h"
66 #include "FormController.h"
67 #include "FrameLoader.h"
68 #include "FrameLoaderClient.h"
69 #include "FrameView.h"
70 #include "GenericCachedHTMLCollection.h"
71 #include "HTMLAllCollection.h"
72 #include "HTMLAnchorElement.h"
73 #include "HTMLBaseElement.h"
74 #include "HTMLBodyElement.h"
75 #include "HTMLCanvasElement.h"
76 #include "HTMLDocument.h"
77 #include "HTMLElementFactory.h"
78 #include "HTMLFormControlElement.h"
79 #include "HTMLFrameOwnerElement.h"
80 #include "HTMLFrameSetElement.h"
81 #include "HTMLHeadElement.h"
82 #include "HTMLHtmlElement.h"
83 #include "HTMLImageElement.h"
84 #include "HTMLInputElement.h"
85 #include "HTMLLinkElement.h"
86 #include "HTMLMediaElement.h"
87 #include "HTMLNameCollection.h"
88 #include "HTMLParserIdioms.h"
89 #include "HTMLPictureElement.h"
90 #include "HTMLPlugInElement.h"
91 #include "HTMLScriptElement.h"
92 #include "HTMLStyleElement.h"
93 #include "HTMLTitleElement.h"
94 #include "HTMLUnknownElement.h"
95 #include "HTTPHeaderNames.h"
96 #include "HTTPParsers.h"
97 #include "HashChangeEvent.h"
98 #include "History.h"
99 #include "HitTestResult.h"
100 #include "IconController.h"
101 #include "ImageLoader.h"
102 #include "InspectorInstrumentation.h"
103 #include "JSCustomElementInterface.h"
104 #include "JSLazyEventListener.h"
105 #include "KeyboardEvent.h"
106 #include "Language.h"
107 #include "LoaderStrategy.h"
108 #include "Logging.h"
109 #include "MainFrame.h"
110 #include "MediaCanStartListener.h"
111 #include "MediaProducer.h"
112 #include "MediaQueryList.h"
113 #include "MediaQueryMatcher.h"
114 #include "MessageEvent.h"
115 #include "MouseEventWithHitTestResults.h"
116 #include "MutationEvent.h"
117 #include "NameNodeList.h"
118 #include "NamedFlowCollection.h"
119 #include "NestingLevelIncrementer.h"
120 #include "NoEventDispatchAssertion.h"
121 #include "NodeIterator.h"
122 #include "NodeRareData.h"
123 #include "NodeWithIndex.h"
124 #include "OriginAccessEntry.h"
125 #include "OverflowEvent.h"
126 #include "PageConsoleClient.h"
127 #include "PageGroup.h"
128 #include "PageTransitionEvent.h"
129 #include "PlatformLocale.h"
130 #include "PlatformMediaSessionManager.h"
131 #include "PlatformScreen.h"
132 #include "PlatformStrategies.h"
133 #include "PlugInsResources.h"
134 #include "PluginDocument.h"
135 #include "PointerLockController.h"
136 #include "PopStateEvent.h"
137 #include "ProcessingInstruction.h"
138 #include "RenderChildIterator.h"
139 #include "RenderLayerCompositor.h"
140 #include "RenderTreeUpdater.h"
141 #include "RenderView.h"
142 #include "RenderWidget.h"
143 #include "RequestAnimationFrameCallback.h"
144 #include "ResourceLoadObserver.h"
145 #include "RuntimeEnabledFeatures.h"
146 #include "SVGDocumentExtensions.h"
147 #include "SVGElement.h"
148 #include "SVGElementFactory.h"
149 #include "SVGNames.h"
150 #include "SVGSVGElement.h"
151 #include "SVGTitleElement.h"
152 #include "SVGZoomEvent.h"
153 #include "SchemeRegistry.h"
154 #include "ScopedEventQueue.h"
155 #include "ScriptController.h"
156 #include "ScriptModuleLoader.h"
157 #include "ScriptRunner.h"
158 #include "ScriptSourceCode.h"
159 #include "ScriptedAnimationController.h"
160 #include "ScrollingCoordinator.h"
161 #include "SecurityOrigin.h"
162 #include "SecurityOriginData.h"
163 #include "SecurityOriginPolicy.h"
164 #include "SecurityPolicy.h"
165 #include "SegmentedString.h"
166 #include "SelectorQuery.h"
167 #include "Settings.h"
168 #include "ShadowRoot.h"
169 #include "SocketProvider.h"
170 #include "StorageEvent.h"
171 #include "StyleProperties.h"
172 #include "StyleResolveForDocument.h"
173 #include "StyleResolver.h"
174 #include "StyleScope.h"
175 #include "StyleSheetContents.h"
176 #include "StyleSheetList.h"
177 #include "StyleTreeResolver.h"
178 #include "SubresourceLoader.h"
179 #include "TextAutoSizing.h"
180 #include "TextEvent.h"
181 #include "TextNodeTraversal.h"
182 #include "TransformSource.h"
183 #include "TreeWalker.h"
184 #include "ValidationMessageClient.h"
185 #include "VisitedLinkState.h"
186 #include "WheelEvent.h"
187 #include "WindowFeatures.h"
188 #include "XMLDocument.h"
189 #include "XMLDocumentParser.h"
190 #include "XMLNSNames.h"
191 #include "XMLNames.h"
192 #include "XPathEvaluator.h"
193 #include "XPathExpression.h"
194 #include "XPathNSResolver.h"
195 #include "XPathResult.h"
196 #include "htmlediting.h"
197 #include <ctime>
198 #include <inspector/ScriptCallStack.h>
199 #include <wtf/CurrentTime.h>
200 #include <wtf/NeverDestroyed.h>
201 #include <wtf/SetForScope.h>
202 #include <wtf/SystemTracing.h>
203 #include <wtf/text/StringBuffer.h>
204 #include <yarr/RegularExpression.h>
205
206 #if ENABLE(DEVICE_ORIENTATION)
207 #include "DeviceMotionEvent.h"
208 #include "DeviceOrientationEvent.h"
209 #endif
210
211 #if ENABLE(FULLSCREEN_API)
212 #include "RenderFullScreen.h"
213 #endif
214
215 #if ENABLE(INDEXED_DATABASE)
216 #include "IDBConnectionProxy.h"
217 #include "IDBOpenDBRequest.h"
218 #endif
219
220 #if PLATFORM(IOS)
221 #include "CSSFontSelector.h"
222 #include "DeviceMotionClientIOS.h"
223 #include "DeviceMotionController.h"
224 #include "DeviceOrientationClientIOS.h"
225 #include "DeviceOrientationController.h"
226 #include "Geolocation.h"
227 #include "Navigator.h"
228 #include "NavigatorGeolocation.h"
229 #include "WKContentObservation.h"
230 #include "WebCoreSystemInterface.h"
231 #endif
232
233 #if ENABLE(IOS_GESTURE_EVENTS)
234 #include "GestureEvent.h"
235 #endif
236
237 #if ENABLE(MATHML)
238 #include "MathMLElement.h"
239 #include "MathMLElementFactory.h"
240 #include "MathMLNames.h"
241 #endif
242
243 #if ENABLE(MEDIA_SESSION)
244 #include "MediaSession.h"
245 #endif
246
247 #if USE(QUICK_LOOK)
248 #include "QuickLook.h"
249 #endif
250
251 #if ENABLE(TOUCH_EVENTS)
252 #include "TouchEvent.h"
253 #include "TouchList.h"
254 #endif
255
256 #if ENABLE(VIDEO_TRACK)
257 #include "CaptionUserPreferences.h"
258 #endif
259
260 #if ENABLE(WEB_REPLAY)
261 #include "WebReplayInputs.h"
262 #include <replay/EmptyInputCursor.h>
263 #include <replay/InputCursor.h>
264 #endif
265
266 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
267 #include "MediaPlaybackTargetClient.h"
268 #endif
269
270 #if ENABLE(XSLT)
271 #include "XSLTProcessor.h"
272 #endif
273
274 using namespace WTF;
275 using namespace Unicode;
276
277 namespace WebCore {
278
279 using namespace HTMLNames;
280
281 static const unsigned cMaxWriteRecursionDepth = 21;
282 bool Document::hasEverCreatedAnAXObjectCache = false;
283
284 // DOM Level 2 says (letters added):
285 //
286 // a) Name start characters must have one of the categories Ll, Lu, Lo, Lt, Nl.
287 // b) Name characters other than Name-start characters must have one of the categories Mc, Me, Mn, Lm, or Nd.
288 // c) Characters in the compatibility area (i.e. with character code greater than #xF900 and less than #xFFFE) are not allowed in XML names.
289 // d) Characters which have a font or compatibility decomposition (i.e. those with a "compatibility formatting tag" in field 5 of the database -- marked by field 5 beginning with a "<") are not allowed.
290 // e) The following characters are treated as name-start characters rather than name characters, because the property file classifies them as Alphabetic: [#x02BB-#x02C1], #x0559, #x06E5, #x06E6.
291 // f) Characters #x20DD-#x20E0 are excluded (in accordance with Unicode, section 5.14).
292 // g) Character #x00B7 is classified as an extender, because the property list so identifies it.
293 // h) Character #x0387 is added as a name character, because #x00B7 is its canonical equivalent.
294 // i) Characters ':' and '_' are allowed as name-start characters.
295 // j) Characters '-' and '.' are allowed as name characters.
296 //
297 // It also contains complete tables. If we decide it's better, we could include those instead of the following code.
298
299 static inline bool isValidNameStart(UChar32 c)
300 {
301     // rule (e) above
302     if ((c >= 0x02BB && c <= 0x02C1) || c == 0x559 || c == 0x6E5 || c == 0x6E6)
303         return true;
304
305     // rule (i) above
306     if (c == ':' || c == '_')
307         return true;
308
309     // rules (a) and (f) above
310     if (!(U_GET_GC_MASK(c) & (U_GC_LL_MASK | U_GC_LU_MASK | U_GC_LO_MASK | U_GC_LT_MASK | U_GC_NL_MASK)))
311         return false;
312
313     // rule (c) above
314     if (c >= 0xF900 && c < 0xFFFE)
315         return false;
316
317     // rule (d) above
318     int type = u_getIntPropertyValue(c, UCHAR_DECOMPOSITION_TYPE);
319     if (type == U_DT_FONT || type == U_DT_COMPAT)
320         return false;
321
322     return true;
323 }
324
325 static inline bool isValidNamePart(UChar32 c)
326 {
327     // rules (a), (e), and (i) above
328     if (isValidNameStart(c))
329         return true;
330
331     // rules (g) and (h) above
332     if (c == 0x00B7 || c == 0x0387)
333         return true;
334
335     // rule (j) above
336     if (c == '-' || c == '.')
337         return true;
338
339     // rules (b) and (f) above
340     if (!(U_GET_GC_MASK(c) & (U_GC_M_MASK | U_GC_LM_MASK | U_GC_ND_MASK)))
341         return false;
342
343     // rule (c) above
344     if (c >= 0xF900 && c < 0xFFFE)
345         return false;
346
347     // rule (d) above
348     int type = u_getIntPropertyValue(c, UCHAR_DECOMPOSITION_TYPE);
349     if (type == U_DT_FONT || type == U_DT_COMPAT)
350         return false;
351
352     return true;
353 }
354
355 static Widget* widgetForElement(Element* focusedElement)
356 {
357     if (!focusedElement)
358         return nullptr;
359     auto* renderer = focusedElement->renderer();
360     if (!is<RenderWidget>(renderer))
361         return nullptr;
362     return downcast<RenderWidget>(*renderer).widget();
363 }
364
365 static bool acceptsEditingFocus(Node* node)
366 {
367     ASSERT(node);
368     ASSERT(node->hasEditableStyle());
369
370     Node* root = node->rootEditableElement();
371     Frame* frame = node->document().frame();
372     if (!frame || !root)
373         return false;
374
375     return frame->editor().shouldBeginEditing(rangeOfContents(*root).ptr());
376 }
377
378 static bool canAccessAncestor(const SecurityOrigin& activeSecurityOrigin, Frame* targetFrame)
379 {
380     // targetFrame can be 0 when we're trying to navigate a top-level frame
381     // that has a 0 opener.
382     if (!targetFrame)
383         return false;
384
385     const bool isLocalActiveOrigin = activeSecurityOrigin.isLocal();
386     for (Frame* ancestorFrame = targetFrame; ancestorFrame; ancestorFrame = ancestorFrame->tree().parent()) {
387         Document* ancestorDocument = ancestorFrame->document();
388         // FIXME: Should be an ASSERT? Frames should alway have documents.
389         if (!ancestorDocument)
390             return true;
391
392         const SecurityOrigin& ancestorSecurityOrigin = ancestorDocument->securityOrigin();
393         if (activeSecurityOrigin.canAccess(ancestorSecurityOrigin))
394             return true;
395         
396         // Allow file URL descendant navigation even when allowFileAccessFromFileURLs is false.
397         // FIXME: It's a bit strange to special-case local origins here. Should we be doing
398         // something more general instead?
399         if (isLocalActiveOrigin && ancestorSecurityOrigin.isLocal())
400             return true;
401     }
402
403     return false;
404 }
405
406 static void printNavigationErrorMessage(Frame* frame, const URL& activeURL, const char* reason)
407 {
408     String message = "Unsafe JavaScript attempt to initiate navigation for frame with URL '" + frame->document()->url().string() + "' from frame with URL '" + activeURL.string() + "'. " + reason + "\n";
409
410     // FIXME: should we print to the console of the document performing the navigation instead?
411     frame->document()->domWindow()->printErrorMessage(message);
412 }
413
414 #if ENABLE(TEXT_AUTOSIZING)
415
416 void TextAutoSizingTraits::constructDeletedValue(TextAutoSizingKey& slot)
417 {
418     new (NotNull, &slot) TextAutoSizingKey(TextAutoSizingKey::Deleted);
419 }
420
421 bool TextAutoSizingTraits::isDeletedValue(const TextAutoSizingKey& value)
422 {
423     return value.isDeleted();
424 }
425
426 #endif
427
428 uint64_t Document::s_globalTreeVersion = 0;
429
430 HashSet<Document*>& Document::allDocuments()
431 {
432     static NeverDestroyed<HashSet<Document*>> documents;
433     return documents;
434 }
435
436 Document::Document(Frame* frame, const URL& url, unsigned documentClasses, unsigned constructionFlags)
437     : ContainerNode(*this, CreateDocument)
438     , TreeScope(*this)
439     , FrameDestructionObserver(frame)
440 #if ENABLE(IOS_TOUCH_EVENTS)
441     , m_touchEventsChangedTimer(*this, &Document::touchEventsChangedTimerFired)
442 #endif
443     , m_referencingNodeCount(0)
444     , m_settings(frame ? Ref<Settings>(frame->settings()) : Settings::create(nullptr))
445     , m_hasNodesWithPlaceholderStyle(false)
446     , m_ignorePendingStylesheets(false)
447     , m_pendingSheetLayout(NoLayoutWithPendingSheets)
448     , m_cachedResourceLoader(m_frame ? Ref<CachedResourceLoader>(m_frame->loader().activeDocumentLoader()->cachedResourceLoader()) : CachedResourceLoader::create(nullptr))
449     , m_activeParserCount(0)
450     , m_wellFormed(false)
451     , m_printing(false)
452     , m_paginatedForScreen(false)
453     , m_compatibilityMode(DocumentCompatibilityMode::NoQuirksMode)
454     , m_compatibilityModeLocked(false)
455     , m_textColor(Color::black)
456     , m_domTreeVersion(++s_globalTreeVersion)
457     , m_listenerTypes(0)
458     , m_mutationObserverTypes(0)
459     , m_styleScope(std::make_unique<Style::Scope>(*this))
460     , m_extensionStyleSheets(std::make_unique<ExtensionStyleSheets>(*this))
461     , m_visitedLinkState(std::make_unique<VisitedLinkState>(*this))
462     , m_visuallyOrdered(false)
463     , m_readyState(Complete)
464     , m_bParsing(false)
465     , m_styleRecalcTimer(*this, &Document::updateStyleIfNeeded)
466     , m_pendingStyleRecalcShouldForce(false)
467     , m_inStyleRecalc(false)
468     , m_closeAfterStyleRecalc(false)
469     , m_gotoAnchorNeededAfterStylesheetsLoad(false)
470     , m_frameElementsShouldIgnoreScrolling(false)
471     , m_updateFocusAppearanceRestoresSelection(SelectionRestorationMode::SetDefault)
472     , m_markers(std::make_unique<DocumentMarkerController>(*this))
473     , m_updateFocusAppearanceTimer(*this, &Document::updateFocusAppearanceTimerFired)
474     , m_cssTarget(nullptr)
475     , m_processingLoadEvent(false)
476     , m_loadEventFinished(false)
477     , m_documentCreationTime(MonotonicTime::now())
478     , m_overMinimumLayoutThreshold(false)
479     , m_scriptRunner(std::make_unique<ScriptRunner>(*this))
480     , m_moduleLoader(std::make_unique<ScriptModuleLoader>(*this))
481     , m_xmlVersion(ASCIILiteral("1.0"))
482     , m_xmlStandalone(StandaloneUnspecified)
483     , m_hasXMLDeclaration(false)
484     , m_designMode(inherit)
485 #if ENABLE(DASHBOARD_SUPPORT)
486     , m_hasAnnotatedRegions(false)
487     , m_annotatedRegionsDirty(false)
488 #endif
489     , m_createRenderers(true)
490     , m_accessKeyMapValid(false)
491     , m_documentClasses(documentClasses)
492     , m_isSynthesized(constructionFlags & Synthesized)
493     , m_isNonRenderedPlaceholder(constructionFlags & NonRenderedPlaceholder)
494     , m_sawElementsInKnownNamespaces(false)
495     , m_isSrcdocDocument(false)
496     , m_eventQueue(*this)
497     , m_weakFactory(this)
498 #if ENABLE(FULLSCREEN_API)
499     , m_areKeysEnabledInFullScreen(0)
500     , m_fullScreenRenderer(nullptr)
501     , m_fullScreenChangeDelayTimer(*this, &Document::fullScreenChangeDelayTimerFired)
502     , m_isAnimatingFullScreen(false)
503 #endif
504     , m_loadEventDelayCount(0)
505     , m_loadEventDelayTimer(*this, &Document::loadEventDelayTimerFired)
506     , m_referrerPolicy(ReferrerPolicy::Default)
507     , m_writeRecursionIsTooDeep(false)
508     , m_writeRecursionDepth(0)
509     , m_lastHandledUserGestureTimestamp(0)
510 #if PLATFORM(IOS)
511 #if ENABLE(DEVICE_ORIENTATION)
512     , m_deviceMotionClient(std::make_unique<DeviceMotionClientIOS>())
513     , m_deviceMotionController(std::make_unique<DeviceMotionController>(m_deviceMotionClient.get()))
514     , m_deviceOrientationClient(std::make_unique<DeviceOrientationClientIOS>())
515     , m_deviceOrientationController(std::make_unique<DeviceOrientationController>(m_deviceOrientationClient.get()))
516 #endif
517 #endif
518 #if ENABLE(TELEPHONE_NUMBER_DETECTION)
519     , m_isTelephoneNumberParsingAllowed(true)
520 #endif
521     , m_pendingTasksTimer(*this, &Document::pendingTasksTimerFired)
522     , m_scheduledTasksAreSuspended(false)
523     , m_visualUpdatesAllowed(true)
524     , m_visualUpdatesSuppressionTimer(*this, &Document::visualUpdatesSuppressionTimerFired)
525     , m_sharedObjectPoolClearTimer(*this, &Document::clearSharedObjectPool)
526 #ifndef NDEBUG
527     , m_didDispatchViewportPropertiesChanged(false)
528 #endif
529     , m_templateDocumentHost(nullptr)
530     , m_fontSelector(CSSFontSelector::create(*this))
531 #if ENABLE(WEB_REPLAY)
532     , m_inputCursor(EmptyInputCursor::create())
533 #endif
534     , m_didAssociateFormControlsTimer(*this, &Document::didAssociateFormControlsTimerFired)
535     , m_cookieCacheExpiryTimer(*this, &Document::invalidateDOMCookieCache)
536     , m_disabledFieldsetElementsCount(0)
537     , m_hasInjectedPlugInsScript(false)
538     , m_hasStyleWithViewportUnits(false)
539 #if ENABLE(WEB_SOCKETS)
540     , m_socketProvider(page() ? &page()->socketProvider() : nullptr)
541 #endif
542 {
543     allDocuments().add(this);
544
545     // We depend on the url getting immediately set in subframes, but we
546     // also depend on the url NOT getting immediately set in opened windows.
547     // See fast/dom/early-frame-url.html
548     // and fast/dom/location-new-window-no-crash.html, respectively.
549     // FIXME: Can/should we unify this behavior?
550     if ((frame && frame->ownerElement()) || !url.isEmpty())
551         setURL(url);
552
553     m_cachedResourceLoader->setDocument(this);
554
555     resetLinkColor();
556     resetVisitedLinkColor();
557     resetActiveLinkColor();
558
559     initSecurityContext();
560     initDNSPrefetch();
561
562     m_fontSelector->registerForInvalidationCallbacks(*this);
563
564     for (auto& nodeListAndCollectionCount : m_nodeListAndCollectionCounts)
565         nodeListAndCollectionCount = 0;
566 }
567
568 #if ENABLE(FULLSCREEN_API)
569
570 static bool isAttributeOnAllOwners(const WebCore::QualifiedName& attribute, const WebCore::QualifiedName& prefixedAttribute, const HTMLFrameOwnerElement* owner)
571 {
572     if (!owner)
573         return true;
574     do {
575         if (!(owner->hasAttribute(attribute) || owner->hasAttribute(prefixedAttribute)))
576             return false;
577     } while ((owner = owner->document().ownerElement()));
578     return true;
579 }
580
581 #endif
582
583 Ref<Document> Document::create(Document& contextDocument)
584 {
585     auto document = adoptRef(*new Document(nullptr, URL()));
586     document->setContextDocument(contextDocument);
587     document->setSecurityOriginPolicy(contextDocument.securityOriginPolicy());
588     return document;
589 }
590
591 Document::~Document()
592 {
593     allDocuments().remove(this);
594
595     ASSERT(!renderView());
596     ASSERT(m_pageCacheState != InPageCache);
597     ASSERT(m_ranges.isEmpty());
598     ASSERT(!m_parentTreeScope);
599     ASSERT(!m_disabledFieldsetElementsCount);
600     ASSERT(m_inDocumentShadowRoots.isEmpty());
601
602 #if ENABLE(DEVICE_ORIENTATION) && PLATFORM(IOS)
603     m_deviceMotionClient->deviceMotionControllerDestroyed();
604     m_deviceOrientationClient->deviceOrientationControllerDestroyed();
605 #endif
606
607     if (m_templateDocument)
608         m_templateDocument->setTemplateDocumentHost(nullptr); // balanced in templateDocument().
609
610     // FIXME: Should we reset m_domWindow when we detach from the Frame?
611     if (m_domWindow)
612         m_domWindow->resetUnlessSuspendedForDocumentSuspension();
613
614     m_scriptRunner = nullptr;
615     m_moduleLoader = nullptr;
616
617     removeAllEventListeners();
618
619     // Currently we believe that Document can never outlive the parser.
620     // Although the Document may be replaced synchronously, DocumentParsers
621     // generally keep at least one reference to an Element which would in turn
622     // has a reference to the Document.  If you hit this ASSERT, then that
623     // assumption is wrong.  DocumentParser::detach() should ensure that even
624     // if the DocumentParser outlives the Document it won't cause badness.
625     ASSERT(!m_parser || m_parser->refCount() == 1);
626     detachParser();
627
628     if (this == &topDocument())
629         clearAXObjectCache();
630
631     m_decoder = nullptr;
632
633     if (m_styleSheetList)
634         m_styleSheetList->detachFromDocument();
635
636     extensionStyleSheets().detachFromDocument();
637
638     styleScope().clearResolver(); // We need to destroy CSSFontSelector before destroying m_cachedResourceLoader.
639     m_fontSelector->clearDocument();
640     m_fontSelector->unregisterForInvalidationCallbacks(*this);
641
642     // It's possible for multiple Documents to end up referencing the same CachedResourceLoader (e.g., SVGImages
643     // load the initial empty document and the SVGDocument with the same DocumentLoader).
644     if (m_cachedResourceLoader->document() == this)
645         m_cachedResourceLoader->setDocument(nullptr);
646
647 #if ENABLE(VIDEO)
648     if (auto* platformMediaSessionManager = PlatformMediaSessionManager::sharedManagerIfExists())
649         platformMediaSessionManager->stopAllMediaPlaybackForDocument(this);
650 #endif
651     
652     // We must call clearRareData() here since a Document class inherits TreeScope
653     // as well as Node. See a comment on TreeScope.h for the reason.
654     if (hasRareData())
655         clearRareData();
656
657     ASSERT(!m_listsInvalidatedAtDocument.size());
658     ASSERT(!m_collectionsInvalidatedAtDocument.size());
659
660     for (unsigned i = 0; i < WTF_ARRAY_LENGTH(m_nodeListAndCollectionCounts); ++i)
661         ASSERT(!m_nodeListAndCollectionCounts[i]);
662 }
663
664 void Document::removedLastRef()
665 {
666     ASSERT(!m_deletionHasBegun);
667     if (m_referencingNodeCount) {
668         // If removing a child removes the last node reference, we don't want the scope to be destroyed
669         // until after removeDetachedChildren returns, so we protect ourselves.
670         incrementReferencingNodeCount();
671
672         RELEASE_ASSERT(!hasLivingRenderTree());
673         // We must make sure not to be retaining any of our children through
674         // these extra pointers or we will create a reference cycle.
675         m_focusedElement = nullptr;
676         m_hoveredElement = nullptr;
677         m_activeElement = nullptr;
678         m_titleElement = nullptr;
679         m_documentElement = nullptr;
680         m_focusNavigationStartingNode = nullptr;
681         m_userActionElements.documentDidRemoveLastRef();
682 #if ENABLE(FULLSCREEN_API)
683         m_fullScreenElement = nullptr;
684         m_fullScreenElementStack.clear();
685 #endif
686
687         detachParser();
688
689         // removeDetachedChildren() doesn't always unregister IDs,
690         // so tear down scope information up front to avoid having
691         // stale references in the map.
692
693         destroyTreeScopeData();
694         removeDetachedChildren();
695         m_formController = nullptr;
696         
697         m_markers->detach();
698         
699         m_cssCanvasElements.clear();
700         
701         commonTeardown();
702
703 #ifndef NDEBUG
704         // We need to do this right now since selfOnlyDeref() can delete this.
705         m_inRemovedLastRefFunction = false;
706 #endif
707         decrementReferencingNodeCount();
708     } else {
709 #ifndef NDEBUG
710         m_inRemovedLastRefFunction = false;
711         m_deletionHasBegun = true;
712 #endif
713         delete this;
714     }
715 }
716
717 void Document::commonTeardown()
718 {
719     if (svgExtensions())
720         accessSVGExtensions().pauseAnimations();
721
722     clearScriptedAnimationController();
723 }
724
725 Element* Document::getElementByAccessKey(const String& key)
726 {
727     if (key.isEmpty())
728         return nullptr;
729     if (!m_accessKeyMapValid) {
730         buildAccessKeyMap(this);
731         m_accessKeyMapValid = true;
732     }
733     return m_elementsByAccessKey.get(key.impl());
734 }
735
736 void Document::buildAccessKeyMap(TreeScope* scope)
737 {
738     ASSERT(scope);
739     for (auto& element : descendantsOfType<Element>(scope->rootNode())) {
740         const AtomicString& accessKey = element.attributeWithoutSynchronization(accesskeyAttr);
741         if (!accessKey.isEmpty())
742             m_elementsByAccessKey.set(accessKey.impl(), &element);
743
744         if (ShadowRoot* root = element.shadowRoot())
745             buildAccessKeyMap(root);
746     }
747 }
748
749 void Document::invalidateAccessKeyMap()
750 {
751     m_accessKeyMapValid = false;
752     m_elementsByAccessKey.clear();
753 }
754
755 void Document::addImageElementByUsemap(const AtomicStringImpl& name, HTMLImageElement& element)
756 {
757     return m_imagesByUsemap.add(name, element, *this);
758 }
759
760 void Document::removeImageElementByUsemap(const AtomicStringImpl& name, HTMLImageElement& element)
761 {
762     return m_imagesByUsemap.remove(name, element);
763 }
764
765 HTMLImageElement* Document::imageElementByUsemap(const AtomicStringImpl& name) const
766 {
767     return m_imagesByUsemap.getElementByUsemap(name, *this);
768 }
769
770 ExceptionOr<SelectorQuery&> Document::selectorQueryForString(const String& selectorString)
771 {
772     if (selectorString.isEmpty())
773         return Exception { SYNTAX_ERR };
774     if (!m_selectorQueryCache)
775         m_selectorQueryCache = std::make_unique<SelectorQueryCache>();
776     return m_selectorQueryCache->add(selectorString, *this);
777 }
778
779 void Document::clearSelectorQueryCache()
780 {
781     m_selectorQueryCache = nullptr;
782 }
783
784 MediaQueryMatcher& Document::mediaQueryMatcher()
785 {
786     if (!m_mediaQueryMatcher)
787         m_mediaQueryMatcher = MediaQueryMatcher::create(*this);
788     return *m_mediaQueryMatcher;
789 }
790
791 void Document::setCompatibilityMode(DocumentCompatibilityMode mode)
792 {
793     if (m_compatibilityModeLocked || mode == m_compatibilityMode)
794         return;
795     bool wasInQuirksMode = inQuirksMode();
796     m_compatibilityMode = mode;
797
798     clearSelectorQueryCache();
799
800     if (inQuirksMode() != wasInQuirksMode) {
801         // All user stylesheets have to reparse using the different mode.
802         extensionStyleSheets().clearPageUserSheet();
803         extensionStyleSheets().invalidateInjectedStyleSheetCache();
804     }
805 }
806
807 String Document::compatMode() const
808 {
809     return inQuirksMode() ? "BackCompat" : "CSS1Compat";
810 }
811
812 void Document::resetLinkColor()
813 {
814     m_linkColor = Color(0, 0, 238);
815 }
816
817 void Document::resetVisitedLinkColor()
818 {
819     m_visitedLinkColor = Color(85, 26, 139);    
820 }
821
822 void Document::resetActiveLinkColor()
823 {
824     m_activeLinkColor = Color(255, 0, 0);
825 }
826
827 DOMImplementation& Document::implementation()
828 {
829     if (!m_implementation)
830         m_implementation = std::make_unique<DOMImplementation>(*this);
831     return *m_implementation;
832 }
833
834 bool Document::hasManifest() const
835 {
836     return documentElement() && documentElement()->hasTagName(htmlTag) && documentElement()->hasAttributeWithoutSynchronization(manifestAttr);
837 }
838
839 DocumentType* Document::doctype() const
840 {
841     for (Node* node = firstChild(); node; node = node->nextSibling()) {
842         if (node->isDocumentTypeNode())
843             return static_cast<DocumentType*>(node);
844     }
845     return nullptr;
846 }
847
848 void Document::childrenChanged(const ChildChange& change)
849 {
850     ContainerNode::childrenChanged(change);
851
852     // FIXME: Chrome::didReceiveDocType() used to be called only when the doctype changed. We need to check the
853     // impact of calling this systematically. If the overhead is negligible, we need to rename didReceiveDocType,
854     // otherwise, we need to detect the doc type changes before updating the viewport.
855     if (Page* page = this->page())
856         page->chrome().didReceiveDocType(*frame());
857
858     Element* newDocumentElement = childrenOfType<Element>(*this).first();
859     if (newDocumentElement == m_documentElement)
860         return;
861     m_documentElement = newDocumentElement;
862     // The root style used for media query matching depends on the document element.
863     styleScope().clearResolver();
864 }
865
866 static ALWAYS_INLINE Ref<HTMLElement> createUpgradeCandidateElement(Document& document, const QualifiedName& name)
867 {
868     if (!RuntimeEnabledFeatures::sharedFeatures().customElementsEnabled()
869         || Document::validateCustomElementName(name.localName()) != CustomElementNameValidationStatus::Valid)
870         return HTMLUnknownElement::create(name, document);
871
872     auto element = HTMLElement::create(name, document);
873     element->setIsCustomElementUpgradeCandidate();
874     return element;
875 }
876
877 static ALWAYS_INLINE Ref<HTMLElement> createUpgradeCandidateElement(Document& document, const AtomicString& localName)
878 {
879     return createUpgradeCandidateElement(document, QualifiedName { nullAtom, localName, xhtmlNamespaceURI });
880 }
881
882 static inline bool isValidHTMLElementName(const AtomicString& localName)
883 {
884     return Document::isValidName(localName);
885 }
886
887 static inline bool isValidHTMLElementName(const QualifiedName& name)
888 {
889     return Document::isValidName(name.localName());
890 }
891
892 template<typename NameType>
893 static ExceptionOr<Ref<Element>> createHTMLElementWithNameValidation(Document& document, const NameType& name)
894 {
895     auto element = HTMLElementFactory::createKnownElement(name, document);
896     if (LIKELY(element))
897         return Ref<Element> { element.releaseNonNull() };
898
899     if (auto* window = document.domWindow()) {
900         auto* registry = window->customElementRegistry();
901         if (UNLIKELY(registry)) {
902             if (auto* elementInterface = registry->findInterface(name))
903                 return elementInterface->constructElementWithFallback(document, name);
904         }
905     }
906
907     if (UNLIKELY(!isValidHTMLElementName(name)))
908         return Exception { INVALID_CHARACTER_ERR };
909
910     return Ref<Element> { createUpgradeCandidateElement(document, name) };
911 }
912
913 ExceptionOr<Ref<Element>> Document::createElementForBindings(const AtomicString& name)
914 {
915     if (isHTMLDocument())
916         return createHTMLElementWithNameValidation(*this, name.convertToASCIILowercase());
917
918     if (isXHTMLDocument())
919         return createHTMLElementWithNameValidation(*this, name);
920
921     if (!isValidName(name))
922         return Exception { INVALID_CHARACTER_ERR };
923
924     return createElement(QualifiedName(nullAtom, name, nullAtom), false);
925 }
926
927 Ref<DocumentFragment> Document::createDocumentFragment()
928 {
929     return DocumentFragment::create(document());
930 }
931
932 Ref<Text> Document::createTextNode(const String& data)
933 {
934     return Text::create(*this, data);
935 }
936
937 Ref<Comment> Document::createComment(const String& data)
938 {
939     return Comment::create(*this, data);
940 }
941
942 ExceptionOr<Ref<CDATASection>> Document::createCDATASection(const String& data)
943 {
944     if (isHTMLDocument())
945         return Exception { NOT_SUPPORTED_ERR };
946     return CDATASection::create(*this, data);
947 }
948
949 ExceptionOr<Ref<ProcessingInstruction>> Document::createProcessingInstruction(const String& target, const String& data)
950 {
951     if (!isValidName(target))
952         return Exception { INVALID_CHARACTER_ERR };
953
954     if (data.contains("?>"))
955         return Exception { INVALID_CHARACTER_ERR };
956
957     return ProcessingInstruction::create(*this, target, data);
958 }
959
960 Ref<Text> Document::createEditingTextNode(const String& text)
961 {
962     return Text::createEditingText(*this, text);
963 }
964
965 Ref<CSSStyleDeclaration> Document::createCSSStyleDeclaration()
966 {
967     Ref<MutableStyleProperties> propertySet(MutableStyleProperties::create());
968     return *propertySet->ensureCSSStyleDeclaration();
969 }
970
971 ExceptionOr<Ref<Node>> Document::importNode(Node& nodeToImport, bool deep)
972 {
973     switch (nodeToImport.nodeType()) {
974     case DOCUMENT_FRAGMENT_NODE:
975         if (nodeToImport.isShadowRoot())
976             break;
977         FALLTHROUGH;
978     case ELEMENT_NODE:
979     case TEXT_NODE:
980     case CDATA_SECTION_NODE:
981     case PROCESSING_INSTRUCTION_NODE:
982     case COMMENT_NODE:
983         return nodeToImport.cloneNodeInternal(document(), deep ? CloningOperation::Everything : CloningOperation::OnlySelf);
984
985     case ATTRIBUTE_NODE:
986         // FIXME: This will "Attr::normalize" child nodes of Attr.
987         return Ref<Node> { Attr::create(*this, QualifiedName(nullAtom, downcast<Attr>(nodeToImport).name(), nullAtom), downcast<Attr>(nodeToImport).value()) };
988
989     case DOCUMENT_NODE: // Can't import a document into another document.
990     case DOCUMENT_TYPE_NODE: // FIXME: Support cloning a DocumentType node per DOM4.
991         break;
992     }
993
994     return Exception { NOT_SUPPORTED_ERR };
995 }
996
997
998 ExceptionOr<Ref<Node>> Document::adoptNode(Node& source)
999 {
1000     EventQueueScope scope;
1001
1002     switch (source.nodeType()) {
1003     case DOCUMENT_NODE:
1004         return Exception { NOT_SUPPORTED_ERR };
1005     case ATTRIBUTE_NODE: {
1006         auto& attr = downcast<Attr>(source);
1007         if (auto* element = attr.ownerElement()) {
1008             auto result = element->removeAttributeNode(attr);
1009             if (result.hasException())
1010                 return result.releaseException();
1011         }
1012         break;
1013     }       
1014     default:
1015         if (source.isShadowRoot()) {
1016             // ShadowRoot cannot disconnect itself from the host node.
1017             return Exception { HIERARCHY_REQUEST_ERR };
1018         }
1019         if (is<HTMLFrameOwnerElement>(source)) {
1020             auto& frameOwnerElement = downcast<HTMLFrameOwnerElement>(source);
1021             if (frame() && frame()->tree().isDescendantOf(frameOwnerElement.contentFrame()))
1022                 return Exception { HIERARCHY_REQUEST_ERR };
1023         }
1024         auto result = source.remove();
1025         if (result.hasException())
1026             return result.releaseException();
1027         ASSERT_WITH_SECURITY_IMPLICATION(!source.isConnected());
1028         ASSERT_WITH_SECURITY_IMPLICATION(!source.parentNode());
1029     }
1030
1031     adoptIfNeeded(source);
1032
1033     return Ref<Node> { source };
1034 }
1035
1036 bool Document::hasValidNamespaceForElements(const QualifiedName& qName)
1037 {
1038     // These checks are from DOM Core Level 2, createElementNS
1039     // http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-DocCrElNS
1040     if (!qName.prefix().isEmpty() && qName.namespaceURI().isNull()) // createElementNS(null, "html:div")
1041         return false;
1042     if (qName.prefix() == xmlAtom && qName.namespaceURI() != XMLNames::xmlNamespaceURI) // createElementNS("http://www.example.com", "xml:lang")
1043         return false;
1044
1045     // Required by DOM Level 3 Core and unspecified by DOM Level 2 Core:
1046     // http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-DocCrElNS
1047     // createElementNS("http://www.w3.org/2000/xmlns/", "foo:bar"), createElementNS(null, "xmlns:bar"), createElementNS(null, "xmlns")
1048     if (qName.prefix() == xmlnsAtom || (qName.prefix().isEmpty() && qName.localName() == xmlnsAtom))
1049         return qName.namespaceURI() == XMLNSNames::xmlnsNamespaceURI;
1050     return qName.namespaceURI() != XMLNSNames::xmlnsNamespaceURI;
1051 }
1052
1053 bool Document::hasValidNamespaceForAttributes(const QualifiedName& qName)
1054 {
1055     return hasValidNamespaceForElements(qName);
1056 }
1057
1058 static Ref<HTMLElement> createFallbackHTMLElement(Document& document, const QualifiedName& name)
1059 {
1060     if (auto* window = document.domWindow()) {
1061         auto* registry = window->customElementRegistry();
1062         if (UNLIKELY(registry)) {
1063             if (auto* elementInterface = registry->findInterface(name)) {
1064                 auto element = HTMLElement::create(name, document);
1065                 element->enqueueToUpgrade(*elementInterface);
1066                 return element;
1067             }
1068         }
1069     }
1070     // FIXME: Should we also check the equality of prefix between the custom element and name?
1071     return createUpgradeCandidateElement(document, name);
1072 }
1073
1074 // FIXME: This should really be in a possible ElementFactory class.
1075 Ref<Element> Document::createElement(const QualifiedName& name, bool createdByParser)
1076 {
1077     RefPtr<Element> element;
1078
1079     // FIXME: Use registered namespaces and look up in a hash to find the right factory.
1080     if (name.namespaceURI() == xhtmlNamespaceURI) {
1081         element = HTMLElementFactory::createKnownElement(name, *this, nullptr, createdByParser);
1082         if (UNLIKELY(!element))
1083             element = createFallbackHTMLElement(*this, name);
1084     } else if (name.namespaceURI() == SVGNames::svgNamespaceURI)
1085         element = SVGElementFactory::createElement(name, *this, createdByParser);
1086 #if ENABLE(MATHML)
1087     else if (name.namespaceURI() == MathMLNames::mathmlNamespaceURI)
1088         element = MathMLElementFactory::createElement(name, *this, createdByParser);
1089 #endif
1090
1091     if (element)
1092         m_sawElementsInKnownNamespaces = true;
1093     else
1094         element = Element::create(name, document());
1095
1096     // <image> uses imgTag so we need a special rule.
1097     ASSERT((name.matches(imageTag) && element->tagQName().matches(imgTag) && element->tagQName().prefix() == name.prefix()) || name == element->tagQName());
1098
1099     return element.releaseNonNull();
1100 }
1101
1102 CustomElementNameValidationStatus Document::validateCustomElementName(const AtomicString& localName)
1103 {
1104     bool containsHyphen = false;
1105     for (auto character : StringView(localName).codeUnits()) {
1106         if (isASCIIUpper(character))
1107             return CustomElementNameValidationStatus::ContainsUpperCase;
1108         if (character == '-')
1109             containsHyphen = true;
1110     }
1111
1112     if (!containsHyphen)
1113         return CustomElementNameValidationStatus::NoHyphen;
1114
1115 #if ENABLE(MATHML)
1116     const auto& annotationXmlLocalName = MathMLNames::annotation_xmlTag.localName();
1117 #else
1118     static NeverDestroyed<const AtomicString> annotationXmlLocalName("annotation-xml", AtomicString::ConstructFromLiteral);
1119 #endif
1120
1121     if (localName == SVGNames::color_profileTag.localName()
1122         || localName == SVGNames::font_faceTag.localName()
1123         || localName == SVGNames::font_face_formatTag.localName()
1124         || localName == SVGNames::font_face_nameTag.localName()
1125         || localName == SVGNames::font_face_srcTag.localName()
1126         || localName == SVGNames::font_face_uriTag.localName()
1127         || localName == SVGNames::missing_glyphTag.localName()
1128         || localName == annotationXmlLocalName)
1129         return CustomElementNameValidationStatus::ConflictsWithBuiltinNames;
1130
1131     return CustomElementNameValidationStatus::Valid;
1132 }
1133
1134 bool Document::isCSSGridLayoutEnabled() const
1135 {
1136     return RuntimeEnabledFeatures::sharedFeatures().isCSSGridLayoutEnabled();
1137 }
1138
1139 #if ENABLE(CSS_REGIONS)
1140
1141 RefPtr<DOMNamedFlowCollection> Document::webkitGetNamedFlows()
1142 {
1143     if (!renderView())
1144         return nullptr;
1145
1146     updateStyleIfNeeded();
1147
1148     return namedFlows().createCSSOMSnapshot();
1149 }
1150
1151 #endif
1152
1153 NamedFlowCollection& Document::namedFlows()
1154 {
1155     if (!m_namedFlows)
1156         m_namedFlows = NamedFlowCollection::create(this);
1157
1158     return *m_namedFlows;
1159 }
1160
1161 ExceptionOr<Ref<Element>> Document::createElementNS(const AtomicString& namespaceURI, const String& qualifiedName)
1162 {
1163     auto parseResult = parseQualifiedName(namespaceURI, qualifiedName);
1164     if (parseResult.hasException())
1165         return parseResult.releaseException();
1166     QualifiedName parsedName { parseResult.releaseReturnValue() };
1167     if (!hasValidNamespaceForElements(parsedName))
1168         return Exception { NAMESPACE_ERR };
1169
1170     if (parsedName.namespaceURI() == xhtmlNamespaceURI)
1171         return createHTMLElementWithNameValidation(*this, parsedName);
1172
1173     return createElement(parsedName, false);
1174 }
1175
1176 String Document::readyState() const
1177 {
1178     static NeverDestroyed<const String> loading(ASCIILiteral("loading"));
1179     static NeverDestroyed<const String> interactive(ASCIILiteral("interactive"));
1180     static NeverDestroyed<const String> complete(ASCIILiteral("complete"));
1181
1182     switch (m_readyState) {
1183     case Loading:
1184         return loading;
1185     case Interactive:
1186         return interactive;
1187     case Complete:
1188         return complete;
1189     }
1190
1191     ASSERT_NOT_REACHED();
1192     return String();
1193 }
1194
1195 void Document::setReadyState(ReadyState readyState)
1196 {
1197     if (readyState == m_readyState)
1198         return;
1199
1200 #if ENABLE(WEB_TIMING)
1201     switch (readyState) {
1202     case Loading:
1203         if (!m_documentTiming.domLoading)
1204             m_documentTiming.domLoading = MonotonicTime::now();
1205         break;
1206     case Interactive:
1207         if (!m_documentTiming.domInteractive)
1208             m_documentTiming.domInteractive = MonotonicTime::now();
1209         break;
1210     case Complete:
1211         if (!m_documentTiming.domComplete)
1212             m_documentTiming.domComplete = MonotonicTime::now();
1213         break;
1214     }
1215 #endif
1216
1217     m_readyState = readyState;
1218     dispatchEvent(Event::create(eventNames().readystatechangeEvent, false, false));
1219     
1220     if (settings().suppressesIncrementalRendering())
1221         setVisualUpdatesAllowed(readyState);
1222 }
1223
1224 void Document::setVisualUpdatesAllowed(ReadyState readyState)
1225 {
1226     ASSERT(settings().suppressesIncrementalRendering());
1227     switch (readyState) {
1228     case Loading:
1229         ASSERT(!m_visualUpdatesSuppressionTimer.isActive());
1230         ASSERT(m_visualUpdatesAllowed);
1231         setVisualUpdatesAllowed(false);
1232         break;
1233     case Interactive:
1234         ASSERT(m_visualUpdatesSuppressionTimer.isActive() || m_visualUpdatesAllowed);
1235         break;
1236     case Complete:
1237         if (m_visualUpdatesSuppressionTimer.isActive()) {
1238             ASSERT(!m_visualUpdatesAllowed);
1239
1240             if (!view()->visualUpdatesAllowedByClient())
1241                 return;
1242
1243             setVisualUpdatesAllowed(true);
1244         } else
1245             ASSERT(m_visualUpdatesAllowed);
1246         break;
1247     }
1248 }
1249     
1250 void Document::setVisualUpdatesAllowed(bool visualUpdatesAllowed)
1251 {
1252     if (m_visualUpdatesAllowed == visualUpdatesAllowed)
1253         return;
1254
1255     m_visualUpdatesAllowed = visualUpdatesAllowed;
1256
1257     if (visualUpdatesAllowed)
1258         m_visualUpdatesSuppressionTimer.stop();
1259     else
1260         m_visualUpdatesSuppressionTimer.startOneShot(settings().incrementalRenderingSuppressionTimeoutInSeconds());
1261
1262     if (!visualUpdatesAllowed)
1263         return;
1264
1265     FrameView* frameView = view();
1266     bool needsLayout = frameView && renderView() && (frameView->layoutPending() || renderView()->needsLayout());
1267     if (needsLayout)
1268         updateLayout();
1269
1270     if (Page* page = this->page()) {
1271         if (frame()->isMainFrame()) {
1272             frameView->addPaintPendingMilestones(DidFirstPaintAfterSuppressedIncrementalRendering);
1273             if (page->requestedLayoutMilestones() & DidFirstLayoutAfterSuppressedIncrementalRendering)
1274                 frame()->loader().didReachLayoutMilestone(DidFirstLayoutAfterSuppressedIncrementalRendering);
1275         }
1276     }
1277
1278     if (view())
1279         view()->updateCompositingLayersAfterLayout();
1280
1281     if (RenderView* renderView = this->renderView())
1282         renderView->repaintViewAndCompositedLayers();
1283
1284     if (Frame* frame = this->frame())
1285         frame->loader().forcePageTransitionIfNeeded();
1286 }
1287
1288 void Document::visualUpdatesSuppressionTimerFired()
1289 {
1290     ASSERT(!m_visualUpdatesAllowed);
1291
1292     // If the client is extending the visual update suppression period explicitly, the
1293     // watchdog should not re-enable visual updates itself, but should wait for the client.
1294     if (!view()->visualUpdatesAllowedByClient())
1295         return;
1296
1297     setVisualUpdatesAllowed(true);
1298 }
1299
1300 void Document::setVisualUpdatesAllowedByClient(bool visualUpdatesAllowedByClient)
1301 {
1302     // We should only re-enable visual updates if ReadyState is Completed or the watchdog timer has fired,
1303     // both of which we can determine by looking at the timer.
1304
1305     if (visualUpdatesAllowedByClient && !m_visualUpdatesSuppressionTimer.isActive() && !visualUpdatesAllowed())
1306         setVisualUpdatesAllowed(true);
1307 }
1308
1309 String Document::characterSetWithUTF8Fallback() const
1310 {
1311     AtomicString name = encoding();
1312     if (!name.isNull())
1313         return name;
1314     return UTF8Encoding().domName();
1315 }
1316
1317 String Document::defaultCharsetForLegacyBindings() const
1318 {
1319     if (!frame())
1320         UTF8Encoding().domName();
1321     return settings().defaultTextEncodingName();
1322 }
1323
1324 void Document::setCharset(const String& charset)
1325 {
1326     if (!decoder())
1327         return;
1328     decoder()->setEncoding(charset, TextResourceDecoder::UserChosenEncoding);
1329 }
1330
1331 void Document::setContentLanguage(const String& language)
1332 {
1333     if (m_contentLanguage == language)
1334         return;
1335     m_contentLanguage = language;
1336
1337     // Recalculate style so language is used when selecting the initial font.
1338     m_styleScope->didChangeStyleSheetEnvironment();
1339 }
1340
1341 ExceptionOr<void> Document::setXMLVersion(const String& version)
1342 {
1343     if (!XMLDocumentParser::supportsXMLVersion(version))
1344         return Exception { NOT_SUPPORTED_ERR };
1345
1346     m_xmlVersion = version;
1347     return { };
1348 }
1349
1350 void Document::setXMLStandalone(bool standalone)
1351 {
1352     m_xmlStandalone = standalone ? Standalone : NotStandalone;
1353 }
1354
1355 void Document::setDocumentURI(const String& uri)
1356 {
1357     // This property is read-only from JavaScript, but writable from Objective-C.
1358     m_documentURI = uri;
1359     updateBaseURL();
1360 }
1361
1362 void Document::setContent(const String& content)
1363 {
1364     open();
1365     // FIXME: This should probably use insert(), but that's (intentionally)
1366     // not implemented for the XML parser as it's normally synonymous with
1367     // document.write(). append() will end up yielding, but close() will
1368     // pump the tokenizer syncrhonously and finish the parse.
1369     m_parser->append(content.impl());
1370     close();
1371 }
1372
1373 String Document::suggestedMIMEType() const
1374 {
1375     if (isXHTMLDocument())
1376         return ASCIILiteral("application/xhtml+xml");
1377     if (isSVGDocument())
1378         return ASCIILiteral("image/svg+xml");
1379     if (xmlStandalone())
1380         return ASCIILiteral("text/xml");
1381     if (isHTMLDocument())
1382         return ASCIILiteral("text/html");
1383     if (DocumentLoader* loader = this->loader())
1384         return loader->responseMIMEType();
1385     return String();
1386 }
1387
1388 void Document::overrideMIMEType(const String& mimeType)
1389 {
1390     m_overriddenMIMEType = mimeType;
1391 }
1392
1393 String Document::contentType() const
1394 {
1395     if (!m_overriddenMIMEType.isNull())
1396         return m_overriddenMIMEType;
1397
1398     if (DocumentLoader* documentLoader = loader())
1399         return documentLoader->currentContentType();
1400
1401     String mimeType = suggestedMIMEType();
1402     if (!mimeType.isNull())
1403         return mimeType;
1404
1405     return ASCIILiteral("application/xml");
1406 }
1407
1408 RefPtr<Range> Document::caretRangeFromPoint(int x, int y)
1409 {
1410     return caretRangeFromPoint(LayoutPoint(x, y));
1411 }
1412
1413 RefPtr<Range> Document::caretRangeFromPoint(const LayoutPoint& clientPoint)
1414 {
1415     if (!hasLivingRenderTree())
1416         return nullptr;
1417
1418     LayoutPoint localPoint;
1419     Node* node = nodeFromPoint(clientPoint, &localPoint);
1420     if (!node)
1421         return nullptr;
1422
1423     RenderObject* renderer = node->renderer();
1424     if (!renderer)
1425         return nullptr;
1426     Position rangeCompliantPosition = renderer->positionForPoint(localPoint).parentAnchoredEquivalent();
1427     if (rangeCompliantPosition.isNull())
1428         return nullptr;
1429
1430     unsigned offset = rangeCompliantPosition.offsetInContainerNode();
1431     node = &retargetToScope(*rangeCompliantPosition.containerNode());
1432     if (node != rangeCompliantPosition.containerNode())
1433         offset = 0;
1434
1435     return Range::create(*this, node, offset, node, offset);
1436 }
1437
1438 Element* Document::scrollingElement()
1439 {
1440     // FIXME: When we fix https://bugs.webkit.org/show_bug.cgi?id=106133, this should be replaced with the full implementation
1441     // of Document.scrollingElement() as specified at http://dev.w3.org/csswg/cssom-view/#dom-document-scrollingelement.
1442
1443     return body();
1444 }
1445
1446 template<typename CharacterType> static inline String canonicalizedTitle(Document& document, const String& title)
1447 {
1448     // FIXME: Compiling a separate copy of this for LChar and UChar is likely unnecessary.
1449     // FIXME: Missing an optimized case for when title is fine as-is. This unnecessarily allocates
1450     // and keeps around a new copy, and it's even the less optimal type of StringImpl with a separate buffer.
1451     // Could probably just use StringBuilder instead.
1452
1453     auto* characters = title.characters<CharacterType>();
1454     unsigned length = title.length();
1455
1456     StringBuffer<CharacterType> buffer { length };
1457     unsigned bufferLength = 0;
1458
1459     auto* decoder = document.decoder();
1460     auto backslashAsCurrencySymbol = decoder ? decoder->encoding().backslashAsCurrencySymbol() : '\\';
1461
1462     // Collapse runs of HTML spaces into single space characters.
1463     // Strip leading and trailing spaces.
1464     // Replace backslashes with currency symbols.
1465     bool previousCharacterWasHTMLSpace = false;
1466     for (unsigned i = 0; i < length; ++i) {
1467         auto character = characters[i];
1468         if (isHTMLSpace(character))
1469             previousCharacterWasHTMLSpace = true;
1470         else {
1471             if (character == '\\')
1472                 character = backslashAsCurrencySymbol;
1473             if (previousCharacterWasHTMLSpace && bufferLength)
1474                 buffer[bufferLength++] = ' ';
1475             buffer[bufferLength++] = character;
1476             previousCharacterWasHTMLSpace = false;
1477         }
1478     }
1479     if (!bufferLength)
1480         return { };
1481
1482     buffer.shrink(bufferLength);
1483     return String::adopt(WTFMove(buffer));
1484 }
1485
1486 void Document::updateTitle(const StringWithDirection& title)
1487 {
1488     if (m_rawTitle == title)
1489         return;
1490
1491     m_rawTitle = title;
1492     m_title = title;
1493
1494     if (!m_title.string.isEmpty()) {
1495         if (m_title.string.is8Bit())
1496             m_title.string = canonicalizedTitle<LChar>(*this, m_title.string);
1497         else
1498             m_title.string = canonicalizedTitle<UChar>(*this, m_title.string);
1499     }
1500
1501     if (auto* loader = this->loader())
1502         loader->setTitle(m_title);
1503 }
1504
1505 void Document::updateTitleFromTitleElement()
1506 {
1507     if (!m_titleElement) {
1508         updateTitle({ });
1509         return;
1510     }
1511
1512     if (is<HTMLTitleElement>(*m_titleElement))
1513         updateTitle(downcast<HTMLTitleElement>(*m_titleElement).textWithDirection());
1514     else if (is<SVGTitleElement>(*m_titleElement)) {
1515         // FIXME: Does the SVG title element have a text direction?
1516         updateTitle({ downcast<SVGTitleElement>(*m_titleElement).textContent(), LTR });
1517     }
1518 }
1519
1520 void Document::setTitle(const String& title)
1521 {
1522     if (!m_titleElement) {
1523         if (isHTMLDocument() || isXHTMLDocument()) {
1524             auto* headElement = head();
1525             if (!headElement)
1526                 return;
1527             m_titleElement = HTMLTitleElement::create(HTMLNames::titleTag, *this);
1528             headElement->appendChild(*m_titleElement);
1529         } else if (isSVGDocument()) {
1530             auto* element = documentElement();
1531             if (!is<SVGSVGElement>(element))
1532                 return;
1533             m_titleElement = SVGTitleElement::create(SVGNames::titleTag, *this);
1534             element->insertBefore(*m_titleElement, element->firstChild());
1535         }
1536     } else if (!isHTMLDocument() && !isXHTMLDocument() && !isSVGDocument()) {
1537         // FIXME: What exactly is the point of this? This seems like a strange moment
1538         // in time to demote something from being m_titleElement, when setting the
1539         // value of the title attribute. Do we have test coverage for this?
1540         m_titleElement = nullptr;
1541     }
1542
1543     if (is<HTMLTitleElement>(m_titleElement.get()))
1544         downcast<HTMLTitleElement>(*m_titleElement).setTextContent(title);
1545     else if (is<SVGTitleElement>(m_titleElement.get()))
1546         downcast<SVGTitleElement>(*m_titleElement).setTextContent(title);
1547     else
1548         updateTitle({ title, LTR });
1549 }
1550
1551 void Document::updateTitleElement(Element* newTitleElement)
1552 {
1553     if (is<SVGSVGElement>(documentElement()))
1554         m_titleElement = childrenOfType<SVGTitleElement>(*documentElement()).first();
1555     else {
1556         if (m_titleElement) {
1557             if (isHTMLDocument() || isXHTMLDocument())
1558                 m_titleElement = descendantsOfType<HTMLTitleElement>(*this).first();
1559         } else
1560             m_titleElement = newTitleElement;
1561     }
1562
1563     updateTitleFromTitleElement();
1564 }
1565
1566 void Document::titleElementAdded(Element& titleElement)
1567 {
1568     if (m_titleElement == &titleElement)
1569         return;
1570
1571     updateTitleElement(&titleElement);
1572 }
1573
1574 void Document::titleElementRemoved(Element& titleElement)
1575 {
1576     if (m_titleElement != &titleElement)
1577         return;
1578
1579     updateTitleElement(nullptr);
1580 }
1581
1582 void Document::titleElementTextChanged(Element& titleElement)
1583 {
1584     if (m_titleElement != &titleElement)
1585         return;
1586
1587     updateTitleFromTitleElement();
1588 }
1589
1590 void Document::registerForVisibilityStateChangedCallbacks(Element* element)
1591 {
1592     m_visibilityStateCallbackElements.add(element);
1593 }
1594
1595 void Document::unregisterForVisibilityStateChangedCallbacks(Element* element)
1596 {
1597     m_visibilityStateCallbackElements.remove(element);
1598 }
1599
1600 void Document::visibilityStateChanged()
1601 {
1602     dispatchEvent(Event::create(eventNames().visibilitychangeEvent, false, false));
1603     for (auto* element : m_visibilityStateCallbackElements)
1604         element->visibilityStateChanged();
1605 }
1606
1607 auto Document::visibilityState() const -> VisibilityState
1608 {
1609     // The visibility of the document is inherited from the visibility of the
1610     // page. If there is no page associated with the document, we will assume
1611     // that the page is hidden, as specified by the spec:
1612     // http://dvcs.w3.org/hg/webperf/raw-file/tip/specs/PageVisibility/Overview.html#dom-document-hidden
1613     if (!m_frame || !m_frame->page())
1614         return VisibilityState::Hidden;
1615     return m_frame->page()->visibilityState();
1616 }
1617
1618 bool Document::hidden() const
1619 {
1620     return visibilityState() != VisibilityState::Visible;
1621 }
1622
1623 #if ENABLE(VIDEO)
1624
1625 void Document::registerForAllowsMediaDocumentInlinePlaybackChangedCallbacks(HTMLMediaElement& element)
1626 {
1627     m_allowsMediaDocumentInlinePlaybackElements.add(&element);
1628 }
1629
1630 void Document::unregisterForAllowsMediaDocumentInlinePlaybackChangedCallbacks(HTMLMediaElement& element)
1631 {
1632     m_allowsMediaDocumentInlinePlaybackElements.remove(&element);
1633 }
1634
1635 void Document::allowsMediaDocumentInlinePlaybackChanged()
1636 {
1637     for (auto* element : m_allowsMediaDocumentInlinePlaybackElements)
1638         element->allowsMediaDocumentInlinePlaybackChanged();
1639 }
1640
1641 #endif
1642
1643 String Document::nodeName() const
1644 {
1645     return ASCIILiteral("#document");
1646 }
1647
1648 Node::NodeType Document::nodeType() const
1649 {
1650     return DOCUMENT_NODE;
1651 }
1652
1653 FormController& Document::formController()
1654 {
1655     if (!m_formController)
1656         m_formController = std::make_unique<FormController>();
1657     return *m_formController;
1658 }
1659
1660 Vector<String> Document::formElementsState() const
1661 {
1662     if (!m_formController)
1663         return Vector<String>();
1664     return m_formController->formElementsState();
1665 }
1666
1667 void Document::setStateForNewFormElements(const Vector<String>& stateVector)
1668 {
1669     if (!stateVector.size() && !m_formController)
1670         return;
1671     formController().setStateForNewFormElements(stateVector);
1672 }
1673
1674 FrameView* Document::view() const
1675 {
1676     return m_frame ? m_frame->view() : nullptr;
1677 }
1678
1679 Page* Document::page() const
1680 {
1681     return m_frame ? m_frame->page() : nullptr;
1682 }
1683
1684 Ref<Range> Document::createRange()
1685 {
1686     return Range::create(*this);
1687 }
1688
1689 Ref<NodeIterator> Document::createNodeIterator(Node& root, unsigned long whatToShow, RefPtr<NodeFilter>&& filter, bool)
1690 {
1691     return NodeIterator::create(root, whatToShow, WTFMove(filter));
1692 }
1693
1694 Ref<TreeWalker> Document::createTreeWalker(Node& root, unsigned long whatToShow, RefPtr<NodeFilter>&& filter, bool)
1695 {
1696     return TreeWalker::create(root, whatToShow, WTFMove(filter));
1697 }
1698
1699 void Document::scheduleForcedStyleRecalc()
1700 {
1701     m_pendingStyleRecalcShouldForce = true;
1702     scheduleStyleRecalc();
1703 }
1704
1705 void Document::scheduleStyleRecalc()
1706 {
1707     ASSERT(!m_renderView || !m_renderView->inHitTesting());
1708
1709     if (m_styleRecalcTimer.isActive() || pageCacheState() != NotInPageCache)
1710         return;
1711
1712     ASSERT(childNeedsStyleRecalc() || m_pendingStyleRecalcShouldForce);
1713
1714     // FIXME: Why on earth is this here? This is clearly misplaced.
1715     invalidateAccessKeyMap();
1716     
1717     m_styleRecalcTimer.startOneShot(0);
1718
1719     InspectorInstrumentation::didScheduleStyleRecalculation(*this);
1720 }
1721
1722 void Document::unscheduleStyleRecalc()
1723 {
1724     ASSERT(!childNeedsStyleRecalc());
1725
1726     m_styleRecalcTimer.stop();
1727     m_pendingStyleRecalcShouldForce = false;
1728 }
1729
1730 bool Document::hasPendingStyleRecalc() const
1731 {
1732     return m_styleRecalcTimer.isActive() && !m_inStyleRecalc;
1733 }
1734
1735 bool Document::hasPendingForcedStyleRecalc() const
1736 {
1737     return m_styleRecalcTimer.isActive() && m_pendingStyleRecalcShouldForce;
1738 }
1739
1740 void Document::recalcStyle(Style::Change change)
1741 {
1742     ASSERT(!view() || !view()->isPainting());
1743
1744     // NOTE: XSL code seems to be the only client stumbling in here without a RenderView.
1745     if (!m_renderView)
1746         return;
1747
1748     FrameView& frameView = m_renderView->frameView();
1749     Ref<FrameView> protect(frameView);
1750     if (frameView.isPainting())
1751         return;
1752     
1753     if (m_inStyleRecalc)
1754         return; // Guard against re-entrancy. -dwh
1755
1756     TraceScope tracingScope(StyleRecalcStart, StyleRecalcEnd);
1757
1758     RenderView::RepaintRegionAccumulator repaintRegionAccumulator(renderView());
1759     AnimationUpdateBlock animationUpdateBlock(&m_frame->animation());
1760
1761     // FIXME: We should update style on our ancestor chain before proceeding (especially for seamless),
1762     // however doing so currently causes several tests to crash, as Frame::setDocument calls Document::attach
1763     // before setting the DOMWindow on the Frame, or the SecurityOrigin on the document. The attach, in turn
1764     // resolves style (here) and then when we resolve style on the parent chain, we may end up
1765     // re-attaching our containing iframe, which when asked HTMLFrameElementBase::isURLAllowed
1766     // hits a null-dereference due to security code always assuming the document has a SecurityOrigin.
1767
1768     styleScope().flushPendingUpdate();
1769
1770     frameView.willRecalcStyle();
1771
1772     InspectorInstrumentationCookie cookie = InspectorInstrumentation::willRecalculateStyle(*this);
1773
1774     m_inStyleRecalc = true;
1775     bool updatedCompositingLayers = false;
1776     {
1777         Style::PostResolutionCallbackDisabler disabler(*this);
1778         WidgetHierarchyUpdatesSuspensionScope suspendWidgetHierarchyUpdates;
1779
1780         if (m_pendingStyleRecalcShouldForce)
1781             change = Style::Force;
1782
1783         if (change == Style::Force) {
1784             // This may get set again during style resolve.
1785             m_hasNodesWithPlaceholderStyle = false;
1786
1787             auto documentStyle = Style::resolveForDocument(*this);
1788
1789             // Inserting the pictograph font at the end of the font fallback list is done by the
1790             // font selector, so set a font selector if needed.
1791             if (settings().fontFallbackPrefersPictographs())
1792                 documentStyle.fontCascade().update(&fontSelector());
1793
1794             auto documentChange = Style::determineChange(documentStyle, m_renderView->style());
1795             if (documentChange != Style::NoChange)
1796                 renderView()->setStyle(WTFMove(documentStyle));
1797         }
1798
1799         Style::TreeResolver resolver(*this);
1800         auto styleUpdate = resolver.resolve(change);
1801
1802         m_lastStyleUpdateSizeForTesting = styleUpdate ? styleUpdate->size() : 0;
1803
1804         setHasValidStyle();
1805         clearChildNeedsStyleRecalc();
1806         unscheduleStyleRecalc();
1807
1808         m_inStyleRecalc = false;
1809
1810         if (styleUpdate) {
1811             SetForScope<bool> inRenderTreeUpdate(m_inRenderTreeUpdate, true);
1812
1813             RenderTreeUpdater updater(*this);
1814             updater.commit(WTFMove(styleUpdate));
1815         }
1816
1817         updatedCompositingLayers = frameView.updateCompositingLayersAfterStyleChange();
1818     }
1819
1820     // If we wanted to call implicitClose() during recalcStyle, do so now that we're finished.
1821     if (m_closeAfterStyleRecalc) {
1822         m_closeAfterStyleRecalc = false;
1823         implicitClose();
1824     }
1825     
1826     ++m_styleRecalcCount;
1827
1828     InspectorInstrumentation::didRecalculateStyle(cookie);
1829
1830     // Some animated images may now be inside the viewport due to style recalc,
1831     // resume them if necessary if there is no layout pending. Otherwise, we'll
1832     // check if they need to be resumed after layout.
1833     if (updatedCompositingLayers && !frameView.needsLayout())
1834         frameView.viewportContentsChanged();
1835
1836     if (!frameView.needsLayout())
1837         frameView.frame().selection().updateAppearanceAfterLayout();
1838
1839     // As a result of the style recalculation, the currently hovered element might have been
1840     // detached (for example, by setting display:none in the :hover style), schedule another mouseMove event
1841     // to check if any other elements ended up under the mouse pointer due to re-layout.
1842     if (m_hoveredElement && !m_hoveredElement->renderer())
1843         frameView.frame().mainFrame().eventHandler().dispatchFakeMouseMoveEventSoon();
1844
1845     if (m_gotoAnchorNeededAfterStylesheetsLoad && !styleScope().hasPendingSheets())
1846         frameView.scrollToFragment(m_url);
1847 }
1848
1849 bool Document::needsStyleRecalc() const
1850 {
1851     if (pageCacheState() != NotInPageCache)
1852         return false;
1853
1854     return m_pendingStyleRecalcShouldForce || childNeedsStyleRecalc() || styleScope().hasPendingUpdate();
1855 }
1856
1857 void Document::updateStyleIfNeeded()
1858 {
1859     ASSERT(isMainThread());
1860     ASSERT(!view() || !view()->isPainting());
1861
1862     if (!view() || view()->isInRenderTreeLayout())
1863         return;
1864
1865     styleScope().flushPendingUpdate();
1866
1867     if (!needsStyleRecalc())
1868         return;
1869
1870     recalcStyle();
1871 }
1872
1873 void Document::updateLayout()
1874 {
1875     ASSERT(isMainThread());
1876
1877     FrameView* frameView = view();
1878     if (frameView && frameView->isInRenderTreeLayout()) {
1879         // View layout should not be re-entrant.
1880         ASSERT_NOT_REACHED();
1881         return;
1882     }
1883
1884     RenderView::RepaintRegionAccumulator repaintRegionAccumulator(renderView());
1885
1886     if (HTMLFrameOwnerElement* owner = ownerElement())
1887         owner->document().updateLayout();
1888
1889     updateStyleIfNeeded();
1890
1891     StackStats::LayoutCheckPoint layoutCheckPoint;
1892
1893     // Only do a layout if changes have occurred that make it necessary.      
1894     if (frameView && renderView() && (frameView->layoutPending() || renderView()->needsLayout()))
1895         frameView->layout();
1896 }
1897
1898 // FIXME: This is a bad idea and needs to be removed eventually.
1899 // Other browsers load stylesheets before they continue parsing the web page.
1900 // Since we don't, we can run JavaScript code that needs answers before the
1901 // stylesheets are loaded. Doing a layout ignoring the pending stylesheets
1902 // lets us get reasonable answers. The long term solution to this problem is
1903 // to instead suspend JavaScript execution.
1904 void Document::updateLayoutIgnorePendingStylesheets(Document::RunPostLayoutTasks runPostLayoutTasks)
1905 {
1906     bool oldIgnore = m_ignorePendingStylesheets;
1907
1908     if (!haveStylesheetsLoaded()) {
1909         m_ignorePendingStylesheets = true;
1910         // FIXME: We are willing to attempt to suppress painting with outdated style info only once.  Our assumption is that it would be
1911         // dangerous to try to stop it a second time, after page content has already been loaded and displayed
1912         // with accurate style information.  (Our suppression involves blanking the whole page at the
1913         // moment.  If it were more refined, we might be able to do something better.)
1914         // It's worth noting though that this entire method is a hack, since what we really want to do is
1915         // suspend JS instead of doing a layout with inaccurate information.
1916         HTMLElement* bodyElement = bodyOrFrameset();
1917         if (bodyElement && !bodyElement->renderer() && m_pendingSheetLayout == NoLayoutWithPendingSheets) {
1918             m_pendingSheetLayout = DidLayoutWithPendingSheets;
1919             styleScope().didChangeActiveStyleSheetCandidates();
1920             recalcStyle(Style::Force);
1921         } else if (m_hasNodesWithPlaceholderStyle)
1922             // If new nodes have been added or style recalc has been done with style sheets still pending, some nodes 
1923             // may not have had their real style calculated yet. Normally this gets cleaned when style sheets arrive 
1924             // but here we need up-to-date style immediately.
1925             recalcStyle(Style::Force);
1926     }
1927
1928     updateLayout();
1929
1930     if (runPostLayoutTasks == RunPostLayoutTasks::Synchronously && view())
1931         view()->flushAnyPendingPostLayoutTasks();
1932
1933     m_ignorePendingStylesheets = oldIgnore;
1934 }
1935
1936 std::unique_ptr<RenderStyle> Document::styleForElementIgnoringPendingStylesheets(Element& element, const RenderStyle* parentStyle)
1937 {
1938     ASSERT(&element.document() == this);
1939
1940     // On iOS request delegates called during styleForElement may result in re-entering WebKit and killing the style resolver.
1941     Style::PostResolutionCallbackDisabler disabler(*this);
1942
1943     SetForScope<bool> change(m_ignorePendingStylesheets, true);
1944     auto elementStyle = element.resolveStyle(parentStyle);
1945
1946     if (elementStyle.relations) {
1947         Style::Update emptyUpdate(*this);
1948         Style::commitRelations(WTFMove(elementStyle.relations), emptyUpdate);
1949     }
1950
1951     return WTFMove(elementStyle.renderStyle);
1952 }
1953
1954 bool Document::updateLayoutIfDimensionsOutOfDate(Element& element, DimensionsCheck dimensionsCheck)
1955 {
1956     ASSERT(isMainThread());
1957     
1958     // If the stylesheets haven't loaded, just give up and do a full layout ignoring pending stylesheets.
1959     if (!haveStylesheetsLoaded()) {
1960         updateLayoutIgnorePendingStylesheets();
1961         return true;
1962     }
1963     
1964     // Check for re-entrancy and assert (same code that is in updateLayout()).
1965     FrameView* frameView = view();
1966     if (frameView && frameView->isInRenderTreeLayout()) {
1967         // View layout should not be re-entrant.
1968         ASSERT_NOT_REACHED();
1969         return true;
1970     }
1971     
1972     RenderView::RepaintRegionAccumulator repaintRegionAccumulator(renderView());
1973     
1974     // Mimic the structure of updateLayout(), but at each step, see if we have been forced into doing a full
1975     // layout.
1976     bool requireFullLayout = false;
1977     if (HTMLFrameOwnerElement* owner = ownerElement()) {
1978         if (owner->document().updateLayoutIfDimensionsOutOfDate(*owner))
1979             requireFullLayout = true;
1980     }
1981     
1982     updateStyleIfNeeded();
1983
1984     RenderObject* renderer = element.renderer();
1985     if (!renderer || renderer->needsLayout() || element.renderNamedFlowFragment()) {
1986         // If we don't have a renderer or if the renderer needs layout for any reason, give up.
1987         // Named flows can have auto height, so don't try to enforce the optimization in this case.
1988         // The 2-pass nature of auto height named flow layout means the region may not be dirty yet.
1989         requireFullLayout = true;
1990     }
1991
1992     bool isVertical = renderer && !renderer->isHorizontalWritingMode();
1993     bool checkingLogicalWidth = ((dimensionsCheck & WidthDimensionsCheck) && !isVertical) || ((dimensionsCheck & HeightDimensionsCheck) && isVertical);
1994     bool checkingLogicalHeight = ((dimensionsCheck & HeightDimensionsCheck) && !isVertical) || ((dimensionsCheck & WidthDimensionsCheck) && isVertical);
1995     bool hasSpecifiedLogicalHeight = renderer && renderer->style().logicalMinHeight() == Length(0, Fixed) && renderer->style().logicalHeight().isFixed() && renderer->style().logicalMaxHeight().isAuto();
1996     
1997     if (!requireFullLayout) {
1998         RenderBox* previousBox = nullptr;
1999         RenderBox* currentBox = nullptr;
2000         
2001         // Check our containing block chain. If anything in the chain needs a layout, then require a full layout.
2002         for (RenderObject* currRenderer = element.renderer(); currRenderer && !currRenderer->isRenderView(); currRenderer = currRenderer->container()) {
2003             
2004             // Require the entire container chain to be boxes.
2005             if (!is<RenderBox>(currRenderer)) {
2006                 requireFullLayout = true;
2007                 break;
2008             }
2009             
2010             previousBox = currentBox;
2011             currentBox = downcast<RenderBox>(currRenderer);
2012             
2013             // If a box needs layout for itself or if a box has changed children and sizes its width to
2014             // its content, then require a full layout.
2015             if (currentBox->selfNeedsLayout() ||
2016                 (checkingLogicalWidth && currRenderer->needsLayout() && currentBox->sizesLogicalWidthToFitContent(MainOrPreferredSize))) {
2017                 requireFullLayout = true;
2018                 break;
2019             }
2020             
2021             // If a block contains floats and the child's height isn't specified, then
2022             // give up also, since our height could end up being influenced by the floats.
2023             if (checkingLogicalHeight && !hasSpecifiedLogicalHeight && currentBox->isRenderBlockFlow()) {
2024                 RenderBlockFlow* currentBlockFlow = downcast<RenderBlockFlow>(currentBox);
2025                 if (currentBlockFlow->containsFloats() && previousBox && !previousBox->isFloatingOrOutOfFlowPositioned()) {
2026                     requireFullLayout = true;
2027                     break;
2028                 }
2029             }
2030             
2031             if (!currentBox->isRenderBlockFlow() || currentBox->flowThreadContainingBlock() || currentBox->isWritingModeRoot()) {
2032                 // FIXME: For now require only block flows all the way back to the root. This limits the optimization
2033                 // for now, and we'll expand it in future patches to apply to more and more scenarios.
2034                 // Disallow regions/columns from having the optimization.
2035                 // Give up if the writing mode changes at all in the containing block chain.
2036                 requireFullLayout = true;
2037                 break;
2038             }
2039             
2040             if (currRenderer == frameView->layoutRoot())
2041                 break;
2042         }
2043     }
2044     
2045     StackStats::LayoutCheckPoint layoutCheckPoint;
2046
2047     // Only do a layout if changes have occurred that make it necessary.      
2048     if (requireFullLayout && frameView && renderView() && (frameView->layoutPending() || renderView()->needsLayout()))
2049         frameView->layout();
2050     
2051     return requireFullLayout;
2052 }
2053
2054 bool Document::isPageBoxVisible(int pageIndex)
2055 {
2056     updateStyleIfNeeded();
2057     std::unique_ptr<RenderStyle> pageStyle(styleScope().resolver().styleForPage(pageIndex));
2058     return pageStyle->visibility() != HIDDEN; // display property doesn't apply to @page.
2059 }
2060
2061 void Document::pageSizeAndMarginsInPixels(int pageIndex, IntSize& pageSize, int& marginTop, int& marginRight, int& marginBottom, int& marginLeft)
2062 {
2063     updateStyleIfNeeded();
2064     auto style = styleScope().resolver().styleForPage(pageIndex);
2065
2066     int width = pageSize.width();
2067     int height = pageSize.height();
2068     switch (style->pageSizeType()) {
2069     case PAGE_SIZE_AUTO:
2070         break;
2071     case PAGE_SIZE_AUTO_LANDSCAPE:
2072         if (width < height)
2073             std::swap(width, height);
2074         break;
2075     case PAGE_SIZE_AUTO_PORTRAIT:
2076         if (width > height)
2077             std::swap(width, height);
2078         break;
2079     case PAGE_SIZE_RESOLVED: {
2080         auto& size = style->pageSize();
2081         ASSERT(size.width.isFixed());
2082         ASSERT(size.height.isFixed());
2083         width = valueForLength(size.width, 0);
2084         height = valueForLength(size.height, 0);
2085         break;
2086     }
2087     default:
2088         ASSERT_NOT_REACHED();
2089     }
2090     pageSize = IntSize(width, height);
2091
2092     // The percentage is calculated with respect to the width even for margin top and bottom.
2093     // http://www.w3.org/TR/CSS2/box.html#margin-properties
2094     marginTop = style->marginTop().isAuto() ? marginTop : intValueForLength(style->marginTop(), width);
2095     marginRight = style->marginRight().isAuto() ? marginRight : intValueForLength(style->marginRight(), width);
2096     marginBottom = style->marginBottom().isAuto() ? marginBottom : intValueForLength(style->marginBottom(), width);
2097     marginLeft = style->marginLeft().isAuto() ? marginLeft : intValueForLength(style->marginLeft(), width);
2098 }
2099
2100 StyleResolver& Document::userAgentShadowTreeStyleResolver()
2101 {
2102     if (!m_userAgentShadowTreeStyleResolver)
2103         m_userAgentShadowTreeStyleResolver = std::make_unique<StyleResolver>(*this);
2104     return *m_userAgentShadowTreeStyleResolver;
2105 }
2106
2107 void Document::fontsNeedUpdate(FontSelector&)
2108 {
2109     if (auto* resolver = styleScope().resolverIfExists())
2110         resolver->invalidateMatchedPropertiesCache();
2111     if (pageCacheState() != NotInPageCache || !renderView())
2112         return;
2113     scheduleForcedStyleRecalc();
2114 }
2115
2116 void Document::didClearStyleResolver()
2117 {
2118     m_userAgentShadowTreeStyleResolver = nullptr;
2119
2120     m_fontSelector->buildStarted();
2121 }
2122
2123 void Document::createRenderTree()
2124 {
2125     ASSERT(!renderView());
2126     ASSERT(m_pageCacheState != InPageCache);
2127     ASSERT(!m_axObjectCache || this != &topDocument());
2128
2129     if (m_isNonRenderedPlaceholder)
2130         return;
2131
2132     // FIXME: It would be better if we could pass the resolved document style directly here.
2133     m_renderView = createRenderer<RenderView>(*this, RenderStyle::create());
2134     Node::setRenderer(m_renderView.get());
2135
2136     renderView()->setIsInWindow(true);
2137
2138     recalcStyle(Style::Force);
2139 }
2140
2141 void Document::didBecomeCurrentDocumentInFrame()
2142 {
2143     // FIXME: Are there cases where the document can be dislodged from the frame during the event handling below?
2144     // If so, then m_frame could become 0, and we need to do something about that.
2145
2146     m_frame->script().updateDocument();
2147
2148     if (!hasLivingRenderTree())
2149         createRenderTree();
2150
2151     updateViewportArguments();
2152
2153     // FIXME: Doing this only for the main frame is insufficient.
2154     // Changing a subframe can also change the wheel event handler count.
2155     // FIXME: Doing this only when a document goes into the frame is insufficient.
2156     // Removing a document can also change the wheel event handler count.
2157     // FIXME: Doing this every time is a waste. If the current document and its
2158     // subframes' documents have no wheel event handlers, then the count did not change,
2159     // unless the documents they are replacing had wheel event handlers.
2160     if (page() && m_frame->isMainFrame())
2161         wheelEventHandlersChanged();
2162
2163     // Ensure that the scheduled task state of the document matches the DOM suspension state of the frame. It can
2164     // be out of sync if the DOM suspension state changed while the document was not in the frame (possibly in the
2165     // page cache, or simply newly created).
2166     if (m_frame->activeDOMObjectsAndAnimationsSuspended()) {
2167         m_frame->animation().suspendAnimationsForDocument(this);
2168         suspendScheduledTasks(ActiveDOMObject::PageWillBeSuspended);
2169     } else {
2170         resumeScheduledTasks(ActiveDOMObject::PageWillBeSuspended);
2171         m_frame->animation().resumeAnimationsForDocument(this);
2172     }
2173 }
2174
2175 void Document::frameDestroyed()
2176 {
2177     // detachFromFrame() must be called before destroying the Frame.
2178     ASSERT_WITH_SECURITY_IMPLICATION(!m_frame);
2179     FrameDestructionObserver::frameDestroyed();
2180 }
2181
2182 void Document::didBecomeCurrentDocumentInView()
2183 {
2184     ASSERT(view());
2185     if (!hasLivingRenderTree())
2186         createRenderTree();
2187 }
2188
2189 void Document::attachToCachedFrame(CachedFrameBase& cachedFrame)
2190 {
2191     ASSERT_WITH_SECURITY_IMPLICATION(cachedFrame.document() == this);
2192     ASSERT(cachedFrame.view());
2193     ASSERT(m_pageCacheState == Document::InPageCache);
2194     observeFrame(&cachedFrame.view()->frame());
2195 }
2196
2197 void Document::detachFromCachedFrame(CachedFrameBase& cachedFrame)
2198 {
2199     ASSERT_UNUSED(cachedFrame, cachedFrame.view());
2200     ASSERT_WITH_SECURITY_IMPLICATION(cachedFrame.document() == this);
2201     ASSERT(m_frame == &cachedFrame.view()->frame());
2202     ASSERT(m_pageCacheState == Document::InPageCache);
2203     detachFromFrame();
2204 }
2205
2206 void Document::destroyRenderTree()
2207 {
2208     ASSERT(hasLivingRenderTree());
2209     ASSERT(frame());
2210     ASSERT(page());
2211
2212     FrameView* frameView = frame()->document() == this ? frame()->view() : nullptr;
2213
2214     // Prevent Widget tree changes from committing until the RenderView is dead and gone.
2215     WidgetHierarchyUpdatesSuspensionScope suspendWidgetHierarchyUpdates;
2216
2217     SetForScope<bool> change(m_renderTreeBeingDestroyed, true);
2218
2219     if (this == &topDocument())
2220         clearAXObjectCache();
2221
2222     documentWillBecomeInactive();
2223
2224     if (frameView)
2225         frameView->willDestroyRenderTree();
2226
2227 #if ENABLE(FULLSCREEN_API)
2228     if (m_fullScreenRenderer)
2229         setFullScreenRenderer(nullptr);
2230 #endif
2231
2232     m_hoveredElement = nullptr;
2233     m_focusedElement = nullptr;
2234     m_activeElement = nullptr;
2235     m_focusNavigationStartingNode = nullptr;
2236
2237     if (m_documentElement)
2238         RenderTreeUpdater::tearDownRenderers(*m_documentElement);
2239
2240     clearChildNeedsStyleRecalc();
2241
2242     unscheduleStyleRecalc();
2243
2244     m_renderView = nullptr;
2245     Node::setRenderer(nullptr);
2246
2247 #if ENABLE(TEXT_AUTOSIZING)
2248     // Do this before the arena is cleared, which is needed to deref the RenderStyle on TextAutoSizingKey.
2249     m_textAutoSizedNodes.clear();
2250 #endif
2251
2252     if (frameView)
2253         frameView->didDestroyRenderTree();
2254 }
2255
2256 void Document::prepareForDestruction()
2257 {
2258     if (m_hasPreparedForDestruction)
2259         return;
2260
2261     if (m_frame)
2262         m_frame->animation().detachFromDocument(this);
2263
2264 #if ENABLE(IOS_TOUCH_EVENTS)
2265     clearTouchEventHandlersAndListeners();
2266 #endif
2267
2268 #if HAVE(ACCESSIBILITY)
2269     // Sub-frames need to cleanup Nodes in the text marker cache when the Document disappears.
2270     if (this != &topDocument()) {
2271         if (AXObjectCache* cache = existingAXObjectCache())
2272             cache->clearTextMarkerNodesInUse(this);
2273     }
2274 #endif
2275     
2276     disconnectDescendantFrames();
2277     if (m_domWindow && m_frame)
2278         m_domWindow->willDetachDocumentFromFrame();
2279
2280     if (hasLivingRenderTree())
2281         destroyRenderTree();
2282
2283     if (is<PluginDocument>(*this))
2284         downcast<PluginDocument>(*this).detachFromPluginElement();
2285
2286 #if ENABLE(POINTER_LOCK)
2287     if (page())
2288         page()->pointerLockController().documentDetached(*this);
2289 #endif
2290
2291     if (auto* page = this->page()) {
2292         if (auto* validationMessageClient = page->validationMessageClient())
2293             validationMessageClient->documentDetached(*this);
2294     }
2295
2296     InspectorInstrumentation::documentDetached(*this);
2297
2298     stopActiveDOMObjects();
2299     m_eventQueue.close();
2300 #if ENABLE(FULLSCREEN_API)
2301     m_fullScreenChangeEventTargetQueue.clear();
2302     m_fullScreenErrorEventTargetQueue.clear();
2303 #endif
2304
2305     commonTeardown();
2306
2307 #if ENABLE(TOUCH_EVENTS)
2308     if (m_touchEventTargets && m_touchEventTargets->size() && parentDocument())
2309         parentDocument()->didRemoveEventTargetNode(*this);
2310 #endif
2311
2312     if (m_wheelEventTargets && m_wheelEventTargets->size() && parentDocument())
2313         parentDocument()->didRemoveEventTargetNode(*this);
2314
2315     if (m_mediaQueryMatcher)
2316         m_mediaQueryMatcher->documentDestroyed();
2317
2318 #if ENABLE(WIRELESS_PLAYBACK_TARGET)
2319     if (!m_clientToIDMap.isEmpty() && page()) {
2320         Vector<WebCore::MediaPlaybackTargetClient*> clients;
2321         copyKeysToVector(m_clientToIDMap, clients);
2322         for (auto* client : clients)
2323             removePlaybackTargetPickerClient(*client);
2324     }
2325 #endif
2326
2327     detachFromFrame();
2328
2329     m_hasPreparedForDestruction = true;
2330 }
2331
2332 void Document::removeAllEventListeners()
2333 {
2334     EventTarget::removeAllEventListeners();
2335
2336     if (m_domWindow)
2337         m_domWindow->removeAllEventListeners();
2338 #if ENABLE(IOS_TOUCH_EVENTS)
2339     clearTouchEventHandlersAndListeners();
2340 #endif
2341     for (Node* node = firstChild(); node; node = NodeTraversal::next(*node))
2342         node->removeAllEventListeners();
2343
2344 #if ENABLE(TOUCH_EVENTS)
2345     m_touchEventTargets = nullptr;
2346 #endif
2347     m_wheelEventTargets = nullptr;
2348 }
2349
2350 void Document::suspendDeviceMotionAndOrientationUpdates()
2351 {
2352     if (m_areDeviceMotionAndOrientationUpdatesSuspended)
2353         return;
2354     m_areDeviceMotionAndOrientationUpdatesSuspended = true;
2355 #if ENABLE(DEVICE_ORIENTATION) && PLATFORM(IOS)
2356     if (m_deviceMotionController)
2357         m_deviceMotionController->suspendUpdates();
2358     if (m_deviceOrientationController)
2359         m_deviceOrientationController->suspendUpdates();
2360 #endif
2361 }
2362
2363 void Document::resumeDeviceMotionAndOrientationUpdates()
2364 {
2365     if (!m_areDeviceMotionAndOrientationUpdatesSuspended)
2366         return;
2367     m_areDeviceMotionAndOrientationUpdatesSuspended = false;
2368 #if ENABLE(DEVICE_ORIENTATION) && PLATFORM(IOS)
2369     if (m_deviceMotionController)
2370         m_deviceMotionController->resumeUpdates();
2371     if (m_deviceOrientationController)
2372         m_deviceOrientationController->resumeUpdates();
2373 #endif
2374 }
2375
2376 bool Document::shouldBypassMainWorldContentSecurityPolicy() const
2377 {
2378     JSC::CallFrame* callFrame = commonVM().topCallFrame;
2379     if (callFrame == JSC::CallFrame::noCaller())
2380         return false;
2381     DOMWrapperWorld& domWrapperWorld = currentWorld(callFrame);
2382     if (domWrapperWorld.isNormal())
2383         return false;
2384     return true;
2385 }
2386
2387 void Document::platformSuspendOrStopActiveDOMObjects()
2388 {
2389 #if PLATFORM(IOS)
2390     if (WebThreadCountOfObservedContentModifiers() > 0) {
2391         if (auto* frame = this->frame()) {
2392             if (auto* page = frame->page())
2393                 page->chrome().client().clearContentChangeObservers(*frame);
2394         }
2395     }
2396 #endif
2397 }
2398
2399 void Document::suspendActiveDOMObjects(ActiveDOMObject::ReasonForSuspension why)
2400 {
2401     ScriptExecutionContext::suspendActiveDOMObjects(why);
2402     suspendDeviceMotionAndOrientationUpdates();
2403     platformSuspendOrStopActiveDOMObjects();
2404 }
2405
2406 void Document::resumeActiveDOMObjects(ActiveDOMObject::ReasonForSuspension why)
2407 {
2408     ScriptExecutionContext::resumeActiveDOMObjects(why);
2409     resumeDeviceMotionAndOrientationUpdates();
2410     // FIXME: For iOS, do we need to add content change observers that were removed in Document::suspendActiveDOMObjects()?
2411 }
2412
2413 void Document::stopActiveDOMObjects()
2414 {
2415     ScriptExecutionContext::stopActiveDOMObjects();
2416     platformSuspendOrStopActiveDOMObjects();
2417 }
2418
2419 void Document::clearAXObjectCache()
2420 {
2421     ASSERT(&topDocument() == this);
2422     // Clear the cache member variable before calling delete because attempts
2423     // are made to access it during destruction.
2424     m_axObjectCache = nullptr;
2425 }
2426
2427 AXObjectCache* Document::existingAXObjectCacheSlow() const
2428 {
2429     ASSERT(hasEverCreatedAnAXObjectCache);
2430     Document& topDocument = this->topDocument();
2431     if (!topDocument.hasLivingRenderTree())
2432         return nullptr;
2433     return topDocument.m_axObjectCache.get();
2434 }
2435
2436 AXObjectCache* Document::axObjectCache() const
2437 {
2438     if (!AXObjectCache::accessibilityEnabled())
2439         return nullptr;
2440     
2441     // The only document that actually has a AXObjectCache is the top-level
2442     // document.  This is because we need to be able to get from any WebCoreAXObject
2443     // to any other WebCoreAXObject on the same page.  Using a single cache allows
2444     // lookups across nested webareas (i.e. multiple documents).
2445     Document& topDocument = this->topDocument();
2446
2447     // If the document has already been detached, do not make a new axObjectCache.
2448     if (!topDocument.hasLivingRenderTree())
2449         return nullptr;
2450
2451     ASSERT(&topDocument == this || !m_axObjectCache);
2452     if (!topDocument.m_axObjectCache) {
2453         topDocument.m_axObjectCache = std::make_unique<AXObjectCache>(topDocument);
2454         hasEverCreatedAnAXObjectCache = true;
2455     }
2456     return topDocument.m_axObjectCache.get();
2457 }
2458
2459 void Document::setVisuallyOrdered()
2460 {
2461     m_visuallyOrdered = true;
2462     if (renderView())
2463         renderView()->mutableStyle().setRTLOrdering(VisualOrder);
2464 }
2465
2466 Ref<DocumentParser> Document::createParser()
2467 {
2468     // FIXME: this should probably pass the frame instead
2469     return XMLDocumentParser::create(*this, view());
2470 }
2471
2472 ScriptableDocumentParser* Document::scriptableDocumentParser() const
2473 {
2474     return parser() ? parser()->asScriptableDocumentParser() : nullptr;
2475 }
2476
2477 void Document::open(Document* ownerDocument)
2478 {
2479     if (m_ignoreOpensDuringUnloadCount)
2480         return;
2481
2482     if (ownerDocument) {
2483         setURL(ownerDocument->url());
2484         setCookieURL(ownerDocument->cookieURL());
2485         setSecurityOriginPolicy(ownerDocument->securityOriginPolicy());
2486     }
2487
2488     if (m_frame) {
2489         if (ScriptableDocumentParser* parser = scriptableDocumentParser()) {
2490             if (parser->isParsing()) {
2491                 // FIXME: HTML5 doesn't tell us to check this, it might not be correct.
2492                 if (parser->isExecutingScript())
2493                     return;
2494
2495                 if (!parser->wasCreatedByScript() && parser->hasInsertionPoint())
2496                     return;
2497             }
2498         }
2499
2500         if (m_frame->loader().state() == FrameStateProvisional)
2501             m_frame->loader().stopAllLoaders();
2502     }
2503
2504     removeAllEventListeners();
2505     implicitOpen();
2506     if (ScriptableDocumentParser* parser = scriptableDocumentParser())
2507         parser->setWasCreatedByScript(true);
2508
2509     if (m_frame)
2510         m_frame->loader().didExplicitOpen();
2511 }
2512
2513 void Document::detachParser()
2514 {
2515     if (!m_parser)
2516         return;
2517     m_parser->detach();
2518     m_parser = nullptr;
2519 }
2520
2521 void Document::cancelParsing()
2522 {
2523     if (!m_parser)
2524         return;
2525
2526     // We have to clear the parser to avoid possibly triggering
2527     // the onload handler when closing as a side effect of a cancel-style
2528     // change, such as opening a new document or closing the window while
2529     // still parsing
2530     detachParser();
2531     explicitClose();
2532 }
2533
2534 void Document::implicitOpen()
2535 {
2536     removeChildren();
2537
2538     setCompatibilityMode(DocumentCompatibilityMode::NoQuirksMode);
2539
2540     cancelParsing();
2541     m_parser = createParser();
2542     setParsing(true);
2543     setReadyState(Loading);
2544 }
2545
2546 HTMLBodyElement* Document::body() const
2547 {
2548     auto* element = documentElement();
2549     if (!element)
2550         return nullptr;
2551     return childrenOfType<HTMLBodyElement>(*element).first();
2552 }
2553
2554 HTMLElement* Document::bodyOrFrameset() const
2555 {
2556     // Return the first body or frameset child of the html element.
2557     auto* element = documentElement();
2558     if (!is<HTMLHtmlElement>(element))
2559         return nullptr;
2560     for (auto& child : childrenOfType<HTMLElement>(*element)) {
2561         if (is<HTMLBodyElement>(child) || is<HTMLFrameSetElement>(child))
2562             return &child;
2563     }
2564     return nullptr;
2565 }
2566
2567 ExceptionOr<void> Document::setBodyOrFrameset(RefPtr<HTMLElement>&& newBody)
2568 {
2569     if (!is<HTMLBodyElement>(newBody.get()) && !is<HTMLFrameSetElement>(newBody.get()))
2570         return Exception { HIERARCHY_REQUEST_ERR };
2571
2572     auto* currentBody = bodyOrFrameset();
2573     if (newBody == currentBody)
2574         return { };
2575
2576     if (!m_documentElement)
2577         return Exception { HIERARCHY_REQUEST_ERR };
2578
2579     if (currentBody)
2580         return m_documentElement->replaceChild(*newBody, *currentBody);
2581     return m_documentElement->appendChild(*newBody);
2582 }
2583
2584 Location* Document::location() const
2585 {
2586     auto* window = domWindow();
2587     if (!window)
2588         return nullptr;
2589
2590     return window->location();
2591 }
2592
2593 HTMLHeadElement* Document::head()
2594 {
2595     if (auto element = documentElement())
2596         return childrenOfType<HTMLHeadElement>(*element).first();
2597     return nullptr;
2598 }
2599
2600 void Document::close()
2601 {
2602     // FIXME: We should follow the specification more closely:
2603     //        http://www.whatwg.org/specs/web-apps/current-work/#dom-document-close
2604
2605     if (!scriptableDocumentParser() || !scriptableDocumentParser()->wasCreatedByScript() || !scriptableDocumentParser()->isParsing())
2606         return;
2607
2608     explicitClose();
2609 }
2610
2611 void Document::explicitClose()
2612 {
2613     if (RefPtr<DocumentParser> parser = m_parser)
2614         parser->finish();
2615
2616     if (!m_frame) {
2617         // Because we have no frame, we don't know if all loading has completed,
2618         // so we just call implicitClose() immediately. FIXME: This might fire
2619         // the load event prematurely <http://bugs.webkit.org/show_bug.cgi?id=14568>.
2620         implicitClose();
2621         return;
2622     }
2623
2624     checkCompleted();
2625 }
2626
2627 void Document::implicitClose()
2628 {
2629     // If we're in the middle of recalcStyle, we need to defer the close until the style information is accurate and all elements are re-attached.
2630     if (m_inStyleRecalc) {
2631         m_closeAfterStyleRecalc = true;
2632         return;
2633     }
2634
2635     bool wasLocationChangePending = frame() && frame()->navigationScheduler().locationChangePending();
2636     bool doload = !parsing() && m_parser && !m_processingLoadEvent && !wasLocationChangePending;
2637     
2638     if (!doload)
2639         return;
2640
2641     // Call to dispatchWindowLoadEvent can blow us from underneath.
2642     Ref<Document> protectedThis(*this);
2643
2644     m_processingLoadEvent = true;
2645
2646     ScriptableDocumentParser* parser = scriptableDocumentParser();
2647     m_wellFormed = parser && parser->wellFormed();
2648
2649     // We have to clear the parser, in case someone document.write()s from the
2650     // onLoad event handler, as in Radar 3206524.
2651     detachParser();
2652
2653     // FIXME: We kick off the icon loader when the Document is done parsing.
2654     // There are earlier opportunities we could start it:
2655     //  -When the <head> finishes parsing
2656     //  -When any new HTMLLinkElement is inserted into the document
2657     // But those add a dynamic component to the favicon that has UI 
2658     // ramifications, and we need to decide what is the Right Thing To Do(tm)
2659     Frame* f = frame();
2660     if (f) {
2661         if (f->loader().client().useIconLoadingClient()) {
2662             if (auto* documentLoader = loader())
2663                 documentLoader->startIconLoading();
2664         } else
2665             f->loader().icon().startLoader();
2666
2667         f->animation().startAnimationsIfNotSuspended(this);
2668
2669         // FIXME: We shouldn't be dispatching pending events globally on all Documents here.
2670         // For now, only do this when there is a Frame, otherwise this could cause JS reentrancy
2671         // below SVG font parsing, for example. <https://webkit.org/b/136269>
2672         ImageLoader::dispatchPendingBeforeLoadEvents();
2673         ImageLoader::dispatchPendingLoadEvents();
2674         ImageLoader::dispatchPendingErrorEvents();
2675         HTMLLinkElement::dispatchPendingLoadEvents();
2676         HTMLStyleElement::dispatchPendingLoadEvents();
2677     }
2678
2679     // To align the HTML load event and the SVGLoad event for the outermost <svg> element, fire it from
2680     // here, instead of doing it from SVGElement::finishedParsingChildren (if externalResourcesRequired="false",
2681     // which is the default, for ='true' its fired at a later time, once all external resources finished loading).
2682     if (svgExtensions())
2683         accessSVGExtensions().dispatchSVGLoadEventToOutermostSVGElements();
2684
2685     dispatchWindowLoadEvent();
2686     enqueuePageshowEvent(PageshowEventNotPersisted);
2687     if (m_pendingStateObject)
2688         enqueuePopstateEvent(WTFMove(m_pendingStateObject));
2689
2690     if (f)
2691         f->loader().dispatchOnloadEvents();
2692
2693     // An event handler may have removed the frame
2694     if (!frame()) {
2695         m_processingLoadEvent = false;
2696         return;
2697     }
2698
2699     // Make sure both the initial layout and reflow happen after the onload
2700     // fires. This will improve onload scores, and other browsers do it.
2701     // If they wanna cheat, we can too. -dwh
2702
2703     if (frame()->navigationScheduler().locationChangePending() && timeSinceDocumentCreation() < settings().layoutInterval()) {
2704         // Just bail out. Before or during the onload we were shifted to another page.
2705         // The old i-Bench suite does this. When this happens don't bother painting or laying out.        
2706         m_processingLoadEvent = false;
2707         view()->unscheduleRelayout();
2708         return;
2709     }
2710
2711     frame()->loader().checkCallImplicitClose();
2712     
2713     // We used to force a synchronous display and flush here.  This really isn't
2714     // necessary and can in fact be actively harmful if pages are loading at a rate of > 60fps
2715     // (if your platform is syncing flushes and limiting them to 60fps).
2716     m_overMinimumLayoutThreshold = true;
2717     if (!ownerElement() || (ownerElement()->renderer() && !ownerElement()->renderer()->needsLayout())) {
2718         updateStyleIfNeeded();
2719         
2720         // Always do a layout after loading if needed.
2721         if (view() && renderView() && (!renderView()->firstChild() || renderView()->needsLayout()))
2722             view()->layout();
2723     }
2724
2725     m_processingLoadEvent = false;
2726
2727 #if PLATFORM(COCOA) || PLATFORM(WIN) || PLATFORM(GTK)
2728     if (f && hasLivingRenderTree() && AXObjectCache::accessibilityEnabled()) {
2729         // The AX cache may have been cleared at this point, but we need to make sure it contains an
2730         // AX object to send the notification to. getOrCreate will make sure that an valid AX object
2731         // exists in the cache (we ignore the return value because we don't need it here). This is 
2732         // only safe to call when a layout is not in progress, so it can not be used in postNotification.
2733         //
2734         // This notification is now called AXNewDocumentLoadComplete because there are other handlers that will
2735         // catch new AND page history loads, and that uses AXLoadComplete
2736         
2737         axObjectCache()->getOrCreate(renderView());
2738         if (this == &topDocument())
2739             axObjectCache()->postNotification(renderView(), AXObjectCache::AXNewDocumentLoadComplete);
2740         else {
2741             // AXLoadComplete can only be posted on the top document, so if it's a document
2742             // in an iframe that just finished loading, post AXLayoutComplete instead.
2743             axObjectCache()->postNotification(renderView(), AXObjectCache::AXLayoutComplete);
2744         }
2745     }
2746 #endif
2747
2748     if (svgExtensions())
2749         accessSVGExtensions().startAnimations();
2750 }
2751
2752 void Document::setParsing(bool b)
2753 {
2754     m_bParsing = b;
2755
2756     if (m_bParsing && !m_sharedObjectPool)
2757         m_sharedObjectPool = std::make_unique<DocumentSharedObjectPool>();
2758
2759     if (!m_bParsing && view() && !view()->needsLayout())
2760         view()->fireLayoutRelatedMilestonesIfNeeded();
2761 }
2762
2763 bool Document::shouldScheduleLayout()
2764 {
2765     // This function will only be called when FrameView thinks a layout is needed.
2766     // This enforces a couple extra rules.
2767     //
2768     //    (a) Only schedule a layout once the stylesheets are loaded.
2769     //    (b) Only schedule layout once we have a body element.
2770
2771     return (haveStylesheetsLoaded() && bodyOrFrameset())
2772         || (documentElement() && !is<HTMLHtmlElement>(*documentElement()));
2773 }
2774     
2775 bool Document::isLayoutTimerActive()
2776 {
2777     return view() && view()->layoutPending() && !minimumLayoutDelay();
2778 }
2779
2780 Seconds Document::minimumLayoutDelay()
2781 {
2782     if (m_overMinimumLayoutThreshold)
2783         return 0_s;
2784     
2785     auto elapsed = timeSinceDocumentCreation();
2786     m_overMinimumLayoutThreshold = elapsed > settings().layoutInterval();
2787
2788     // We'll want to schedule the timer to fire at the minimum layout threshold.
2789     return std::max(0_s, settings().layoutInterval() - elapsed);
2790 }
2791
2792 Seconds Document::timeSinceDocumentCreation() const
2793 {
2794     return MonotonicTime::now() - m_documentCreationTime;
2795 }
2796
2797 void Document::write(SegmentedString&& text, Document* ownerDocument)
2798 {
2799     NestingLevelIncrementer nestingLevelIncrementer(m_writeRecursionDepth);
2800
2801     m_writeRecursionIsTooDeep = (m_writeRecursionDepth > 1) && m_writeRecursionIsTooDeep;
2802     m_writeRecursionIsTooDeep = (m_writeRecursionDepth > cMaxWriteRecursionDepth) || m_writeRecursionIsTooDeep;
2803
2804     if (m_writeRecursionIsTooDeep)
2805         return;
2806
2807     bool hasInsertionPoint = m_parser && m_parser->hasInsertionPoint();
2808     if (!hasInsertionPoint && (m_ignoreOpensDuringUnloadCount || m_ignoreDestructiveWriteCount))
2809         return;
2810
2811     if (!hasInsertionPoint)
2812         open(ownerDocument);
2813
2814     ASSERT(m_parser);
2815     m_parser->insert(WTFMove(text));
2816 }
2817
2818 void Document::write(const String& text, Document* ownerDocument)
2819 {
2820     write(SegmentedString { text }, ownerDocument);
2821 }
2822
2823 void Document::writeln(const String& text, Document* ownerDocument)
2824 {
2825     SegmentedString textWithNewline { text };
2826     textWithNewline.append(String { "\n" });
2827     write(WTFMove(textWithNewline), ownerDocument);
2828 }
2829
2830 std::chrono::milliseconds Document::minimumTimerInterval() const
2831 {
2832     auto* page = this->page();
2833     if (!page)
2834         return ScriptExecutionContext::minimumTimerInterval();
2835     return page->settings().minimumDOMTimerInterval();
2836 }
2837
2838 void Document::setTimerThrottlingEnabled(bool shouldThrottle)
2839 {
2840     if (m_isTimerThrottlingEnabled == shouldThrottle)
2841         return;
2842
2843     m_isTimerThrottlingEnabled = shouldThrottle;
2844     didChangeTimerAlignmentInterval();
2845 }
2846
2847 std::chrono::milliseconds Document::timerAlignmentInterval(bool hasReachedMaxNestingLevel) const
2848 {
2849     auto alignmentInterval = ScriptExecutionContext::timerAlignmentInterval(hasReachedMaxNestingLevel);
2850
2851     // Apply Document-level DOMTimer throttling only if timers have reached their maximum nesting level as the Page may still be visible.
2852     if (m_isTimerThrottlingEnabled && hasReachedMaxNestingLevel)
2853         alignmentInterval = std::max(alignmentInterval, DOMTimer::hiddenPageAlignmentInterval());
2854
2855     if (Page* page = this->page())
2856         alignmentInterval = std::max(alignmentInterval, page->domTimerAlignmentInterval());
2857
2858     return alignmentInterval;
2859 }
2860
2861 EventTarget* Document::errorEventTarget()
2862 {
2863     return m_domWindow.get();
2864 }
2865
2866 void Document::logExceptionToConsole(const String& errorMessage, const String& sourceURL, int lineNumber, int columnNumber, RefPtr<Inspector::ScriptCallStack>&& callStack)
2867 {
2868     addMessage(MessageSource::JS, MessageLevel::Error, errorMessage, sourceURL, lineNumber, columnNumber, WTFMove(callStack));
2869 }
2870
2871 void Document::setURL(const URL& url)
2872 {
2873     const URL& newURL = url.isEmpty() ? blankURL() : url;
2874     if (newURL == m_url)
2875         return;
2876
2877     m_url = newURL;
2878     m_documentURI = m_url.string();
2879     updateBaseURL();
2880 }
2881
2882 void Document::updateBaseURL()
2883 {
2884     URL oldBaseURL = m_baseURL;
2885     // DOM 3 Core: When the Document supports the feature "HTML" [DOM Level 2 HTML], the base URI is computed using
2886     // first the value of the href attribute of the HTML BASE element if any, and the value of the documentURI attribute
2887     // from the Document interface otherwise.
2888     if (!m_baseElementURL.isEmpty())
2889         m_baseURL = m_baseElementURL;
2890     else if (!m_baseURLOverride.isEmpty())
2891         m_baseURL = m_baseURLOverride;
2892     else {
2893         // The documentURI attribute is read-only from JavaScript, but writable from Objective C, so we need to retain
2894         // this fallback behavior. We use a null base URL, since the documentURI attribute is an arbitrary string
2895         // and DOM 3 Core does not specify how it should be resolved.
2896         m_baseURL = URL(ParsedURLString, documentURI());
2897     }
2898
2899     clearSelectorQueryCache();
2900
2901     if (!m_baseURL.isValid())
2902         m_baseURL = URL();
2903
2904     if (!equalIgnoringFragmentIdentifier(oldBaseURL, m_baseURL)) {
2905         // Base URL change changes any relative visited links.
2906         // FIXME: There are other URLs in the tree that would need to be re-evaluated on dynamic base URL change. Style should be invalidated too.
2907         for (auto& anchor : descendantsOfType<HTMLAnchorElement>(*this))
2908             anchor.invalidateCachedVisitedLinkHash();
2909     }
2910 }
2911
2912 void Document::setBaseURLOverride(const URL& url)
2913 {
2914     m_baseURLOverride = url;
2915     updateBaseURL();
2916 }
2917
2918 void Document::processBaseElement()
2919 {
2920     // Find the first href attribute in a base element and the first target attribute in a base element.
2921     const AtomicString* href = nullptr;
2922     const AtomicString* target = nullptr;
2923     auto baseDescendants = descendantsOfType<HTMLBaseElement>(*this);
2924     for (auto& base : baseDescendants) {
2925         if (!href) {
2926             const AtomicString& value = base.attributeWithoutSynchronization(hrefAttr);
2927             if (!value.isNull()) {
2928                 href = &value;
2929                 if (target)
2930                     break;
2931             }
2932         }
2933         if (!target) {
2934             const AtomicString& value = base.attributeWithoutSynchronization(targetAttr);
2935             if (!value.isNull()) {
2936                 target = &value;
2937                 if (href)
2938                     break;
2939             }
2940         }
2941     }
2942
2943     // FIXME: Since this doesn't share code with completeURL it may not handle encodings correctly.
2944     URL baseElementURL;
2945     if (href) {
2946         String strippedHref = stripLeadingAndTrailingHTMLSpaces(*href);
2947         if (!strippedHref.isEmpty())
2948             baseElementURL = URL(url(), strippedHref);
2949     }
2950     if (m_baseElementURL != baseElementURL && contentSecurityPolicy()->allowBaseURI(baseElementURL)) {
2951         m_baseElementURL = baseElementURL;
2952         updateBaseURL();
2953     }
2954
2955     m_baseTarget = target ? *target : nullAtom;
2956 }
2957
2958 String Document::userAgent(const URL& url) const
2959 {
2960     return frame() ? frame()->loader().userAgent(url) : String();
2961 }
2962
2963 void Document::disableEval(const String& errorMessage)
2964 {
2965     if (!frame())
2966         return;
2967
2968     frame()->script().disableEval(errorMessage);
2969 }
2970
2971 #if ENABLE(INDEXED_DATABASE)
2972
2973 IDBClient::IDBConnectionProxy* Document::idbConnectionProxy()
2974 {
2975     if (!m_idbConnectionProxy) {
2976         Page* currentPage = page();
2977         if (!currentPage)
2978             return nullptr;
2979         m_idbConnectionProxy = &currentPage->idbConnection().proxy();
2980     }
2981     return m_idbConnectionProxy.get();
2982 }
2983
2984 #endif
2985
2986 #if ENABLE(WEB_SOCKETS)
2987
2988 SocketProvider* Document::socketProvider()
2989 {
2990     return m_socketProvider.get();
2991 }
2992
2993 #endif
2994     
2995 bool Document::canNavigate(Frame* targetFrame)
2996 {
2997     if (!m_frame)
2998         return false;
2999
3000     // FIXME: We shouldn't call this function without a target frame, but
3001     // fast/forms/submit-to-blank-multiple-times.html depends on this function
3002     // returning true when supplied with a 0 targetFrame.
3003     if (!targetFrame)
3004         return true;
3005
3006     // Frame-busting is generally allowed, but blocked for sandboxed frames lacking the 'allow-top-navigation' flag.
3007     if (!isSandboxed(SandboxTopNavigation) && targetFrame == &m_frame->tree().top())
3008         return true;
3009
3010     if (isSandboxed(SandboxNavigation)) {
3011         if (targetFrame->tree().isDescendantOf(m_frame))
3012             return true;
3013
3014         const char* reason = "The frame attempting navigation is sandboxed, and is therefore disallowed from navigating its ancestors.";
3015         if (isSandboxed(SandboxTopNavigation) && targetFrame == &m_frame->tree().top())
3016             reason = "The frame attempting navigation of the top-level window is sandboxed, but the 'allow-top-navigation' flag is not set.";
3017
3018         printNavigationErrorMessage(targetFrame, url(), reason);
3019         return false;
3020     }
3021
3022     // This is the normal case. A document can navigate its decendant frames,
3023     // or, more generally, a document can navigate a frame if the document is
3024     // in the same origin as any of that frame's ancestors (in the frame
3025     // hierarchy).
3026     //
3027     // See http://www.adambarth.com/papers/2008/barth-jackson-mitchell.pdf for
3028     // historical information about this security check.
3029     if (canAccessAncestor(securityOrigin(), targetFrame))
3030         return true;
3031
3032     // Top-level frames are easier to navigate than other frames because they
3033     // display their URLs in the address bar (in most browsers). However, there
3034     // are still some restrictions on navigation to avoid nuisance attacks.
3035     // Specifically, a document can navigate a top-level frame if that frame
3036     // opened the document or if the document is the same-origin with any of
3037     // the top-level frame's opener's ancestors (in the frame hierarchy).
3038     //
3039     // In both of these cases, the document performing the navigation is in
3040     // some way related to the frame being navigate (e.g., by the "opener"
3041     // and/or "parent" relation). Requiring some sort of relation prevents a
3042     // document from navigating arbitrary, unrelated top-level frames.
3043     if (!targetFrame->tree().parent()) {
3044         if (targetFrame == m_frame->loader().opener())
3045             return true;
3046
3047         if (canAccessAncestor(securityOrigin(), targetFrame->loader().opener()))
3048             return true;
3049     }
3050
3051     printNavigationErrorMessage(targetFrame, url(), "The frame attempting navigation is neither same-origin with the target, nor is it the target's parent or opener.");
3052     return false;
3053 }
3054
3055 Frame* Document::findUnsafeParentScrollPropagationBoundary()
3056 {
3057     Frame* currentFrame = m_frame;
3058     if (!currentFrame)
3059         return nullptr;
3060
3061     Frame* ancestorFrame = currentFrame->tree().parent();
3062
3063     while (ancestorFrame) {
3064         if (!ancestorFrame->document()->securityOrigin().canAccess(securityOrigin()))
3065             return currentFrame;
3066         currentFrame = ancestorFrame;
3067         ancestorFrame = ancestorFrame->tree().parent();
3068     }
3069     return nullptr;
3070 }
3071
3072 void Document::didRemoveAllPendingStylesheet()
3073 {
3074     if (m_pendingSheetLayout == DidLayoutWithPendingSheets) {
3075         // Painting is disabled when doing layouts with pending sheets to avoid FOUC.
3076         // We need to force paint when coming out from this state.
3077         // FIXME: This is not very elegant.
3078         m_pendingSheetLayout = IgnoreLayoutWithPendingSheets;
3079         if (renderView())
3080             renderView()->repaintViewAndCompositedLayers();
3081     }
3082
3083     if (auto* parser = scriptableDocumentParser())
3084         parser->executeScriptsWaitingForStylesheetsSoon();
3085 }
3086
3087 bool Document::usesStyleBasedEditability() const
3088 {
3089     if (m_hasElementUsingStyleBasedEditability)
3090         return true;
3091
3092     ASSERT(!m_renderView || !m_renderView->frameView().isPainting());
3093     ASSERT(!m_inStyleRecalc);
3094
3095     auto& styleScope = const_cast<Style::Scope&>(this->styleScope());
3096     styleScope.flushPendingUpdate();
3097     return styleScope.usesStyleBasedEditability();
3098 }
3099
3100 void Document::setHasElementUsingStyleBasedEditability()
3101 {
3102     m_hasElementUsingStyleBasedEditability = true;
3103 }
3104
3105 void Document::processHttpEquiv(const String& equiv, const String& content, bool isInDocumentHead)
3106 {
3107     ASSERT(!equiv.isNull());
3108     ASSERT(!content.isNull());
3109
3110     HttpEquivPolicy policy = httpEquivPolicy();
3111     if (policy != HttpEquivPolicy::Enabled) {
3112         String reason;
3113         switch (policy) {
3114         case HttpEquivPolicy::Enabled:
3115             ASSERT_NOT_REACHED();
3116             break;
3117         case HttpEquivPolicy::DisabledBySettings:
3118             reason = "by the embedder.";
3119             break;
3120         case HttpEquivPolicy::DisabledByContentDispositionAttachmentSandbox:
3121             reason = "for documents with Content-Disposition: attachment.";
3122             break;
3123         }
3124         String message = "http-equiv '" + equiv + "' is disabled " + reason;
3125         addConsoleMessage(MessageSource::Security, MessageLevel::Error, message);
3126         return;
3127     }
3128
3129     Frame* frame = this->frame();
3130
3131     HTTPHeaderName headerName;
3132     if (!findHTTPHeaderName(equiv, headerName))
3133         return;
3134
3135     switch (headerName) {
3136     case HTTPHeaderName::DefaultStyle:
3137         // The preferred style set has been overridden as per section
3138         // 14.3.2 of the HTML4.0 specification.  We need to update the
3139         // sheet used variable and then update our style selector.
3140         // For more info, see the test at:
3141         // http://www.hixie.ch/tests/evil/css/import/main/preferred.html
3142         // -dwh
3143         styleScope().setSelectedStylesheetSetName(content);
3144         styleScope().setPreferredStylesheetSetName(content);
3145         break;
3146
3147     case HTTPHeaderName::Refresh: {
3148         double delay;
3149         String urlString;
3150         if (frame && parseMetaHTTPEquivRefresh(content, delay, urlString)) {
3151             URL completedURL;
3152             if (urlString.isEmpty())
3153                 completedURL = m_url;
3154             else
3155                 completedURL = completeURL(urlString);
3156             if (!protocolIsJavaScript(completedURL))
3157                 frame->navigationScheduler().scheduleRedirect(*this, delay, completedURL);
3158             else {
3159                 String message = "Refused to refresh " + m_url.stringCenterEllipsizedToLength() + " to a javascript: URL";
3160                 addConsoleMessage(MessageSource::Security, MessageLevel::Error, message);
3161             }
3162         }
3163
3164         break;
3165     }
3166
3167     case HTTPHeaderName::SetCookie:
3168         // FIXME: make setCookie work on XML documents too; e.g. in case of <html:meta .....>
3169         if (is<HTMLDocument>(*this)) {
3170             // Exception (for sandboxed documents) ignored.
3171             downcast<HTMLDocument>(*this).setCookie(content);
3172         }
3173         break;
3174
3175     case HTTPHeaderName::ContentLanguage:
3176         setContentLanguage(content);
3177         break;
3178
3179     case HTTPHeaderName::XDNSPrefetchControl:
3180         parseDNSPrefetchControlHeader(content);
3181         break;
3182
3183     case HTTPHeaderName::XFrameOptions:
3184         if (frame) {
3185             FrameLoader& frameLoader = frame->loader();
3186             unsigned long requestIdentifier = 0;
3187             if (frameLoader.activeDocumentLoader() && frameLoader.activeDocumentLoader()->mainResourceLoader())
3188                 requestIdentifier = frameLoader.activeDocumentLoader()->mainResourceLoader()->identifier();
3189
3190             String message = "The X-Frame-Option '" + content + "' supplied in a <meta> element was ignored. X-Frame-Options may only be provided by an HTTP header sent with the document.";
3191             addConsoleMessage(MessageSource::Security, MessageLevel::Error, message, requestIdentifier);
3192         }
3193         break;
3194
3195     case HTTPHeaderName::ContentSecurityPolicy:
3196         if (isInDocumentHead)
3197             contentSecurityPolicy()->didReceiveHeader(content, ContentSecurityPolicyHeaderType::Enforce, ContentSecurityPolicy::PolicyFrom::HTTPEquivMeta);
3198         break;
3199
3200     case HTTPHeaderName::XWebKitCSP:
3201         if (isInDocumentHead)
3202             contentSecurityPolicy()->didReceiveHeader(content, ContentSecurityPolicyHeaderType::PrefixedEnforce, ContentSecurityPolicy::PolicyFrom::HTTPEquivMeta);
3203         break;
3204
3205     default:
3206         break;
3207     }
3208 }
3209
3210 void Document::processViewport(const String& features, ViewportArguments::Type origin)
3211 {
3212     ASSERT(!features.isNull());
3213
3214     if (origin < m_viewportArguments.type)
3215         return;
3216
3217     m_viewportArguments = ViewportArguments(origin);
3218
3219     processFeaturesString(features, [this](StringView key, StringView value) {
3220         setViewportFeature(m_viewportArguments, *this, key, value);
3221     });
3222
3223     updateViewportArguments();
3224 }
3225
3226 void Document::updateViewportArguments()
3227 {
3228     if (page() && frame()->isMainFrame()) {
3229 #ifndef NDEBUG
3230         m_didDispatchViewportPropertiesChanged = true;
3231 #endif
3232         page()->chrome().dispatchViewportPropertiesDidChange(m_viewportArguments);
3233         page()->chrome().didReceiveDocType(*frame());
3234     }
3235 }
3236
3237 #if PLATFORM(IOS)
3238
3239 void Document::processFormatDetection(const String& features)
3240 {
3241     // FIXME: Find a better place for this function.
3242     processFeaturesString(features, [this](StringView key, StringView value) {
3243         if (equalLettersIgnoringASCIICase(key, "telephone") && equalLettersIgnoringASCIICase(value, "no"))
3244             setIsTelephoneNumberParsingAllowed(false);
3245     });
3246 }
3247
3248 void Document::processWebAppOrientations()
3249 {
3250     if (Page* page = this->page())
3251         page->chrome().client().webAppOrientationsUpdated();
3252 }
3253
3254 #endif
3255
3256 void Document::processReferrerPolicy(const String& policy)
3257 {
3258     ASSERT(!policy.isNull());
3259
3260     // Documents in a Content-Disposition: attachment sandbox should never send a Referer header,
3261     // even if the document has a meta tag saying otherwise.
3262     if (shouldEnforceContentDispositionAttachmentSandbox())
3263         return;
3264
3265 #if USE(QUICK_LOOK)
3266     if (shouldEnforceQuickLookSandbox())
3267         return;
3268 #endif
3269
3270     // Note that we're supporting both the standard and legacy keywords for referrer
3271     // policies, as defined by http://www.w3.org/TR/referrer-policy/#referrer-policy-delivery-meta
3272     if (equalLettersIgnoringASCIICase(policy, "no-referrer") || equalLettersIgnoringASCIICase(policy, "never"))
3273         setReferrerPolicy(ReferrerPolicy::Never);
3274     else if (equalLettersIgnoringASCIICase(policy, "unsafe-url") || equalLettersIgnoringASCIICase(policy, "always"))
3275         setReferrerPolicy(ReferrerPolicy::Always);
3276     else if (equalLettersIgnoringASCIICase(policy, "origin"))
3277         setReferrerPolicy(ReferrerPolicy::Origin);
3278     else if (equalLettersIgnoringASCIICase(policy, "no-referrer-when-downgrade") || equalLettersIgnoringASCIICase(policy, "default"))
3279         setReferrerPolicy(ReferrerPolicy::Default);
3280     else {
3281         addConsoleMessage(MessageSource::Rendering, MessageLevel::Error, "Failed to set referrer policy: The value '" + policy + "' is not one of 'no-referrer', 'origin', 'no-referrer-when-downgrade', or 'unsafe-url'. Defaulting to 'no-referrer'.");
3282         setReferrerPolicy(ReferrerPolicy::Never);
3283     }
3284 }
3285
3286 MouseEventWithHitTestResults Document::prepareMouseEvent(const HitTestRequest& request, const LayoutPoint& documentPoint, const PlatformMouseEvent& event)
3287 {
3288     if (!hasLivingRenderTree())
3289         return MouseEventWithHitTestResults(event, HitTestResult(LayoutPoint()));
3290
3291     HitTestResult result(documentPoint);
3292     renderView()->hitTest(request, result);
3293
3294     if (!request.readOnly())
3295         updateHoverActiveState(request, result.targetElement());
3296
3297     return MouseEventWithHitTestResults(event, result);
3298 }
3299
3300 // DOM Section 1.1.1
3301 bool Document::childTypeAllowed(NodeType type) const
3302 {
3303     switch (type) {
3304     case ATTRIBUTE_NODE:
3305     case CDATA_SECTION_NODE:
3306     case DOCUMENT_FRAGMENT_NODE:
3307     case DOCUMENT_NODE:
3308     case TEXT_NODE:
3309         return false;
3310     case COMMENT_NODE:
3311     case PROCESSING_INSTRUCTION_NODE:
3312         return true;
3313     case DOCUMENT_TYPE_NODE:
3314     case ELEMENT_NODE:
3315         // Documents may contain no more than one of each of these.
3316         // (One Element and one DocumentType.)
3317         for (Node* c = firstChild(); c; c = c->nextSibling())
3318             if (c->nodeType() == type)
3319                 return false;
3320         return true;
3321     }
3322     return false;
3323 }
3324
3325 bool Document::canAcceptChild(const Node& newChild, const Node* refChild, AcceptChildOperation operation) const
3326 {
3327     if (operation == AcceptChildOperation::Replace && refChild->nodeType() == newChild.nodeType())
3328         return true;
3329
3330     switch (newChild.nodeType()) {
3331     case ATTRIBUTE_NODE:
3332     case CDATA_SECTION_NODE:
3333     case DOCUMENT_NODE:
3334     case TEXT_NODE:
3335         return false;
3336     case COMMENT_NODE:
3337     case PROCESSING_INSTRUCTION_NODE:
3338         return true;
3339     case DOCUMENT_FRAGMENT_NODE: {
3340         bool hasSeenElementChild = false;
3341         for (auto* node = downcast<DocumentFragment>(newChild).firstChild(); node; node = node->nextSibling()) {
3342             if (is<Element>(*node)) {
3343                 if (hasSeenElementChild)
3344                     return false;
3345                 hasSeenElementChild = true;
3346             }
3347             if (!canAcceptChild(*node, refChild, operation))
3348                 return false;
3349         }
3350         break;
3351     }
3352     case DOCUMENT_TYPE_NODE: {
3353         auto* existingDocType = childrenOfType<DocumentType>(*this).first();
3354         if (operation == AcceptChildOperation::Replace) {
3355             //  parent has a doctype child that is not child, or an element is preceding child.
3356             if (existingDocType && existingDocType != refChild)
3357                 return false;
3358             if (refChild->previousElementSibling())
3359                 return false;
3360         } else {
3361             ASSERT(operation == AcceptChildOperation::InsertOrAdd);
3362             if (existingDocType)
3363                 return false;
3364             if ((refChild && refChild->previousElementSibling()) || (!refChild && firstElementChild()))
3365                 return false;
3366         }
3367         break;
3368     }
3369     case ELEMENT_NODE: {
3370         auto* existingElementChild = firstElementChild();
3371         if (operation == AcceptChildOperation::Replace) {
3372             if (existingElementChild && existingElementChild != refChild)
3373                 return false;
3374             for (auto* child = refChild->nextSibling(); child; child = child->nextSibling()) {
3375                 if (is<DocumentType>(*child))
3376                     return false;
3377             }
3378         } else {
3379             ASSERT(operation == AcceptChildOperation::InsertOrAdd);
3380             if (existingElementChild)
3381                 return false;
3382             for (auto* child = refChild; child; child = child->nextSibling()) {
3383                 if (is<DocumentType>(*child))
3384                     return false;
3385             }
3386         }
3387         break;
3388     }
3389     }
3390     return true;
3391 }
3392
3393 Ref<Node> Document::cloneNodeInternal(Document&, CloningOperation type)
3394 {
3395     Ref<Document> clone = cloneDocumentWithoutChildren();
3396     clone->cloneDataFromDocument(*this);
3397     switch (type) {
3398     case CloningOperation::OnlySelf:
3399     case CloningOperation::SelfWithTemplateContent:
3400         break;
3401     case CloningOperation::Everything:
3402         cloneChildNodes(clone);
3403         break;
3404     }
3405     return WTFMove(clone);
3406 }
3407
3408 Ref<Document> Document::cloneDocumentWithoutChildren() const
3409 {
3410     if (isXMLDocument()) {
3411         if (isXHTMLDocument())
3412             return XMLDocument::createXHTML(nullptr, url());
3413         return XMLDocument::create(nullptr, url());
3414     }
3415     return create(nullptr, url());
3416 }
3417
3418 void Document::cloneDataFromDocument(const Document& other)
3419 {
3420     ASSERT(m_url == other.url());
3421     m_baseURL = other.baseURL();
3422     m_baseURLOverride = other.baseURLOverride();
3423     m_documentURI = other.documentURI();
3424
3425     setCompatibilityMode(other.m_compatibilityMode);
3426     setContextDocument(other.contextDocument());
3427     setSecurityOriginPolicy(other.securityOriginPolicy());
3428     overrideMIMEType(other.contentType());
3429     setDecoder(other.decoder());
3430 }
3431
3432 StyleSheetList& Document::styleSheets()
3433 {
3434     if (!m_styleSheetList)
3435         m_styleSheetList = StyleSheetList::create(this);
3436     return *m_styleSheetList;
3437 }
3438
3439 String Document::preferredStylesheetSet() const
3440 {
3441     return styleScope().preferredStylesheetSetName();
3442 }
3443
3444 String Document::selectedStylesheetSet() const
3445 {
3446     return styleScope().selectedStylesheetSetName();
3447 }
3448
3449 void Document::setSelectedStylesheetSet(const String& aString)
3450 {
3451     styleScope().setSelectedStylesheetSetName(aString);
3452 }
3453
3454 void Document::evaluateMediaQueryList()
3455 {
3456     if (m_mediaQueryMatcher)
3457         m_mediaQueryMatcher->styleResolverChanged();
3458     
3459     checkViewportDependentPictures();
3460 }
3461
3462 void Document::checkViewportDependentPictures()
3463 {
3464     Vector<HTMLPictureElement*, 16> changedPictures;
3465     HashSet<HTMLPictureElement*>::iterator end = m_viewportDependentPictures.end();
3466     for (HashSet<HTMLPictureElement*>::iterator it = m_viewportDependentPictures.begin(); it != end; ++it) {
3467         if ((*it)->viewportChangeAffectedPicture())
3468             changedPictures.append(*it);
3469     }
3470     for (auto* picture : changedPictures)
3471         picture->sourcesChanged();
3472 }
3473
3474 void Document::updateViewportUnitsOnResize()
3475 {
3476     if (!hasStyleWithViewportUnits())
3477         return;
3478
3479     styleScope().resolver().clearCachedPropertiesAffectedByViewportUnits();
3480
3481     // FIXME: Ideally, we should save the list of elements that have viewport units and only iterate over those.
3482     for (Element* element = ElementTraversal::firstWithin(rootNode()); element; element = ElementTraversal::nextIncludingPseudo(*element)) {
3483         auto* renderer = element->renderer();
3484         if (renderer && renderer->style().hasViewportUnits())
3485             element->invalidateStyle();
3486     }
3487 }
3488
3489 void Document::addAudioProducer(MediaProducer* audioProducer)
3490 {
3491     m_audioProducers.add(audioProducer);
3492     updateIsPlayingMedia();
3493 }
3494
3495 void Document::removeAudioProducer(MediaProducer* audioProducer)
3496 {
3497     m_audioProducers.remove(audioProducer);
3498     updateIsPlayingMedia();
3499 }
3500
3501 void Document::updateIsPlayingMedia(uint64_t sourceElementID)
3502 {
3503     MediaProducer::MediaStateFlags state = MediaProducer::IsNotPlaying;
3504     for (auto* audioProducer : m_audioProducers)
3505         state |= audioProducer->mediaState();
3506
3507 #if ENABLE(MEDIA_SESSION)
3508     if (HTMLMediaElement* sourceElement = HTMLMediaElement::elementWithID(sourceElementID)) {
3509         if (sourceElement->isPlaying())
3510             state |= MediaProducer::IsSourceElementPlaying;
3511
3512         if (auto* session = sourceElement->session()) {
3513             if (auto* controls = session->controls()) {
3514                 if (controls->previousTrackEnabled())
3515                     state |= MediaProducer::IsPreviousTrackControlEnabled;
3516                 if (controls->nextTrackEnabled())
3517                     state |= MediaProducer::IsNextTrackControlEnabled;
3518             }
3519         }
3520     }
3521 #endif
3522
3523     if (state == m_mediaState)
3524         return;
3525
3526     m_mediaState = state;
3527
3528     if (page())
3529         page()->updateIsPlayingMedia(sourceElementID);
3530 }
3531
3532 void Document::pageMutedStateDidChange()
3533 {
3534     for (auto* audioProducer : m_audioProducers)
3535         audioProducer->pageMutedStateDidChange();
3536 }
3537
3538 static bool isNodeInSubtree(Node& node, Node& container, bool amongChildrenOnly)
3539 {
3540     if (amongChildrenOnly)
3541         return node.isDescendantOf(container);
3542     else
3543         return &node == &container || node.isDescendantOf(container);
3544 }
3545
3546 void Document::removeFocusedNodeOfSubtree(Node& node, bool amongChildrenOnly)
3547 {
3548     if (!m_focusedElement || pageCacheState() != NotInPageCache) // If the document is in the page cache, then we don't need to clear out the focused node.
3549         return;
3550
3551     Element* focusedElement = node.treeScope().focusedElementInScope();
3552     if (!focusedElement)
3553         return;
3554     
3555     if (isNodeInSubtree(*focusedElement, node, amongChildrenOnly)) {
3556         setFocusedElement(nullptr, FocusDirectionNone, FocusRemovalEventsMode::DoNotDispatch);
3557         // Set the focus navigation starting node to the previous focused element so that
3558         // we can fallback to the siblings or parent node for the next search.
3559         // Also we need to call removeFocusNavigationNodeOfSubtree after this function because
3560         // setFocusedElement(nullptr) will reset m_focusNavigationStartingNode.
3561         setFocusNavigationStartingNode(focusedElement);
3562     }
3563 }
3564
3565 void Document::hoveredElementDidDetach(Element* element)
3566 {
3567     if (!m_hoveredElement || element != m_hoveredElement)
3568         return;
3569
3570     m_hoveredElement = element->parentElement();
3571     while (m_hoveredElement && !m_hoveredElement->renderer())
3572         m_hoveredElement = m_hoveredElement->parentElement();
3573     if (frame())
3574         frame()->eventHandler().scheduleHoverStateUpdate();
3575 }
3576
3577 void Document::elementInActiveChainDidDetach(Element* element)
3578 {
3579     if (!m_activeElement || element != m_activeElement)
3580         return;
3581
3582     m_activeElement = element->parentElement();
3583     while (m_activeElement && !m_activeElement->renderer())
3584         m_activeElement = m_activeElement->parentElement();
3585 }
3586
3587 #if ENABLE(DASHBOARD_SUPPORT)
3588
3589 const Vector<AnnotatedRegionValue>& Document::annotatedRegions() const
3590 {
3591     return m_annotatedRegions;
3592 }
3593
3594 void Document::setAnnotatedRegions(const Vector<AnnotatedRegionValue>& regions)
3595 {
3596     m_annotatedRegions = regions;
3597     setAnnotatedRegionsDirty(false);
3598 }
3599
3600 #endif
3601
3602 bool Document::setFocusedElement(Element* element, FocusDirection direction, FocusRemovalEventsMode eventsMode)
3603 {
3604     RefPtr<Element> newFocusedElement = element;
3605     // Make sure newFocusedElement is actually in this document
3606     if (newFocusedElement && (&newFocusedElement->document() != this))
3607         return true;
3608
3609     if (m_focusedElement == newFocusedElement)
3610         return true;
3611
3612     if (pageCacheState() != NotInPageCache)
3613         return false;
3614
3615     bool focusChangeBlocked = false;
3616     RefPtr<Element> oldFocusedElement = WTFMove(m_focusedElement);
3617
3618     // Remove focus from the existing focus node (if any)
3619     if (oldFocusedElement) {
3620         oldFocusedElement->setFocus(false);
3621         setFocusNavigationStartingNode(nullptr);
3622
3623         if (eventsMode == FocusRemovalEventsMode::Dispatch) {
3624             // Dispatch a change event for form control elements that have been edited.
3625             if (is<HTMLFormControlElement>(*oldFocusedElement)) {
3626                 HTMLFormControlElement& formControlElement = downcast<HTMLFormControlElement>(*oldFocusedElement);
3627                 if (formControlElement.wasChangedSinceLastFormControlChangeEvent())
3628                     formControlElement.dispatchFormControlChangeEvent();
3629             }
3630
3631             // Dispatch the blur event and let the node do any other blur related activities (important for text fields)
3632             oldFocusedElement->dispatchBlurEvent(newFocusedElement.copyRef());
3633
3634             if (m_focusedElement) {
3635                 // handler shifted focus
3636                 focusChangeBlocked = true;
3637                 newFocusedElement = nullptr;
3638             }
3639
3640             oldFocusedElement->dispatchFocusOutEvent(eventNames().focusoutEvent, newFocusedElement.copyRef()); // DOM level 3 name for the bubbling blur event.
3641             // FIXME: We should remove firing DOMFocusOutEvent event when we are sure no content depends
3642             // on it, probably when <rdar://problem/8503958> is resolved.
3643             oldFocusedElement->dispatchFocusOutEvent(eventNames().DOMFocusOutEvent, newFocusedElement.copyRef()); // DOM level 2 name for compatibility.
3644