Node.h 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745
  1. /*
  2. * Copyright (c) 2018-2023, Andreas Kling <kling@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #pragma once
  7. #include <AK/Badge.h>
  8. #include <AK/FlyString.h>
  9. #include <AK/JsonObjectSerializer.h>
  10. #include <AK/RefPtr.h>
  11. #include <AK/TypeCasts.h>
  12. #include <AK/Vector.h>
  13. #include <LibWeb/DOM/AccessibilityTreeNode.h>
  14. #include <LibWeb/DOM/EventTarget.h>
  15. #include <LibWeb/DOM/Slottable.h>
  16. #include <LibWeb/DOMParsing/XMLSerializer.h>
  17. #include <LibWeb/TraversalDecision.h>
  18. #include <LibWeb/WebIDL/ExceptionOr.h>
  19. namespace Web::DOM {
  20. enum class NodeType : u16 {
  21. INVALID = 0,
  22. ELEMENT_NODE = 1,
  23. ATTRIBUTE_NODE = 2,
  24. TEXT_NODE = 3,
  25. CDATA_SECTION_NODE = 4,
  26. ENTITY_REFERENCE_NODE = 5,
  27. ENTITY_NODE = 6,
  28. PROCESSING_INSTRUCTION_NODE = 7,
  29. COMMENT_NODE = 8,
  30. DOCUMENT_NODE = 9,
  31. DOCUMENT_TYPE_NODE = 10,
  32. DOCUMENT_FRAGMENT_NODE = 11,
  33. NOTATION_NODE = 12
  34. };
  35. enum class NameOrDescription {
  36. Name,
  37. Description
  38. };
  39. struct GetRootNodeOptions {
  40. bool composed { false };
  41. };
  42. enum class FragmentSerializationMode {
  43. Inner,
  44. Outer,
  45. };
  46. class Node : public EventTarget {
  47. WEB_PLATFORM_OBJECT(Node, EventTarget);
  48. public:
  49. ParentNode* parent_or_shadow_host();
  50. ParentNode const* parent_or_shadow_host() const { return const_cast<Node*>(this)->parent_or_shadow_host(); }
  51. Element* parent_or_shadow_host_element();
  52. Element const* parent_or_shadow_host_element() const { return const_cast<Node*>(this)->parent_or_shadow_host_element(); }
  53. virtual ~Node();
  54. NodeType type() const { return m_type; }
  55. bool is_element() const { return type() == NodeType::ELEMENT_NODE; }
  56. bool is_text() const { return type() == NodeType::TEXT_NODE; }
  57. bool is_document() const { return type() == NodeType::DOCUMENT_NODE; }
  58. bool is_document_type() const { return type() == NodeType::DOCUMENT_TYPE_NODE; }
  59. bool is_comment() const { return type() == NodeType::COMMENT_NODE; }
  60. bool is_character_data() const { return type() == NodeType::TEXT_NODE || type() == NodeType::COMMENT_NODE; }
  61. bool is_document_fragment() const { return type() == NodeType::DOCUMENT_FRAGMENT_NODE; }
  62. bool is_parent_node() const { return is_element() || is_document() || is_document_fragment(); }
  63. bool is_slottable() const { return is_element() || is_text() || is_cdata_section(); }
  64. bool is_attribute() const { return type() == NodeType::ATTRIBUTE_NODE; }
  65. bool is_cdata_section() const { return type() == NodeType::CDATA_SECTION_NODE; }
  66. virtual bool is_shadow_root() const { return false; }
  67. virtual bool requires_svg_container() const { return false; }
  68. virtual bool is_svg_container() const { return false; }
  69. virtual bool is_svg_element() const { return false; }
  70. virtual bool is_svg_graphics_element() const { return false; }
  71. virtual bool is_svg_script_element() const { return false; }
  72. virtual bool is_svg_svg_element() const { return false; }
  73. virtual bool is_svg_use_element() const { return false; }
  74. bool in_a_document_tree() const;
  75. // NOTE: This is intended for the JS bindings.
  76. u16 node_type() const { return (u16)m_type; }
  77. virtual bool is_editable() const;
  78. virtual bool is_dom_node() const final { return true; }
  79. virtual bool is_html_element() const { return false; }
  80. virtual bool is_html_html_element() const { return false; }
  81. virtual bool is_html_anchor_element() const { return false; }
  82. virtual bool is_html_base_element() const { return false; }
  83. virtual bool is_html_body_element() const { return false; }
  84. virtual bool is_html_input_element() const { return false; }
  85. virtual bool is_html_progress_element() const { return false; }
  86. virtual bool is_html_script_element() const { return false; }
  87. virtual bool is_html_template_element() const { return false; }
  88. virtual bool is_html_table_element() const { return false; }
  89. virtual bool is_html_table_section_element() const { return false; }
  90. virtual bool is_html_table_row_element() const { return false; }
  91. virtual bool is_html_table_cell_element() const { return false; }
  92. virtual bool is_html_br_element() const { return false; }
  93. virtual bool is_html_button_element() const { return false; }
  94. virtual bool is_html_slot_element() const { return false; }
  95. virtual bool is_html_embed_element() const { return false; }
  96. virtual bool is_html_object_element() const { return false; }
  97. virtual bool is_html_form_element() const { return false; }
  98. virtual bool is_html_image_element() const { return false; }
  99. virtual bool is_navigable_container() const { return false; }
  100. virtual bool is_lazy_loading() const { return false; }
  101. WebIDL::ExceptionOr<JS::NonnullGCPtr<Node>> pre_insert(JS::NonnullGCPtr<Node>, JS::GCPtr<Node>);
  102. WebIDL::ExceptionOr<JS::NonnullGCPtr<Node>> pre_remove(JS::NonnullGCPtr<Node>);
  103. WebIDL::ExceptionOr<JS::NonnullGCPtr<Node>> append_child(JS::NonnullGCPtr<Node>);
  104. WebIDL::ExceptionOr<JS::NonnullGCPtr<Node>> remove_child(JS::NonnullGCPtr<Node>);
  105. void insert_before(JS::NonnullGCPtr<Node> node, JS::GCPtr<Node> child, bool suppress_observers = false);
  106. void remove(bool suppress_observers = false);
  107. void remove_all_children(bool suppress_observers = false);
  108. enum DocumentPosition : u16 {
  109. DOCUMENT_POSITION_EQUAL = 0,
  110. DOCUMENT_POSITION_DISCONNECTED = 1,
  111. DOCUMENT_POSITION_PRECEDING = 2,
  112. DOCUMENT_POSITION_FOLLOWING = 4,
  113. DOCUMENT_POSITION_CONTAINS = 8,
  114. DOCUMENT_POSITION_CONTAINED_BY = 16,
  115. DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 32,
  116. };
  117. u16 compare_document_position(JS::GCPtr<Node> other);
  118. WebIDL::ExceptionOr<JS::NonnullGCPtr<Node>> replace_child(JS::NonnullGCPtr<Node> node, JS::NonnullGCPtr<Node> child);
  119. WebIDL::ExceptionOr<JS::NonnullGCPtr<Node>> clone_node(Document* document = nullptr, bool clone_children = false);
  120. WebIDL::ExceptionOr<JS::NonnullGCPtr<Node>> clone_node_binding(bool deep);
  121. // NOTE: This is intended for the JS bindings.
  122. bool has_child_nodes() const { return has_children(); }
  123. JS::NonnullGCPtr<NodeList> child_nodes();
  124. Vector<JS::Handle<Node>> children_as_vector() const;
  125. virtual FlyString node_name() const = 0;
  126. String base_uri() const;
  127. String descendant_text_content() const;
  128. Optional<String> text_content() const;
  129. void set_text_content(Optional<String> const&);
  130. Optional<String> node_value() const;
  131. void set_node_value(Optional<String> const&);
  132. JS::GCPtr<HTML::Navigable> navigable() const;
  133. Document& document() { return *m_document; }
  134. Document const& document() const { return *m_document; }
  135. JS::GCPtr<Document> owner_document() const;
  136. const HTML::HTMLAnchorElement* enclosing_link_element() const;
  137. const HTML::HTMLElement* enclosing_html_element() const;
  138. const HTML::HTMLElement* enclosing_html_element_with_attribute(FlyString const&) const;
  139. String child_text_content() const;
  140. Node& root();
  141. Node const& root() const
  142. {
  143. return const_cast<Node*>(this)->root();
  144. }
  145. Node& shadow_including_root();
  146. Node const& shadow_including_root() const
  147. {
  148. return const_cast<Node*>(this)->shadow_including_root();
  149. }
  150. bool is_connected() const;
  151. [[nodiscard]] bool is_browsing_context_connected() const;
  152. Node* parent_node() { return parent(); }
  153. Node const* parent_node() const { return parent(); }
  154. Element* parent_element();
  155. Element const* parent_element() const;
  156. virtual void inserted();
  157. virtual void removed_from(Node*);
  158. virtual void children_changed() { }
  159. virtual void adopted_from(Document&) { }
  160. virtual WebIDL::ExceptionOr<void> cloned(Node&, bool) { return {}; }
  161. Layout::Node const* layout_node() const { return m_layout_node; }
  162. Layout::Node* layout_node() { return m_layout_node; }
  163. Painting::PaintableBox const* paintable_box() const;
  164. Painting::PaintableBox* paintable_box();
  165. Painting::Paintable const* paintable() const;
  166. Painting::Paintable* paintable();
  167. void set_paintable(JS::GCPtr<Painting::Paintable>);
  168. void set_layout_node(Badge<Layout::Node>, JS::NonnullGCPtr<Layout::Node>);
  169. void detach_layout_node(Badge<Layout::TreeBuilder>);
  170. virtual bool is_child_allowed(Node const&) const { return true; }
  171. bool needs_style_update() const { return m_needs_style_update; }
  172. void set_needs_style_update(bool);
  173. bool child_needs_style_update() const { return m_child_needs_style_update; }
  174. void set_child_needs_style_update(bool b) { m_child_needs_style_update = b; }
  175. void invalidate_style();
  176. void set_document(Badge<Document>, Document&);
  177. virtual EventTarget* get_parent(Event const&) override;
  178. template<typename T>
  179. bool fast_is() const = delete;
  180. WebIDL::ExceptionOr<void> ensure_pre_insertion_validity(JS::NonnullGCPtr<Node> node, JS::GCPtr<Node> child) const;
  181. bool is_host_including_inclusive_ancestor_of(Node const&) const;
  182. bool is_scripting_enabled() const;
  183. bool is_scripting_disabled() const;
  184. bool contains(JS::GCPtr<Node>) const;
  185. // Used for dumping the DOM Tree
  186. void serialize_tree_as_json(JsonObjectSerializer<StringBuilder>&) const;
  187. bool is_shadow_including_descendant_of(Node const&) const;
  188. bool is_shadow_including_inclusive_descendant_of(Node const&) const;
  189. bool is_shadow_including_ancestor_of(Node const&) const;
  190. bool is_shadow_including_inclusive_ancestor_of(Node const&) const;
  191. i32 unique_id() const { return m_unique_id; }
  192. static Node* from_unique_id(i32);
  193. WebIDL::ExceptionOr<String> serialize_fragment(DOMParsing::RequireWellFormed, FragmentSerializationMode = FragmentSerializationMode::Inner) const;
  194. WebIDL::ExceptionOr<void> unsafely_set_html(Element&, StringView);
  195. void replace_all(JS::GCPtr<Node>);
  196. void string_replace_all(String const&);
  197. bool is_same_node(Node const*) const;
  198. bool is_equal_node(Node const*) const;
  199. JS::NonnullGCPtr<Node> get_root_node(GetRootNodeOptions const& options = {});
  200. bool is_uninteresting_whitespace_node() const;
  201. String debug_description() const;
  202. size_t length() const;
  203. auto& registered_observer_list() { return m_registered_observer_list; }
  204. auto const& registered_observer_list() const { return m_registered_observer_list; }
  205. void add_registered_observer(RegisteredObserver&);
  206. void queue_mutation_record(FlyString const& type, Optional<FlyString> const& attribute_name, Optional<FlyString> const& attribute_namespace, Optional<String> const& old_value, Vector<JS::Handle<Node>> added_nodes, Vector<JS::Handle<Node>> removed_nodes, Node* previous_sibling, Node* next_sibling) const;
  207. // https://dom.spec.whatwg.org/#concept-shadow-including-inclusive-descendant
  208. template<typename Callback>
  209. TraversalDecision for_each_shadow_including_inclusive_descendant(Callback);
  210. // https://dom.spec.whatwg.org/#concept-shadow-including-descendant
  211. template<typename Callback>
  212. TraversalDecision for_each_shadow_including_descendant(Callback);
  213. Slottable as_slottable();
  214. Node* parent() { return m_parent.ptr(); }
  215. Node const* parent() const { return m_parent.ptr(); }
  216. bool has_children() const { return m_first_child; }
  217. Node* next_sibling() { return m_next_sibling.ptr(); }
  218. Node* previous_sibling() { return m_previous_sibling.ptr(); }
  219. Node* first_child() { return m_first_child.ptr(); }
  220. Node* last_child() { return m_last_child.ptr(); }
  221. Node const* next_sibling() const { return m_next_sibling.ptr(); }
  222. Node const* previous_sibling() const { return m_previous_sibling.ptr(); }
  223. Node const* first_child() const { return m_first_child.ptr(); }
  224. Node const* last_child() const { return m_last_child.ptr(); }
  225. size_t child_count() const
  226. {
  227. size_t count = 0;
  228. for (auto* child = first_child(); child; child = child->next_sibling())
  229. ++count;
  230. return count;
  231. }
  232. Node* child_at_index(int index)
  233. {
  234. int count = 0;
  235. for (auto* child = first_child(); child; child = child->next_sibling()) {
  236. if (count == index)
  237. return child;
  238. ++count;
  239. }
  240. return nullptr;
  241. }
  242. Node const* child_at_index(int index) const
  243. {
  244. return const_cast<Node*>(this)->child_at_index(index);
  245. }
  246. // https://dom.spec.whatwg.org/#concept-tree-index
  247. size_t index() const
  248. {
  249. // The index of an object is its number of preceding siblings, or 0 if it has none.
  250. size_t index = 0;
  251. for (auto* node = previous_sibling(); node; node = node->previous_sibling())
  252. ++index;
  253. return index;
  254. }
  255. Optional<size_t> index_of_child(Node const& search_child)
  256. {
  257. VERIFY(search_child.parent() == this);
  258. size_t index = 0;
  259. auto* child = first_child();
  260. VERIFY(child);
  261. do {
  262. if (child == &search_child)
  263. return index;
  264. index++;
  265. } while (child && (child = child->next_sibling()));
  266. return {};
  267. }
  268. template<typename ChildType>
  269. Optional<size_t> index_of_child(Node const& search_child)
  270. {
  271. VERIFY(search_child.parent() == this);
  272. size_t index = 0;
  273. auto* child = first_child();
  274. VERIFY(child);
  275. do {
  276. if (!is<ChildType>(child))
  277. continue;
  278. if (child == &search_child)
  279. return index;
  280. index++;
  281. } while (child && (child = child->next_sibling()));
  282. return {};
  283. }
  284. bool is_ancestor_of(Node const&) const;
  285. bool is_inclusive_ancestor_of(Node const&) const;
  286. bool is_descendant_of(Node const&) const;
  287. bool is_inclusive_descendant_of(Node const&) const;
  288. bool is_following(Node const&) const;
  289. Node* next_in_pre_order()
  290. {
  291. if (first_child())
  292. return first_child();
  293. Node* node;
  294. if (!(node = next_sibling())) {
  295. node = parent();
  296. while (node && !node->next_sibling())
  297. node = node->parent();
  298. if (node)
  299. node = node->next_sibling();
  300. }
  301. return node;
  302. }
  303. Node* next_in_pre_order(Node const* stay_within)
  304. {
  305. if (first_child())
  306. return first_child();
  307. Node* node = static_cast<Node*>(this);
  308. Node* next = nullptr;
  309. while (!(next = node->next_sibling())) {
  310. node = node->parent();
  311. if (!node || node == stay_within)
  312. return nullptr;
  313. }
  314. return next;
  315. }
  316. Node const* next_in_pre_order() const
  317. {
  318. return const_cast<Node*>(this)->next_in_pre_order();
  319. }
  320. Node const* next_in_pre_order(Node const* stay_within) const
  321. {
  322. return const_cast<Node*>(this)->next_in_pre_order(stay_within);
  323. }
  324. Node* previous_in_pre_order()
  325. {
  326. if (auto* node = previous_sibling()) {
  327. while (node->last_child())
  328. node = node->last_child();
  329. return node;
  330. }
  331. return parent();
  332. }
  333. Node const* previous_in_pre_order() const
  334. {
  335. return const_cast<Node*>(this)->previous_in_pre_order();
  336. }
  337. bool is_before(Node const& other) const
  338. {
  339. if (this == &other)
  340. return false;
  341. for (auto* node = this; node; node = node->next_in_pre_order()) {
  342. if (node == &other)
  343. return true;
  344. }
  345. return false;
  346. }
  347. // https://dom.spec.whatwg.org/#concept-tree-preceding (Object A is 'typename U' and Object B is 'this')
  348. template<typename U>
  349. bool has_preceding_node_of_type_in_tree_order() const
  350. {
  351. for (auto* node = previous_in_pre_order(); node; node = node->previous_in_pre_order()) {
  352. if (is<U>(node))
  353. return true;
  354. }
  355. return false;
  356. }
  357. // https://dom.spec.whatwg.org/#concept-tree-following (Object A is 'typename U' and Object B is 'this')
  358. template<typename U>
  359. bool has_following_node_of_type_in_tree_order() const
  360. {
  361. for (auto* node = next_in_pre_order(); node; node = node->next_in_pre_order()) {
  362. if (is<U>(node))
  363. return true;
  364. }
  365. return false;
  366. }
  367. template<typename Callback>
  368. TraversalDecision for_each_in_inclusive_subtree(Callback callback) const
  369. {
  370. if (auto decision = callback(static_cast<Node const&>(*this)); decision != TraversalDecision::Continue)
  371. return decision;
  372. for (auto* child = first_child(); child; child = child->next_sibling()) {
  373. if (child->for_each_in_inclusive_subtree(callback) == TraversalDecision::Break)
  374. return TraversalDecision::Break;
  375. }
  376. return TraversalDecision::Continue;
  377. }
  378. template<typename Callback>
  379. TraversalDecision for_each_in_inclusive_subtree(Callback callback)
  380. {
  381. if (auto decision = callback(static_cast<Node&>(*this)); decision != TraversalDecision::Continue)
  382. return decision;
  383. for (auto* child = first_child(); child; child = child->next_sibling()) {
  384. if (child->for_each_in_inclusive_subtree(callback) == TraversalDecision::Break)
  385. return TraversalDecision::Break;
  386. }
  387. return TraversalDecision::Continue;
  388. }
  389. template<typename U, typename Callback>
  390. TraversalDecision for_each_in_inclusive_subtree_of_type(Callback callback)
  391. {
  392. if (is<U>(static_cast<Node&>(*this))) {
  393. if (auto decision = callback(static_cast<U&>(*this)); decision != TraversalDecision::Continue)
  394. return decision;
  395. }
  396. for (auto* child = first_child(); child; child = child->next_sibling()) {
  397. if (child->template for_each_in_inclusive_subtree_of_type<U>(callback) == TraversalDecision::Break)
  398. return TraversalDecision::Break;
  399. }
  400. return TraversalDecision::Continue;
  401. }
  402. template<typename U, typename Callback>
  403. TraversalDecision for_each_in_inclusive_subtree_of_type(Callback callback) const
  404. {
  405. if (is<U>(static_cast<Node const&>(*this))) {
  406. if (auto decision = callback(static_cast<U const&>(*this)); decision != TraversalDecision::Continue)
  407. return decision;
  408. }
  409. for (auto* child = first_child(); child; child = child->next_sibling()) {
  410. if (child->template for_each_in_inclusive_subtree_of_type<U>(callback) == TraversalDecision::Break)
  411. return TraversalDecision::Break;
  412. }
  413. return TraversalDecision::Continue;
  414. }
  415. template<typename Callback>
  416. TraversalDecision for_each_in_subtree(Callback callback) const
  417. {
  418. for (auto* child = first_child(); child; child = child->next_sibling()) {
  419. if (child->for_each_in_inclusive_subtree(callback) == TraversalDecision::Break)
  420. return TraversalDecision::Break;
  421. }
  422. return TraversalDecision::Continue;
  423. }
  424. template<typename Callback>
  425. TraversalDecision for_each_in_subtree(Callback callback)
  426. {
  427. for (auto* child = first_child(); child; child = child->next_sibling()) {
  428. if (child->for_each_in_inclusive_subtree(callback) == TraversalDecision::Break)
  429. return TraversalDecision::Break;
  430. }
  431. return TraversalDecision::Continue;
  432. }
  433. template<typename U, typename Callback>
  434. TraversalDecision for_each_in_subtree_of_type(Callback callback)
  435. {
  436. for (auto* child = first_child(); child; child = child->next_sibling()) {
  437. if (child->template for_each_in_inclusive_subtree_of_type<U>(callback) == TraversalDecision::Break)
  438. return TraversalDecision::Break;
  439. }
  440. return TraversalDecision::Continue;
  441. }
  442. template<typename U, typename Callback>
  443. TraversalDecision for_each_in_subtree_of_type(Callback callback) const
  444. {
  445. for (auto* child = first_child(); child; child = child->next_sibling()) {
  446. if (child->template for_each_in_inclusive_subtree_of_type<U>(callback) == TraversalDecision::Break)
  447. return TraversalDecision::Break;
  448. }
  449. return TraversalDecision::Continue;
  450. }
  451. template<typename Callback>
  452. void for_each_child(Callback callback) const
  453. {
  454. return const_cast<Node*>(this)->for_each_child(move(callback));
  455. }
  456. template<typename Callback>
  457. void for_each_child(Callback callback)
  458. {
  459. for (auto* node = first_child(); node; node = node->next_sibling()) {
  460. if (callback(*node) == IterationDecision::Break)
  461. return;
  462. }
  463. }
  464. template<typename U, typename Callback>
  465. void for_each_child_of_type(Callback callback)
  466. {
  467. for (auto* node = first_child(); node; node = node->next_sibling()) {
  468. if (is<U>(node)) {
  469. if (callback(verify_cast<U>(*node)) == IterationDecision::Break)
  470. return;
  471. }
  472. }
  473. }
  474. template<typename U, typename Callback>
  475. void for_each_child_of_type(Callback callback) const
  476. {
  477. return const_cast<Node*>(this)->template for_each_child_of_type<U>(move(callback));
  478. }
  479. template<typename U>
  480. U const* next_sibling_of_type() const
  481. {
  482. return const_cast<Node*>(this)->template next_sibling_of_type<U>();
  483. }
  484. template<typename U>
  485. inline U* next_sibling_of_type()
  486. {
  487. for (auto* sibling = next_sibling(); sibling; sibling = sibling->next_sibling()) {
  488. if (is<U>(*sibling))
  489. return &verify_cast<U>(*sibling);
  490. }
  491. return nullptr;
  492. }
  493. template<typename U>
  494. U const* previous_sibling_of_type() const
  495. {
  496. return const_cast<Node*>(this)->template previous_sibling_of_type<U>();
  497. }
  498. template<typename U>
  499. U* previous_sibling_of_type()
  500. {
  501. for (auto* sibling = previous_sibling(); sibling; sibling = sibling->previous_sibling()) {
  502. if (is<U>(*sibling))
  503. return &verify_cast<U>(*sibling);
  504. }
  505. return nullptr;
  506. }
  507. template<typename U>
  508. U const* first_child_of_type() const
  509. {
  510. return const_cast<Node*>(this)->template first_child_of_type<U>();
  511. }
  512. template<typename U>
  513. U const* last_child_of_type() const
  514. {
  515. return const_cast<Node*>(this)->template last_child_of_type<U>();
  516. }
  517. template<typename U>
  518. U* first_child_of_type()
  519. {
  520. for (auto* child = first_child(); child; child = child->next_sibling()) {
  521. if (is<U>(*child))
  522. return &verify_cast<U>(*child);
  523. }
  524. return nullptr;
  525. }
  526. template<typename U>
  527. U* last_child_of_type()
  528. {
  529. for (auto* child = last_child(); child; child = child->previous_sibling()) {
  530. if (is<U>(*child))
  531. return &verify_cast<U>(*child);
  532. }
  533. return nullptr;
  534. }
  535. template<typename U>
  536. bool has_child_of_type() const
  537. {
  538. return first_child_of_type<U>() != nullptr;
  539. }
  540. template<typename U>
  541. U const* first_ancestor_of_type() const
  542. {
  543. return const_cast<Node*>(this)->template first_ancestor_of_type<U>();
  544. }
  545. template<typename U>
  546. U* first_ancestor_of_type()
  547. {
  548. for (auto* ancestor = parent(); ancestor; ancestor = ancestor->parent()) {
  549. if (is<U>(*ancestor))
  550. return &verify_cast<U>(*ancestor);
  551. }
  552. return nullptr;
  553. }
  554. template<typename U>
  555. U const* shadow_including_first_ancestor_of_type() const
  556. {
  557. return const_cast<Node*>(this)->template shadow_including_first_ancestor_of_type<U>();
  558. }
  559. template<typename U>
  560. U* shadow_including_first_ancestor_of_type();
  561. bool is_parent_of(Node const& other) const
  562. {
  563. for (auto* child = first_child(); child; child = child->next_sibling()) {
  564. if (&other == child)
  565. return true;
  566. }
  567. return false;
  568. }
  569. ErrorOr<String> accessible_name(Document const&) const;
  570. ErrorOr<String> accessible_description(Document const&) const;
  571. protected:
  572. Node(JS::Realm&, Document&, NodeType);
  573. Node(Document&, NodeType);
  574. virtual void visit_edges(Cell::Visitor&) override;
  575. virtual void finalize() override;
  576. JS::GCPtr<Document> m_document;
  577. JS::GCPtr<Layout::Node> m_layout_node;
  578. JS::GCPtr<Painting::Paintable> m_paintable;
  579. NodeType m_type { NodeType::INVALID };
  580. bool m_needs_style_update { false };
  581. bool m_child_needs_style_update { false };
  582. i32 m_unique_id {};
  583. // https://dom.spec.whatwg.org/#registered-observer-list
  584. // "Nodes have a strong reference to registered observers in their registered observer list." https://dom.spec.whatwg.org/#garbage-collection
  585. OwnPtr<Vector<JS::NonnullGCPtr<RegisteredObserver>>> m_registered_observer_list;
  586. void build_accessibility_tree(AccessibilityTreeNode& parent);
  587. ErrorOr<String> name_or_description(NameOrDescription, Document const&, HashTable<i32>&) const;
  588. private:
  589. void queue_tree_mutation_record(Vector<JS::Handle<Node>> added_nodes, Vector<JS::Handle<Node>> removed_nodes, Node* previous_sibling, Node* next_sibling);
  590. void insert_before_impl(JS::NonnullGCPtr<Node>, JS::GCPtr<Node> child);
  591. void append_child_impl(JS::NonnullGCPtr<Node>);
  592. void remove_child_impl(JS::NonnullGCPtr<Node>);
  593. static Optional<StringView> first_valid_id(StringView, Document const&);
  594. static ErrorOr<void> append_without_space(StringBuilder, StringView const&);
  595. static ErrorOr<void> append_with_space(StringBuilder, StringView const&);
  596. static ErrorOr<void> prepend_without_space(StringBuilder, StringView const&);
  597. static ErrorOr<void> prepend_with_space(StringBuilder, StringView const&);
  598. JS::GCPtr<Node> m_parent;
  599. JS::GCPtr<Node> m_first_child;
  600. JS::GCPtr<Node> m_last_child;
  601. JS::GCPtr<Node> m_next_sibling;
  602. JS::GCPtr<Node> m_previous_sibling;
  603. JS::GCPtr<NodeList> m_child_nodes;
  604. };
  605. }
  606. template<>
  607. inline bool JS::Object::fast_is<Web::DOM::Node>() const { return is_dom_node(); }