src/third_party/WebKit/Source/core/dom/Document.h

   1 /*
   2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
   3  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
   4  *           (C) 2001 Dirk Mueller (mueller@kde.org)
   5  *           (C) 2006 Alexey Proskuryakov (ap@webkit.org)
   6  * Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2012 Apple Inc. All rights reserved.
   7  * Copyright (C) 2008, 2009 Torch Mobile Inc. All rights reserved. (http://www.torchmobile.com/)
   8  * Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies)
   9  * Copyright (C) 2011 Google Inc. All rights reserved.
  10  *
  11  * This library is free software; you can redistribute it and/or
  12  * modify it under the terms of the GNU Library General Public
  13  * License as published by the Free Software Foundation; either
  14  * version 2 of the License, or (at your option) any later version.
  15  *
  16  * This library is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  19  * Library General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU Library General Public License
  22  * along with this library; see the file COPYING.LIB.  If not, write to
  23  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  24  * Boston, MA 02110-1301, USA.
  25  *
  26  */
  27
  28 #ifndef Document_h
  29 #define Document_h
  30
  31 #include "bindings/v8/ExceptionStatePlaceholder.h"
  32 #include "bindings/v8/ScriptValue.h"
  33 #include "core/animation/AnimationClock.h"
  34 #include "core/animation/CompositorPendingAnimations.h"
  35 #include "core/dom/ContainerNode.h"
  36 #include "core/dom/DocumentEncodingData.h"
  37 #include "core/dom/DocumentInit.h"
  38 #include "core/dom/DocumentLifecycle.h"
  39 #include "core/dom/DocumentSupplementable.h"
  40 #include "core/dom/DocumentTiming.h"
  41 #include "core/dom/ExecutionContext.h"
  42 #include "core/dom/IconURL.h"
  43 #include "core/dom/MutationObserver.h"
  44 #include "core/dom/QualifiedName.h"
  45 #include "core/dom/TextLinkColors.h"
  46 #include "core/dom/TreeScope.h"
  47 #include "core/dom/UserActionElementSet.h"
  48 #include "core/dom/ViewportDescription.h"
  49 #include "core/dom/custom/CustomElement.h"
  50 #include "core/html/CollectionType.h"
  51 #include "core/page/FocusType.h"
  52 #include "core/page/PageVisibilityState.h"
  53 #include "core/rendering/HitTestRequest.h"
  54 #include "platform/Length.h"
  55 #include "platform/Timer.h"
  56 #include "platform/heap/Handle.h"
  57 #include "platform/weborigin/KURL.h"
  58 #include "platform/weborigin/ReferrerPolicy.h"
  59 #include "wtf/HashSet.h"
  60 #include "wtf/OwnPtr.h"
  61 #include "wtf/PassOwnPtr.h"
  62 #include "wtf/PassRefPtr.h"
  63 #include "wtf/WeakPtr.h"
  64
  65 namespace WebCore {
  66
  67 class AXObjectCache;
  68 class Attr;
  69 class CDATASection;
  70 class CSSFontSelector;
  71 class CSSStyleDeclaration;
  72 class CSSStyleSheet;
  73 class CSSStyleSheetResource;
  74 class CanvasRenderingContext2D;
  75 class CharacterData;
  76 class Chrome;
  77 class Comment;
  78 class ContentSecurityPolicyResponseHeaders;
  79 class ContextFeatures;
  80 class CustomElementRegistrationContext;
  81 class DOMImplementation;
  82 class DOMSelection;
  83 class LocalDOMWindow;
  84 class Database;
  85 class DatabaseThread;
  86 class DocumentFragment;
  87 class DocumentLifecycleNotifier;
  88 class DocumentLifecycleObserver;
  89 class DocumentLoader;
  90 class DocumentMarkerController;
  91 class DocumentParser;
  92 class DocumentState;
  93 class AnimationTimeline;
  94 class DocumentType;
  95 class Element;
  96 class ElementDataCache;
  97 class Event;
  98 class EventFactoryBase;
  99 class EventListener;
 100 class ExceptionState;
 101 class FastTextAutosizer;
 102 class FloatQuad;
 103 class FloatRect;
 104 class FontFaceSet;
 105 class FormController;
 106 class Frame;
 107 class FrameHost;
 108 class FrameView;
 109 class HTMLAllCollection;
 110 class HTMLCanvasElement;
 111 class HTMLCollection;
 112 class HTMLDialogElement;
 113 class HTMLDocument;
 114 class HTMLElement;
 115 class HTMLFrameOwnerElement;
 116 class HTMLHeadElement;
 117 class HTMLIFrameElement;
 118 class HTMLImport;
 119 class HTMLImportLoader;
 120 class HTMLImportsController;
 121 class HTMLLinkElement;
 122 class HTMLMapElement;
 123 class HTMLNameCollection;
 124 class HTMLScriptElement;
 125 class HitTestRequest;
 126 class HitTestResult;
 127 class IntPoint;
 128 class JSNode;
 129 class LayoutPoint;
 130 class LayoutRect;
 131 class LiveNodeListBase;
 132 class Locale;
 133 class LocalFrame;
 134 class Location;
 135 class MainThreadTaskRunner;
 136 class MediaQueryList;
 137 class MediaQueryMatcher;
 138 class MouseEventWithHitTestResults;
 139 class NodeFilter;
 140 class NodeIterator;
 141 class Page;
 142 class PlatformMouseEvent;
 143 class ProcessingInstruction;
 144 class Range;
 145 class RegisteredEventListener;
 146 class RenderView;
 147 class RequestAnimationFrameCallback;
 148 class ResourceFetcher;
 149 class SVGDocumentExtensions;
 150 class SVGUseElement;
 151 class ScriptElementData;
 152 class ScriptResource;
 153 class ScriptRunner;
 154 class ScriptableDocumentParser;
 155 class ScriptedAnimationController;
 156 class SecurityOrigin;
 157 class SegmentedString;
 158 class SelectorQueryCache;
 159 class SerializedScriptValue;
 160 class Settings;
 161 class StyleEngine;
 162 class StyleResolver;
 163 class StyleSheet;
 164 class StyleSheetContents;
 165 class StyleSheetList;
 166 class Text;
 167 class TextAutosizer;
 168 class Touch;
 169 class TouchList;
 170 class TransformSource;
 171 class TreeWalker;
 172 class VisitedLinkState;
 173 class WebGLRenderingContext;
 174 class XMLHttpRequest;
 175
 176 struct AnnotatedRegionValue;
 177
 178 typedef int ExceptionCode;
 179
 180 enum StyleResolverUpdateMode {
 181     // Discards the StyleResolver and rebuilds it.
 182     FullStyleUpdate,
 183     // Attempts to use StyleInvalidationAnalysis to avoid discarding the entire StyleResolver.
 184     AnalyzedStyleUpdate
 185 };
 186
 187 enum NodeListInvalidationType {
 188     DoNotInvalidateOnAttributeChanges = 0,
 189     InvalidateOnClassAttrChange,
 190     InvalidateOnIdNameAttrChange,
 191     InvalidateOnNameAttrChange,
 192     InvalidateOnForAttrChange,
 193     InvalidateForFormControls,
 194     InvalidateOnHRefAttrChange,
 195     InvalidateOnAnyAttrChange,
 196 };
 197 const int numNodeListInvalidationTypes = InvalidateOnAnyAttrChange + 1;
 198
 199 typedef HashCountedSet<Node*> TouchEventTargetSet;
 200
 201 enum DocumentClass {
 202     DefaultDocumentClass = 0,
 203     HTMLDocumentClass = 1,
 204     XHTMLDocumentClass = 1 << 1,
 205     ImageDocumentClass = 1 << 2,
 206     PluginDocumentClass = 1 << 3,
 207     MediaDocumentClass = 1 << 4,
 208     SVGDocumentClass = 1 << 5,
 209     XMLDocumentClass = 1 << 6,
 210 };
 211
 212 typedef unsigned char DocumentClassFlags;
 213
 214 class Document;
 215
 216 class DocumentVisibilityObserver : public WillBeGarbageCollectedMixin {
 217 public:
 218     DocumentVisibilityObserver(Document&);
 219     virtual ~DocumentVisibilityObserver();
 220
 221     virtual void didChangeVisibilityState(PageVisibilityState) = 0;
 222
 223     // Classes that inherit Node and DocumentVisibilityObserver must have a
 224     // virtual override of Node::didMoveToNewDocument that calls
 225     // DocumentVisibilityObserver::setDocument
 226     void setObservedDocument(Document&);
 227
 228 protected:
 229     void trace(Visitor*);
 230
 231 private:
 232     void registerObserver(Document&);
 233     void unregisterObserver();
 234
 235     RawPtrWillBeMember<Document> m_document;
 236 };
 237
 238 class Document : public ContainerNode, public TreeScope, public SecurityContext, public ExecutionContext, public ExecutionContextClient
 239     , public DocumentSupplementable, public LifecycleContext<Document> {
 240     WILL_BE_USING_GARBAGE_COLLECTED_MIXIN(Document);
 241 public:
 242     static PassRefPtrWillBeRawPtr<Document> create(const DocumentInit& initializer = DocumentInit())
 243     {
 244         return adoptRefWillBeNoop(new Document(initializer));
 245     }
 246     virtual ~Document();
 247
 248     MediaQueryMatcher& mediaQueryMatcher();
 249
 250     void mediaQueryAffectingValueChanged();
 251
 252 #if !ENABLE(OILPAN)
 253     using ContainerNode::ref;
 254     using ContainerNode::deref;
 255 #endif
 256     using SecurityContext::securityOrigin;
 257     using SecurityContext::contentSecurityPolicy;
 258     using ExecutionContextClient::addConsoleMessage;
 259     using TreeScope::getElementById;
 260
 261     virtual bool canContainRangeEndPoint() const OVERRIDE { return true; }
 262
 263     SelectorQueryCache& selectorQueryCache();
 264
 265     // Focus Management.
 266     Element* activeElement() const;
 267     bool hasFocus() const;
 268
 269     // DOM methods & attributes for Document
 270
 271     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecopy);
 272     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforecut);
 273     DEFINE_ATTRIBUTE_EVENT_LISTENER(beforepaste);
 274     DEFINE_ATTRIBUTE_EVENT_LISTENER(copy);
 275     DEFINE_ATTRIBUTE_EVENT_LISTENER(cut);
 276     DEFINE_ATTRIBUTE_EVENT_LISTENER(paste);
 277     DEFINE_ATTRIBUTE_EVENT_LISTENER(pointerlockchange);
 278     DEFINE_ATTRIBUTE_EVENT_LISTENER(pointerlockerror);
 279     DEFINE_ATTRIBUTE_EVENT_LISTENER(readystatechange);
 280     DEFINE_ATTRIBUTE_EVENT_LISTENER(search);
 281     DEFINE_ATTRIBUTE_EVENT_LISTENER(securitypolicyviolation);
 282     DEFINE_ATTRIBUTE_EVENT_LISTENER(selectionchange);
 283     DEFINE_ATTRIBUTE_EVENT_LISTENER(selectstart);
 284     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchcancel);
 285     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchend);
 286     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchmove);
 287     DEFINE_ATTRIBUTE_EVENT_LISTENER(touchstart);
 288     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenchange);
 289     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitfullscreenerror);
 290     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitpointerlockchange);
 291     DEFINE_ATTRIBUTE_EVENT_LISTENER(webkitpointerlockerror);
 292     DEFINE_ATTRIBUTE_EVENT_LISTENER(wheel);
 293
 294     bool shouldMergeWithLegacyDescription(ViewportDescription::Type);
 295     bool shouldOverrideLegacyDescription(ViewportDescription::Type);
 296     void setViewportDescription(const ViewportDescription&);
 297     const ViewportDescription& viewportDescription() const { return m_viewportDescription; }
 298     Length viewportDefaultMinWidth() const { return m_viewportDefaultMinWidth; }
 299
 300 #ifndef NDEBUG
 301     bool didDispatchViewportPropertiesChanged() const { return m_didDispatchViewportPropertiesChanged; }
 302 #endif
 303     bool hasLegacyViewportTag() const { return m_legacyViewportDescription.isLegacyViewportType(); }
 304
 305     void setReferrerPolicy(ReferrerPolicy);
 306     ReferrerPolicy referrerPolicy() const { return m_referrerPolicy; }
 307
 308     String outgoingReferrer();
 309     String outgoingOrigin() const;
 310
 311     void setDoctype(PassRefPtrWillBeRawPtr<DocumentType>);
 312     DocumentType* doctype() const { return m_docType.get(); }
 313
 314     DOMImplementation& implementation();
 315
 316     Element* documentElement() const
 317     {
 318         return m_documentElement.get();
 319     }
 320
 321     // Returns whether the Document has an AppCache manifest.
 322     bool hasAppCacheManifest() const;
 323
 324     Location* location() const;
 325
 326     PassRefPtrWillBeRawPtr<Element> createElement(const AtomicString& name, ExceptionState&);
 327     PassRefPtrWillBeRawPtr<DocumentFragment> createDocumentFragment();
 328     PassRefPtrWillBeRawPtr<Text> createTextNode(const String& data);
 329     PassRefPtrWillBeRawPtr<Comment> createComment(const String& data);
 330     PassRefPtrWillBeRawPtr<CDATASection> createCDATASection(const String& data, ExceptionState&);
 331     PassRefPtrWillBeRawPtr<ProcessingInstruction> createProcessingInstruction(const String& target, const String& data, ExceptionState&);
 332     PassRefPtrWillBeRawPtr<Attr> createAttribute(const AtomicString& name, ExceptionState&);
 333     PassRefPtrWillBeRawPtr<Attr> createAttributeNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, ExceptionState&, bool shouldIgnoreNamespaceChecks = false);
 334     PassRefPtrWillBeRawPtr<Node> importNode(Node* importedNode, ExceptionState&);
 335     PassRefPtrWillBeRawPtr<Node> importNode(Node* importedNode, bool deep, ExceptionState&);
 336     PassRefPtrWillBeRawPtr<Element> createElementNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, ExceptionState&);
 337     PassRefPtrWillBeRawPtr<Element> createElement(const QualifiedName&, bool createdByParser);
 338
 339     bool regionBasedColumnsEnabled() const;
 340
 341     Element* elementFromPoint(int x, int y) const;
 342     PassRefPtrWillBeRawPtr<Range> caretRangeFromPoint(int x, int y);
 343
 344     String readyState() const;
 345
 346     String defaultCharset() const;
 347
 348     AtomicString inputEncoding() const { return Document::encodingName(); }
 349     AtomicString charset() const { return Document::encodingName(); }
 350     AtomicString characterSet() const { return Document::encodingName(); }
 351
 352     AtomicString encodingName() const;
 353
 354     void setCharset(const String&);
 355
 356     void setContent(const String&);
 357
 358     String suggestedMIMEType() const;
 359     void setMimeType(const AtomicString&);
 360     AtomicString contentType() const; // DOM 4 document.contentType
 361
 362     const AtomicString& contentLanguage() const { return m_contentLanguage; }
 363     void setContentLanguage(const AtomicString&);
 364
 365     String xmlEncoding() const { return m_xmlEncoding; }
 366     String xmlVersion() const { return m_xmlVersion; }
 367     enum StandaloneStatus { StandaloneUnspecified, Standalone, NotStandalone };
 368     bool xmlStandalone() const { return m_xmlStandalone == Standalone; }
 369     StandaloneStatus xmlStandaloneStatus() const { return static_cast<StandaloneStatus>(m_xmlStandalone); }
 370     bool hasXMLDeclaration() const { return m_hasXMLDeclaration; }
 371
 372     void setXMLEncoding(const String& encoding) { m_xmlEncoding = encoding; } // read-only property, only to be set from XMLDocumentParser
 373     void setXMLVersion(const String&, ExceptionState&);
 374     void setXMLStandalone(bool, ExceptionState&);
 375     void setHasXMLDeclaration(bool hasXMLDeclaration) { m_hasXMLDeclaration = hasXMLDeclaration ? 1 : 0; }
 376
 377     virtual KURL baseURI() const OVERRIDE FINAL;
 378
 379     String visibilityState() const;
 380     bool hidden() const;
 381     void didChangeVisibilityState();
 382
 383     PassRefPtrWillBeRawPtr<Node> adoptNode(PassRefPtrWillBeRawPtr<Node> source, ExceptionState&);
 384
 385     PassRefPtrWillBeRawPtr<HTMLCollection> images();
 386     PassRefPtrWillBeRawPtr<HTMLCollection> embeds();
 387     PassRefPtrWillBeRawPtr<HTMLCollection> applets();
 388     PassRefPtrWillBeRawPtr<HTMLCollection> links();
 389     PassRefPtrWillBeRawPtr<HTMLCollection> forms();
 390     PassRefPtrWillBeRawPtr<HTMLCollection> anchors();
 391     PassRefPtrWillBeRawPtr<HTMLCollection> scripts();
 392     PassRefPtrWillBeRawPtr<HTMLAllCollection> allForBinding();
 393     PassRefPtrWillBeRawPtr<HTMLAllCollection> all();
 394
 395     PassRefPtrWillBeRawPtr<HTMLCollection> windowNamedItems(const AtomicString& name);
 396     PassRefPtrWillBeRawPtr<HTMLCollection> documentNamedItems(const AtomicString& name);
 397
 398     bool isHTMLDocument() const { return m_documentClasses & HTMLDocumentClass; }
 399     bool isXHTMLDocument() const { return m_documentClasses & XHTMLDocumentClass; }
 400     bool isXMLDocument() const { return m_documentClasses & XMLDocumentClass; }
 401     bool isImageDocument() const { return m_documentClasses & ImageDocumentClass; }
 402     bool isSVGDocument() const { return m_documentClasses & SVGDocumentClass; }
 403     bool isPluginDocument() const { return m_documentClasses & PluginDocumentClass; }
 404     bool isMediaDocument() const { return m_documentClasses & MediaDocumentClass; }
 405
 406     bool hasSVGRootNode() const;
 407
 408     bool isFrameSet() const;
 409
 410     bool isSrcdocDocument() const { return m_isSrcdocDocument; }
 411     bool isMobileDocument() const { return m_isMobileDocument; }
 412
 413     bool isTransitionDocument() const { return m_isTransitionDocument; }
 414     void setIsTransitionDocument() { m_isTransitionDocument = true; }
 415
 416     StyleResolver* styleResolver() const;
 417     StyleResolver& ensureStyleResolver() const;
 418
 419     bool isViewSource() const { return m_isViewSource; }
 420     void setIsViewSource(bool);
 421
 422     bool sawElementsInKnownNamespaces() const { return m_sawElementsInKnownNamespaces; }
 423
 424     bool isRenderingReady() const { return haveImportsLoaded() && haveStylesheetsLoaded(); }
 425     bool isScriptExecutionReady() const { return isRenderingReady(); }
 426
 427     // This is a DOM function.
 428     StyleSheetList* styleSheets();
 429
 430     StyleEngine* styleEngine() { return m_styleEngine.get(); }
 431
 432     bool gotoAnchorNeededAfterStylesheetsLoad() { return m_gotoAnchorNeededAfterStylesheetsLoad; }
 433     void setGotoAnchorNeededAfterStylesheetsLoad(bool b) { m_gotoAnchorNeededAfterStylesheetsLoad = b; }
 434
 435     // Called when one or more stylesheets in the document may have been added, removed, or changed.
 436     void styleResolverChanged(StyleResolverUpdateMode = FullStyleUpdate);
 437     void styleResolverMayHaveChanged();
 438
 439     // FIXME: Switch all callers of styleResolverChanged to these or better ones and then make them
 440     // do something smarter.
 441     void removedStyleSheet(StyleSheet*, StyleResolverUpdateMode = FullStyleUpdate);
 442     void addedStyleSheet(StyleSheet*) { styleResolverChanged(); }
 443     void modifiedStyleSheet(StyleSheet*, StyleResolverUpdateMode = FullStyleUpdate);
 444     void changedSelectorWatch() { styleResolverChanged(); }
 445
 446     void scheduleUseShadowTreeUpdate(SVGUseElement&);
 447     void unscheduleUseShadowTreeUpdate(SVGUseElement&);
 448
 449     // FIXME: SVG filters should change to store the filter on the RenderStyle
 450     // instead of the RenderObject so we can get rid of this hack.
 451     void scheduleSVGFilterLayerUpdateHack(Element&);
 452     void unscheduleSVGFilterLayerUpdateHack(Element&);
 453
 454     void evaluateMediaQueryList();
 455
 456     FormController& formController();
 457     DocumentState* formElementsState() const;
 458     void setStateForNewFormElements(const Vector<String>&);
 459
 460     FrameView* view() const; // can be null
 461     LocalFrame* frame() const { return m_frame; } // can be null
 462     FrameHost* frameHost() const; // can be null
 463     Page* page() const; // can be null
 464     Settings* settings() const; // can be null
 465
 466     float devicePixelRatio() const;
 467
 468     PassRefPtrWillBeRawPtr<Range> createRange();
 469
 470     PassRefPtrWillBeRawPtr<NodeIterator> createNodeIterator(Node* root, ExceptionState&);
 471     PassRefPtrWillBeRawPtr<NodeIterator> createNodeIterator(Node* root, unsigned whatToShow, ExceptionState&);
 472     PassRefPtrWillBeRawPtr<NodeIterator> createNodeIterator(Node* root, unsigned whatToShow, PassRefPtrWillBeRawPtr<NodeFilter>, ExceptionState&);
 473
 474     PassRefPtrWillBeRawPtr<TreeWalker> createTreeWalker(Node* root, ExceptionState&);
 475     PassRefPtrWillBeRawPtr<TreeWalker> createTreeWalker(Node* root, unsigned whatToShow, ExceptionState&);
 476     PassRefPtrWillBeRawPtr<TreeWalker> createTreeWalker(Node* root, unsigned whatToShow, PassRefPtrWillBeRawPtr<NodeFilter>, ExceptionState&);
 477
 478     // Special support for editing
 479     PassRefPtrWillBeRawPtr<Text> createEditingTextNode(const String&);
 480
 481     void setupFontBuilder(RenderStyle* documentStyle);
 482
 483     void updateRenderTreeIfNeeded() { updateRenderTree(NoChange); }
 484     void updateRenderTreeForNodeIfNeeded(Node*);
 485     void updateLayout();
 486     enum RunPostLayoutTasks {
 487         RunPostLayoutTasksAsyhnchronously,
 488         RunPostLayoutTasksSynchronously,
 489     };
 490     void updateLayoutIgnorePendingStylesheets(RunPostLayoutTasks = RunPostLayoutTasksAsyhnchronously);
 491     PassRefPtr<RenderStyle> styleForElementIgnoringPendingStylesheets(Element*);
 492     PassRefPtr<RenderStyle> styleForPage(int pageIndex);
 493
 494     void updateDistributionForNodeIfNeeded(Node*);
 495
 496     // Returns true if page box (margin boxes and page borders) is visible.
 497     bool isPageBoxVisible(int pageIndex);
 498
 499     // Returns the preferred page size and margins in pixels, assuming 96
 500     // pixels per inch. pageSize, marginTop, marginRight, marginBottom,
 501     // marginLeft must be initialized to the default values that are used if
 502     // auto is specified.
 503     void pageSizeAndMarginsInPixels(int pageIndex, IntSize& pageSize, int& marginTop, int& marginRight, int& marginBottom, int& marginLeft);
 504
 505     ResourceFetcher* fetcher() { return m_fetcher.get(); }
 506
 507     virtual void attach(const AttachContext& = AttachContext()) OVERRIDE;
 508     virtual void detach(const AttachContext& = AttachContext()) OVERRIDE;
 509     void prepareForDestruction();
 510
 511     // If you have a Document, use renderView() instead which is faster.
 512     void renderer() const WTF_DELETED_FUNCTION;
 513
 514     RenderView* renderView() const { return m_renderView; }
 515
 516     AXObjectCache* existingAXObjectCache() const;
 517     AXObjectCache* axObjectCache() const;
 518     void clearAXObjectCache();
 519
 520     // to get visually ordered hebrew and arabic pages right
 521     bool visuallyOrdered() const { return m_visuallyOrdered; }
 522
 523     DocumentLoader* loader() const;
 524
 525     void open(Document* ownerDocument = 0, ExceptionState& = ASSERT_NO_EXCEPTION);
 526     PassRefPtrWillBeRawPtr<DocumentParser> implicitOpen();
 527
 528     // close() is the DOM API document.close()
 529     void close(ExceptionState& = ASSERT_NO_EXCEPTION);
 530     // In some situations (see the code), we ignore document.close().
 531     // explicitClose() bypass these checks and actually tries to close the
 532     // input stream.
 533     void explicitClose();
 534     // implicitClose() actually does the work of closing the input stream.
 535     void implicitClose();
 536
 537     bool dispatchBeforeUnloadEvent(Chrome&, bool&);
 538     void dispatchUnloadEvents();
 539
 540     enum PageDismissalType {
 541         NoDismissal = 0,
 542         BeforeUnloadDismissal = 1,
 543         PageHideDismissal = 2,
 544         UnloadDismissal = 3
 545     };
 546     PageDismissalType pageDismissalEventBeingDispatched() const;
 547
 548     void cancelParsing();
 549
 550     void write(const SegmentedString& text, Document* ownerDocument = 0, ExceptionState& = ASSERT_NO_EXCEPTION);
 551     void write(const String& text, Document* ownerDocument = 0, ExceptionState& = ASSERT_NO_EXCEPTION);
 552     void writeln(const String& text, Document* ownerDocument = 0, ExceptionState& = ASSERT_NO_EXCEPTION);
 553
 554     bool wellFormed() const { return m_wellFormed; }
 555
 556     const KURL& url() const { return m_url; }
 557     void setURL(const KURL&);
 558
 559     // To understand how these concepts relate to one another, please see the
 560     // comments surrounding their declaration.
 561     const KURL& baseURL() const { return m_baseURL; }
 562     void setBaseURLOverride(const KURL&);
 563     const KURL& baseURLOverride() const { return m_baseURLOverride; }
 564     const KURL& baseElementURL() const { return m_baseElementURL; }
 565     const AtomicString& baseTarget() const { return m_baseTarget; }
 566     void processBaseElement();
 567
 568     KURL completeURL(const String&) const;
 569     KURL completeURLWithOverride(const String&, const KURL& baseURLOverride) const;
 570
 571     virtual String userAgent(const KURL&) const OVERRIDE FINAL;
 572     virtual void disableEval(const String& errorMessage) OVERRIDE FINAL;
 573
 574     bool canNavigate(const Frame& targetFrame);
 575     LocalFrame* findUnsafeParentScrollPropagationBoundary();
 576
 577     CSSStyleSheet& elementSheet();
 578
 579     virtual PassRefPtrWillBeRawPtr<DocumentParser> createParser();
 580     DocumentParser* parser() const { return m_parser.get(); }
 581     ScriptableDocumentParser* scriptableDocumentParser() const;
 582
 583     bool printing() const { return m_printing; }
 584     void setPrinting(bool p) { m_printing = p; }
 585
 586     bool paginatedForScreen() const { return m_paginatedForScreen; }
 587     void setPaginatedForScreen(bool p) { m_paginatedForScreen = p; }
 588
 589     bool paginated() const { return printing() || paginatedForScreen(); }
 590
 591     enum CompatibilityMode { QuirksMode, LimitedQuirksMode, NoQuirksMode };
 592
 593     void setCompatibilityMode(CompatibilityMode m);
 594     CompatibilityMode compatibilityMode() const { return m_compatibilityMode; }
 595
 596     String compatMode() const;
 597
 598     bool inQuirksMode() const { return m_compatibilityMode == QuirksMode; }
 599     bool inLimitedQuirksMode() const { return m_compatibilityMode == LimitedQuirksMode; }
 600     bool inNoQuirksMode() const { return m_compatibilityMode == NoQuirksMode; }
 601
 602     enum ReadyState {
 603         Loading,
 604         Interactive,
 605         Complete
 606     };
 607     void setReadyState(ReadyState);
 608     bool isLoadCompleted();
 609
 610     void setParsing(bool);
 611     bool parsing() const { return m_isParsing; }
 612
 613     bool shouldScheduleLayout() const;
 614     int elapsedTime() const;
 615
 616     TextLinkColors& textLinkColors() { return m_textLinkColors; }
 617     VisitedLinkState& visitedLinkState() const { return *m_visitedLinkState; }
 618
 619     MouseEventWithHitTestResults prepareMouseEvent(const HitTestRequest&, const LayoutPoint&, const PlatformMouseEvent&);
 620
 621     /* Newly proposed CSS3 mechanism for selecting alternate
 622        stylesheets using the DOM. May be subject to change as
 623        spec matures. - dwh
 624     */
 625     String preferredStylesheetSet() const;
 626     String selectedStylesheetSet() const;
 627     void setSelectedStylesheetSet(const String&);
 628
 629     bool setFocusedElement(PassRefPtrWillBeRawPtr<Element>, FocusType = FocusTypeNone);
 630     Element* focusedElement() const { return m_focusedElement.get(); }
 631     UserActionElementSet& userActionElements()  { return m_userActionElements; }
 632     const UserActionElementSet& userActionElements() const { return m_userActionElements; }
 633     void setNeedsFocusedElementCheck();
 634     void setAutofocusElement(Element*);
 635     Element* autofocusElement() const { return m_autofocusElement.get(); }
 636
 637     void setActiveHoverElement(PassRefPtrWillBeRawPtr<Element>);
 638     Element* activeHoverElement() const { return m_activeHoverElement.get(); }
 639
 640     void removeFocusedElementOfSubtree(Node*, bool amongChildrenOnly = false);
 641     void hoveredNodeDetached(Node*);
 642     void activeChainNodeDetached(Node*);
 643
 644     void updateHoverActiveState(const HitTestRequest&, Element*, const PlatformMouseEvent* = 0);
 645
 646     // Updates for :target (CSS3 selector).
 647     void setCSSTarget(Element*);
 648     Element* cssTarget() const { return m_cssTarget; }
 649
 650     void scheduleRenderTreeUpdateIfNeeded();
 651     bool hasPendingForcedStyleRecalc() const;
 652
 653     void registerNodeList(const LiveNodeListBase*);
 654     void unregisterNodeList(const LiveNodeListBase*);
 655     void registerNodeListWithIdNameCache(const LiveNodeListBase*);
 656     void unregisterNodeListWithIdNameCache(const LiveNodeListBase*);
 657     bool shouldInvalidateNodeListCaches(const QualifiedName* attrName = 0) const;
 658     void invalidateNodeListCaches(const QualifiedName* attrName);
 659
 660     void attachNodeIterator(NodeIterator*);
 661     void detachNodeIterator(NodeIterator*);
 662     void moveNodeIteratorsToNewDocument(Node&, Document&);
 663
 664     void attachRange(Range*);
 665     void detachRange(Range*);
 666
 667     void updateRangesAfterChildrenChanged(ContainerNode*);
 668     void updateRangesAfterNodeMovedToAnotherDocument(const Node&);
 669     // nodeChildrenWillBeRemoved is used when removing all node children at once.
 670     void nodeChildrenWillBeRemoved(ContainerNode&);
 671     // nodeWillBeRemoved is only safe when removing one node at a time.
 672     void nodeWillBeRemoved(Node&);
 673     bool canReplaceChild(const Node& newChild, const Node& oldChild) const;
 674
 675     void didInsertText(Node*, unsigned offset, unsigned length);
 676     void didRemoveText(Node*, unsigned offset, unsigned length);
 677     void didMergeTextNodes(Text& oldNode, unsigned offset);
 678     void didSplitTextNode(Text& oldNode);
 679
 680     void clearDOMWindow() { m_domWindow = nullptr; }
 681     LocalDOMWindow* domWindow() const { return m_domWindow; }
 682
 683     // Helper functions for forwarding LocalDOMWindow event related tasks to the LocalDOMWindow if it exists.
 684     void setWindowAttributeEventListener(const AtomicString& eventType, PassRefPtr<EventListener>);
 685     EventListener* getWindowAttributeEventListener(const AtomicString& eventType);
 686
 687     static void registerEventFactory(PassOwnPtr<EventFactoryBase>);
 688     static PassRefPtrWillBeRawPtr<Event> createEvent(const String& eventType, ExceptionState&);
 689
 690     // keep track of what types of event listeners are registered, so we don't
 691     // dispatch events unnecessarily
 692     enum ListenerType {
 693         DOMSUBTREEMODIFIED_LISTENER          = 1,
 694         DOMNODEINSERTED_LISTENER             = 1 << 1,
 695         DOMNODEREMOVED_LISTENER              = 1 << 2,
 696         DOMNODEREMOVEDFROMDOCUMENT_LISTENER  = 1 << 3,
 697         DOMNODEINSERTEDINTODOCUMENT_LISTENER = 1 << 4,
 698         DOMCHARACTERDATAMODIFIED_LISTENER    = 1 << 5,
 699         OVERFLOWCHANGED_LISTENER             = 1 << 6,
 700         ANIMATIONEND_LISTENER                = 1 << 7,
 701         ANIMATIONSTART_LISTENER              = 1 << 8,
 702         ANIMATIONITERATION_LISTENER          = 1 << 9,
 703         TRANSITIONEND_LISTENER               = 1 << 10,
 704         SCROLL_LISTENER                      = 1 << 12
 705         // 4 bits remaining
 706     };
 707
 708     bool hasListenerType(ListenerType listenerType) const { return (m_listenerTypes & listenerType); }
 709     void addListenerTypeIfNeeded(const AtomicString& eventType);
 710
 711     bool hasMutationObserversOfType(MutationObserver::MutationType type) const
 712     {
 713         return m_mutationObserverTypes & type;
 714     }
 715     bool hasMutationObservers() const { return m_mutationObserverTypes; }
 716     void addMutationObserverTypes(MutationObserverOptions types) { m_mutationObserverTypes |= types; }
 717
 718     CSSStyleDeclaration* getOverrideStyle(Element*, const String& pseudoElt);
 719
 720     /**
 721      * Handles a HTTP header equivalent set by a meta tag using <meta http-equiv="..." content="...">. This is called
 722      * when a meta tag is encountered during document parsing, and also when a script dynamically changes or adds a meta
 723      * tag. This enables scripts to use meta tags to perform refreshes and set expiry dates in addition to them being
 724      * specified in a HTML file.
 725      *
 726      * @param equiv The http header name (value of the meta tag's "equiv" attribute)
 727      * @param content The header value (value of the meta tag's "content" attribute)
 728      * @param inDocumentHeadElement Is the element in the document's <head> element?
 729      */
 730     void processHttpEquiv(const AtomicString& equiv, const AtomicString& content, bool inDocumentHeadElement);
 731     void updateViewportDescription();
 732     void processReferrerPolicy(const String& policy);
 733
 734     // Returns the owning element in the parent document.
 735     // Returns 0 if this is the top level document.
 736     HTMLFrameOwnerElement* ownerElement() const;
 737
 738     String title() const { return m_title; }
 739     void setTitle(const String&);
 740
 741     Element* titleElement() const { return m_titleElement.get(); }
 742     void setTitleElement(Element*);
 743     void removeTitle(Element* titleElement);
 744
 745     const AtomicString& dir();
 746     void setDir(const AtomicString&);
 747
 748     String cookie(ExceptionState&) const;
 749     void setCookie(const String&, ExceptionState&);
 750
 751     const AtomicString& referrer() const;
 752
 753     String domain() const;
 754     void setDomain(const String& newDomain, ExceptionState&);
 755
 756     String lastModified() const;
 757
 758     // The cookieURL is used to query the cookie database for this document's
 759     // cookies. For example, if the cookie URL is http://example.com, we'll
 760     // use the non-Secure cookies for example.com when computing
 761     // document.cookie.
 762     //
 763     // Q: How is the cookieURL different from the document's URL?
 764     // A: The two URLs are the same almost all the time.  However, if one
 765     //    document inherits the security context of another document, it
 766     //    inherits its cookieURL but not its URL.
 767     //
 768     const KURL& cookieURL() const { return m_cookieURL; }
 769     void setCookieURL(const KURL& url) { m_cookieURL = url; }
 770
 771     const KURL& firstPartyForCookies() const;
 772
 773     // The following implements the rule from HTML 4 for what valid names are.
 774     // To get this right for all the XML cases, we probably have to improve this or move it
 775     // and make it sensitive to the type of document.
 776     static bool isValidName(const String&);
 777
 778     // The following breaks a qualified name into a prefix and a local name.
 779     // It also does a validity check, and returns false if the qualified name
 780     // is invalid.  It also sets ExceptionCode when name is invalid.
 781     static bool parseQualifiedName(const AtomicString& qualifiedName, AtomicString& prefix, AtomicString& localName, ExceptionState&);
 782
 783     // Checks to make sure prefix and namespace do not conflict (per DOM Core 3)
 784     static bool hasValidNamespaceForElements(const QualifiedName&);
 785     static bool hasValidNamespaceForAttributes(const QualifiedName&);
 786
 787     HTMLElement* body() const;
 788     void setBody(PassRefPtrWillBeRawPtr<HTMLElement>, ExceptionState&);
 789
 790     HTMLHeadElement* head() const;
 791
 792     // Decide which element is to define the viewport's overflow policy. If |rootStyle| is set, use
 793     // that as the style for the root element, rather than obtaining it on our own. The reason for
 794     // this is that style may not have been associated with the elements yet - in which case it may
 795     // have been calculated on the fly (without associating it with the actual element) somewhere.
 796     Element* viewportDefiningElement(RenderStyle* rootStyle = 0) const;
 797
 798     DocumentMarkerController& markers() const { return *m_markers; }
 799
 800     bool directionSetOnDocumentElement() const { return m_directionSetOnDocumentElement; }
 801     bool writingModeSetOnDocumentElement() const { return m_writingModeSetOnDocumentElement; }
 802     void setDirectionSetOnDocumentElement(bool b) { m_directionSetOnDocumentElement = b; }
 803     void setWritingModeSetOnDocumentElement(bool b) { m_writingModeSetOnDocumentElement = b; }
 804
 805     bool execCommand(const String& command, bool userInterface = false, const String& value = String());
 806     bool queryCommandEnabled(const String& command);
 807     bool queryCommandIndeterm(const String& command);
 808     bool queryCommandState(const String& command);
 809     bool queryCommandSupported(const String& command);
 810     String queryCommandValue(const String& command);
 811
 812     KURL openSearchDescriptionURL();
 813
 814     // designMode support
 815     enum InheritedBool { off = false, on = true, inherit };
 816     void setDesignMode(InheritedBool value);
 817     InheritedBool getDesignMode() const;
 818     bool inDesignMode() const;
 819     String designMode() const;
 820     void setDesignMode(const String&);
 821
 822     Document* parentDocument() const;
 823     Document& topDocument() const;
 824     WeakPtrWillBeRawPtr<Document> contextDocument();
 825
 826     ScriptRunner* scriptRunner() { return m_scriptRunner.get(); }
 827
 828     HTMLScriptElement* currentScript() const { return !m_currentScriptStack.isEmpty() ? m_currentScriptStack.last().get() : 0; }
 829     void pushCurrentScript(PassRefPtrWillBeRawPtr<HTMLScriptElement>);
 830     void popCurrentScript();
 831
 832     void applyXSLTransform(ProcessingInstruction* pi);
 833     PassRefPtrWillBeRawPtr<Document> transformSourceDocument() { return m_transformSourceDocument; }
 834     void setTransformSourceDocument(Document* doc) { m_transformSourceDocument = doc; }
 835
 836     void setTransformSource(PassOwnPtr<TransformSource>);
 837     TransformSource* transformSource() const { return m_transformSource.get(); }
 838
 839     void incDOMTreeVersion() { ASSERT(m_lifecycle.stateAllowsTreeMutations()); m_domTreeVersion = ++s_globalTreeVersion; }
 840     uint64_t domTreeVersion() const { return m_domTreeVersion; }
 841
 842     enum PendingSheetLayout { NoLayoutWithPendingSheets, DidLayoutWithPendingSheets, IgnoreLayoutWithPendingSheets };
 843
 844     bool didLayoutWithPendingStylesheets() const { return m_pendingSheetLayout == DidLayoutWithPendingSheets; }
 845     bool ignoreLayoutWithPendingStylesheets() const { return m_pendingSheetLayout == IgnoreLayoutWithPendingSheets; }
 846
 847     bool hasNodesWithPlaceholderStyle() const { return m_hasNodesWithPlaceholderStyle; }
 848     void setHasNodesWithPlaceholderStyle() { m_hasNodesWithPlaceholderStyle = true; }
 849
 850     Vector<IconURL> iconURLs(int iconTypesMask);
 851
 852     Color themeColor() const;
 853
 854     // Returns the HTMLLinkElement currently in use for the Web Manifest.
 855     // Returns null if there is no such element.
 856     HTMLLinkElement* linkManifest() const;
 857
 858     void setUseSecureKeyboardEntryWhenActive(bool);
 859     bool useSecureKeyboardEntryWhenActive() const;
 860
 861     void updateFocusAppearanceSoon(bool restorePreviousSelection);
 862     void cancelFocusAppearanceUpdate();
 863
 864     // Extension for manipulating canvas drawing contexts for use in CSS
 865     void getCSSCanvasContext(const String& type, const String& name, int width, int height, bool&, RefPtrWillBeRawPtr<CanvasRenderingContext2D>&, bool&, RefPtrWillBeRawPtr<WebGLRenderingContext>&);
 866     HTMLCanvasElement& getCSSCanvasElement(const String& name);
 867
 868     bool isDNSPrefetchEnabled() const { return m_isDNSPrefetchEnabled; }
 869     void parseDNSPrefetchControlHeader(const String&);
 870
 871     // FIXME(crbug.com/305497): This should be removed once LocalDOMWindow is an ExecutionContext.
 872     virtual void postTask(PassOwnPtr<ExecutionContextTask>) OVERRIDE; // Executes the task on context's thread asynchronously.
 873
 874     virtual void tasksWereSuspended() OVERRIDE FINAL;
 875     virtual void tasksWereResumed() OVERRIDE FINAL;
 876     virtual void suspendScheduledTasks() OVERRIDE FINAL;
 877     virtual void resumeScheduledTasks() OVERRIDE FINAL;
 878     virtual bool tasksNeedSuspension() OVERRIDE FINAL;
 879
 880     void finishedParsing();
 881
 882     void setEncodingData(const DocumentEncodingData& newData);
 883     const WTF::TextEncoding& encoding() const { return m_encodingData.encoding(); }
 884
 885     bool encodingWasDetectedHeuristically() const { return m_encodingData.wasDetectedHeuristically(); }
 886     bool sawDecodingError() const { return m_encodingData.sawDecodingError(); }
 887
 888     void setAnnotatedRegionsDirty(bool f) { m_annotatedRegionsDirty = f; }
 889     bool annotatedRegionsDirty() const { return m_annotatedRegionsDirty; }
 890     bool hasAnnotatedRegions () const { return m_hasAnnotatedRegions; }
 891     void setHasAnnotatedRegions(bool f) { m_hasAnnotatedRegions = f; }
 892     const Vector<AnnotatedRegionValue>& annotatedRegions() const;
 893     void setAnnotatedRegions(const Vector<AnnotatedRegionValue>&);
 894
 895     virtual void removeAllEventListeners() OVERRIDE FINAL;
 896
 897     const SVGDocumentExtensions* svgExtensions();
 898     SVGDocumentExtensions& accessSVGExtensions();
 899
 900     void initSecurityContext();
 901     void initSecurityContext(const DocumentInit&);
 902     void initContentSecurityPolicy(const ContentSecurityPolicyResponseHeaders&);
 903
 904     bool allowInlineEventHandlers(Node*, EventListener*, const String& contextURL, const WTF::OrdinalNumber& contextLine);
 905     bool allowExecutingScripts(Node*);
 906
 907     void statePopped(PassRefPtr<SerializedScriptValue>);
 908
 909     enum LoadEventProgress {
 910         LoadEventNotRun,
 911         LoadEventTried,
 912         LoadEventInProgress,
 913         LoadEventCompleted,
 914         BeforeUnloadEventInProgress,
 915         BeforeUnloadEventCompleted,
 916         PageHideInProgress,
 917         UnloadEventInProgress,
 918         UnloadEventHandled
 919     };
 920     bool loadEventStillNeeded() const { return m_loadEventProgress == LoadEventNotRun; }
 921     bool processingLoadEvent() const { return m_loadEventProgress == LoadEventInProgress; }
 922     bool loadEventFinished() const { return m_loadEventProgress >= LoadEventCompleted; }
 923     bool unloadStarted() const { return m_loadEventProgress >= PageHideInProgress; }
 924
 925     void setContainsPlugins() { m_containsPlugins = true; }
 926     bool containsPlugins() const { return m_containsPlugins; }
 927
 928     virtual bool isContextThread() const OVERRIDE FINAL;
 929     virtual bool isJSExecutionForbidden() const OVERRIDE FINAL { return false; }
 930
 931     bool containsValidityStyleRules() const { return m_containsValidityStyleRules; }
 932     void setContainsValidityStyleRules() { m_containsValidityStyleRules = true; }
 933
 934     void enqueueResizeEvent();
 935     void enqueueScrollEventForNode(Node*);
 936     void enqueueAnimationFrameEvent(PassRefPtrWillBeRawPtr<Event>);
 937
 938     bool hasFullscreenElementStack() const { return m_hasFullscreenElementStack; }
 939     void setHasFullscreenElementStack() { m_hasFullscreenElementStack = true; }
 940
 941     void exitPointerLock();
 942     Element* pointerLockElement() const;
 943
 944     // Used to allow element that loads data without going through a FrameLoader to delay the 'load' event.
 945     void incrementLoadEventDelayCount() { ++m_loadEventDelayCount; }
 946     void decrementLoadEventDelayCount();
 947     void checkLoadEventSoon();
 948     bool isDelayingLoadEvent();
 949     void loadPluginsSoon();
 950
 951     PassRefPtrWillBeRawPtr<Touch> createTouch(LocalDOMWindow*, EventTarget*, int identifier, double pageX, double pageY, double screenX, double screenY, double radiusX, double radiusY, float rotationAngle, float force) const;
 952     PassRefPtrWillBeRawPtr<TouchList> createTouchList(WillBeHeapVector<RefPtrWillBeMember<Touch> >&) const;
 953
 954     const DocumentTiming& timing() const { return m_documentTiming; }
 955
 956     int requestAnimationFrame(PassOwnPtr<RequestAnimationFrameCallback>);
 957     void cancelAnimationFrame(int id);
 958     void serviceScriptedAnimations(double monotonicAnimationStartTime);
 959
 960     virtual EventTarget* errorEventTarget() OVERRIDE FINAL;
 961     virtual void logExceptionToConsole(const String& errorMessage, const String& sourceURL, int lineNumber, int columnNumber, PassRefPtrWillBeRawPtr<ScriptCallStack>) OVERRIDE FINAL;
 962
 963     void initDNSPrefetch();
 964
 965     bool hasTouchEventHandlers() const { return (m_touchEventTargets.get()) ? m_touchEventTargets->size() : false; }
 966
 967     // Called when a single touch event handler has been added or removed for a node.
 968     // The Node should always be in this Document, except for child Documents which report
 969     // themselves to their parent exactly once if they have any touch handlers.
 970     // Handlers added/removed from the LocalDOMWindow are reported as the Document.
 971     void didAddTouchEventHandler(Node*);
 972     void didRemoveTouchEventHandler(Node* handler) { didRemoveTouchEventHandler(handler, false); }
 973
 974     // Called whenever all touch event handlers have been removed for a node (such as when the
 975     // node itself is being removed from the document).
 976     void didClearTouchEventHandlers(Node* handler) { didRemoveTouchEventHandler(handler, true); }
 977
 978     const TouchEventTargetSet* touchEventTargets() const { return m_touchEventTargets.get(); }
 979
 980     bool isInDocumentWrite() { return m_writeRecursionDepth > 0; }
 981
 982     IntSize initialViewportSize() const;
 983
 984     // There are currently two parallel autosizing implementations: TextAutosizer and FastTextAutosizer.
 985     // See http://tinyurl.com/chromium-fast-autosizer for more details.
 986     TextAutosizer* textAutosizer();
 987     FastTextAutosizer* fastTextAutosizer();
 988
 989     PassRefPtrWillBeRawPtr<Element> createElement(const AtomicString& localName, const AtomicString& typeExtension, ExceptionState&);
 990     PassRefPtrWillBeRawPtr<Element> createElementNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, const AtomicString& typeExtension, ExceptionState&);
 991     ScriptValue registerElement(WebCore::ScriptState*, const AtomicString& name, ExceptionState&);
 992     ScriptValue registerElement(WebCore::ScriptState*, const AtomicString& name, const Dictionary& options, ExceptionState&, CustomElement::NameSet validNames = CustomElement::StandardNames);
 993     CustomElementRegistrationContext* registrationContext() { return m_registrationContext.get(); }
 994
 995     void setImportsController(HTMLImportsController*);
 996     HTMLImportsController* importsController() const { return m_importsController; }
 997     HTMLImportLoader* importLoader() const;
 998
 999     bool haveImportsLoaded() const;
1000     void didLoadAllImports();
1001
1002     void adjustFloatQuadsForScrollAndAbsoluteZoom(Vector<FloatQuad>&, RenderObject&);
1003     void adjustFloatRectForScrollAndAbsoluteZoom(FloatRect&, RenderObject&);
1004
1005     bool hasActiveParser();
1006     unsigned activeParserCount() { return m_activeParserCount; }
1007     void incrementActiveParserCount() { ++m_activeParserCount; }
1008     void decrementActiveParserCount();
1009
1010     void setContextFeatures(ContextFeatures&);
1011     ContextFeatures& contextFeatures() const { return *m_contextFeatures; }
1012
1013     ElementDataCache* elementDataCache() { return m_elementDataCache.get(); }
1014
1015     void didLoadAllScriptBlockingResources();
1016     void didRemoveAllPendingStylesheet();
1017     void clearStyleResolver();
1018
1019     bool inStyleRecalc() const { return m_lifecycle.state() == DocumentLifecycle::InStyleRecalc; }
1020
1021     // Return a Locale for the default locale if the argument is null or empty.
1022     Locale& getCachedLocale(const AtomicString& locale = nullAtom);
1023
1024     AnimationClock& animationClock() { return m_animationClock; }
1025     AnimationTimeline& timeline() const { return *m_timeline; }
1026     CompositorPendingAnimations& compositorPendingAnimations() { return m_compositorPendingAnimations; }
1027
1028     void addToTopLayer(Element*, const Element* before = 0);
1029     void removeFromTopLayer(Element*);
1030     const WillBeHeapVector<RefPtrWillBeMember<Element> >& topLayerElements() const { return m_topLayerElements; }
1031     HTMLDialogElement* activeModalDialog() const;
1032
1033     // A non-null m_templateDocumentHost implies that |this| was created by ensureTemplateDocument().
1034     bool isTemplateDocument() const { return !!m_templateDocumentHost; }
1035     Document& ensureTemplateDocument();
1036     Document* templateDocumentHost() { return m_templateDocumentHost; }
1037
1038     void didAssociateFormControl(Element*);
1039
1040     void addConsoleMessageWithRequestIdentifier(MessageSource, MessageLevel, const String& message, unsigned long requestIdentifier);
1041
1042     virtual LocalDOMWindow* executingWindow() OVERRIDE FINAL;
1043     LocalFrame* executingFrame();
1044
1045     DocumentLifecycleNotifier& lifecycleNotifier();
1046     DocumentLifecycle& lifecycle() { return m_lifecycle; }
1047     bool isActive() const { return m_lifecycle.isActive(); }
1048     bool isStopped() const { return m_lifecycle.state() == DocumentLifecycle::Stopped; }
1049     bool isDisposed() const { return m_lifecycle.state() == DocumentLifecycle::Disposed; }
1050
1051     enum HttpRefreshType {
1052         HttpRefreshFromHeader,
1053         HttpRefreshFromMetaTag
1054     };
1055     void maybeHandleHttpRefresh(const String&, HttpRefreshType);
1056
1057     void updateSecurityOrigin(PassRefPtr<SecurityOrigin>);
1058     PassOwnPtr<LifecycleNotifier<Document> > createLifecycleNotifier();
1059
1060     void setHasViewportUnits() { m_hasViewportUnits = true; }
1061     bool hasViewportUnits() const { return m_hasViewportUnits; }
1062     void notifyResizeForViewportUnits();
1063
1064     void registerVisibilityObserver(DocumentVisibilityObserver*);
1065     void unregisterVisibilityObserver(DocumentVisibilityObserver*);
1066
1067     void updateStyleInvalidationIfNeeded();
1068
1069     virtual void trace(Visitor*) OVERRIDE;
1070
1071     bool hasSVGFilterElementsRequiringLayerUpdate() const { return m_layerUpdateSVGFilterElements.size(); }
1072     void didRecalculateStyleForElement() { ++m_styleRecalcElementCounter; }
1073
1074 protected:
1075     Document(const DocumentInit&, DocumentClassFlags = DefaultDocumentClass);
1076
1077     virtual void didUpdateSecurityOrigin() OVERRIDE FINAL;
1078
1079     void clearXMLVersion() { m_xmlVersion = String(); }
1080
1081 #if !ENABLE(OILPAN)
1082     virtual void dispose() OVERRIDE;
1083 #endif
1084
1085     virtual PassRefPtrWillBeRawPtr<Document> cloneDocumentWithoutChildren();
1086
1087     bool importContainerNodeChildren(ContainerNode* oldContainerNode, PassRefPtrWillBeRawPtr<ContainerNode> newContainerNode, ExceptionState&);
1088     void lockCompatibilityMode() { m_compatibilityModeLocked = true; }
1089
1090 private:
1091     friend class Node;
1092     friend class IgnoreDestructiveWriteCountIncrementer;
1093
1094     ScriptedAnimationController& ensureScriptedAnimationController();
1095     virtual SecurityContext& securityContext() OVERRIDE FINAL { return *this; }
1096     virtual EventQueue* eventQueue() const OVERRIDE FINAL;
1097
1098     // FIXME: Rename the StyleRecalc state to RenderTreeUpdate.
1099     bool hasPendingStyleRecalc() const { return m_lifecycle.state() == DocumentLifecycle::VisualUpdatePending; }
1100
1101     bool shouldScheduleRenderTreeUpdate() const;
1102     void scheduleRenderTreeUpdate();
1103
1104     bool needsFullRenderTreeUpdate() const;
1105     bool needsRenderTreeUpdate() const;
1106
1107     void inheritHtmlAndBodyElementStyles(StyleRecalcChange);
1108
1109     bool dirtyElementsForLayerUpdate();
1110     void updateDistributionIfNeeded();
1111     void updateUseShadowTreesIfNeeded();
1112     void evaluateMediaQueryListIfNeeded();
1113
1114     void updateRenderTree(StyleRecalcChange);
1115     void updateStyle(StyleRecalcChange);
1116
1117     void detachParser();
1118
1119     void clearWeakMembers(Visitor*);
1120
1121     virtual bool isDocument() const OVERRIDE FINAL { return true; }
1122
1123     virtual void childrenChanged(bool changedByParser = false, Node* beforeChange = 0, Node* afterChange = 0, int childCountDelta = 0) OVERRIDE;
1124
1125     virtual String nodeName() const OVERRIDE FINAL;
1126     virtual NodeType nodeType() const OVERRIDE FINAL;
1127     virtual bool childTypeAllowed(NodeType) const OVERRIDE FINAL;
1128     virtual PassRefPtrWillBeRawPtr<Node> cloneNode(bool deep = true) OVERRIDE FINAL;
1129     void cloneDataFromDocument(const Document&);
1130
1131 #if !ENABLE(OILPAN)
1132     virtual void refExecutionContext() OVERRIDE FINAL { ref(); }
1133     virtual void derefExecutionContext() OVERRIDE FINAL { deref(); }
1134 #endif
1135
1136     virtual const KURL& virtualURL() const OVERRIDE FINAL; // Same as url(), but needed for ExecutionContext to implement it without a performance loss for direct calls.
1137     virtual KURL virtualCompleteURL(const String&) const OVERRIDE FINAL; // Same as completeURL() for the same reason as above.
1138
1139     virtual void reportBlockedScriptExecutionToInspector(const String& directiveText) OVERRIDE FINAL;
1140     virtual void addMessage(MessageSource, MessageLevel, const String& message, const String& sourceURL, unsigned lineNumber, ScriptState*) OVERRIDE FINAL;
1141     void internalAddMessage(MessageSource, MessageLevel, const String& message, const String& sourceURL, unsigned lineNumber, PassRefPtrWillBeRawPtr<ScriptCallStack>, ScriptState*);
1142
1143     virtual double timerAlignmentInterval() const OVERRIDE FINAL;
1144
1145     void updateTitle(const String&);
1146     void updateFocusAppearanceTimerFired(Timer<Document>*);
1147     void updateBaseURL();
1148
1149     void executeScriptsWaitingForResourcesTimerFired(Timer<Document>*);
1150
1151     void loadEventDelayTimerFired(Timer<Document>*);
1152     void pluginLoadingTimerFired(Timer<Document>*);
1153
1154     PageVisibilityState pageVisibilityState() const;
1155
1156     PassRefPtrWillBeRawPtr<HTMLCollection> ensureCachedCollection(CollectionType);
1157
1158     // Note that dispatching a window load event may cause the LocalDOMWindow to be detached from
1159     // the LocalFrame, so callers should take a reference to the LocalDOMWindow (which owns us) to
1160     // prevent the Document from getting blown away from underneath them.
1161     void dispatchWindowLoadEvent();
1162
1163     void addListenerType(ListenerType listenerType) { m_listenerTypes |= listenerType; }
1164     void addMutationEventListenerTypeIfEnabled(ListenerType);
1165
1166     void didAssociateFormControlsTimerFired(Timer<Document>*);
1167
1168     void clearFocusedElementSoon();
1169     void clearFocusedElementTimerFired(Timer<Document>*);
1170
1171     void processHttpEquivDefaultStyle(const AtomicString& content);
1172     void processHttpEquivRefresh(const AtomicString& content);
1173     void processHttpEquivSetCookie(const AtomicString& content);
1174     void processHttpEquivXFrameOptions(const AtomicString& content);
1175     void processHttpEquivContentSecurityPolicy(const AtomicString& equiv, const AtomicString& content);
1176
1177     void didRemoveTouchEventHandler(Node*, bool clearAll);
1178
1179     bool haveStylesheetsLoaded() const;
1180
1181     void setHoverNode(PassRefPtrWillBeRawPtr<Node>);
1182     Node* hoverNode() const { return m_hoverNode.get(); }
1183
1184     typedef HashSet<OwnPtr<EventFactoryBase> > EventFactorySet;
1185     static EventFactorySet& eventFactories();
1186
1187     DocumentLifecycle m_lifecycle;
1188
1189     bool m_hasNodesWithPlaceholderStyle;
1190     bool m_evaluateMediaQueriesOnStyleRecalc;
1191
1192     // If we do ignore the pending stylesheet count, then we need to add a boolean
1193     // to track that this happened so that we can do a full repaint when the stylesheets
1194     // do eventually load.
1195     PendingSheetLayout m_pendingSheetLayout;
1196
1197     LocalFrame* m_frame;
1198     RawPtrWillBeMember<LocalDOMWindow> m_domWindow;
1199     // FIXME: oilpan: when we get rid of the transition types change the
1200     // HTMLImportsController to not be a DocumentSupplement since it is
1201     // redundant with oilpan.
1202     RawPtrWillBeMember<HTMLImportsController> m_importsController;
1203
1204     RefPtrWillBeMember<ResourceFetcher> m_fetcher;
1205     RefPtrWillBeMember<DocumentParser> m_parser;
1206     unsigned m_activeParserCount;
1207     RefPtrWillBeMember<ContextFeatures> m_contextFeatures;
1208
1209     bool m_wellFormed;
1210
1211     // Document URLs.
1212     KURL m_url; // Document.URL: The URL from which this document was retrieved.
1213     KURL m_baseURL; // Node.baseURI: The URL to use when resolving relative URLs.
1214     KURL m_baseURLOverride; // An alternative base URL that takes precedence over m_baseURL (but not m_baseElementURL).
1215     KURL m_baseElementURL; // The URL set by the <base> element.
1216     KURL m_cookieURL; // The URL to use for cookie access.
1217
1218     AtomicString m_baseTarget;
1219
1220     // Mime-type of the document in case it was cloned or created by XHR.
1221     AtomicString m_mimeType;
1222
1223     RefPtrWillBeMember<DocumentType> m_docType;
1224     OwnPtrWillBeMember<DOMImplementation> m_implementation;
1225
1226     RefPtrWillBeMember<CSSStyleSheet> m_elemSheet;
1227
1228     bool m_printing;
1229     bool m_paginatedForScreen;
1230
1231     CompatibilityMode m_compatibilityMode;
1232     bool m_compatibilityModeLocked; // This is cheaper than making setCompatibilityMode virtual.
1233
1234     Timer<Document> m_executeScriptsWaitingForResourcesTimer;
1235
1236     bool m_hasAutofocused;
1237     Timer<Document> m_clearFocusedElementTimer;
1238     RefPtrWillBeMember<Element> m_autofocusElement;
1239     RefPtrWillBeMember<Element> m_focusedElement;
1240     RefPtrWillBeMember<Node> m_hoverNode;
1241     RefPtrWillBeMember<Element> m_activeHoverElement;
1242     RefPtrWillBeMember<Element> m_documentElement;
1243     UserActionElementSet m_userActionElements;
1244
1245     uint64_t m_domTreeVersion;
1246     static uint64_t s_globalTreeVersion;
1247
1248     WillBeHeapHashSet<RawPtrWillBeWeakMember<NodeIterator> > m_nodeIterators;
1249     typedef WillBeHeapHashSet<RawPtrWillBeWeakMember<Range> > AttachedRangeSet;
1250     AttachedRangeSet m_ranges;
1251
1252     unsigned short m_listenerTypes;
1253
1254     MutationObserverOptions m_mutationObserverTypes;
1255
1256     OwnPtrWillBeMember<StyleEngine> m_styleEngine;
1257     RefPtrWillBeMember<StyleSheetList> m_styleSheetList;
1258
1259     OwnPtrWillBeMember<FormController> m_formController;
1260
1261     TextLinkColors m_textLinkColors;
1262     const OwnPtr<VisitedLinkState> m_visitedLinkState;
1263
1264     bool m_visuallyOrdered;
1265     ReadyState m_readyState;
1266     bool m_isParsing;
1267
1268     bool m_gotoAnchorNeededAfterStylesheetsLoad;
1269     bool m_isDNSPrefetchEnabled;
1270     bool m_haveExplicitlyDisabledDNSPrefetch;
1271     bool m_containsValidityStyleRules;
1272     bool m_updateFocusAppearanceRestoresSelection;
1273     bool m_containsPlugins;
1274
1275     // http://www.whatwg.org/specs/web-apps/current-work/#ignore-destructive-writes-counter
1276     unsigned m_ignoreDestructiveWriteCount;
1277
1278     String m_title;
1279     String m_rawTitle;
1280     RefPtrWillBeMember<Element> m_titleElement;
1281
1282     OwnPtr<AXObjectCache> m_axObjectCache;
1283     OwnPtrWillBeMember<DocumentMarkerController> m_markers;
1284
1285     Timer<Document> m_updateFocusAppearanceTimer;
1286
1287     RawPtrWillBeMember<Element> m_cssTarget;
1288
1289     LoadEventProgress m_loadEventProgress;
1290
1291     double m_startTime;
1292
1293     OwnPtrWillBeMember<ScriptRunner> m_scriptRunner;
1294
1295     WillBeHeapVector<RefPtrWillBeMember<HTMLScriptElement> > m_currentScriptStack;
1296
1297     OwnPtr<TransformSource> m_transformSource;
1298     RefPtrWillBeMember<Document> m_transformSourceDocument;
1299
1300     String m_xmlEncoding;
1301     String m_xmlVersion;
1302     unsigned m_xmlStandalone : 2;
1303     unsigned m_hasXMLDeclaration : 1;
1304
1305     AtomicString m_contentLanguage;
1306
1307     DocumentEncodingData m_encodingData;
1308
1309     InheritedBool m_designMode;
1310
1311     WillBeHeapHashSet<RawPtrWillBeWeakMember<const LiveNodeListBase> > m_listsInvalidatedAtDocument;
1312 #if ENABLE(OILPAN)
1313     // Oilpan keeps track of all registered NodeLists.
1314     //
1315     // FIXME: Oilpan: improve - only need to know if a NodeList
1316     // is currently alive or not for the different types.
1317     HeapHashSet<WeakMember<const LiveNodeListBase> > m_nodeLists[numNodeListInvalidationTypes];
1318 #else
1319     unsigned m_nodeListCounts[numNodeListInvalidationTypes];
1320 #endif
1321
1322     OwnPtrWillBeMember<SVGDocumentExtensions> m_svgExtensions;
1323
1324     Vector<AnnotatedRegionValue> m_annotatedRegions;
1325     bool m_hasAnnotatedRegions;
1326     bool m_annotatedRegionsDirty;
1327
1328     WillBeHeapHashMap<String, RefPtrWillBeMember<HTMLCanvasElement> > m_cssCanvasElements;
1329
1330     OwnPtr<SelectorQueryCache> m_selectorQueryCache;
1331
1332     bool m_useSecureKeyboardEntryWhenActive;
1333
1334     DocumentClassFlags m_documentClasses;
1335
1336     bool m_isViewSource;
1337     bool m_sawElementsInKnownNamespaces;
1338     bool m_isSrcdocDocument;
1339     bool m_isMobileDocument;
1340     bool m_isTransitionDocument;
1341
1342     RenderView* m_renderView;
1343
1344 #if !ENABLE(OILPAN)
1345     WeakPtrFactory<Document> m_weakFactory;
1346 #endif
1347     WeakPtrWillBeWeakMember<Document> m_contextDocument;
1348
1349     bool m_hasFullscreenElementStack; // For early return in FullscreenElementStack::fromIfExists()
1350
1351     WillBeHeapVector<RefPtrWillBeMember<Element> > m_topLayerElements;
1352
1353     int m_loadEventDelayCount;
1354     Timer<Document> m_loadEventDelayTimer;
1355     Timer<Document> m_pluginLoadingTimer;
1356
1357     ViewportDescription m_viewportDescription;
1358     ViewportDescription m_legacyViewportDescription;
1359     Length m_viewportDefaultMinWidth;
1360
1361     bool m_didSetReferrerPolicy;
1362     ReferrerPolicy m_referrerPolicy;
1363
1364     bool m_directionSetOnDocumentElement;
1365     bool m_writingModeSetOnDocumentElement;
1366     DocumentTiming m_documentTiming;
1367     RefPtrWillBeMember<MediaQueryMatcher> m_mediaQueryMatcher;
1368     bool m_writeRecursionIsTooDeep;
1369     unsigned m_writeRecursionDepth;
1370
1371     OwnPtr<TouchEventTargetSet> m_touchEventTargets;
1372
1373     RefPtrWillBeMember<ScriptedAnimationController> m_scriptedAnimationController;
1374     OwnPtr<MainThreadTaskRunner> m_taskRunner;
1375     OwnPtr<TextAutosizer> m_textAutosizer;
1376     OwnPtr<FastTextAutosizer> m_fastTextAutosizer;
1377
1378     RefPtrWillBeMember<CustomElementRegistrationContext> m_registrationContext;
1379
1380     void elementDataCacheClearTimerFired(Timer<Document>*);
1381     Timer<Document> m_elementDataCacheClearTimer;
1382
1383     OwnPtr<ElementDataCache> m_elementDataCache;
1384
1385 #ifndef NDEBUG
1386     bool m_didDispatchViewportPropertiesChanged;
1387 #endif
1388
1389     typedef HashMap<AtomicString, OwnPtr<Locale> > LocaleIdentifierToLocaleMap;
1390     LocaleIdentifierToLocaleMap m_localeCache;
1391
1392     AnimationClock m_animationClock;
1393     RefPtrWillBeMember<AnimationTimeline> m_timeline;
1394     CompositorPendingAnimations m_compositorPendingAnimations;
1395
1396     RefPtrWillBeMember<Document> m_templateDocument;
1397     // With Oilpan the templateDocument and the templateDocumentHost
1398     // live and die together. Without Oilpan, the templateDocumentHost
1399     // is a manually managed backpointer from m_templateDocument.
1400     RawPtrWillBeMember<Document> m_templateDocumentHost;
1401
1402     Timer<Document> m_didAssociateFormControlsTimer;
1403     WillBeHeapHashSet<RefPtrWillBeMember<Element> > m_associatedFormControls;
1404
1405     WillBeHeapHashSet<RawPtrWillBeMember<SVGUseElement> > m_useElementsNeedingUpdate;
1406     WillBeHeapHashSet<RawPtrWillBeMember<Element> > m_layerUpdateSVGFilterElements;
1407
1408     bool m_hasViewportUnits;
1409
1410     typedef WillBeHeapHashSet<RawPtrWillBeWeakMember<DocumentVisibilityObserver> > DocumentVisibilityObserverSet;
1411     DocumentVisibilityObserverSet m_visibilityObservers;
1412
1413     int m_styleRecalcElementCounter;
1414 };
1415
1416 inline bool Document::shouldOverrideLegacyDescription(ViewportDescription::Type origin)
1417 {
1418     // The different (legacy) meta tags have different priorities based on the type
1419     // regardless of which order they appear in the DOM. The priority is given by the
1420     // ViewportDescription::Type enum.
1421     return origin >= m_legacyViewportDescription.type;
1422 }
1423
1424 inline void Document::scheduleRenderTreeUpdateIfNeeded()
1425 {
1426     // Inline early out to avoid the function calls below.
1427     if (hasPendingStyleRecalc())
1428         return;
1429     if (shouldScheduleRenderTreeUpdate() && needsRenderTreeUpdate())
1430         scheduleRenderTreeUpdate();
1431 }
1432
1433 DEFINE_TYPE_CASTS(Document, ExecutionContextClient, client, client->isDocument(), client.isDocument());
1434 DEFINE_TYPE_CASTS(Document, ExecutionContext, context, context->isDocument(), context.isDocument());
1435 DEFINE_NODE_TYPE_CASTS(Document, isDocumentNode());
1436
1437 #define DEFINE_DOCUMENT_TYPE_CASTS(thisType) \
1438     DEFINE_TYPE_CASTS(thisType, Document, document, document->is##thisType(), document.is##thisType())
1439
1440 // All these varations are needed to avoid ambiguous overloads with the Node and TreeScope versions.
1441 inline bool operator==(const Document& a, const Document& b) { return &a == &b; }
1442 inline bool operator==(const Document& a, const Document* b) { return &a == b; }
1443 inline bool operator==(const Document* a, const Document& b) { return a == &b; }
1444 inline bool operator!=(const Document& a, const Document& b) { return !(a == b); }
1445 inline bool operator!=(const Document& a, const Document* b) { return !(a == b); }
1446 inline bool operator!=(const Document* a, const Document& b) { return !(a == b); }
1447
1448 // Put these methods here, because they require the Document definition, but we really want to inline them.
1449
1450 inline bool Node::isDocumentNode() const
1451 {
1452     return this == document();
1453 }
1454
1455 Node* eventTargetNodeForDocument(Document*);
1456
1457 } // namespace WebCore
1458
1459 #endif // Document_h