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