Eliminate isMainThread() checks in most call sites of NoEventDispatchAssertion
[WebKit-https.git] / Source / WebCore / dom / Element.cpp
1 /*
2  * Copyright (C) 1999 Lars Knoll (knoll@kde.org)
3  *           (C) 1999 Antti Koivisto (koivisto@kde.org)
4  *           (C) 2001 Peter Kelly (pmk@post.com)
5  *           (C) 2001 Dirk Mueller (mueller@kde.org)
6  *           (C) 2007 David Smith (catfish.man@gmail.com)
7  * Copyright (C) 2004-2017 Apple Inc. All rights reserved.
8  *           (C) 2007 Eric Seidel (eric@webkit.org)
9  *
10  * This library is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Library General Public
12  * License as published by the Free Software Foundation; either
13  * version 2 of the License, or (at your option) any later version.
14  *
15  * This library is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18  * Library General Public License for more details.
19  *
20  * You should have received a copy of the GNU Library General Public License
21  * along with this library; see the file COPYING.LIB.  If not, write to
22  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23  * Boston, MA 02110-1301, USA.
24  */
25
26 #include "config.h"
27 #include "Element.h"
28
29 #include "AXObjectCache.h"
30 #include "Attr.h"
31 #include "AttributeChangeInvalidation.h"
32 #include "CSSAnimationController.h"
33 #include "CSSParser.h"
34 #include "Chrome.h"
35 #include "ChromeClient.h"
36 #include "ClassChangeInvalidation.h"
37 #include "ComposedTreeAncestorIterator.h"
38 #include "ContainerNodeAlgorithms.h"
39 #include "CustomElementReactionQueue.h"
40 #include "CustomElementRegistry.h"
41 #include "DOMRect.h"
42 #include "DOMRectList.h"
43 #include "DOMTokenList.h"
44 #include "DocumentSharedObjectPool.h"
45 #include "Editing.h"
46 #include "ElementIterator.h"
47 #include "ElementRareData.h"
48 #include "EventDispatcher.h"
49 #include "EventHandler.h"
50 #include "EventNames.h"
51 #include "FocusController.h"
52 #include "FocusEvent.h"
53 #include "FrameSelection.h"
54 #include "FrameView.h"
55 #include "HTMLBodyElement.h"
56 #include "HTMLCanvasElement.h"
57 #include "HTMLCollection.h"
58 #include "HTMLDocument.h"
59 #include "HTMLHtmlElement.h"
60 #include "HTMLLabelElement.h"
61 #include "HTMLNameCollection.h"
62 #include "HTMLObjectElement.h"
63 #include "HTMLOptGroupElement.h"
64 #include "HTMLOptionElement.h"
65 #include "HTMLParserIdioms.h"
66 #include "HTMLSelectElement.h"
67 #include "HTMLTemplateElement.h"
68 #include "IdChangeInvalidation.h"
69 #include "IdTargetObserverRegistry.h"
70 #include "InspectorInstrumentation.h"
71 #include "JSLazyEventListener.h"
72 #include "KeyboardEvent.h"
73 #include "MainFrame.h"
74 #include "MutationObserverInterestGroup.h"
75 #include "MutationRecord.h"
76 #include "NoEventDispatchAssertion.h"
77 #include "NodeRenderStyle.h"
78 #include "PlatformWheelEvent.h"
79 #include "PointerLockController.h"
80 #include "RenderFragmentContainer.h"
81 #include "RenderLayer.h"
82 #include "RenderListBox.h"
83 #include "RenderTheme.h"
84 #include "RenderTreeUpdater.h"
85 #include "RenderView.h"
86 #include "RenderWidget.h"
87 #include "SVGDocumentExtensions.h"
88 #include "SVGElement.h"
89 #include "SVGNames.h"
90 #include "SVGSVGElement.h"
91 #include "ScrollLatchingState.h"
92 #include "SelectorQuery.h"
93 #include "Settings.h"
94 #include "SimulatedClick.h"
95 #include "SlotAssignment.h"
96 #include "StyleProperties.h"
97 #include "StyleResolver.h"
98 #include "StyleScope.h"
99 #include "StyleTreeResolver.h"
100 #include "TextIterator.h"
101 #include "VoidCallback.h"
102 #include "WheelEvent.h"
103 #include "XLinkNames.h"
104 #include "XMLNSNames.h"
105 #include "XMLNames.h"
106 #include "markup.h"
107 #include <wtf/CurrentTime.h>
108 #include <wtf/NeverDestroyed.h>
109 #include <wtf/text/CString.h>
110
111 namespace WebCore {
112
113 using namespace HTMLNames;
114 using namespace XMLNames;
115
116 static HashMap<Element*, Vector<RefPtr<Attr>>>& attrNodeListMap()
117 {
118     static NeverDestroyed<HashMap<Element*, Vector<RefPtr<Attr>>>> map;
119     return map;
120 }
121
122 static Vector<RefPtr<Attr>>* attrNodeListForElement(Element& element)
123 {
124     if (!element.hasSyntheticAttrChildNodes())
125         return nullptr;
126     ASSERT(attrNodeListMap().contains(&element));
127     return &attrNodeListMap().find(&element)->value;
128 }
129
130 static Vector<RefPtr<Attr>>& ensureAttrNodeListForElement(Element& element)
131 {
132     if (element.hasSyntheticAttrChildNodes()) {
133         ASSERT(attrNodeListMap().contains(&element));
134         return attrNodeListMap().find(&element)->value;
135     }
136     ASSERT(!attrNodeListMap().contains(&element));
137     element.setHasSyntheticAttrChildNodes(true);
138     return attrNodeListMap().add(&element, Vector<RefPtr<Attr>>()).iterator->value;
139 }
140
141 static void removeAttrNodeListForElement(Element& element)
142 {
143     ASSERT(element.hasSyntheticAttrChildNodes());
144     ASSERT(attrNodeListMap().contains(&element));
145     attrNodeListMap().remove(&element);
146     element.setHasSyntheticAttrChildNodes(false);
147 }
148
149 static Attr* findAttrNodeInList(Vector<RefPtr<Attr>>& attrNodeList, const QualifiedName& name)
150 {
151     for (auto& node : attrNodeList) {
152         if (node->qualifiedName().matches(name))
153             return node.get();
154     }
155     return nullptr;
156 }
157
158 static Attr* findAttrNodeInList(Vector<RefPtr<Attr>>& attrNodeList, const AtomicString& localName, bool shouldIgnoreAttributeCase)
159 {
160     const AtomicString& caseAdjustedName = shouldIgnoreAttributeCase ? localName.convertToASCIILowercase() : localName;
161     for (auto& node : attrNodeList) {
162         if (node->qualifiedName().localName() == caseAdjustedName)
163             return node.get();
164     }
165     return nullptr;
166 }
167
168 Ref<Element> Element::create(const QualifiedName& tagName, Document& document)
169 {
170     return adoptRef(*new Element(tagName, document, CreateElement));
171 }
172
173 Element::Element(const QualifiedName& tagName, Document& document, ConstructionType type)
174     : ContainerNode(document, type)
175     , m_tagName(tagName)
176 {
177 }
178
179 Element::~Element()
180 {
181     ASSERT(!beforePseudoElement());
182     ASSERT(!afterPseudoElement());
183
184     removeShadowRoot();
185
186     if (hasSyntheticAttrChildNodes())
187         detachAllAttrNodesFromElement();
188
189     if (hasPendingResources()) {
190         document().accessSVGExtensions().removeElementFromPendingResources(this);
191         ASSERT(!hasPendingResources());
192     }
193 }
194
195 inline ElementRareData* Element::elementRareData() const
196 {
197     ASSERT_WITH_SECURITY_IMPLICATION(hasRareData());
198     return static_cast<ElementRareData*>(rareData());
199 }
200
201 inline ElementRareData& Element::ensureElementRareData()
202 {
203     return static_cast<ElementRareData&>(ensureRareData());
204 }
205
206 void Element::clearTabIndexExplicitlyIfNeeded()
207 {
208     if (hasRareData())
209         elementRareData()->clearTabIndexExplicitly();
210 }
211
212 void Element::setTabIndexExplicitly(int tabIndex)
213 {
214     ensureElementRareData().setTabIndexExplicitly(tabIndex);
215 }
216
217 bool Element::tabIndexSetExplicitly() const
218 {
219     return hasRareData() && elementRareData()->tabIndexSetExplicitly();
220 }
221
222 bool Element::supportsFocus() const
223 {
224     return tabIndexSetExplicitly();
225 }
226
227 RefPtr<Element> Element::focusDelegate()
228 {
229     return this;
230 }
231
232 int Element::tabIndex() const
233 {
234     return hasRareData() ? elementRareData()->tabIndex() : 0;
235 }
236
237 void Element::setTabIndex(int value)
238 {
239     setIntegralAttribute(tabindexAttr, value);
240 }
241
242 bool Element::isKeyboardFocusable(KeyboardEvent&) const
243 {
244     return isFocusable() && tabIndex() >= 0;
245 }
246
247 bool Element::isMouseFocusable() const
248 {
249     return isFocusable();
250 }
251
252 bool Element::shouldUseInputMethod()
253 {
254     return computeEditability(UserSelectAllIsAlwaysNonEditable, ShouldUpdateStyle::Update) != Editability::ReadOnly;
255 }
256
257 static bool isForceEvent(const PlatformMouseEvent& platformEvent)
258 {
259     return platformEvent.type() == PlatformEvent::MouseForceChanged || platformEvent.type() == PlatformEvent::MouseForceDown || platformEvent.type() == PlatformEvent::MouseForceUp;
260 }
261
262 bool Element::dispatchMouseEvent(const PlatformMouseEvent& platformEvent, const AtomicString& eventType, int detail, Element* relatedTarget)
263 {
264     if (isDisabledFormControl())
265         return false;
266
267     if (isForceEvent(platformEvent) && !document().hasListenerTypeForEventType(platformEvent.type()))
268         return false;
269
270     Ref<MouseEvent> mouseEvent = MouseEvent::create(eventType, document().defaultView(), platformEvent, detail, relatedTarget);
271
272     if (mouseEvent->type().isEmpty())
273         return true; // Shouldn't happen.
274
275     ASSERT(!mouseEvent->target() || mouseEvent->target() != relatedTarget);
276     bool didNotSwallowEvent = dispatchEvent(mouseEvent) && !mouseEvent->defaultHandled();
277
278     if (mouseEvent->type() == eventNames().clickEvent && mouseEvent->detail() == 2) {
279         // Special case: If it's a double click event, we also send the dblclick event. This is not part
280         // of the DOM specs, but is used for compatibility with the ondblclick="" attribute. This is treated
281         // as a separate event in other DOM-compliant browsers like Firefox, and so we do the same.
282         Ref<MouseEvent> doubleClickEvent = MouseEvent::create(eventNames().dblclickEvent,
283             mouseEvent->bubbles(), mouseEvent->cancelable(), mouseEvent->view(), mouseEvent->detail(),
284             mouseEvent->screenX(), mouseEvent->screenY(), mouseEvent->clientX(), mouseEvent->clientY(),
285             mouseEvent->ctrlKey(), mouseEvent->altKey(), mouseEvent->shiftKey(), mouseEvent->metaKey(),
286             mouseEvent->button(), mouseEvent->buttons(), mouseEvent->syntheticClickType(), relatedTarget);
287
288         if (mouseEvent->defaultHandled())
289             doubleClickEvent->setDefaultHandled();
290
291         dispatchEvent(doubleClickEvent);
292         if (doubleClickEvent->defaultHandled() || doubleClickEvent->defaultPrevented())
293             return false;
294     }
295     return didNotSwallowEvent;
296 }
297
298
299 bool Element::dispatchWheelEvent(const PlatformWheelEvent& event)
300 {
301     Ref<WheelEvent> wheelEvent = WheelEvent::create(event, document().defaultView());
302
303     // Events with no deltas are important because they convey platform information about scroll gestures
304     // and momentum beginning or ending. However, those events should not be sent to the DOM since some
305     // websites will break. They need to be dispatched because dispatching them will call into the default
306     // event handler, and our platform code will correctly handle the phase changes. Calling stopPropogation()
307     // will prevent the event from being sent to the DOM, but will still call the default event handler.
308     if (!event.deltaX() && !event.deltaY())
309         wheelEvent->stopPropagation();
310
311     return EventDispatcher::dispatchEvent(*this, wheelEvent) && !wheelEvent->defaultHandled();
312 }
313
314 bool Element::dispatchKeyEvent(const PlatformKeyboardEvent& platformEvent)
315 {
316     Ref<KeyboardEvent> event = KeyboardEvent::create(platformEvent, document().defaultView());
317     if (Frame* frame = document().frame()) {
318         if (frame->eventHandler().accessibilityPreventsEventPropogation(event))
319             event->stopPropagation();
320     }
321     return EventDispatcher::dispatchEvent(*this, event) && !event->defaultHandled();
322 }
323
324 void Element::dispatchSimulatedClick(Event* underlyingEvent, SimulatedClickMouseEventOptions eventOptions, SimulatedClickVisualOptions visualOptions)
325 {
326     simulateClick(*this, underlyingEvent, eventOptions, visualOptions, SimulatedClickSource::UserAgent);
327 }
328
329 Ref<Node> Element::cloneNodeInternal(Document& targetDocument, CloningOperation type)
330 {
331     switch (type) {
332     case CloningOperation::OnlySelf:
333     case CloningOperation::SelfWithTemplateContent:
334         return cloneElementWithoutChildren(targetDocument);
335     case CloningOperation::Everything:
336         break;
337     }
338     return cloneElementWithChildren(targetDocument);
339 }
340
341 Ref<Element> Element::cloneElementWithChildren(Document& targetDocument)
342 {
343     Ref<Element> clone = cloneElementWithoutChildren(targetDocument);
344
345     // It's safe to dispatch events on the cloned node since author scripts have no access to it yet.
346     // This is needed for SVGUseElement::cloneTarget.
347     NoEventDispatchAssertion::EventAllowedScope allowedScope(clone.get());
348
349     cloneChildNodes(clone);
350     return clone;
351 }
352
353 Ref<Element> Element::cloneElementWithoutChildren(Document& targetDocument)
354 {
355     Ref<Element> clone = cloneElementWithoutAttributesAndChildren(targetDocument);
356
357     // It's safe to dispatch events on the cloned node since author scripts have no access to it yet.
358     // This is needed for SVGUseElement::cloneTarget.
359     NoEventDispatchAssertion::EventAllowedScope allowedScope(clone.get());
360
361     // This will catch HTML elements in the wrong namespace that are not correctly copied.
362     // This is a sanity check as HTML overloads some of the DOM methods.
363     ASSERT(isHTMLElement() == clone->isHTMLElement());
364
365     clone->cloneDataFromElement(*this);
366     return clone;
367 }
368
369 Ref<Element> Element::cloneElementWithoutAttributesAndChildren(Document& targetDocument)
370 {
371     return targetDocument.createElement(tagQName(), false);
372 }
373
374 Ref<Attr> Element::detachAttribute(unsigned index)
375 {
376     ASSERT(elementData());
377
378     const Attribute& attribute = elementData()->attributeAt(index);
379
380     RefPtr<Attr> attrNode = attrIfExists(attribute.name());
381     if (attrNode)
382         detachAttrNodeFromElementWithValue(attrNode.get(), attribute.value());
383     else
384         attrNode = Attr::create(document(), attribute.name(), attribute.value());
385
386     removeAttributeInternal(index, NotInSynchronizationOfLazyAttribute);
387     return attrNode.releaseNonNull();
388 }
389
390 bool Element::removeAttribute(const QualifiedName& name)
391 {
392     if (!elementData())
393         return false;
394
395     unsigned index = elementData()->findAttributeIndexByName(name);
396     if (index == ElementData::attributeNotFound)
397         return false;
398
399     removeAttributeInternal(index, NotInSynchronizationOfLazyAttribute);
400     return true;
401 }
402
403 void Element::setBooleanAttribute(const QualifiedName& name, bool value)
404 {
405     if (value)
406         setAttribute(name, emptyAtom());
407     else
408         removeAttribute(name);
409 }
410
411 NamedNodeMap& Element::attributes() const
412 {
413     ElementRareData& rareData = const_cast<Element*>(this)->ensureElementRareData();
414     if (NamedNodeMap* attributeMap = rareData.attributeMap())
415         return *attributeMap;
416
417     rareData.setAttributeMap(std::make_unique<NamedNodeMap>(const_cast<Element&>(*this)));
418     return *rareData.attributeMap();
419 }
420
421 Node::NodeType Element::nodeType() const
422 {
423     return ELEMENT_NODE;
424 }
425
426 bool Element::hasAttribute(const QualifiedName& name) const
427 {
428     return hasAttributeNS(name.namespaceURI(), name.localName());
429 }
430
431 void Element::synchronizeAllAttributes() const
432 {
433     if (!elementData())
434         return;
435     if (elementData()->styleAttributeIsDirty()) {
436         ASSERT(isStyledElement());
437         static_cast<const StyledElement*>(this)->synchronizeStyleAttributeInternal();
438     }
439
440     if (elementData()->animatedSVGAttributesAreDirty()) {
441         ASSERT(isSVGElement());
442         downcast<SVGElement>(*this).synchronizeAnimatedSVGAttribute(anyQName());
443     }
444 }
445
446 ALWAYS_INLINE void Element::synchronizeAttribute(const QualifiedName& name) const
447 {
448     if (!elementData())
449         return;
450     if (UNLIKELY(name == styleAttr && elementData()->styleAttributeIsDirty())) {
451         ASSERT_WITH_SECURITY_IMPLICATION(isStyledElement());
452         static_cast<const StyledElement*>(this)->synchronizeStyleAttributeInternal();
453         return;
454     }
455
456     if (UNLIKELY(elementData()->animatedSVGAttributesAreDirty())) {
457         ASSERT(isSVGElement());
458         downcast<SVGElement>(*this).synchronizeAnimatedSVGAttribute(name);
459     }
460 }
461
462 static ALWAYS_INLINE bool isStyleAttribute(const Element& element, const AtomicString& attributeLocalName)
463 {
464     if (shouldIgnoreAttributeCase(element))
465         return equalLettersIgnoringASCIICase(attributeLocalName, "style");
466     return attributeLocalName == styleAttr->localName();
467 }
468
469 ALWAYS_INLINE void Element::synchronizeAttribute(const AtomicString& localName) const
470 {
471     // This version of synchronizeAttribute() is streamlined for the case where you don't have a full QualifiedName,
472     // e.g when called from DOM API.
473     if (!elementData())
474         return;
475     if (elementData()->styleAttributeIsDirty() && isStyleAttribute(*this, localName)) {
476         ASSERT_WITH_SECURITY_IMPLICATION(isStyledElement());
477         static_cast<const StyledElement*>(this)->synchronizeStyleAttributeInternal();
478         return;
479     }
480     if (elementData()->animatedSVGAttributesAreDirty()) {
481         // We're not passing a namespace argument on purpose. SVGNames::*Attr are defined w/o namespaces as well.
482         ASSERT_WITH_SECURITY_IMPLICATION(isSVGElement());
483         downcast<SVGElement>(*this).synchronizeAnimatedSVGAttribute(QualifiedName(nullAtom(), localName, nullAtom()));
484     }
485 }
486
487 const AtomicString& Element::getAttribute(const QualifiedName& name) const
488 {
489     if (!elementData())
490         return nullAtom();
491     synchronizeAttribute(name);
492     if (const Attribute* attribute = findAttributeByName(name))
493         return attribute->value();
494     return nullAtom();
495 }
496
497 Vector<String> Element::getAttributeNames() const
498 {
499     Vector<String> attributesVector;
500     if (!hasAttributes())
501         return attributesVector;
502
503     auto attributes = attributesIterator();
504     attributesVector.reserveInitialCapacity(attributes.attributeCount());
505     for (auto& attribute : attributes)
506         attributesVector.uncheckedAppend(attribute.name().toString());
507     return attributesVector;
508 }
509
510 bool Element::isFocusable() const
511 {
512     if (!isConnected() || !supportsFocus())
513         return false;
514
515     if (!renderer()) {
516         // If the node is in a display:none tree it might say it needs style recalc but
517         // the whole document is actually up to date.
518         ASSERT(!needsStyleRecalc() || !document().childNeedsStyleRecalc());
519
520         // Elements in canvas fallback content are not rendered, but they are allowed to be
521         // focusable as long as their canvas is displayed and visible.
522         if (auto* canvas = ancestorsOfType<HTMLCanvasElement>(*this).first())
523             return canvas->renderer() && canvas->renderer()->style().visibility() == VISIBLE;
524     }
525
526     // FIXME: Even if we are not visible, we might have a child that is visible.
527     // Hyatt wants to fix that some day with a "has visible content" flag or the like.
528     if (!renderer() || renderer()->style().visibility() != VISIBLE)
529         return false;
530
531     return true;
532 }
533
534 bool Element::isUserActionElementInActiveChain() const
535 {
536     ASSERT(isUserActionElement());
537     return document().userActionElements().isInActiveChain(this);
538 }
539
540 bool Element::isUserActionElementActive() const
541 {
542     ASSERT(isUserActionElement());
543     return document().userActionElements().isActive(this);
544 }
545
546 bool Element::isUserActionElementFocused() const
547 {
548     ASSERT(isUserActionElement());
549     return document().userActionElements().isFocused(this);
550 }
551
552 bool Element::isUserActionElementHovered() const
553 {
554     ASSERT(isUserActionElement());
555     return document().userActionElements().isHovered(this);
556 }
557
558 void Element::setActive(bool flag, bool pause)
559 {
560     if (flag == active())
561         return;
562
563     document().userActionElements().setActive(this, flag);
564
565     const RenderStyle* renderStyle = this->renderStyle();
566     bool reactsToPress = (renderStyle && renderStyle->affectedByActive()) || styleAffectedByActive();
567     if (reactsToPress)
568         invalidateStyleForSubtree();
569
570     if (!renderer())
571         return;
572
573     if (renderer()->style().hasAppearance() && renderer()->theme().stateChanged(*renderer(), ControlStates::PressedState))
574         reactsToPress = true;
575
576     // The rest of this function implements a feature that only works if the
577     // platform supports immediate invalidations on the ChromeClient, so bail if
578     // that isn't supported.
579     if (!document().page()->chrome().client().supportsImmediateInvalidation())
580         return;
581
582     if (reactsToPress && pause) {
583         // The delay here is subtle. It relies on an assumption, namely that the amount of time it takes
584         // to repaint the "down" state of the control is about the same time as it would take to repaint the
585         // "up" state. Once you assume this, you can just delay for 100ms - that time (assuming that after you
586         // leave this method, it will be about that long before the flush of the up state happens again).
587 #ifdef HAVE_FUNC_USLEEP
588         double startTime = monotonicallyIncreasingTime();
589 #endif
590
591         document().updateStyleIfNeeded();
592
593         // Do an immediate repaint.
594         if (renderer())
595             renderer()->repaint();
596
597         // FIXME: Come up with a less ridiculous way of doing this.
598 #ifdef HAVE_FUNC_USLEEP
599         // Now pause for a small amount of time (1/10th of a second from before we repainted in the pressed state)
600         double remainingTime = 0.1 - (monotonicallyIncreasingTime() - startTime);
601         if (remainingTime > 0)
602             usleep(static_cast<useconds_t>(remainingTime * 1000000.0));
603 #endif
604     }
605 }
606
607 void Element::setFocus(bool flag)
608 {
609     if (flag == focused())
610         return;
611
612     document().userActionElements().setFocused(this, flag);
613     invalidateStyleForSubtree();
614
615     for (Element* element = this; element; element = element->parentElementInComposedTree())
616         element->setHasFocusWithin(flag);
617 }
618
619 void Element::setHovered(bool flag)
620 {
621     if (flag == hovered())
622         return;
623
624     document().userActionElements().setHovered(this, flag);
625
626     if (!renderer()) {
627         // When setting hover to false, the style needs to be recalc'd even when
628         // there's no renderer (imagine setting display:none in the :hover class,
629         // if a nil renderer would prevent this element from recalculating its
630         // style, it would never go back to its normal style and remain
631         // stuck in its hovered style).
632         if (!flag)
633             invalidateStyleForSubtree();
634
635         return;
636     }
637
638     if (renderer()->style().affectedByHover() || childrenAffectedByHover())
639         invalidateStyleForSubtree();
640
641     if (renderer()->style().hasAppearance())
642         renderer()->theme().stateChanged(*renderer(), ControlStates::HoverState);
643 }
644
645 void Element::scrollIntoView(bool alignToTop) 
646 {
647     document().updateLayoutIgnorePendingStylesheets();
648
649     if (!renderer())
650         return;
651
652     bool insideFixed;
653     LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
654     // Align to the top / bottom and to the closest edge.
655     if (alignToTop)
656         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNeeded, ScrollAlignment::alignTopAlways);
657     else
658         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNeeded, ScrollAlignment::alignBottomAlways);
659 }
660
661 void Element::scrollIntoViewIfNeeded(bool centerIfNeeded)
662 {
663     document().updateLayoutIgnorePendingStylesheets();
664
665     if (!renderer())
666         return;
667
668     bool insideFixed;
669     LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
670     if (centerIfNeeded)
671         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignCenterIfNeeded, ScrollAlignment::alignCenterIfNeeded);
672     else
673         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNeeded, ScrollAlignment::alignToEdgeIfNeeded);
674 }
675
676 void Element::scrollIntoViewIfNotVisible(bool centerIfNotVisible)
677 {
678     document().updateLayoutIgnorePendingStylesheets();
679     
680     if (!renderer())
681         return;
682     
683     bool insideFixed;
684     LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
685     if (centerIfNotVisible)
686         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignCenterIfNotVisible, ScrollAlignment::alignCenterIfNotVisible);
687     else
688         renderer()->scrollRectToVisible(SelectionRevealMode::Reveal, absoluteBounds, insideFixed, ScrollAlignment::alignToEdgeIfNotVisible, ScrollAlignment::alignToEdgeIfNotVisible);
689 }
690
691 void Element::scrollBy(const ScrollToOptions& options)
692 {
693     return scrollBy(options.left.value_or(0), options.top.value_or(0));
694 }
695
696 static inline double normalizeNonFiniteValue(double f)
697 {
698     return std::isfinite(f) ? f : 0;
699 }
700
701 void Element::scrollBy(double x, double y)
702 {
703     scrollTo(scrollLeft() + normalizeNonFiniteValue(x), scrollTop() + normalizeNonFiniteValue(y));
704 }
705
706 void Element::scrollTo(const ScrollToOptions& options, ScrollClamping clamping)
707 {
708     // If the element is the root element and document is in quirks mode, terminate these steps.
709     // Note that WebKit always uses quirks mode document scrolling behavior. See Document::scrollingElement().
710     if (this == document().documentElement())
711         return;
712
713     document().updateLayoutIgnorePendingStylesheets();
714
715     // If the element does not have any associated CSS layout box, the element has no associated scrolling box,
716     // or the element has no overflow, terminate these steps.
717     RenderBox* renderer = renderBox();
718     if (!renderer || !renderer->hasOverflowClip())
719         return;
720
721     // Normalize non-finite values for left and top dictionary members of options, if present.
722     double x = options.left ? normalizeNonFiniteValue(options.left.value()) : adjustForAbsoluteZoom(renderer->scrollLeft(), *renderer);
723     double y = options.top ? normalizeNonFiniteValue(options.top.value()) : adjustForAbsoluteZoom(renderer->scrollTop(), *renderer);
724
725     renderer->setScrollLeft(clampToInteger(x * renderer->style().effectiveZoom()), clamping);
726     renderer->setScrollTop(clampToInteger(y * renderer->style().effectiveZoom()), clamping);
727 }
728
729 void Element::scrollTo(double x, double y)
730 {
731     scrollTo({ x, y });
732 }
733
734 void Element::scrollByUnits(int units, ScrollGranularity granularity)
735 {
736     document().updateLayoutIgnorePendingStylesheets();
737
738     auto* renderer = this->renderer();
739     if (!renderer)
740         return;
741
742     if (!renderer->hasOverflowClip())
743         return;
744
745     ScrollDirection direction = ScrollDown;
746     if (units < 0) {
747         direction = ScrollUp;
748         units = -units;
749     }
750     Element* stopElement = this;
751     downcast<RenderBox>(*renderer).scroll(direction, granularity, units, &stopElement);
752 }
753
754 void Element::scrollByLines(int lines)
755 {
756     scrollByUnits(lines, ScrollByLine);
757 }
758
759 void Element::scrollByPages(int pages)
760 {
761     scrollByUnits(pages, ScrollByPage);
762 }
763
764 static double localZoomForRenderer(const RenderElement& renderer)
765 {
766     // FIXME: This does the wrong thing if two opposing zooms are in effect and canceled each
767     // other out, but the alternative is that we'd have to crawl up the whole render tree every
768     // time (or store an additional bit in the RenderStyle to indicate that a zoom was specified).
769     double zoomFactor = 1;
770     if (renderer.style().effectiveZoom() != 1) {
771         // Need to find the nearest enclosing RenderElement that set up
772         // a differing zoom, and then we divide our result by it to eliminate the zoom.
773         const RenderElement* prev = &renderer;
774         for (RenderElement* curr = prev->parent(); curr; curr = curr->parent()) {
775             if (curr->style().effectiveZoom() != prev->style().effectiveZoom()) {
776                 zoomFactor = prev->style().zoom();
777                 break;
778             }
779             prev = curr;
780         }
781         if (prev->isRenderView())
782             zoomFactor = prev->style().zoom();
783     }
784     return zoomFactor;
785 }
786
787 static double adjustForLocalZoom(LayoutUnit value, const RenderElement& renderer, double& zoomFactor)
788 {
789     zoomFactor = localZoomForRenderer(renderer);
790     if (zoomFactor == 1)
791         return value.toDouble();
792     return value.toDouble() / zoomFactor;
793 }
794
795 enum LegacyCSSOMElementMetricsRoundingStrategy { Round, Floor };
796
797 static bool subpixelMetricsEnabled(const Document& document)
798 {
799     return document.settings().subpixelCSSOMElementMetricsEnabled();
800 }
801
802 static double convertToNonSubpixelValueIfNeeded(double value, const Document& document, LegacyCSSOMElementMetricsRoundingStrategy roundStrategy = Round)
803 {
804     return subpixelMetricsEnabled(document) ? value : roundStrategy == Round ? round(value) : floor(value);
805 }
806
807 double Element::offsetLeft()
808 {
809     document().updateLayoutIgnorePendingStylesheets();
810     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
811         LayoutUnit offsetLeft = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetLeft() : LayoutUnit(roundToInt(renderer->offsetLeft()));
812         double zoomFactor = 1;
813         double offsetLeftAdjustedWithZoom = adjustForLocalZoom(offsetLeft, *renderer, zoomFactor);
814         return convertToNonSubpixelValueIfNeeded(offsetLeftAdjustedWithZoom, renderer->document(), zoomFactor == 1 ? Floor : Round);
815     }
816     return 0;
817 }
818
819 double Element::offsetTop()
820 {
821     document().updateLayoutIgnorePendingStylesheets();
822     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
823         LayoutUnit offsetTop = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetTop() : LayoutUnit(roundToInt(renderer->offsetTop()));
824         double zoomFactor = 1;
825         double offsetTopAdjustedWithZoom = adjustForLocalZoom(offsetTop, *renderer, zoomFactor);
826         return convertToNonSubpixelValueIfNeeded(offsetTopAdjustedWithZoom, renderer->document(), zoomFactor == 1 ? Floor : Round);
827     }
828     return 0;
829 }
830
831 double Element::offsetWidth()
832 {
833     document().updateLayoutIfDimensionsOutOfDate(*this, WidthDimensionsCheck);
834     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
835         LayoutUnit offsetWidth = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetWidth() : LayoutUnit(roundToInt(renderer->offsetWidth()));
836         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(offsetWidth, *renderer).toDouble(), renderer->document());
837     }
838     return 0;
839 }
840
841 double Element::offsetHeight()
842 {
843     document().updateLayoutIfDimensionsOutOfDate(*this, HeightDimensionsCheck);
844     if (RenderBoxModelObject* renderer = renderBoxModelObject()) {
845         LayoutUnit offsetHeight = subpixelMetricsEnabled(renderer->document()) ? renderer->offsetHeight() : LayoutUnit(roundToInt(renderer->offsetHeight()));
846         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(offsetHeight, *renderer).toDouble(), renderer->document());
847     }
848     return 0;
849 }
850
851 Element* Element::bindingsOffsetParent()
852 {
853     Element* element = offsetParent();
854     if (!element || !element->isInShadowTree())
855         return element;
856     return element->containingShadowRoot()->mode() == ShadowRootMode::UserAgent ? nullptr : element;
857 }
858
859 Element* Element::offsetParent()
860 {
861     document().updateLayoutIgnorePendingStylesheets();
862     auto renderer = this->renderer();
863     if (!renderer)
864         return nullptr;
865     auto offsetParent = renderer->offsetParent();
866     if (!offsetParent)
867         return nullptr;
868     return offsetParent->element();
869 }
870
871 double Element::clientLeft()
872 {
873     document().updateLayoutIgnorePendingStylesheets();
874
875     if (auto* renderer = renderBox()) {
876         LayoutUnit clientLeft = subpixelMetricsEnabled(renderer->document()) ? renderer->clientLeft() : LayoutUnit(roundToInt(renderer->clientLeft()));
877         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientLeft, *renderer).toDouble(), renderer->document());
878     }
879     return 0;
880 }
881
882 double Element::clientTop()
883 {
884     document().updateLayoutIgnorePendingStylesheets();
885
886     if (auto* renderer = renderBox()) {
887         LayoutUnit clientTop = subpixelMetricsEnabled(renderer->document()) ? renderer->clientTop() : LayoutUnit(roundToInt(renderer->clientTop()));
888         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientTop, *renderer).toDouble(), renderer->document());
889     }
890     return 0;
891 }
892
893 double Element::clientWidth()
894 {
895     document().updateLayoutIfDimensionsOutOfDate(*this, WidthDimensionsCheck);
896
897     if (!document().hasLivingRenderTree())
898         return 0;
899
900     RenderView& renderView = *document().renderView();
901
902     // When in strict mode, clientWidth for the document element should return the width of the containing frame.
903     // When in quirks mode, clientWidth for the body element should return the width of the containing frame.
904     bool inQuirksMode = document().inQuirksMode();
905     if ((!inQuirksMode && document().documentElement() == this) || (inQuirksMode && isHTMLElement() && document().bodyOrFrameset() == this))
906         return adjustForAbsoluteZoom(renderView.frameView().layoutWidth(), renderView);
907     
908     if (RenderBox* renderer = renderBox()) {
909         LayoutUnit clientWidth = subpixelMetricsEnabled(renderer->document()) ? renderer->clientWidth() : LayoutUnit(roundToInt(renderer->clientWidth()));
910         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientWidth, *renderer).toDouble(), renderer->document());
911     }
912     return 0;
913 }
914
915 double Element::clientHeight()
916 {
917     document().updateLayoutIfDimensionsOutOfDate(*this, HeightDimensionsCheck);
918     if (!document().hasLivingRenderTree())
919         return 0;
920
921     RenderView& renderView = *document().renderView();
922
923     // When in strict mode, clientHeight for the document element should return the height of the containing frame.
924     // When in quirks mode, clientHeight for the body element should return the height of the containing frame.
925     bool inQuirksMode = document().inQuirksMode();
926     if ((!inQuirksMode && document().documentElement() == this) || (inQuirksMode && isHTMLElement() && document().bodyOrFrameset() == this))
927         return adjustForAbsoluteZoom(renderView.frameView().layoutHeight(), renderView);
928
929     if (RenderBox* renderer = renderBox()) {
930         LayoutUnit clientHeight = subpixelMetricsEnabled(renderer->document()) ? renderer->clientHeight() : LayoutUnit(roundToInt(renderer->clientHeight()));
931         return convertToNonSubpixelValueIfNeeded(adjustLayoutUnitForAbsoluteZoom(clientHeight, *renderer).toDouble(), renderer->document());
932     }
933     return 0;
934 }
935
936 int Element::scrollLeft()
937 {
938     document().updateLayoutIgnorePendingStylesheets();
939
940     if (auto* renderer = renderBox())
941         return adjustForAbsoluteZoom(renderer->scrollLeft(), *renderer);
942     return 0;
943 }
944
945 int Element::scrollTop()
946 {
947     document().updateLayoutIgnorePendingStylesheets();
948
949     if (RenderBox* renderer = renderBox())
950         return adjustForAbsoluteZoom(renderer->scrollTop(), *renderer);
951     return 0;
952 }
953
954 void Element::setScrollLeft(int newLeft)
955 {
956     document().updateLayoutIgnorePendingStylesheets();
957
958     if (auto* renderer = renderBox()) {
959         renderer->setScrollLeft(static_cast<int>(newLeft * renderer->style().effectiveZoom()));
960         if (auto* scrollableArea = renderer->layer())
961             scrollableArea->setScrolledProgrammatically(true);
962     }
963 }
964
965 void Element::setScrollTop(int newTop)
966 {
967     document().updateLayoutIgnorePendingStylesheets();
968
969     if (auto* renderer = renderBox()) {
970         renderer->setScrollTop(static_cast<int>(newTop * renderer->style().effectiveZoom()));
971         if (auto* scrollableArea = renderer->layer())
972             scrollableArea->setScrolledProgrammatically(true);
973     }
974 }
975
976 int Element::scrollWidth()
977 {
978     document().updateLayoutIfDimensionsOutOfDate(*this, WidthDimensionsCheck);
979     if (auto* renderer = renderBox())
980         return adjustForAbsoluteZoom(renderer->scrollWidth(), *renderer);
981     return 0;
982 }
983
984 int Element::scrollHeight()
985 {
986     document().updateLayoutIfDimensionsOutOfDate(*this, HeightDimensionsCheck);
987     if (auto* renderer = renderBox())
988         return adjustForAbsoluteZoom(renderer->scrollHeight(), *renderer);
989     return 0;
990 }
991
992 IntRect Element::boundsInRootViewSpace()
993 {
994     document().updateLayoutIgnorePendingStylesheets();
995
996     FrameView* view = document().view();
997     if (!view)
998         return IntRect();
999
1000     Vector<FloatQuad> quads;
1001
1002     if (isSVGElement() && renderer()) {
1003         // Get the bounding rectangle from the SVG model.
1004         SVGElement& svgElement = downcast<SVGElement>(*this);
1005         FloatRect localRect;
1006         if (svgElement.getBoundingBox(localRect))
1007             quads.append(renderer()->localToAbsoluteQuad(localRect));
1008     } else {
1009         // Get the bounding rectangle from the box model.
1010         if (renderBoxModelObject())
1011             renderBoxModelObject()->absoluteQuads(quads);
1012     }
1013
1014     if (quads.isEmpty())
1015         return IntRect();
1016
1017     IntRect result = quads[0].enclosingBoundingBox();
1018     for (size_t i = 1; i < quads.size(); ++i)
1019         result.unite(quads[i].enclosingBoundingBox());
1020
1021     result = view->contentsToRootView(result);
1022     return result;
1023 }
1024
1025 static bool layoutOverflowRectContainsAllDescendants(const RenderBox& renderBox)
1026 {
1027     if (renderBox.isRenderView())
1028         return true;
1029
1030     if (!renderBox.element())
1031         return false;
1032
1033     // If there are any position:fixed inside of us, game over.
1034     if (auto* viewPositionedObjects = renderBox.view().positionedObjects()) {
1035         for (auto* positionedBox : *viewPositionedObjects) {
1036             if (positionedBox == &renderBox)
1037                 continue;
1038             if (positionedBox->style().position() == FixedPosition && renderBox.element()->contains(positionedBox->element()))
1039                 return false;
1040         }
1041     }
1042
1043     if (renderBox.canContainAbsolutelyPositionedObjects()) {
1044         // Our layout overflow will include all descendant positioned elements.
1045         return true;
1046     }
1047
1048     // This renderer may have positioned descendants whose containing block is some ancestor.
1049     if (auto* containingBlock = renderBox.containingBlockForAbsolutePosition()) {
1050         if (auto* positionedObjects = containingBlock->positionedObjects()) {
1051             for (auto* positionedBox : *positionedObjects) {
1052                 if (positionedBox == &renderBox)
1053                     continue;
1054                 if (renderBox.element()->contains(positionedBox->element()))
1055                     return false;
1056             }
1057         }
1058     }
1059     return false;
1060 }
1061
1062 LayoutRect Element::absoluteEventBounds(bool& boundsIncludeAllDescendantElements, bool& includesFixedPositionElements)
1063 {
1064     boundsIncludeAllDescendantElements = false;
1065     includesFixedPositionElements = false;
1066
1067     if (!renderer())
1068         return LayoutRect();
1069
1070     LayoutRect result;
1071     if (isSVGElement()) {
1072         // Get the bounding rectangle from the SVG model.
1073         SVGElement& svgElement = downcast<SVGElement>(*this);
1074         FloatRect localRect;
1075         if (svgElement.getBoundingBox(localRect, SVGLocatable::DisallowStyleUpdate))
1076             result = LayoutRect(renderer()->localToAbsoluteQuad(localRect, UseTransforms, &includesFixedPositionElements).boundingBox());
1077     } else {
1078         auto* renderer = this->renderer();
1079         if (is<RenderBox>(renderer)) {
1080             auto& box = downcast<RenderBox>(*renderer);
1081
1082             bool computedBounds = false;
1083             
1084             if (RenderFragmentedFlow* fragmentedFlow = box.enclosingFragmentedFlow()) {
1085                 bool wasFixed = false;
1086                 Vector<FloatQuad> quads;
1087                 FloatRect localRect(0, 0, box.width(), box.height());
1088                 if (fragmentedFlow->absoluteQuadsForBox(quads, &wasFixed, &box, localRect.y(), localRect.maxY())) {
1089                     FloatRect quadBounds = quads[0].boundingBox();
1090                     for (size_t i = 1; i < quads.size(); ++i)
1091                         quadBounds.unite(quads[i].boundingBox());
1092                     
1093                     result = LayoutRect(quadBounds);
1094                     computedBounds = true;
1095                 } else {
1096                     // Probably columns. Just return the bounds of the multicol block for now.
1097                     // FIXME: this doesn't handle nested columns.
1098                     RenderElement* multicolContainer = fragmentedFlow->parent();
1099                     if (multicolContainer && is<RenderBox>(multicolContainer)) {
1100                         auto overflowRect = downcast<RenderBox>(*multicolContainer).layoutOverflowRect();
1101                         result = LayoutRect(multicolContainer->localToAbsoluteQuad(FloatRect(overflowRect), UseTransforms, &includesFixedPositionElements).boundingBox());
1102                         computedBounds = true;
1103                     }
1104                 }
1105             }
1106
1107             if (!computedBounds) {
1108                 LayoutRect overflowRect = box.layoutOverflowRect();
1109                 result = LayoutRect(box.localToAbsoluteQuad(FloatRect(overflowRect), UseTransforms, &includesFixedPositionElements).boundingBox());
1110                 boundsIncludeAllDescendantElements = layoutOverflowRectContainsAllDescendants(box);
1111             }
1112         } else
1113             result = LayoutRect(renderer->absoluteBoundingBoxRect(true /* useTransforms */, &includesFixedPositionElements));
1114     }
1115
1116     return result;
1117 }
1118
1119 LayoutRect Element::absoluteEventBoundsOfElementAndDescendants(bool& includesFixedPositionElements)
1120 {
1121     bool boundsIncludeDescendants;
1122     LayoutRect result = absoluteEventBounds(boundsIncludeDescendants, includesFixedPositionElements);
1123     if (boundsIncludeDescendants)
1124         return result;
1125
1126     for (auto& child : childrenOfType<Element>(*this)) {
1127         bool includesFixedPosition = false;
1128         LayoutRect childBounds = child.absoluteEventBoundsOfElementAndDescendants(includesFixedPosition);
1129         includesFixedPositionElements |= includesFixedPosition;
1130         result.unite(childBounds);
1131     }
1132
1133     return result;
1134 }
1135
1136 LayoutRect Element::absoluteEventHandlerBounds(bool& includesFixedPositionElements)
1137 {
1138     // This is not web-exposed, so don't call the FOUC-inducing updateLayoutIgnorePendingStylesheets().
1139     FrameView* frameView = document().view();
1140     if (!frameView)
1141         return LayoutRect();
1142
1143     if (frameView->needsLayout())
1144         frameView->layoutContext().layout();
1145
1146     return absoluteEventBoundsOfElementAndDescendants(includesFixedPositionElements);
1147 }
1148
1149 static std::optional<std::pair<RenderObject*, LayoutRect>> listBoxElementBoundingBox(Element& element)
1150 {
1151     HTMLSelectElement* selectElement;
1152     bool isGroup;
1153     if (is<HTMLOptionElement>(element)) {
1154         selectElement = downcast<HTMLOptionElement>(element).ownerSelectElement();
1155         isGroup = false;
1156     } else if (is<HTMLOptGroupElement>(element)) {
1157         selectElement = downcast<HTMLOptGroupElement>(element).ownerSelectElement();
1158         isGroup = true;
1159     } else
1160         return std::nullopt;
1161
1162     if (!selectElement || !selectElement->renderer() || !is<RenderListBox>(selectElement->renderer()))
1163         return std::nullopt;
1164
1165     auto& renderer = downcast<RenderListBox>(*selectElement->renderer());
1166     std::optional<LayoutRect> boundingBox;
1167     int optionIndex = 0;
1168     for (auto* item : selectElement->listItems()) {
1169         if (item == &element) {
1170             LayoutPoint additionOffset;
1171             boundingBox = renderer.itemBoundingBoxRect(additionOffset, optionIndex);
1172             if (!isGroup)
1173                 break;
1174         } else if (isGroup && boundingBox) {
1175             if (item->parentNode() != &element)
1176                 break;
1177             LayoutPoint additionOffset;
1178             boundingBox->setHeight(boundingBox->height() + renderer.itemBoundingBoxRect(additionOffset, optionIndex).height());
1179         }
1180         ++optionIndex;
1181     }
1182
1183     if (!boundingBox)
1184         return std::nullopt;
1185
1186     return std::pair<RenderObject*, LayoutRect> { &renderer, boundingBox.value() };
1187 }
1188
1189 Ref<DOMRectList> Element::getClientRects()
1190 {
1191     document().updateLayoutIgnorePendingStylesheets();
1192
1193     RenderObject* renderer = this->renderer();
1194     Vector<FloatQuad> quads;
1195
1196     if (auto pair = listBoxElementBoundingBox(*this)) {
1197         renderer = pair.value().first;
1198         quads.append(renderer->localToAbsoluteQuad(FloatQuad { pair.value().second }));
1199     } else if (auto* renderBoxModelObject = this->renderBoxModelObject())
1200         renderBoxModelObject->absoluteQuads(quads);
1201
1202     // FIXME: Handle SVG elements.
1203     // FIXME: Handle table/inline-table with a caption.
1204
1205     if (quads.isEmpty())
1206         return DOMRectList::create();
1207
1208     document().convertAbsoluteToClientQuads(quads, renderer->style());
1209     return DOMRectList::create(quads);
1210 }
1211
1212 FloatRect Element::boundingClientRect()
1213 {
1214     document().updateLayoutIgnorePendingStylesheets();
1215
1216     RenderObject* renderer = this->renderer();
1217     Vector<FloatQuad> quads;
1218     if (isSVGElement() && renderer && !renderer->isSVGRoot()) {
1219         // Get the bounding rectangle from the SVG model.
1220         SVGElement& svgElement = downcast<SVGElement>(*this);
1221         FloatRect localRect;
1222         if (svgElement.getBoundingBox(localRect))
1223             quads.append(renderer->localToAbsoluteQuad(localRect));
1224     } else if (auto pair = listBoxElementBoundingBox(*this)) {
1225         renderer = pair.value().first;
1226         quads.append(renderer->localToAbsoluteQuad(FloatQuad { pair.value().second }));
1227     } else if (auto* renderBoxModelObject = this->renderBoxModelObject())
1228         renderBoxModelObject->absoluteQuads(quads);
1229
1230     if (quads.isEmpty())
1231         return { };
1232
1233     FloatRect result = quads[0].boundingBox();
1234     for (size_t i = 1; i < quads.size(); ++i)
1235         result.unite(quads[i].boundingBox());
1236
1237     document().convertAbsoluteToClientRect(result, renderer->style());
1238     return result;
1239 }
1240
1241 Ref<DOMRect> Element::getBoundingClientRect()
1242 {
1243     return DOMRect::create(boundingClientRect());
1244 }
1245
1246 // Note that this is not web-exposed, and does not use the same coordinate system as getBoundingClientRect() and friends.
1247 IntRect Element::clientRect() const
1248 {
1249     if (RenderObject* renderer = this->renderer())
1250         return document().view()->contentsToRootView(renderer->absoluteBoundingBoxRect());
1251     return IntRect();
1252 }
1253     
1254 IntRect Element::screenRect() const
1255 {
1256     if (RenderObject* renderer = this->renderer())
1257         return document().view()->contentsToScreen(renderer->absoluteBoundingBoxRect());
1258     return IntRect();
1259 }
1260
1261 const AtomicString& Element::getAttribute(const AtomicString& localName) const
1262 {
1263     if (!elementData())
1264         return nullAtom();
1265     synchronizeAttribute(localName);
1266     if (const Attribute* attribute = elementData()->findAttributeByName(localName, shouldIgnoreAttributeCase(*this)))
1267         return attribute->value();
1268     return nullAtom();
1269 }
1270
1271 const AtomicString& Element::getAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const
1272 {
1273     return getAttribute(QualifiedName(nullAtom(), localName, namespaceURI));
1274 }
1275
1276 ExceptionOr<void> Element::setAttribute(const AtomicString& localName, const AtomicString& value)
1277 {
1278     if (!Document::isValidName(localName))
1279         return Exception { InvalidCharacterError };
1280
1281     synchronizeAttribute(localName);
1282     auto caseAdjustedLocalName = shouldIgnoreAttributeCase(*this) ? localName.convertToASCIILowercase() : localName;
1283     unsigned index = elementData() ? elementData()->findAttributeIndexByName(caseAdjustedLocalName, false) : ElementData::attributeNotFound;
1284     auto name = index != ElementData::attributeNotFound ? attributeAt(index).name() : QualifiedName { nullAtom(), caseAdjustedLocalName, nullAtom() };
1285     setAttributeInternal(index, name, value, NotInSynchronizationOfLazyAttribute);
1286
1287     return { };
1288 }
1289
1290 void Element::setAttribute(const QualifiedName& name, const AtomicString& value)
1291 {
1292     synchronizeAttribute(name);
1293     unsigned index = elementData() ? elementData()->findAttributeIndexByName(name) : ElementData::attributeNotFound;
1294     setAttributeInternal(index, name, value, NotInSynchronizationOfLazyAttribute);
1295 }
1296
1297 void Element::setAttributeWithoutSynchronization(const QualifiedName& name, const AtomicString& value)
1298 {
1299     unsigned index = elementData() ? elementData()->findAttributeIndexByName(name) : ElementData::attributeNotFound;
1300     setAttributeInternal(index, name, value, NotInSynchronizationOfLazyAttribute);
1301 }
1302
1303 void Element::setSynchronizedLazyAttribute(const QualifiedName& name, const AtomicString& value)
1304 {
1305     unsigned index = elementData() ? elementData()->findAttributeIndexByName(name) : ElementData::attributeNotFound;
1306     setAttributeInternal(index, name, value, InSynchronizationOfLazyAttribute);
1307 }
1308
1309 inline void Element::setAttributeInternal(unsigned index, const QualifiedName& name, const AtomicString& newValue, SynchronizationOfLazyAttribute inSynchronizationOfLazyAttribute)
1310 {
1311     if (newValue.isNull()) {
1312         if (index != ElementData::attributeNotFound)
1313             removeAttributeInternal(index, inSynchronizationOfLazyAttribute);
1314         return;
1315     }
1316
1317     if (index == ElementData::attributeNotFound) {
1318         addAttributeInternal(name, newValue, inSynchronizationOfLazyAttribute);
1319         return;
1320     }
1321
1322     if (inSynchronizationOfLazyAttribute) {
1323         ensureUniqueElementData().attributeAt(index).setValue(newValue);
1324         return;
1325     }
1326
1327     const Attribute& attribute = attributeAt(index);
1328     QualifiedName attributeName = attribute.name();
1329     AtomicString oldValue = attribute.value();
1330
1331     willModifyAttribute(attributeName, oldValue, newValue);
1332
1333     if (newValue != oldValue) {
1334         Style::AttributeChangeInvalidation styleInvalidation(*this, name, oldValue, newValue);
1335         ensureUniqueElementData().attributeAt(index).setValue(newValue);
1336     }
1337
1338     didModifyAttribute(attributeName, oldValue, newValue);
1339 }
1340
1341 static inline AtomicString makeIdForStyleResolution(const AtomicString& value, bool inQuirksMode)
1342 {
1343     if (inQuirksMode)
1344         return value.convertToASCIILowercase();
1345     return value;
1346 }
1347
1348 void Element::attributeChanged(const QualifiedName& name, const AtomicString& oldValue, const AtomicString& newValue, AttributeModificationReason)
1349 {
1350     bool valueIsSameAsBefore = oldValue == newValue;
1351
1352     if (!valueIsSameAsBefore) {
1353         if (name == HTMLNames::idAttr) {
1354             if (!oldValue.isEmpty())
1355                 treeScope().idTargetObserverRegistry().notifyObservers(*oldValue.impl());
1356             if (!newValue.isEmpty())
1357                 treeScope().idTargetObserverRegistry().notifyObservers(*newValue.impl());
1358
1359             AtomicString oldId = elementData()->idForStyleResolution();
1360             AtomicString newId = makeIdForStyleResolution(newValue, document().inQuirksMode());
1361             if (newId != oldId) {
1362                 Style::IdChangeInvalidation styleInvalidation(*this, oldId, newId);
1363                 elementData()->setIdForStyleResolution(newId);
1364             }
1365         } else if (name == classAttr)
1366             classAttributeChanged(newValue);
1367         else if (name == HTMLNames::nameAttr)
1368             elementData()->setHasNameAttribute(!newValue.isNull());
1369         else if (name == HTMLNames::pseudoAttr) {
1370             if (needsStyleInvalidation() && isInShadowTree())
1371                 invalidateStyleForSubtree();
1372         }
1373         else if (name == HTMLNames::slotAttr) {
1374             if (auto* parent = parentElement()) {
1375                 if (auto* shadowRoot = parent->shadowRoot())
1376                     shadowRoot->hostChildElementDidChangeSlotAttribute(*this, oldValue, newValue);
1377             }
1378         }
1379     }
1380
1381     parseAttribute(name, newValue);
1382
1383     document().incDOMTreeVersion();
1384
1385     if (UNLIKELY(isDefinedCustomElement()))
1386         CustomElementReactionQueue::enqueueAttributeChangedCallbackIfNeeded(*this, name, oldValue, newValue);
1387
1388     if (valueIsSameAsBefore)
1389         return;
1390
1391     invalidateNodeListAndCollectionCachesInAncestorsForAttribute(name);
1392
1393     if (AXObjectCache* cache = document().existingAXObjectCache())
1394         cache->handleAttributeChanged(name, this);
1395 }
1396
1397 template <typename CharacterType>
1398 static inline bool classStringHasClassName(const CharacterType* characters, unsigned length)
1399 {
1400     ASSERT(length > 0);
1401
1402     unsigned i = 0;
1403     do {
1404         if (isNotHTMLSpace(characters[i]))
1405             break;
1406         ++i;
1407     } while (i < length);
1408
1409     return i < length;
1410 }
1411
1412 static inline bool classStringHasClassName(const AtomicString& newClassString)
1413 {
1414     unsigned length = newClassString.length();
1415
1416     if (!length)
1417         return false;
1418
1419     if (newClassString.is8Bit())
1420         return classStringHasClassName(newClassString.characters8(), length);
1421     return classStringHasClassName(newClassString.characters16(), length);
1422 }
1423
1424 void Element::classAttributeChanged(const AtomicString& newClassString)
1425 {
1426     // Note: We'll need ElementData, but it doesn't have to be UniqueElementData.
1427     if (!elementData())
1428         ensureUniqueElementData();
1429
1430     bool shouldFoldCase = document().inQuirksMode();
1431     bool newStringHasClasses = classStringHasClassName(newClassString);
1432
1433     auto oldClassNames = elementData()->classNames();
1434     auto newClassNames = newStringHasClasses ? SpaceSplitString(newClassString, shouldFoldCase) : SpaceSplitString();
1435     {
1436         Style::ClassChangeInvalidation styleInvalidation(*this, oldClassNames, newClassNames);
1437         elementData()->setClassNames(newClassNames);
1438     }
1439
1440     if (hasRareData()) {
1441         if (auto* classList = elementRareData()->classList())
1442             classList->associatedAttributeValueChanged(newClassString);
1443     }
1444 }
1445
1446 URL Element::absoluteLinkURL() const
1447 {
1448     if (!isLink())
1449         return URL();
1450
1451     AtomicString linkAttribute;
1452     if (hasTagName(SVGNames::aTag))
1453         linkAttribute = getAttribute(XLinkNames::hrefAttr);
1454     else
1455         linkAttribute = getAttribute(HTMLNames::hrefAttr);
1456
1457     if (linkAttribute.isEmpty())
1458         return URL();
1459
1460     return document().completeURL(stripLeadingAndTrailingHTMLSpaces(linkAttribute));
1461 }
1462
1463 #if ENABLE(TOUCH_EVENTS)
1464 bool Element::allowsDoubleTapGesture() const
1465 {
1466     if (renderStyle() && renderStyle()->touchAction() != TouchAction::Auto)
1467         return false;
1468
1469     Element* parent = parentElement();
1470     return !parent || parent->allowsDoubleTapGesture();
1471 }
1472 #endif
1473
1474 StyleResolver& Element::styleResolver()
1475 {
1476     if (auto* shadowRoot = containingShadowRoot())
1477         return shadowRoot->styleScope().resolver();
1478
1479     return document().styleScope().resolver();
1480 }
1481
1482 ElementStyle Element::resolveStyle(const RenderStyle* parentStyle)
1483 {
1484     return styleResolver().styleForElement(*this, parentStyle);
1485 }
1486
1487 void Element::invalidateStyle()
1488 {
1489     Node::invalidateStyle(Style::Validity::ElementInvalid);
1490 }
1491
1492 void Element::invalidateStyleAndLayerComposition()
1493 {
1494     Node::invalidateStyle(Style::Validity::ElementInvalid, Style::InvalidationMode::RecompositeLayer);
1495 }
1496
1497 void Element::invalidateStyleForSubtree()
1498 {
1499     Node::invalidateStyle(Style::Validity::SubtreeInvalid);
1500 }
1501
1502 void Element::invalidateStyleAndRenderersForSubtree()
1503 {
1504     Node::invalidateStyle(Style::Validity::SubtreeAndRenderersInvalid);
1505 }
1506
1507 bool Element::hasDisplayContents() const
1508 {
1509     if (renderer() || !hasRareData())
1510         return false;
1511     const RenderStyle* style = elementRareData()->computedStyle();
1512     return style && style->display() == CONTENTS;
1513 }
1514
1515 void Element::storeDisplayContentsStyle(std::unique_ptr<RenderStyle> style)
1516 {
1517     ASSERT(style && style->display() == CONTENTS);
1518     ASSERT(!renderer());
1519     ensureElementRareData().setComputedStyle(WTFMove(style));
1520 }
1521
1522 // Returns true is the given attribute is an event handler.
1523 // We consider an event handler any attribute that begins with "on".
1524 // It is a simple solution that has the advantage of not requiring any
1525 // code or configuration change if a new event handler is defined.
1526
1527 bool Element::isEventHandlerAttribute(const Attribute& attribute) const
1528 {
1529     return attribute.name().namespaceURI().isNull() && attribute.name().localName().startsWith("on");
1530 }
1531
1532 bool Element::isJavaScriptURLAttribute(const Attribute& attribute) const
1533 {
1534     return isURLAttribute(attribute) && protocolIsJavaScript(stripLeadingAndTrailingHTMLSpaces(attribute.value()));
1535 }
1536
1537 void Element::stripScriptingAttributes(Vector<Attribute>& attributeVector) const
1538 {
1539     attributeVector.removeAllMatching([this](auto& attribute) -> bool {
1540         return this->isEventHandlerAttribute(attribute)
1541             || this->isJavaScriptURLAttribute(attribute)
1542             || this->isHTMLContentAttribute(attribute);
1543     });
1544 }
1545
1546 void Element::parserSetAttributes(const Vector<Attribute>& attributeVector)
1547 {
1548     ASSERT(!isConnected());
1549     ASSERT(!parentNode());
1550     ASSERT(!m_elementData);
1551
1552     if (!attributeVector.isEmpty()) {
1553         if (document().sharedObjectPool())
1554             m_elementData = document().sharedObjectPool()->cachedShareableElementDataWithAttributes(attributeVector);
1555         else
1556             m_elementData = ShareableElementData::createWithAttributes(attributeVector);
1557
1558     }
1559
1560     parserDidSetAttributes();
1561
1562     // Use attributeVector instead of m_elementData because attributeChanged might modify m_elementData.
1563     for (const auto& attribute : attributeVector)
1564         attributeChanged(attribute.name(), nullAtom(), attribute.value(), ModifiedDirectly);
1565 }
1566
1567 void Element::parserDidSetAttributes()
1568 {
1569 }
1570
1571 void Element::didMoveToNewDocument(Document& oldDocument, Document& newDocument)
1572 {
1573     ASSERT_WITH_SECURITY_IMPLICATION(&document() == &newDocument);
1574
1575     if (oldDocument.inQuirksMode() != document().inQuirksMode()) {
1576         // ElementData::m_classNames or ElementData::m_idForStyleResolution need to be updated with the right case.
1577         if (hasID())
1578             attributeChanged(idAttr, nullAtom(), getIdAttribute());
1579         if (hasClass())
1580             attributeChanged(classAttr, nullAtom(), getAttribute(classAttr));
1581     }
1582
1583     if (UNLIKELY(isDefinedCustomElement()))
1584         CustomElementReactionQueue::enqueueAdoptedCallbackIfNeeded(*this, oldDocument, newDocument);
1585 }
1586
1587 bool Element::hasAttributes() const
1588 {
1589     synchronizeAllAttributes();
1590     return elementData() && elementData()->length();
1591 }
1592
1593 bool Element::hasEquivalentAttributes(const Element* other) const
1594 {
1595     synchronizeAllAttributes();
1596     other->synchronizeAllAttributes();
1597     if (elementData() == other->elementData())
1598         return true;
1599     if (elementData())
1600         return elementData()->isEquivalent(other->elementData());
1601     if (other->elementData())
1602         return other->elementData()->isEquivalent(elementData());
1603     return true;
1604 }
1605
1606 String Element::nodeName() const
1607 {
1608     return m_tagName.toString();
1609 }
1610
1611 String Element::nodeNamePreservingCase() const
1612 {
1613     return m_tagName.toString();
1614 }
1615
1616 ExceptionOr<void> Element::setPrefix(const AtomicString& prefix)
1617 {
1618     auto result = checkSetPrefix(prefix);
1619     if (result.hasException())
1620         return result.releaseException();
1621
1622     m_tagName.setPrefix(prefix.isEmpty() ? nullAtom() : prefix);
1623     return { };
1624 }
1625
1626 const AtomicString& Element::imageSourceURL() const
1627 {
1628     return attributeWithoutSynchronization(srcAttr);
1629 }
1630
1631 bool Element::rendererIsNeeded(const RenderStyle& style)
1632 {
1633     return style.display() != NONE && style.display() != CONTENTS;
1634 }
1635
1636 RenderPtr<RenderElement> Element::createElementRenderer(RenderStyle&& style, const RenderTreePosition&)
1637 {
1638     return RenderElement::createFor(*this, WTFMove(style));
1639 }
1640
1641 Node::InsertedIntoAncestorResult Element::insertedIntoAncestor(InsertionType insertionType, ContainerNode& parentOfInsertedTree)
1642 {
1643     ContainerNode::insertedIntoAncestor(insertionType, parentOfInsertedTree);
1644
1645 #if ENABLE(FULLSCREEN_API)
1646     if (containsFullScreenElement() && parentElement() && !parentElement()->containsFullScreenElement())
1647         setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(true);
1648 #endif
1649
1650     if (parentNode() == &parentOfInsertedTree) {
1651         if (auto* shadowRoot = parentNode()->shadowRoot())
1652             shadowRoot->hostChildElementDidChange(*this);
1653     }
1654
1655     if (!parentOfInsertedTree.isInTreeScope())
1656         return InsertedIntoAncestorResult::Done;
1657
1658     bool becomeConnected = insertionType.connectedToDocument;
1659     TreeScope* newScope = &parentOfInsertedTree.treeScope();
1660     HTMLDocument* newDocument = becomeConnected && is<HTMLDocument>(newScope->documentScope()) ? &downcast<HTMLDocument>(newScope->documentScope()) : nullptr;
1661     if (!insertionType.treeScopeChanged)
1662         newScope = nullptr;
1663
1664     const AtomicString& idValue = getIdAttribute();
1665     if (!idValue.isNull()) {
1666         if (newScope)
1667             updateIdForTreeScope(*newScope, nullAtom(), idValue);
1668         if (newDocument)
1669             updateIdForDocument(*newDocument, nullAtom(), idValue, AlwaysUpdateHTMLDocumentNamedItemMaps);
1670     }
1671
1672     const AtomicString& nameValue = getNameAttribute();
1673     if (!nameValue.isNull()) {
1674         if (newScope)
1675             updateNameForTreeScope(*newScope, nullAtom(), nameValue);
1676         if (newDocument)
1677             updateNameForDocument(*newDocument, nullAtom(), nameValue);
1678     }
1679
1680     if (newScope && hasTagName(labelTag)) {
1681         if (newScope->shouldCacheLabelsByForAttribute())
1682             updateLabel(*newScope, nullAtom(), attributeWithoutSynchronization(forAttr));
1683     }
1684
1685     if (becomeConnected) {
1686         if (UNLIKELY(isCustomElementUpgradeCandidate()))
1687             CustomElementReactionQueue::enqueueElementUpgradeIfDefined(*this);
1688         if (UNLIKELY(isDefinedCustomElement()))
1689             CustomElementReactionQueue::enqueueConnectedCallbackIfNeeded(*this);
1690     }
1691
1692     return InsertedIntoAncestorResult::Done;
1693 }
1694
1695 void Element::removedFromAncestor(RemovalType removalType, ContainerNode& oldParentOfRemovedTree)
1696 {
1697 #if ENABLE(FULLSCREEN_API)
1698     if (containsFullScreenElement())
1699         setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(false);
1700 #endif
1701 #if ENABLE(POINTER_LOCK)
1702     if (document().page())
1703         document().page()->pointerLockController().elementRemoved(*this);
1704 #endif
1705
1706     setSavedLayerScrollPosition(ScrollPosition());
1707
1708     if (oldParentOfRemovedTree.isInTreeScope()) {
1709         TreeScope* oldScope = &oldParentOfRemovedTree.treeScope();
1710         Document* oldDocument = removalType.disconnectedFromDocument ? &oldScope->documentScope() : nullptr;
1711         HTMLDocument* oldHTMLDocument = oldDocument && is<HTMLDocument>(*oldDocument) ? &downcast<HTMLDocument>(*oldDocument) : nullptr;
1712         if (!removalType.treeScopeChanged)
1713             oldScope = nullptr;
1714
1715         const AtomicString& idValue = getIdAttribute();
1716         if (!idValue.isNull()) {
1717             if (oldScope)
1718                 updateIdForTreeScope(*oldScope, idValue, nullAtom());
1719             if (oldHTMLDocument)
1720                 updateIdForDocument(*oldHTMLDocument, idValue, nullAtom(), AlwaysUpdateHTMLDocumentNamedItemMaps);
1721         }
1722
1723         const AtomicString& nameValue = getNameAttribute();
1724         if (!nameValue.isNull()) {
1725             if (oldScope)
1726                 updateNameForTreeScope(*oldScope, nameValue, nullAtom());
1727             if (oldHTMLDocument)
1728                 updateNameForDocument(*oldHTMLDocument, nameValue, nullAtom());
1729         }
1730
1731         if (oldScope && hasTagName(labelTag)) {
1732             if (oldScope->shouldCacheLabelsByForAttribute())
1733                 updateLabel(*oldScope, attributeWithoutSynchronization(forAttr), nullAtom());
1734         }
1735
1736         if (oldDocument) {
1737             if (oldDocument->cssTarget() == this)
1738                 oldDocument->setCSSTarget(nullptr);
1739         }
1740
1741         if (removalType.disconnectedFromDocument && UNLIKELY(isDefinedCustomElement()))
1742             CustomElementReactionQueue::enqueueDisconnectedCallbackIfNeeded(*this);
1743     }
1744
1745     if (!parentNode()) {
1746         if (auto* shadowRoot = oldParentOfRemovedTree.shadowRoot())
1747             shadowRoot->hostChildElementDidChange(*this);
1748     }
1749
1750     ContainerNode::removedFromAncestor(removalType, oldParentOfRemovedTree);
1751
1752     if (hasPendingResources())
1753         document().accessSVGExtensions().removeElementFromPendingResources(this);
1754
1755     RefPtr<Frame> frame = document().frame();
1756     if (frame)
1757         frame->animation().cancelAnimations(*this);
1758
1759 #if PLATFORM(MAC)
1760     if (frame)
1761         frame->mainFrame().removeLatchingStateForTarget(*this);
1762 #endif
1763 }
1764
1765 ShadowRoot* Element::shadowRoot() const
1766 {
1767     return hasRareData() ? elementRareData()->shadowRoot() : nullptr;
1768 }
1769
1770 void Element::addShadowRoot(Ref<ShadowRoot>&& newShadowRoot)
1771 {
1772     ASSERT(!newShadowRoot->hasChildNodes());
1773     ASSERT(!shadowRoot());
1774
1775     ShadowRoot& shadowRoot = newShadowRoot;
1776     {
1777         NoEventDispatchAssertion::InMainThread noEventDispatchAssertion;
1778         if (renderer())
1779             RenderTreeUpdater::tearDownRenderers(*this);
1780
1781         ensureElementRareData().setShadowRoot(WTFMove(newShadowRoot));
1782
1783         shadowRoot.setHost(this);
1784         shadowRoot.setParentTreeScope(treeScope());
1785
1786 #if !ASSERT_DISABLED
1787         ASSERT(notifyChildNodeInserted(*this, shadowRoot).isEmpty());
1788 #else
1789         notifyChildNodeInserted(*this, shadowRoot);
1790 #endif
1791
1792         invalidateStyleAndRenderersForSubtree();
1793     }
1794
1795     if (shadowRoot.mode() == ShadowRootMode::UserAgent)
1796         didAddUserAgentShadowRoot(shadowRoot);
1797
1798     InspectorInstrumentation::didPushShadowRoot(*this, shadowRoot);
1799 }
1800
1801 void Element::removeShadowRoot()
1802 {
1803     RefPtr<ShadowRoot> oldRoot = shadowRoot();
1804     if (!oldRoot)
1805         return;
1806
1807     InspectorInstrumentation::willPopShadowRoot(*this, *oldRoot);
1808     document().removeFocusedNodeOfSubtree(*oldRoot);
1809
1810     ASSERT(!oldRoot->renderer());
1811
1812     elementRareData()->clearShadowRoot();
1813
1814     oldRoot->setHost(nullptr);
1815     oldRoot->setParentTreeScope(document());
1816 }
1817
1818 static bool canAttachAuthorShadowRoot(const Element& element)
1819 {
1820     static NeverDestroyed<HashSet<AtomicString>> tagNames = [] {
1821         static const HTMLQualifiedName* const tagList[] = {
1822             &articleTag.get(),
1823             &asideTag.get(),
1824             &blockquoteTag.get(),
1825             &bodyTag.get(),
1826             &divTag.get(),
1827             &footerTag.get(),
1828             &h1Tag.get(),
1829             &h2Tag.get(),
1830             &h3Tag.get(),
1831             &h4Tag.get(),
1832             &h5Tag.get(),
1833             &h6Tag.get(),
1834             &headerTag.get(),
1835             &navTag.get(),
1836             &pTag.get(),
1837             &sectionTag.get(),
1838             &spanTag.get()
1839         };
1840         HashSet<AtomicString> set;
1841         for (auto& name : tagList)
1842             set.add(name->localName());
1843         return set;
1844     }();
1845
1846     if (!is<HTMLElement>(element))
1847         return false;
1848
1849     const auto& localName = element.localName();
1850     return tagNames.get().contains(localName) || Document::validateCustomElementName(localName) == CustomElementNameValidationStatus::Valid;
1851 }
1852
1853 ExceptionOr<ShadowRoot&> Element::attachShadow(const ShadowRootInit& init)
1854 {
1855     if (!canAttachAuthorShadowRoot(*this))
1856         return Exception { NotSupportedError };
1857     if (shadowRoot())
1858         return Exception { InvalidStateError };
1859     if (init.mode == ShadowRootMode::UserAgent)
1860         return Exception { TypeError };
1861     auto shadow = ShadowRoot::create(document(), init.mode);
1862     auto& result = shadow.get();
1863     addShadowRoot(WTFMove(shadow));
1864     return result;
1865 }
1866
1867 ShadowRoot* Element::shadowRootForBindings(JSC::ExecState& state) const
1868 {
1869     auto* shadow = shadowRoot();
1870     if (!shadow)
1871         return nullptr;
1872     if (shadow->mode() == ShadowRootMode::Open)
1873         return shadow;
1874     if (JSC::jsCast<JSDOMGlobalObject*>(state.lexicalGlobalObject())->world().shadowRootIsAlwaysOpen())
1875         return shadow;
1876     return nullptr;
1877 }
1878
1879 RefPtr<ShadowRoot> Element::userAgentShadowRoot() const
1880 {
1881     ASSERT(!shadowRoot() || shadowRoot()->mode() == ShadowRootMode::UserAgent);
1882     return shadowRoot();
1883 }
1884
1885 ShadowRoot& Element::ensureUserAgentShadowRoot()
1886 {
1887     if (auto shadow = userAgentShadowRoot())
1888         return *shadow;
1889     auto newShadow = ShadowRoot::create(document(), ShadowRootMode::UserAgent);
1890     ShadowRoot& shadow = newShadow;
1891     addShadowRoot(WTFMove(newShadow));
1892     return shadow;
1893 }
1894
1895 void Element::setIsDefinedCustomElement(JSCustomElementInterface& elementInterface)
1896 {
1897     clearFlag(IsEditingTextOrUndefinedCustomElementFlag);
1898     setFlag(IsCustomElement);
1899     auto& data = ensureElementRareData();
1900     if (!data.customElementReactionQueue())
1901         data.setCustomElementReactionQueue(std::make_unique<CustomElementReactionQueue>(elementInterface));
1902     InspectorInstrumentation::didChangeCustomElementState(*this);
1903 }
1904
1905 void Element::setIsFailedCustomElement(JSCustomElementInterface&)
1906 {
1907     ASSERT(isUndefinedCustomElement());
1908     ASSERT(getFlag(IsEditingTextOrUndefinedCustomElementFlag));
1909     clearFlag(IsCustomElement);
1910
1911     if (hasRareData()) {
1912         // Clear the queue instead of deleting it since this function can be called inside CustomElementReactionQueue::invokeAll during upgrades.
1913         if (auto* queue = elementRareData()->customElementReactionQueue())
1914             queue->clear();
1915     }
1916     InspectorInstrumentation::didChangeCustomElementState(*this);
1917 }
1918
1919 void Element::setIsCustomElementUpgradeCandidate()
1920 {
1921     ASSERT(!getFlag(IsCustomElement));
1922     setFlag(IsCustomElement);
1923     setFlag(IsEditingTextOrUndefinedCustomElementFlag);
1924     InspectorInstrumentation::didChangeCustomElementState(*this);
1925 }
1926
1927 void Element::enqueueToUpgrade(JSCustomElementInterface& elementInterface)
1928 {
1929     ASSERT(!isDefinedCustomElement() && !isFailedCustomElement());
1930     setFlag(IsCustomElement);
1931     setFlag(IsEditingTextOrUndefinedCustomElementFlag);
1932     InspectorInstrumentation::didChangeCustomElementState(*this);
1933
1934     auto& data = ensureElementRareData();
1935     ASSERT(!data.customElementReactionQueue());
1936
1937     data.setCustomElementReactionQueue(std::make_unique<CustomElementReactionQueue>(elementInterface));
1938     data.customElementReactionQueue()->enqueueElementUpgrade(*this);
1939 }
1940
1941 CustomElementReactionQueue* Element::reactionQueue() const
1942 {
1943     ASSERT(isDefinedCustomElement() || isCustomElementUpgradeCandidate());
1944     if (!hasRareData())
1945         return nullptr;
1946     return elementRareData()->customElementReactionQueue();
1947 }
1948
1949 const AtomicString& Element::shadowPseudoId() const
1950 {
1951     return pseudo();
1952 }
1953
1954 bool Element::childTypeAllowed(NodeType type) const
1955 {
1956     switch (type) {
1957     case ELEMENT_NODE:
1958     case TEXT_NODE:
1959     case COMMENT_NODE:
1960     case PROCESSING_INSTRUCTION_NODE:
1961     case CDATA_SECTION_NODE:
1962         return true;
1963     default:
1964         break;
1965     }
1966     return false;
1967 }
1968
1969 static void checkForEmptyStyleChange(Element& element)
1970 {
1971     if (element.styleAffectedByEmpty()) {
1972         auto* style = element.renderStyle();
1973         if (!style || (!style->emptyState() || element.hasChildNodes()))
1974             element.invalidateStyleForSubtree();
1975     }
1976 }
1977
1978 enum SiblingCheckType { FinishedParsingChildren, SiblingElementRemoved, Other };
1979
1980 static void checkForSiblingStyleChanges(Element& parent, SiblingCheckType checkType, Element* elementBeforeChange, Element* elementAfterChange)
1981 {
1982     // :empty selector.
1983     checkForEmptyStyleChange(parent);
1984
1985     if (parent.styleValidity() >= Style::Validity::SubtreeInvalid)
1986         return;
1987
1988     // :first-child.  In the parser callback case, we don't have to check anything, since we were right the first time.
1989     // In the DOM case, we only need to do something if |afterChange| is not 0.
1990     // |afterChange| is 0 in the parser case, so it works out that we'll skip this block.
1991     if (parent.childrenAffectedByFirstChildRules() && elementAfterChange) {
1992         // Find our new first child.
1993         RefPtr<Element> newFirstElement = ElementTraversal::firstChild(parent);
1994         // Find the first element node following |afterChange|
1995
1996         // This is the insert/append case.
1997         if (newFirstElement != elementAfterChange) {
1998             auto* style = elementAfterChange->renderStyle();
1999             if (!style || style->firstChildState())
2000                 elementAfterChange->invalidateStyleForSubtree();
2001         }
2002
2003         // We also have to handle node removal.
2004         if (checkType == SiblingElementRemoved && newFirstElement == elementAfterChange && newFirstElement) {
2005             auto* style = newFirstElement->renderStyle();
2006             if (!style || !style->firstChildState())
2007                 newFirstElement->invalidateStyleForSubtree();
2008         }
2009     }
2010
2011     // :last-child.  In the parser callback case, we don't have to check anything, since we were right the first time.
2012     // In the DOM case, we only need to do something if |afterChange| is not 0.
2013     if (parent.childrenAffectedByLastChildRules() && elementBeforeChange) {
2014         // Find our new last child.
2015         RefPtr<Element> newLastElement = ElementTraversal::lastChild(parent);
2016
2017         if (newLastElement != elementBeforeChange) {
2018             auto* style = elementBeforeChange->renderStyle();
2019             if (!style || style->lastChildState())
2020                 elementBeforeChange->invalidateStyleForSubtree();
2021         }
2022
2023         // We also have to handle node removal.  The parser callback case is similar to node removal as well in that we need to change the last child
2024         // to match now.
2025         if ((checkType == SiblingElementRemoved || checkType == FinishedParsingChildren) && newLastElement == elementBeforeChange && newLastElement) {
2026             auto* style = newLastElement->renderStyle();
2027             if (!style || !style->lastChildState())
2028                 newLastElement->invalidateStyleForSubtree();
2029         }
2030     }
2031
2032     if (elementAfterChange) {
2033         if (elementAfterChange->styleIsAffectedByPreviousSibling())
2034             elementAfterChange->invalidateStyleForSubtree();
2035         else if (elementAfterChange->affectsNextSiblingElementStyle()) {
2036             Element* elementToInvalidate = elementAfterChange;
2037             do {
2038                 elementToInvalidate = elementToInvalidate->nextElementSibling();
2039             } while (elementToInvalidate && !elementToInvalidate->styleIsAffectedByPreviousSibling());
2040
2041             if (elementToInvalidate)
2042                 elementToInvalidate->invalidateStyleForSubtree();
2043         }
2044     }
2045
2046     // Backward positional selectors include nth-last-child, nth-last-of-type, last-of-type and only-of-type.
2047     // We have to invalidate everything following the insertion point in the forward case, and everything before the insertion point in the
2048     // backward case.
2049     // |afterChange| is 0 in the parser callback case, so we won't do any work for the forward case if we don't have to.
2050     // For performance reasons we just mark the parent node as changed, since we don't want to make childrenChanged O(n^2) by crawling all our kids
2051     // here.  recalcStyle will then force a walk of the children when it sees that this has happened.
2052     if (parent.childrenAffectedByBackwardPositionalRules() && elementBeforeChange)
2053         parent.invalidateStyleForSubtree();
2054 }
2055
2056 void Element::childrenChanged(const ChildChange& change)
2057 {
2058     ContainerNode::childrenChanged(change);
2059     if (change.source == ChildChangeSource::Parser)
2060         checkForEmptyStyleChange(*this);
2061     else {
2062         SiblingCheckType checkType = change.type == ElementRemoved ? SiblingElementRemoved : Other;
2063         checkForSiblingStyleChanges(*this, checkType, change.previousSiblingElement, change.nextSiblingElement);
2064     }
2065
2066     if (ShadowRoot* shadowRoot = this->shadowRoot()) {
2067         switch (change.type) {
2068         case ElementInserted:
2069         case ElementRemoved:
2070             // For elements, we notify shadowRoot in Element::insertedInto and Element::removedFrom.
2071             break;
2072         case AllChildrenRemoved:
2073         case AllChildrenReplaced:
2074             shadowRoot->didRemoveAllChildrenOfShadowHost();
2075             break;
2076         case TextInserted:
2077         case TextRemoved:
2078         case TextChanged:
2079             shadowRoot->didChangeDefaultSlot();
2080             break;
2081         case NonContentsChildInserted:
2082         case NonContentsChildRemoved:
2083             break;
2084         }
2085     }
2086 }
2087
2088 void Element::setAttributeEventListener(const AtomicString& eventType, const QualifiedName& attributeName, const AtomicString& attributeValue)
2089 {
2090     setAttributeEventListener(eventType, JSLazyEventListener::create(*this, attributeName, attributeValue), mainThreadNormalWorld());
2091 }
2092
2093 void Element::removeAllEventListeners()
2094 {
2095     ContainerNode::removeAllEventListeners();
2096     if (ShadowRoot* shadowRoot = this->shadowRoot())
2097         shadowRoot->removeAllEventListeners();
2098 }
2099
2100 void Element::beginParsingChildren()
2101 {
2102     clearIsParsingChildrenFinished();
2103 }
2104
2105 void Element::finishParsingChildren()
2106 {
2107     ContainerNode::finishParsingChildren();
2108     setIsParsingChildrenFinished();
2109     checkForSiblingStyleChanges(*this, FinishedParsingChildren, ElementTraversal::lastChild(*this), nullptr);
2110 }
2111
2112 #if ENABLE(TREE_DEBUGGING)
2113 void Element::formatForDebugger(char* buffer, unsigned length) const
2114 {
2115     StringBuilder result;
2116     String s;
2117
2118     result.append(nodeName());
2119
2120     s = getIdAttribute();
2121     if (s.length() > 0) {
2122         if (result.length() > 0)
2123             result.appendLiteral("; ");
2124         result.appendLiteral("id=");
2125         result.append(s);
2126     }
2127
2128     s = getAttribute(classAttr);
2129     if (s.length() > 0) {
2130         if (result.length() > 0)
2131             result.appendLiteral("; ");
2132         result.appendLiteral("class=");
2133         result.append(s);
2134     }
2135
2136     strncpy(buffer, result.toString().utf8().data(), length - 1);
2137 }
2138 #endif
2139
2140 const Vector<RefPtr<Attr>>& Element::attrNodeList()
2141 {
2142     ASSERT(hasSyntheticAttrChildNodes());
2143     return *attrNodeListForElement(*this);
2144 }
2145
2146 void Element::attachAttributeNodeIfNeeded(Attr& attrNode)
2147 {
2148     ASSERT(!attrNode.ownerElement() || attrNode.ownerElement() == this);
2149     if (attrNode.ownerElement() == this)
2150         return;
2151
2152     NoEventDispatchAssertion::InMainThread assertNoEventDispatch;
2153
2154     attrNode.attachToElement(*this);
2155     ensureAttrNodeListForElement(*this).append(&attrNode);
2156 }
2157
2158 ExceptionOr<RefPtr<Attr>> Element::setAttributeNode(Attr& attrNode)
2159 {
2160     RefPtr<Attr> oldAttrNode = attrIfExists(attrNode.localName(), shouldIgnoreAttributeCase(*this));
2161     if (oldAttrNode.get() == &attrNode)
2162         return WTFMove(oldAttrNode);
2163
2164     // InUseAttributeError: Raised if node is an Attr that is already an attribute of another Element object.
2165     // The DOM user must explicitly clone Attr nodes to re-use them in other elements.
2166     if (attrNode.ownerElement() && attrNode.ownerElement() != this)
2167         return Exception { InUseAttributeError };
2168
2169     {
2170         NoEventDispatchAssertion::InMainThread assertNoEventDispatch;
2171         synchronizeAllAttributes();
2172     }
2173
2174     auto& elementData = ensureUniqueElementData();
2175
2176     auto existingAttributeIndex = elementData.findAttributeIndexByName(attrNode.localName(), shouldIgnoreAttributeCase(*this));
2177
2178     // Attr::value() will return its 'm_standaloneValue' member any time its Element is set to nullptr. We need to cache this value
2179     // before making changes to attrNode's Element connections.
2180     auto attrNodeValue = attrNode.value();
2181
2182     if (existingAttributeIndex == ElementData::attributeNotFound) {
2183         attachAttributeNodeIfNeeded(attrNode);
2184         setAttributeInternal(elementData.findAttributeIndexByName(attrNode.qualifiedName()), attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2185     } else {
2186         const Attribute& attribute = attributeAt(existingAttributeIndex);
2187         if (oldAttrNode)
2188             detachAttrNodeFromElementWithValue(oldAttrNode.get(), attribute.value());
2189         else
2190             oldAttrNode = Attr::create(document(), attrNode.qualifiedName(), attribute.value());
2191
2192         attachAttributeNodeIfNeeded(attrNode);
2193
2194         if (attribute.name().matches(attrNode.qualifiedName()))
2195             setAttributeInternal(existingAttributeIndex, attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2196         else {
2197             removeAttributeInternal(existingAttributeIndex, NotInSynchronizationOfLazyAttribute);
2198             setAttributeInternal(ensureUniqueElementData().findAttributeIndexByName(attrNode.qualifiedName()), attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2199         }
2200     }
2201
2202     return WTFMove(oldAttrNode);
2203 }
2204
2205 ExceptionOr<RefPtr<Attr>> Element::setAttributeNodeNS(Attr& attrNode)
2206 {
2207     RefPtr<Attr> oldAttrNode = attrIfExists(attrNode.qualifiedName());
2208     if (oldAttrNode.get() == &attrNode)
2209         return WTFMove(oldAttrNode);
2210
2211     // InUseAttributeError: Raised if node is an Attr that is already an attribute of another Element object.
2212     // The DOM user must explicitly clone Attr nodes to re-use them in other elements.
2213     if (attrNode.ownerElement() && attrNode.ownerElement() != this)
2214         return Exception { InUseAttributeError };
2215
2216     // Attr::value() will return its 'm_standaloneValue' member any time its Element is set to nullptr. We need to cache this value
2217     // before making changes to attrNode's Element connections.
2218     auto attrNodeValue = attrNode.value();
2219     unsigned index = 0;
2220     {
2221         NoEventDispatchAssertion::InMainThread assertNoEventDispatch;
2222         synchronizeAllAttributes();
2223         auto& elementData = ensureUniqueElementData();
2224
2225         index = elementData.findAttributeIndexByName(attrNode.qualifiedName());
2226
2227         if (index != ElementData::attributeNotFound) {
2228             if (oldAttrNode)
2229                 detachAttrNodeFromElementWithValue(oldAttrNode.get(), elementData.attributeAt(index).value());
2230             else
2231                 oldAttrNode = Attr::create(document(), attrNode.qualifiedName(), elementData.attributeAt(index).value());
2232         }
2233     }
2234
2235     attachAttributeNodeIfNeeded(attrNode);
2236     setAttributeInternal(index, attrNode.qualifiedName(), attrNodeValue, NotInSynchronizationOfLazyAttribute);
2237
2238     return WTFMove(oldAttrNode);
2239 }
2240
2241 ExceptionOr<Ref<Attr>> Element::removeAttributeNode(Attr& attr)
2242 {
2243     if (attr.ownerElement() != this)
2244         return Exception { NotFoundError };
2245
2246     ASSERT(&document() == &attr.document());
2247
2248     synchronizeAllAttributes();
2249
2250     if (!m_elementData)
2251         return Exception { NotFoundError };
2252
2253     auto existingAttributeIndex = m_elementData->findAttributeIndexByName(attr.qualifiedName());
2254     if (existingAttributeIndex == ElementData::attributeNotFound)
2255         return Exception { NotFoundError };
2256
2257     Ref<Attr> oldAttrNode { attr };
2258
2259     detachAttrNodeFromElementWithValue(&attr, m_elementData->attributeAt(existingAttributeIndex).value());
2260     removeAttributeInternal(existingAttributeIndex, NotInSynchronizationOfLazyAttribute);
2261
2262     return WTFMove(oldAttrNode);
2263 }
2264
2265 ExceptionOr<QualifiedName> Element::parseAttributeName(const AtomicString& namespaceURI, const AtomicString& qualifiedName)
2266 {
2267     auto parseResult = Document::parseQualifiedName(namespaceURI, qualifiedName);
2268     if (parseResult.hasException())
2269         return parseResult.releaseException();
2270     QualifiedName parsedAttributeName { parseResult.releaseReturnValue() };
2271     if (!Document::hasValidNamespaceForAttributes(parsedAttributeName))
2272         return Exception { NamespaceError };
2273     return WTFMove(parsedAttributeName);
2274 }
2275
2276 ExceptionOr<void> Element::setAttributeNS(const AtomicString& namespaceURI, const AtomicString& qualifiedName, const AtomicString& value)
2277 {
2278     auto result = parseAttributeName(namespaceURI, qualifiedName);
2279     if (result.hasException())
2280         return result.releaseException();
2281     setAttribute(result.releaseReturnValue(), value);
2282     return { };
2283 }
2284
2285 void Element::removeAttributeInternal(unsigned index, SynchronizationOfLazyAttribute inSynchronizationOfLazyAttribute)
2286 {
2287     ASSERT_WITH_SECURITY_IMPLICATION(index < attributeCount());
2288
2289     UniqueElementData& elementData = ensureUniqueElementData();
2290
2291     QualifiedName name = elementData.attributeAt(index).name();
2292     AtomicString valueBeingRemoved = elementData.attributeAt(index).value();
2293
2294     if (RefPtr<Attr> attrNode = attrIfExists(name))
2295         detachAttrNodeFromElementWithValue(attrNode.get(), elementData.attributeAt(index).value());
2296
2297     if (inSynchronizationOfLazyAttribute) {
2298         elementData.removeAttribute(index);
2299         return;
2300     }
2301
2302     if (!valueBeingRemoved.isNull())
2303         willModifyAttribute(name, valueBeingRemoved, nullAtom());
2304
2305     {
2306         Style::AttributeChangeInvalidation styleInvalidation(*this, name, valueBeingRemoved, nullAtom());
2307         elementData.removeAttribute(index);
2308     }
2309
2310     didRemoveAttribute(name, valueBeingRemoved);
2311 }
2312
2313 void Element::addAttributeInternal(const QualifiedName& name, const AtomicString& value, SynchronizationOfLazyAttribute inSynchronizationOfLazyAttribute)
2314 {
2315     if (inSynchronizationOfLazyAttribute) {
2316         ensureUniqueElementData().addAttribute(name, value);
2317         return;
2318     }
2319
2320     willModifyAttribute(name, nullAtom(), value);
2321     {
2322         Style::AttributeChangeInvalidation styleInvalidation(*this, name, nullAtom(), value);
2323         ensureUniqueElementData().addAttribute(name, value);
2324     }
2325     didAddAttribute(name, value);
2326 }
2327
2328 bool Element::removeAttribute(const AtomicString& name)
2329 {
2330     if (!elementData())
2331         return false;
2332
2333     AtomicString localName = shouldIgnoreAttributeCase(*this) ? name.convertToASCIILowercase() : name;
2334     unsigned index = elementData()->findAttributeIndexByName(localName, false);
2335     if (index == ElementData::attributeNotFound) {
2336         if (UNLIKELY(localName == styleAttr) && elementData()->styleAttributeIsDirty() && is<StyledElement>(*this))
2337             downcast<StyledElement>(*this).removeAllInlineStyleProperties();
2338         return false;
2339     }
2340
2341     removeAttributeInternal(index, NotInSynchronizationOfLazyAttribute);
2342     return true;
2343 }
2344
2345 bool Element::removeAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName)
2346 {
2347     return removeAttribute(QualifiedName(nullAtom(), localName, namespaceURI));
2348 }
2349
2350 RefPtr<Attr> Element::getAttributeNode(const AtomicString& localName)
2351 {
2352     if (!elementData())
2353         return nullptr;
2354     synchronizeAttribute(localName);
2355     const Attribute* attribute = elementData()->findAttributeByName(localName, shouldIgnoreAttributeCase(*this));
2356     if (!attribute)
2357         return nullptr;
2358     return ensureAttr(attribute->name());
2359 }
2360
2361 RefPtr<Attr> Element::getAttributeNodeNS(const AtomicString& namespaceURI, const AtomicString& localName)
2362 {
2363     if (!elementData())
2364         return 0;
2365     QualifiedName qName(nullAtom(), localName, namespaceURI);
2366     synchronizeAttribute(qName);
2367     const Attribute* attribute = elementData()->findAttributeByName(qName);
2368     if (!attribute)
2369         return 0;
2370     return ensureAttr(attribute->name());
2371 }
2372
2373 bool Element::hasAttribute(const AtomicString& localName) const
2374 {
2375     if (!elementData())
2376         return false;
2377     synchronizeAttribute(localName);
2378     return elementData()->findAttributeByName(localName, shouldIgnoreAttributeCase(*this));
2379 }
2380
2381 bool Element::hasAttributeNS(const AtomicString& namespaceURI, const AtomicString& localName) const
2382 {
2383     if (!elementData())
2384         return false;
2385     QualifiedName qName(nullAtom(), localName, namespaceURI);
2386     synchronizeAttribute(qName);
2387     return elementData()->findAttributeByName(qName);
2388 }
2389
2390 void Element::focus(bool restorePreviousSelection, FocusDirection direction)
2391 {
2392     if (!isConnected())
2393         return;
2394
2395     if (document().focusedElement() == this) {
2396         if (document().page())
2397             document().page()->chrome().client().elementDidRefocus(*this);
2398
2399         return;
2400     }
2401
2402     // If the stylesheets have already been loaded we can reliably check isFocusable.
2403     // If not, we continue and set the focused node on the focus controller below so
2404     // that it can be updated soon after attach. 
2405     if (document().haveStylesheetsLoaded()) {
2406         document().updateLayoutIgnorePendingStylesheets();
2407         if (!isFocusable())
2408             return;
2409     }
2410
2411     if (!supportsFocus())
2412         return;
2413
2414     RefPtr<Node> protect;
2415     if (Page* page = document().page()) {
2416         // Focus and change event handlers can cause us to lose our last ref.
2417         // If a focus event handler changes the focus to a different node it
2418         // does not make sense to continue and update appearence.
2419         protect = this;
2420         if (!page->focusController().setFocusedElement(this, *document().frame(), direction))
2421             return;
2422     }
2423
2424     // Setting the focused node above might have invalidated the layout due to scripts.
2425     document().updateLayoutIgnorePendingStylesheets();
2426
2427     SelectionRevealMode revealMode = SelectionRevealMode::Reveal;
2428 #if PLATFORM(IOS)
2429     // Focusing a form element triggers animation in UIKit to scroll to the right position.
2430     // Calling updateFocusAppearance() would generate an unnecessary call to ScrollView::setScrollPosition(),
2431     // which would jump us around during this animation. See <rdar://problem/6699741>.
2432     bool isFormControl = is<HTMLFormControlElement>(*this);
2433     if (isFormControl)
2434         revealMode = SelectionRevealMode::RevealUpToMainFrame;
2435 #endif
2436
2437     updateFocusAppearance(restorePreviousSelection ? SelectionRestorationMode::Restore : SelectionRestorationMode::SetDefault, revealMode);
2438 }
2439
2440 void Element::updateFocusAppearance(SelectionRestorationMode, SelectionRevealMode revealMode)
2441 {
2442     if (isRootEditableElement()) {
2443         // Keep frame alive in this method, since setSelection() may release the last reference to |frame|.
2444         RefPtr<Frame> frame = document().frame();
2445         if (!frame)
2446             return;
2447         
2448         // When focusing an editable element in an iframe, don't reset the selection if it already contains a selection.
2449         if (this == frame->selection().selection().rootEditableElement())
2450             return;
2451
2452         // FIXME: We should restore the previous selection if there is one.
2453         VisibleSelection newSelection = VisibleSelection(firstPositionInOrBeforeNode(this), DOWNSTREAM);
2454         
2455         if (frame->selection().shouldChangeSelection(newSelection)) {
2456             frame->selection().setSelection(newSelection, FrameSelection::defaultSetSelectionOptions(), Element::defaultFocusTextStateChangeIntent());
2457             frame->selection().revealSelection(revealMode);
2458         }
2459     } else if (renderer() && !renderer()->isWidget()) {
2460         bool insideFixed;
2461         LayoutRect absoluteBounds = renderer()->absoluteAnchorRect(&insideFixed);
2462         renderer()->scrollRectToVisible(revealMode, absoluteBounds, insideFixed);
2463     }
2464 }
2465
2466 void Element::blur()
2467 {
2468     if (treeScope().focusedElementInScope() == this) {
2469         if (Frame* frame = document().frame())
2470             frame->page()->focusController().setFocusedElement(nullptr, *frame);
2471         else
2472             document().setFocusedElement(nullptr);
2473     }
2474 }
2475
2476 void Element::dispatchFocusInEvent(const AtomicString& eventType, RefPtr<Element>&& oldFocusedElement)
2477 {
2478     ASSERT_WITH_SECURITY_IMPLICATION(NoEventDispatchAssertion::InMainThread::isEventAllowed());
2479     ASSERT(eventType == eventNames().focusinEvent || eventType == eventNames().DOMFocusInEvent);
2480     dispatchScopedEvent(FocusEvent::create(eventType, true, false, document().defaultView(), 0, WTFMove(oldFocusedElement)));
2481 }
2482
2483 void Element::dispatchFocusOutEvent(const AtomicString& eventType, RefPtr<Element>&& newFocusedElement)
2484 {
2485     ASSERT_WITH_SECURITY_IMPLICATION(NoEventDispatchAssertion::InMainThread::isEventAllowed());
2486     ASSERT(eventType == eventNames().focusoutEvent || eventType == eventNames().DOMFocusOutEvent);
2487     dispatchScopedEvent(FocusEvent::create(eventType, true, false, document().defaultView(), 0, WTFMove(newFocusedElement)));
2488 }
2489
2490 void Element::dispatchFocusEvent(RefPtr<Element>&& oldFocusedElement, FocusDirection)
2491 {
2492     if (document().page())
2493         document().page()->chrome().client().elementDidFocus(*this);
2494
2495     EventDispatcher::dispatchEvent(*this, FocusEvent::create(eventNames().focusEvent, false, false, document().defaultView(), 0, WTFMove(oldFocusedElement)));
2496 }
2497
2498 void Element::dispatchBlurEvent(RefPtr<Element>&& newFocusedElement)
2499 {
2500     if (document().page())
2501         document().page()->chrome().client().elementDidBlur(*this);
2502
2503     EventDispatcher::dispatchEvent(*this, FocusEvent::create(eventNames().blurEvent, false, false, document().defaultView(), 0, WTFMove(newFocusedElement)));
2504 }
2505
2506 void Element::dispatchWebKitImageReadyEventForTesting()
2507 {
2508     if (document().settings().webkitImageReadyEventEnabled())
2509         dispatchEvent(Event::create("webkitImageFrameReady", true, true));
2510 }
2511
2512 bool Element::dispatchMouseForceWillBegin()
2513 {
2514 #if ENABLE(MOUSE_FORCE_EVENTS)
2515     if (!document().hasListenerType(Document::FORCEWILLBEGIN_LISTENER))
2516         return false;
2517
2518     Frame* frame = document().frame();
2519     if (!frame)
2520         return false;
2521
2522     PlatformMouseEvent platformMouseEvent { frame->eventHandler().lastKnownMousePosition(), frame->eventHandler().lastKnownMouseGlobalPosition(), NoButton, PlatformEvent::NoType, 1, false, false, false, false, WallTime::now(), ForceAtClick, NoTap };
2523     auto mouseForceWillBeginEvent = MouseEvent::create(eventNames().webkitmouseforcewillbeginEvent, document().defaultView(), platformMouseEvent, 0, nullptr);
2524     mouseForceWillBeginEvent->setTarget(this);
2525     dispatchEvent(mouseForceWillBeginEvent);
2526
2527     if (mouseForceWillBeginEvent->defaultHandled() || mouseForceWillBeginEvent->defaultPrevented())
2528         return true;
2529 #endif
2530
2531     return false;
2532 }
2533
2534 ExceptionOr<void> Element::mergeWithNextTextNode(Text& node)
2535 {
2536     auto* next = node.nextSibling();
2537     if (!is<Text>(next))
2538         return { };
2539     Ref<Text> textNext { downcast<Text>(*next) };
2540     node.appendData(textNext->data());
2541     return textNext->remove();
2542 }
2543
2544 String Element::innerHTML() const
2545 {
2546     return createMarkup(*this, ChildrenOnly);
2547 }
2548
2549 String Element::outerHTML() const
2550 {
2551     return createMarkup(*this);
2552 }
2553
2554 ExceptionOr<void> Element::setOuterHTML(const String& html)
2555 {
2556     auto* parentElement = this->parentElement();
2557     if (!is<HTMLElement>(parentElement))
2558         return Exception { NoModificationAllowedError };
2559
2560     Ref<HTMLElement> parent = downcast<HTMLElement>(*parentElement);
2561     RefPtr<Node> prev = previousSibling();
2562     RefPtr<Node> next = nextSibling();
2563
2564     auto fragment = createFragmentForInnerOuterHTML(parent, html, AllowScriptingContent);
2565     if (fragment.hasException())
2566         return fragment.releaseException();
2567
2568     auto replaceResult = parent->replaceChild(fragment.releaseReturnValue().get(), *this);
2569     if (replaceResult.hasException())
2570         return replaceResult.releaseException();
2571
2572     RefPtr<Node> node = next ? next->previousSibling() : nullptr;
2573     if (is<Text>(node)) {
2574         auto result = mergeWithNextTextNode(downcast<Text>(*node));
2575         if (result.hasException())
2576             return result.releaseException();
2577     }
2578     if (is<Text>(prev)) {
2579         auto result = mergeWithNextTextNode(downcast<Text>(*prev));
2580         if (result.hasException())
2581             return result.releaseException();
2582     }
2583     return { };
2584 }
2585
2586
2587 ExceptionOr<void> Element::setInnerHTML(const String& html)
2588 {
2589     auto fragment = createFragmentForInnerOuterHTML(*this, html, AllowScriptingContent);
2590     if (fragment.hasException())
2591         return fragment.releaseException();
2592
2593     ContainerNode* container;
2594     if (!is<HTMLTemplateElement>(*this))
2595         container = this;
2596     else
2597         container = &downcast<HTMLTemplateElement>(*this).content();
2598
2599     return replaceChildrenWithFragment(*container, fragment.releaseReturnValue());
2600 }
2601
2602 String Element::innerText()
2603 {
2604     // We need to update layout, since plainText uses line boxes in the render tree.
2605     document().updateLayoutIgnorePendingStylesheets();
2606
2607     if (!renderer())
2608         return textContent(true);
2609
2610     return plainText(rangeOfContents(*this).ptr());
2611 }
2612
2613 String Element::outerText()
2614 {
2615     // Getting outerText is the same as getting innerText, only
2616     // setting is different. You would think this should get the plain
2617     // text for the outer range, but this is wrong, <br> for instance
2618     // would return different values for inner and outer text by such
2619     // a rule, but it doesn't in WinIE, and we want to match that.
2620     return innerText();
2621 }
2622
2623 String Element::title() const
2624 {
2625     return String();
2626 }
2627
2628 const AtomicString& Element::pseudo() const
2629 {
2630     return attributeWithoutSynchronization(pseudoAttr);
2631 }
2632
2633 void Element::setPseudo(const AtomicString& value)
2634 {
2635     setAttributeWithoutSynchronization(pseudoAttr, value);
2636 }
2637
2638 LayoutSize Element::minimumSizeForResizing() const
2639 {
2640     return hasRareData() ? elementRareData()->minimumSizeForResizing() : defaultMinimumSizeForResizing();
2641 }
2642
2643 void Element::setMinimumSizeForResizing(const LayoutSize& size)
2644 {
2645     if (!hasRareData() && size == defaultMinimumSizeForResizing())
2646         return;
2647     ensureElementRareData().setMinimumSizeForResizing(size);
2648 }
2649
2650 void Element::willBecomeFullscreenElement()
2651 {
2652     for (auto& child : descendantsOfType<Element>(*this))
2653         child.ancestorWillEnterFullscreen();
2654 }
2655
2656 static PseudoElement* beforeOrAfterPseudoElement(Element& host, PseudoId pseudoElementSpecifier)
2657 {
2658     switch (pseudoElementSpecifier) {
2659     case BEFORE:
2660         return host.beforePseudoElement();
2661     case AFTER:
2662         return host.afterPseudoElement();
2663     default:
2664         return nullptr;
2665     }
2666 }
2667
2668 const RenderStyle* Element::existingComputedStyle() const
2669 {
2670     if (auto* renderTreeStyle = renderStyle())
2671         return renderTreeStyle;
2672
2673     if (hasRareData())
2674         return elementRareData()->computedStyle();
2675
2676     return nullptr;
2677 }
2678
2679 const RenderStyle& Element::resolveComputedStyle()
2680 {
2681     ASSERT(isConnected());
2682     ASSERT(!existingComputedStyle());
2683
2684     Deque<Element*, 32> elementsRequiringComputedStyle({ this });
2685     const RenderStyle* computedStyle = nullptr;
2686
2687     // Collect ancestors until we find one that has style.
2688     auto composedAncestors = composedTreeAncestors(*this);
2689     for (auto& ancestor : composedAncestors) {
2690         if (auto* existingStyle = ancestor.existingComputedStyle()) {
2691             computedStyle = existingStyle;
2692             break;
2693         }
2694         elementsRequiringComputedStyle.prepend(&ancestor);
2695     }
2696
2697     // Resolve and cache styles starting from the most distant ancestor.
2698     for (auto* element : elementsRequiringComputedStyle) {
2699         auto style = document().styleForElementIgnoringPendingStylesheets(*element, computedStyle);
2700         computedStyle = style.get();
2701         ElementRareData& rareData = element->ensureElementRareData();
2702         rareData.setComputedStyle(WTFMove(style));
2703     }
2704
2705     return *computedStyle;
2706 }
2707
2708 const RenderStyle& Element::resolvePseudoElementStyle(PseudoId pseudoElementSpecifier)
2709 {
2710     ASSERT(!isPseudoElement());
2711
2712     auto* parentStyle = existingComputedStyle();
2713     ASSERT(parentStyle);
2714     ASSERT(!parentStyle->getCachedPseudoStyle(pseudoElementSpecifier));
2715
2716     auto style = document().styleForElementIgnoringPendingStylesheets(*this, parentStyle, pseudoElementSpecifier);
2717     if (!style) {
2718         style = RenderStyle::createPtr();
2719         style->inheritFrom(*parentStyle);
2720         style->setStyleType(pseudoElementSpecifier);
2721     }
2722
2723     auto* computedStyle = style.get();
2724     const_cast<RenderStyle*>(parentStyle)->addCachedPseudoStyle(WTFMove(style));
2725     return *computedStyle;
2726 }
2727
2728 const RenderStyle* Element::computedStyle(PseudoId pseudoElementSpecifier)
2729 {
2730     if (!isConnected())
2731         return nullptr;
2732
2733     if (PseudoElement* pseudoElement = beforeOrAfterPseudoElement(*this, pseudoElementSpecifier))
2734         return pseudoElement->computedStyle();
2735
2736     auto* style = existingComputedStyle();
2737     if (!style)
2738         style = &resolveComputedStyle();
2739
2740     if (pseudoElementSpecifier) {
2741         if (auto* cachedPseudoStyle = style->getCachedPseudoStyle(pseudoElementSpecifier))
2742             return cachedPseudoStyle;
2743         return &resolvePseudoElementStyle(pseudoElementSpecifier);
2744     }
2745
2746     return style;
2747 }
2748
2749 bool Element::needsStyleInvalidation() const
2750 {
2751     if (!inRenderedDocument())
2752         return false;
2753     if (styleValidity() >= Style::Validity::SubtreeInvalid)
2754         return false;
2755     if (document().hasPendingForcedStyleRecalc())
2756         return false;
2757
2758     return true;
2759 }
2760
2761 void Element::setStyleAffectedByEmpty()
2762 {
2763     ensureElementRareData().setStyleAffectedByEmpty(true);
2764 }
2765
2766 void Element::setStyleAffectedByFocusWithin()
2767 {
2768     ensureElementRareData().setStyleAffectedByFocusWithin(true);
2769 }
2770
2771 void Element::setStyleAffectedByActive()
2772 {
2773     ensureElementRareData().setStyleAffectedByActive(true);
2774 }
2775
2776 void Element::setChildrenAffectedByDrag()
2777 {
2778     ensureElementRareData().setChildrenAffectedByDrag(true);
2779 }
2780
2781 void Element::setChildrenAffectedByBackwardPositionalRules()
2782 {
2783     ensureElementRareData().setChildrenAffectedByBackwardPositionalRules(true);
2784 }
2785
2786 void Element::setChildrenAffectedByPropertyBasedBackwardPositionalRules()
2787 {
2788     ensureElementRareData().setChildrenAffectedByPropertyBasedBackwardPositionalRules(true);
2789 }
2790
2791 void Element::setChildIndex(unsigned index)
2792 {
2793     ElementRareData& rareData = ensureElementRareData();
2794     rareData.setChildIndex(index);
2795 }
2796
2797 bool Element::hasFlagsSetDuringStylingOfChildren() const
2798 {
2799     if (childrenAffectedByHover() || childrenAffectedByFirstChildRules() || childrenAffectedByLastChildRules())
2800         return true;
2801
2802     if (!hasRareData())
2803         return false;
2804     return rareDataStyleAffectedByActive()
2805         || rareDataChildrenAffectedByDrag()
2806         || rareDataChildrenAffectedByBackwardPositionalRules()
2807         || rareDataChildrenAffectedByPropertyBasedBackwardPositionalRules();
2808 }
2809
2810 bool Element::rareDataStyleAffectedByEmpty() const
2811 {
2812     ASSERT(hasRareData());
2813     return elementRareData()->styleAffectedByEmpty();
2814 }
2815
2816 bool Element::rareDataStyleAffectedByFocusWithin() const
2817 {
2818     ASSERT(hasRareData());
2819     return elementRareData()->styleAffectedByFocusWithin();
2820 }
2821
2822 bool Element::rareDataStyleAffectedByActive() const
2823 {
2824     ASSERT(hasRareData());
2825     return elementRareData()->styleAffectedByActive();
2826 }
2827
2828 bool Element::rareDataChildrenAffectedByDrag() const
2829 {
2830     ASSERT(hasRareData());
2831     return elementRareData()->childrenAffectedByDrag();
2832 }
2833
2834 bool Element::rareDataChildrenAffectedByBackwardPositionalRules() const
2835 {
2836     ASSERT(hasRareData());
2837     return elementRareData()->childrenAffectedByBackwardPositionalRules();
2838 }
2839
2840 bool Element::rareDataChildrenAffectedByPropertyBasedBackwardPositionalRules() const
2841 {
2842     ASSERT(hasRareData());
2843     return elementRareData()->childrenAffectedByPropertyBasedBackwardPositionalRules();
2844 }
2845
2846 unsigned Element::rareDataChildIndex() const
2847 {
2848     ASSERT(hasRareData());
2849     return elementRareData()->childIndex();
2850 }
2851
2852 AtomicString Element::computeInheritedLanguage() const
2853 {
2854     if (const ElementData* elementData = this->elementData()) {
2855         if (const Attribute* attribute = elementData->findLanguageAttribute())
2856             return attribute->value();
2857     }
2858
2859     // The language property is inherited, so we iterate over the parents to find the first language.
2860     const Node* currentNode = this;
2861     while ((currentNode = currentNode->parentNode())) {
2862         if (is<Element>(*currentNode)) {
2863             if (const ElementData* elementData = downcast<Element>(*currentNode).elementData()) {
2864                 if (const Attribute* attribute = elementData->findLanguageAttribute())
2865                     return attribute->value();
2866             }
2867         } else if (is<Document>(*currentNode)) {
2868             // checking the MIME content-language
2869             return downcast<Document>(*currentNode).contentLanguage();
2870         }
2871     }
2872
2873     return nullAtom();
2874 }
2875
2876 Locale& Element::locale() const
2877 {
2878     return document().getCachedLocale(computeInheritedLanguage());
2879 }
2880
2881 void Element::normalizeAttributes()
2882 {
2883     if (!hasAttributes())
2884         return;
2885
2886     auto* attrNodeList = attrNodeListForElement(*this);
2887     if (!attrNodeList)
2888         return;
2889
2890     // Copy the Attr Vector because Node::normalize() can fire synchronous JS
2891     // events (e.g. DOMSubtreeModified) and a JS listener could add / remove
2892     // attributes while we are iterating.
2893     auto copyOfAttrNodeList = *attrNodeList;
2894     for (auto& attrNode : copyOfAttrNodeList)
2895         attrNode->normalize();
2896 }
2897
2898 PseudoElement* Element::beforePseudoElement() const
2899 {
2900     return hasRareData() ? elementRareData()->beforePseudoElement() : nullptr;
2901 }
2902
2903 PseudoElement* Element::afterPseudoElement() const
2904 {
2905     return hasRareData() ? elementRareData()->afterPseudoElement() : nullptr;
2906 }
2907
2908 void Element::setBeforePseudoElement(Ref<PseudoElement>&& element)
2909 {
2910     ensureElementRareData().setBeforePseudoElement(WTFMove(element));
2911 }
2912
2913 void Element::setAfterPseudoElement(Ref<PseudoElement>&& element)
2914 {
2915     ensureElementRareData().setAfterPseudoElement(WTFMove(element));
2916 }
2917
2918 static void disconnectPseudoElement(PseudoElement* pseudoElement)
2919 {
2920     if (!pseudoElement)
2921         return;
2922     if (pseudoElement->renderer())
2923         RenderTreeUpdater::tearDownRenderers(*pseudoElement);
2924     ASSERT(pseudoElement->hostElement());
2925     pseudoElement->clearHostElement();
2926 }
2927
2928 void Element::clearBeforePseudoElement()
2929 {
2930     if (!hasRareData())
2931         return;
2932     disconnectPseudoElement(elementRareData()->beforePseudoElement());
2933     elementRareData()->setBeforePseudoElement(nullptr);
2934 }
2935
2936 void Element::clearAfterPseudoElement()
2937 {
2938     if (!hasRareData())
2939         return;
2940     disconnectPseudoElement(elementRareData()->afterPseudoElement());
2941     elementRareData()->setAfterPseudoElement(nullptr);
2942 }
2943
2944 bool Element::matchesValidPseudoClass() const
2945 {
2946     return false;
2947 }
2948
2949 bool Element::matchesInvalidPseudoClass() const
2950 {
2951     return false;
2952 }
2953
2954 bool Element::matchesReadWritePseudoClass() const
2955 {
2956     return false;
2957 }
2958
2959 bool Element::matchesIndeterminatePseudoClass() const
2960 {
2961     return shouldAppearIndeterminate();
2962 }
2963
2964 bool Element::matchesDefaultPseudoClass() const
2965 {
2966     return false;
2967 }
2968
2969 ExceptionOr<bool> Element::matches(const String& selector)
2970 {
2971     auto query = document().selectorQueryForString(selector);
2972     if (query.hasException())
2973         return query.releaseException();
2974     return query.releaseReturnValue().matches(*this);
2975 }
2976
2977 ExceptionOr<Element*> Element::closest(const String& selector)
2978 {
2979     auto query = document().selectorQueryForString(selector);
2980     if (query.hasException())
2981         return query.releaseException();
2982     return query.releaseReturnValue().closest(*this);
2983 }
2984
2985 bool Element::shouldAppearIndeterminate() const
2986 {
2987     return false;
2988 }
2989
2990 bool Element::mayCauseRepaintInsideViewport(const IntRect* visibleRect) const
2991 {
2992     return renderer() && renderer()->mayCauseRepaintInsideViewport(visibleRect);
2993 }
2994
2995 DOMTokenList& Element::classList()
2996 {
2997     ElementRareData& data = ensureElementRareData();
2998     if (!data.classList())
2999         data.setClassList(std::make_unique<DOMTokenList>(*this, HTMLNames::classAttr));
3000     return *data.classList();
3001 }
3002
3003 DatasetDOMStringMap& Element::dataset()
3004 {
3005     ElementRareData& data = ensureElementRareData();
3006     if (!data.dataset())
3007         data.setDataset(std::make_unique<DatasetDOMStringMap>(*this));
3008     return *data.dataset();
3009 }
3010
3011 URL Element::getURLAttribute(const QualifiedName& name) const
3012 {
3013 #if !ASSERT_DISABLED
3014     if (elementData()) {
3015         if (const Attribute* attribute = findAttributeByName(name))
3016             ASSERT(isURLAttribute(*attribute));
3017     }
3018 #endif
3019     return document().completeURL(stripLeadingAndTrailingHTMLSpaces(getAttribute(name)));
3020 }
3021
3022 URL Element::getNonEmptyURLAttribute(const QualifiedName& name) const
3023 {
3024 #if !ASSERT_DISABLED
3025     if (elementData()) {
3026         if (const Attribute* attribute = findAttributeByName(name))
3027             ASSERT(isURLAttribute(*attribute));
3028     }
3029 #endif
3030     String value = stripLeadingAndTrailingHTMLSpaces(getAttribute(name));
3031     if (value.isEmpty())
3032         return URL();
3033     return document().completeURL(value);
3034 }
3035
3036 int Element::getIntegralAttribute(const QualifiedName& attributeName) const
3037 {
3038     return parseHTMLInteger(getAttribute(attributeName)).valueOr(0);
3039 }
3040
3041 void Element::setIntegralAttribute(const QualifiedName& attributeName, int value)
3042 {
3043     setAttribute(attributeName, AtomicString::number(value));
3044 }
3045
3046 unsigned Element::getUnsignedIntegralAttribute(const QualifiedName& attributeName) const
3047 {
3048     return parseHTMLNonNegativeInteger(getAttribute(attributeName)).valueOr(0);
3049 }
3050
3051 void Element::setUnsignedIntegralAttribute(const QualifiedName& attributeName, unsigned value)
3052 {
3053     setAttribute(attributeName, AtomicString::number(limitToOnlyHTMLNonNegative(value)));
3054 }
3055
3056 bool Element::childShouldCreateRenderer(const Node& child) const
3057 {
3058     // Only create renderers for SVG elements whose parents are SVG elements, or for proper <svg xmlns="svgNS"> subdocuments.
3059     if (child.isSVGElement()) {
3060         ASSERT(!isSVGElement());
3061         const SVGElement& childElement = downcast<SVGElement>(child);
3062         return is<SVGSVGElement>(childElement) && childElement.isValid();
3063     }
3064     return true;
3065 }
3066
3067 #if ENABLE(FULLSCREEN_API)
3068 void Element::webkitRequestFullscreen()
3069 {
3070     document().requestFullScreenForElement(this, Document::EnforceIFrameAllowFullScreenRequirement);
3071 }
3072
3073 bool Element::containsFullScreenElement() const
3074 {
3075     return hasRareData() && elementRareData()->containsFullScreenElement();
3076 }
3077
3078 void Element::setContainsFullScreenElement(bool flag)
3079 {
3080     ensureElementRareData().setContainsFullScreenElement(flag);
3081     invalidateStyleAndLayerComposition();
3082 }
3083
3084 static Element* parentCrossingFrameBoundaries(Element* element)
3085 {
3086     ASSERT(element);
3087     return element->parentElement() ? element->parentElement() : element->document().ownerElement();
3088 }
3089
3090 void Element::setContainsFullScreenElementOnAncestorsCrossingFrameBoundaries(bool flag)
3091 {
3092     Element* element = this;
3093     while ((element = parentCrossingFrameBoundaries(element)))
3094         element->setContainsFullScreenElement(flag);
3095 }
3096 #endif
3097
3098 #if ENABLE(POINTER_LOCK)
3099 void Element::requestPointerLock()
3100 {
3101     if (document().page())
3102         document().page()->pointerLockController().requestPointerLock(this);
3103 }
3104 #endif
3105
3106 SpellcheckAttributeState Element::spellcheckAttributeState() const
3107 {
3108     const AtomicString& value = attributeWithoutSynchronization(HTMLNames::spellcheckAttr);
3109     if (value.isNull())
3110         return SpellcheckAttributeDefault;
3111     if (value.isEmpty() || equalLettersIgnoringASCIICase(value, "true"))
3112         return SpellcheckAttributeTrue;
3113     if (equalLettersIgnoringASCIICase(value, "false"))
3114         return SpellcheckAttributeFalse;
3115     return SpellcheckAttributeDefault;
3116 }
3117
3118 bool Element::isSpellCheckingEnabled() const
3119 {
3120     for (const Element* element = this; element; element = element->parentOrShadowHostElement()) {
3121         switch (element->spellcheckAttributeState()) {
3122         case SpellcheckAttributeTrue:
3123             return true;
3124         case SpellcheckAttributeFalse:
3125             return false;
3126         case SpellcheckAttributeDefault:
3127             break;
3128         }
3129     }
3130
3131     return true;
3132 }
3133
3134 #ifndef NDEBUG
3135 bool Element::fastAttributeLookupAllowed(const QualifiedName& name) const
3136 {
3137     if (name == HTMLNames::styleAttr)
3138         return false;
3139
3140     if (isSVGElement())
3141         return !downcast<SVGElement>(*this).isAnimatableAttribute(name);
3142
3143     return true;
3144 }
3145 #endif
3146
3147 #ifdef DUMP_NODE_STATISTICS
3148 bool Element::hasNamedNodeMap() const
3149 {
3150     return hasRareData() && elementRareData()->attributeMap();
3151 }
3152 #endif
3153
3154 inline void Element::updateName(const AtomicString& oldName, const AtomicString& newName)
3155 {
3156     if (!isInTreeScope())
3157         return;
3158
3159     if (oldName == newName)
3160         return;
3161
3162     updateNameForTreeScope(treeScope(), oldName, newName);
3163
3164     if (!isConnected())
3165         return;
3166     if (!is<HTMLDocument>(document()))
3167         return;
3168     updateNameForDocument(downcast<HTMLDocument>(document()), oldName, newName);
3169 }
3170
3171 void Element::updateNameForTreeScope(TreeScope& scope, const AtomicString& oldName, const AtomicString& newName)
3172 {
3173     ASSERT(oldName != newName);
3174
3175     if (!oldName.isEmpty())
3176         scope.removeElementByName(*oldName.impl(), *this);
3177     if (!newName.isEmpty())
3178         scope.addElementByName(*newName.impl(), *this);
3179 }
3180
3181 void Element::updateNameForDocument(HTMLDocument& document, const AtomicString& oldName, const AtomicString& newName)
3182 {
3183     ASSERT(oldName != newName);
3184
3185     if (isInShadowTree())
3186         return;
3187
3188     if (WindowNameCollection::elementMatchesIfNameAttributeMatch(*this)) {
3189         const AtomicString& id = WindowNameCollection::elementMatchesIfIdAttributeMatch(*this) ? getIdAttribute() : nullAtom();
3190         if (!oldName.isEmpty() && oldName != id)
3191             document.removeWindowNamedItem(*oldName.impl(), *this);
3192         if (!newName.isEmpty() && newName != id)
3193             document.addWindowNamedItem(*newName.impl(), *this);
3194     }
3195
3196     if (DocumentNameCollection::elementMatchesIfNameAttributeMatch(*this)) {
3197         const AtomicString& id = DocumentNameCollection::elementMatchesIfIdAttributeMatch(*this) ? getIdAttribute() : nullAtom();
3198         if (!oldName.isEmpty() && oldName != id)
3199             document.removeDocumentNamedItem(*oldName.impl(), *this);
3200         if (!newName.isEmpty() && newName != id)
3201             document.addDocumentNamedItem(*newName.impl(), *this);
3202     }
3203 }
3204
3205 inline void Element::updateId(const AtomicString& oldId, const AtomicString& newId, NotifyObservers notifyObservers)
3206 {
3207     if (!isInTreeScope())
3208         return;
3209
3210     if (oldId == newId)
3211         return;
3212
3213     updateIdForTreeScope(treeScope(), oldId, newId, notifyObservers);
3214
3215     if (!isConnected())
3216         return;
3217     if (!is<HTMLDocument>(document()))
3218         return;
3219     updateIdForDocument(downcast<HTMLDocument>(document()), oldId, newId, UpdateHTMLDocumentNamedItemMapsOnlyIfDiffersFromNameAttribute);
3220 }
3221
3222 void Element::updateIdForTreeScope(TreeScope& scope, const AtomicString& oldId, const AtomicString& newId, NotifyObservers notifyObservers)
3223 {
3224     ASSERT(isInTreeScope());
3225     ASSERT(oldId != newId);
3226
3227     if (!oldId.isEmpty())
3228         scope.removeElementById(*oldId.impl(), *this, notifyObservers == NotifyObservers::Yes);
3229     if (!newId.isEmpty())
3230         scope.addElementById(*newId.impl(), *this, notifyObservers == NotifyObservers::Yes);
3231 }
3232
3233 void Element::updateIdForDocument(HTMLDocument& document, const AtomicString& oldId, const AtomicString& newId, HTMLDocumentNamedItemMapsUpdatingCondition condition)
3234 {
3235     ASSERT(isConnected());
3236     ASSERT(oldId != newId);
3237
3238     if (isInShadowTree())
3239         return;
3240
3241     if (WindowNameCollection::elementMatchesIfIdAttributeMatch(*this)) {
3242         const AtomicString& name = condition == UpdateHTMLDocumentNamedItemMapsOnlyIfDiffersFromNameAttribute && WindowNameCollection::elementMatchesIfNameAttributeMatch(*this) ? getNameAttribute() : nullAtom();
3243         if (!oldId.isEmpty() && oldId != name)
3244             document.removeWindowNamedItem(*oldId.impl(), *this);
3245         if (!newId.isEmpty() && newId != name)
3246             document.addWindowNamedItem(*newId.impl(), *this);
3247     }
3248
3249     if (DocumentNameCollection::elementMatchesIfIdAttributeMatch(*this)) {
3250         const AtomicString& name = condition == UpdateHTMLDocumentNamedItemMapsOnlyIfDiffersFromNameAttribute && DocumentNameCollection::elementMatchesIfNameAttributeMatch(*this) ? getNameAttribute() : nullAtom();
3251         if (!oldId.isEmpty() && oldId != name)
3252             document.removeDocumentNamedItem(*oldId.impl(), *this);
3253         if (!newId.isEmpty() && newId != name)
3254             document.addDocumentNamedItem(*newId.impl(), *this);
3255     }
3256 }
3257
3258 void Element::updateLabel(TreeScope& scope, const AtomicString& oldForAttributeValue, const AtomicString& newForAttributeValue)
3259 {
3260     ASSERT(hasTagName(labelTag));
3261
3262     if (!isConnected())
3263         return;
3264
3265     if (oldForAttributeValue == newForAttributeValue)
3266         return;
3267
3268     if (!oldForAttributeValue.isEmpty())
3269         scope.removeLabel(*oldForAttributeValue.impl(), downcast<HTMLLabelElement>(*this));
3270     if (!newForAttributeValue.isEmpty())
3271         scope.addLabel(*newForAttributeValue.impl(), downcast<HTMLLabelElement>(*this));
3272 }
3273
3274 void Element::willModifyAttribute(const QualifiedName& name, const AtomicString& oldValue, const AtomicString& newValue)
3275 {
3276     if (name == HTMLNames::idAttr)
3277         updateId(oldValue, newValue, NotifyObservers::No); // Will notify observers after the attribute is actually changed.
3278     else if (name == HTMLNames::nameAttr)
3279         updateName(oldValue, newValue);
3280     else if (name == HTMLNames::forAttr && hasTagName(labelTag)) {
3281         if (treeScope().shouldCacheLabelsByForAttribute())
3282             updateLabel(treeScope(), oldValue, newValue);
3283     }
3284
3285     if (auto recipients = MutationObserverInterestGroup::createForAttributesMutation(*this, name))
3286         recipients->enqueueMutationRecord(MutationRecord::createAttributes(*this, name, oldValue));
3287
3288     InspectorInstrumentation::willModifyDOMAttr(document(), *this, oldValue, newValue);
3289 }
3290
3291 void Element::didAddAttribute(const QualifiedName& name, const AtomicString& value)
3292 {
3293     attributeChanged(name, nullAtom(), value);
3294     InspectorInstrumentation::didModifyDOMAttr(document(), *this, name.localName(), value);
3295     dispatchSubtreeModifiedEvent();
3296 }
3297
3298 void Element::didModifyAttribute(const QualifiedName& name, const AtomicString& oldValue, const AtomicString& newValue)
3299 {
3300     attributeChanged(name, oldValue, newValue);
3301     InspectorInstrumentation::didModifyDOMAttr(document(), *this, name.localName(), newValue);
3302     // Do not dispatch a DOMSubtreeModified event here; see bug 81141.
3303 }
3304
3305 void Element::didRemoveAttribute(const QualifiedName& name, const AtomicString& oldValue)
3306 {
3307     attributeChanged(name, oldValue, nullAtom());
3308     InspectorInstrumentation::didRemoveDOMAttr(document(), *this, name.localName());
3309     dispatchSubtreeModifiedEvent();
3310 }
3311
3312 IntPoint Element::savedLayerScrollPosition() const
3313 {
3314     return hasRareData() ? elementRareData()->savedLayerScrollPosition() : IntPoint();
3315 }
3316
3317 void Element::setSavedLayerScrollPosition(const IntPoint& position)
3318 {
3319     if (position.isZero() && !hasRareData())
3320         return;
3321     ensureElementRareData().setSavedLayerScrollPosition(position);
3322 }
3323
3324 RefPtr<Attr> Element::attrIfExists(const AtomicString& localName, bool shouldIgnoreAttributeCase)
3325 {
3326     if (auto* attrNodeList = attrNodeListForElement(*this))
3327         return findAttrNodeInList(*attrNodeList, localName, shouldIgnoreAttributeCase);
3328     return nullptr;
3329 }
3330
3331 RefPtr<Attr> Element::attrIfExists(const QualifiedName& name)
3332 {
3333     if (auto* attrNodeList = attrNodeListForElement(*this))
3334         return findAttrNodeInList(*attrNodeList, name);
3335     return nullptr;
3336 }
3337
3338 Ref<Attr> Element::ensureAttr(const QualifiedName& name)
3339 {
3340     auto& attrNodeList = ensureAttrNodeListForElement(*this);
3341     RefPtr<Attr> attrNode = findAttrNodeInList(attrNodeList, name);
3342     if (!attrNode) {
3343         attrNode = Attr::create(*this, name);
3344         attrNode->setTreeScopeRecursively(treeScope());
3345         attrNodeList.append(attrNode);
3346     }
3347     return attrNode.releaseNonNull();
3348 }
3349
3350 void Element::detachAttrNodeFromElementWithValue(Attr* attrNode, const AtomicString& value)
3351 {
3352     ASSERT(hasSyntheticAttrChildNodes());
3353     attrNode->detachFromElementWithValue(value);
3354
3355     auto& attrNodeList = *attrNodeListForElement(*this);
3356     bool found = attrNodeList.removeFirstMatching([attrNode](auto& attribute) {
3357         return attribute->qualifiedName() == attrNode->qualifiedName();
3358     });
3359     ASSERT_UNUSED(found, found);
3360     if (attrNodeList.isEmpty())
3361         removeAttrNodeListForElement(*this);
3362 }
3363
3364 void Element::detachAllAttrNodesFromElement()
3365 {
3366     auto* attrNodeList = attrNodeListForElement(*this);
3367     ASSERT(attrNodeList);
3368
3369     for (const Attribute& attribute : attributesIterator()) {
3370         if (RefPtr<Attr> attrNode = findAttrNodeInList(*attrNodeList, attribute.name()))
3371             attrNode->detachFromElementWithValue(attribute.value());
3372     }
3373
3374     removeAttrNodeListForElement(*this);
3375 }
3376
3377 void Element::resetComputedStyle()
3378 {
3379     if (!hasRareData() || !elementRareData()->computedStyle())
3380         return;
3381
3382     auto reset = [](Element& element) {
3383         if (!element.hasRareData() || !element.elementRareData()->computedStyle())
3384             return;
3385         if (element.hasCustomStyleResolveCallbacks())
3386             element.willResetComputedStyle();
3387         element.elementRareData()->resetComputedStyle();
3388     };
3389     reset(*this);
3390     for (auto& child : descendantsOfType<Element>(*this))
3391         reset(child);
3392 }
3393
3394 void Element::resetStyleRelations()
3395 {
3396     if (!hasRareData())
3397         return;
3398     elementRareData()->resetStyleRelations();
3399 }
3400
3401 void Element::clearStyleDerivedDataBeforeDetachingRenderer()
3402 {
3403     clearBeforePseudoElement();
3404     clearAfterPseudoElement();
3405 }
3406
3407 void Element::clearHoverAndActiveStatusBeforeDetachingRenderer()
3408 {
3409     if (!isUserActionElement())
3410         return;
3411     if (hovered())
3412         document().hoveredElementDidDetach(this);
3413     if (inActiveChain())
3414         document().elementInActiveChainDidDetach(this);
3415     document().userActionElements().didDetach(this);
3416 }
3417
3418 void Element::willRecalcStyle(Style::Change)
3419 {
3420     ASSERT(hasCustomStyleResolveCallbacks());
3421 }
3422
3423 void Element::didRecalcStyle(Style::Change)
3424 {
3425     ASSERT(hasCustomStyleResolveCallbacks());
3426 }
3427
3428 void Element::willResetComputedStyle()
3429 {
3430     ASSERT(hasCustomStyleResolveCallbacks());
3431 }
3432
3433 void Element::willAttachRenderers()
3434 {
3435     ASSERT(hasCustomStyleResolveCallbacks());
3436 }
3437
3438 void Element::didAttachRenderers()
3439 {
3440     ASSERT(hasCustomStyleResolveCallbacks());
3441 }
3442
3443 void Element::willDetachRenderers()
3444 {
3445     ASSERT(hasCustomStyleResolveCallbacks());
3446 }
3447
3448 void Element::didDetachRenderers()
3449 {
3450     ASSERT(hasCustomStyleResolveCallbacks());
3451 }
3452
3453 std::optional<ElementStyle> Element::resolveCustomStyle(const RenderStyle&, const RenderStyle*)
3454 {
3455     ASSERT(hasCustomStyleResolveCallbacks());
3456     return std::nullopt;
3457 }
3458
3459 void Element::cloneAttributesFromElement(const Element& other)
3460 {
3461     if (hasSyntheticAttrChildNodes())
3462         detachAllAttrNodesFromElement();
3463
3464     other.synchronizeAllAttributes();
3465     if (!other.m_elementData) {
3466         m_elementData = nullptr;
3467         return;
3468     }
3469
3470     // We can't update window and document's named item maps since the presence of image and object elements depend on other attributes and children.
3471     // Fortunately, those named item maps are only updated when this element is in the document, which should never be the case.
3472     ASSERT(!isConnected());
3473
3474     const AtomicString& oldID = getIdAttribute();
3475     const AtomicString& newID = other.getIdAttribute();
3476
3477     if (!oldID.isNull() || !newID.isNull())
3478         updateId(oldID, newID, NotifyObservers::No); // Will notify observers after the attribute is actually changed.
3479
3480     const AtomicString& oldName = getNameAttribute();
3481     const AtomicString& newName = other.getNameAttribute();
3482
3483     if (!oldName.isNull() || !newName.isNull())
3484         updateName(oldName, newName);
3485
3486     // If 'other' has a mutable ElementData, convert it to an immutable one so we can share it between both elements.
3487     // We can only do this if there is no CSSOM wrapper for other's inline style, and there are no presentation attributes.
3488     if (is<UniqueElementData>(*other.m_elementData)
3489         && !other.m_elementData->presentationAttributeStyle()
3490         && (!other.m_elementData->inlineStyle() || !other.m_elementData->inlineStyle()->hasCSSOMWrapper()))
3491         const_cast<Element&>(other).m_elementData = downcast<UniqueElementData>(*other.m_elementData).makeShareableCopy();
3492
3493     if (!other.m_elementData->isUnique())
3494         m_elementData = other.m_elementData;
3495     else
3496         m_elementData = other.m_elementData->makeUniqueCopy();
3497
3498     for (const Attribute& attribute : attributesIterator())
3499         attributeChanged(attribute.name(), nullAtom(), attribute.value(), ModifiedByCloning);
3500 }
3501
3502 void Element::cloneDataFromElement(const Element& other)
3503 {
3504     cloneAttributesFromElement(other);
3505     copyNonAttributePropertiesFromElement(other);
3506 }
3507
3508 void Element::createUniqueElementData()
3509 {
3510     if (!m_elementData)
3511         m_elementData = UniqueElementData::create();
3512     else
3513         m_elementData = downcast<ShareableElementData>(*m_elementData).makeUniqueCopy();
3514 }
3515
3516 bool Element::hasPendingResources() const
3517 {
3518     return hasRareData() && elementRareData()->hasPendingResources();
3519 }
3520
3521 void Element::setHasPendingResources()
3522 {
3523     ensureElementRareData().setHasPendingResources(true);
3524 }
3525
3526 void Element::clearHasPendingResources()
3527 {
3528     if (!hasRareData())
3529         return;
3530     elementRareData()->setHasPendingResources(false);
3531 }
3532
3533 bool Element::hasCSSAnimation() const
3534 {
3535     return hasRareData() && elementRareData()->hasCSSAnimation();
3536 }
3537
3538 void Element::setHasCSSAnimation()
3539 {
3540     ensureElementRareData().setHasCSSAnimation(true);
3541 }
3542
3543 void Element::clearHasCSSAnimation()
3544 {
3545     if (!hasRareData())
3546         return;
3547     elementRareData()->setHasCSSAnimation(false);
3548 }
3549
3550 bool Element::canContainRangeEndPoint() const
3551 {
3552     return !equalLettersIgnoringASCIICase(attributeWithoutSynchronization(roleAttr), "img");
3553 }
3554
3555 String Element::completeURLsInAttributeValue(const URL& base, const Attribute& attribute) const
3556 {
3557     return URL(base, attribute.value()).string();
3558 }
3559
3560 ExceptionOr<Node*> Element::insertAdjacent(const String& where, Ref<Node>&& newChild)
3561 {
3562     // In Internet Explorer if the element has no parent and where is "beforeBegin" or "afterEnd",
3563     // a document fragment is created and the elements appended in the correct order. This document
3564     // fragment isn't returned anywhere.
3565     //
3566     // This is impossible for us to implement as the DOM tree does not allow for such structures,
3567     // Opera also appears to disallow such usage.
3568
3569     if (equalLettersIgnoringASCIICase(where, "beforebegin")) {
3570         auto* parent = this->parentNode();
3571         if (!parent)
3572             return nullptr;
3573         auto result = parent->insertBefore(newChild, this);
3574         if (result.hasException())
3575             return result.releaseException();
3576         return newChild.ptr();
3577     }
3578
3579     if (equalLettersIgnoringASCIICase(where, "afterbegin")) {
3580         auto result = insertBefore(newChild, firstChild());
3581         if (result.hasException())
3582             return result.releaseException();
3583         return newChild.ptr();
3584     }
3585
3586     if (equalLettersIgnoringASCIICase(where, "beforeend")) {
3587         auto result = appendChild(newChild);
3588         if (result.hasException())
3589             return result.releaseException();
3590         return newChild.ptr();
3591     }
3592
3593     if (equalLettersIgnoringASCIICase(where, "afterend")) {
3594         auto* parent = this->parentNode();
3595         if (!parent)
3596             return nullptr;
3597         auto result = parent->insertBefore(newChild, nextSibling());
3598         if (result.hasException())
3599             return result.releaseException();
3600         return newChild.ptr();
3601     }
3602
3603     return Exception { SyntaxError };
3604 }
3605
3606 ExceptionOr<Element*> Element::insertAdjacentElement(const String& where, Element& newChild)
3607 {
3608     auto result = insertAdjacent(where, newChild);
3609     if (result.hasException())
3610         return result.releaseException();
3611     return downcast<Element>(result.releaseReturnValue());
3612 }
3613
3614 // Step 1 of https://w3c.github.io/DOM-Parsing/#dom-element-insertadjacenthtml.
3615 static ExceptionOr<ContainerNode&> contextNodeForInsertion(const String& where, Element& element)
3616 {
3617     if (equalLettersIgnoringASCIICase(where, "beforebegin") || equalLettersIgnoringASCIICase(where, "afterend")) {
3618         auto* parent = element.parentNode();
3619         if (!parent || is<Document>(*parent))
3620             return Exception { NoModificationAllowedError };
3621         return *parent;
3622     }
3623     if (equalLettersIgnoringASCIICase(where, "afterbegin") || equalLettersIgnoringASCIICase(where, "beforeend"))
3624         return element;
3625     return Exception { SyntaxError };
3626 }
3627
3628 // Step 2 of https://w3c.github.io/DOM-Parsing/#dom-element-insertadjacenthtml.
3629 static ExceptionOr<Ref<Element>> contextElementForInsertion(const String& where, Element& element)
3630 {
3631     auto contextNodeResult = contextNodeForInsertion(where, element);
3632     if (contextNodeResult.hasException())
3633         return contextNodeResult.releaseException();
3634     auto& contextNode = contextNodeResult.releaseReturnValue();
3635     if (!is<Element>(contextNode) || (contextNode.document().isHTMLDocument() && is<HTMLHtmlElement>(contextNode)))
3636         return Ref<Element> { HTMLBodyElement::create(contextNode.document()) };
3637     return Ref<Element> { downcast<Element>(contextNode) };
3638 }
3639
3640 // https://w3c.github.io/DOM-Parsing/#dom-element-insertadjacenthtml
3641 ExceptionOr<void> Element::insertAdjacentHTML(const String& where, const String& markup)
3642 {
3643     // Steps 1 and 2.
3644     auto contextElement = contextElementForInsertion(where, *this);
3645     if (contextElement.hasException())
3646         return contextElement.releaseException();
3647     // Step 3.
3648     auto fragment = createFragmentForInnerOuterHTML(contextElement.releaseReturnValue(), markup, AllowScriptingContent);
3649     if (fragment.hasException())
3650         return fragment.releaseException();
3651     // Step 4.
3652     auto result = insertAdjacent(where, fragment.releaseReturnValue());
3653     if (result.hasException())
3654         return result.releaseException();
3655     return { };
3656 }
3657
3658 ExceptionOr<void> Element::insertAdjacentText(const String& where, const String& text)
3659 {
3660     auto result = insertAdjacent(where, document().createTextNode(text));
3661     if (result.hasException())
3662         return result.releaseException();
3663     return { };
3664 }
3665
3666 Element* Element::findAnchorElementForLink(String& outAnchorName)
3667 {
3668     if (!isLink())
3669         return nullptr;
3670
3671     const AtomicString& href = attributeWithoutSynchronization(HTMLNames::hrefAttr);
3672     if (href.isNull())
3673         return nullptr;
3674
3675     Document& document = this->document();
3676     URL url = document.completeURL(href);
3677     if (!url.isValid())
3678         return nullptr;
3679
3680     if (url.hasFragmentIdentifier() && equalIgnoringFragmentIdentifier(url, document.baseURL())) {
3681         outAnchorName = url.fragmentIdentifier();
3682         return document.findAnchor(outAnchorName);
3683     }
3684
3685     return nullptr;
3686 }
3687
3688 } // namespace WebCore