/src/serenity/Userland/Libraries/LibWeb/DOM/NodeIterator.cpp
Line | Count | Source (jump to first uncovered line) |
1 | | /* |
2 | | * Copyright (c) 2022, Andreas Kling <kling@serenityos.org> |
3 | | * |
4 | | * SPDX-License-Identifier: BSD-2-Clause |
5 | | */ |
6 | | |
7 | | #include <LibWeb/Bindings/NodeIteratorPrototype.h> |
8 | | #include <LibWeb/DOM/Document.h> |
9 | | #include <LibWeb/DOM/Node.h> |
10 | | #include <LibWeb/DOM/NodeIterator.h> |
11 | | #include <LibWeb/WebIDL/AbstractOperations.h> |
12 | | |
13 | | namespace Web::DOM { |
14 | | |
15 | | JS_DEFINE_ALLOCATOR(NodeIterator); |
16 | | |
17 | | NodeIterator::NodeIterator(Node& root) |
18 | 0 | : PlatformObject(root.realm()) |
19 | 0 | , m_root(root) |
20 | 0 | , m_reference({ root }) |
21 | 0 | { |
22 | 0 | root.document().register_node_iterator({}, *this); |
23 | 0 | } |
24 | | |
25 | 0 | NodeIterator::~NodeIterator() = default; |
26 | | |
27 | | void NodeIterator::initialize(JS::Realm& realm) |
28 | 0 | { |
29 | 0 | Base::initialize(realm); |
30 | 0 | WEB_SET_PROTOTYPE_FOR_INTERFACE(NodeIterator); |
31 | 0 | } |
32 | | |
33 | | void NodeIterator::finalize() |
34 | 0 | { |
35 | 0 | Base::finalize(); |
36 | 0 | m_root->document().unregister_node_iterator({}, *this); |
37 | 0 | } |
38 | | |
39 | | void NodeIterator::visit_edges(Cell::Visitor& visitor) |
40 | 0 | { |
41 | 0 | Base::visit_edges(visitor); |
42 | 0 | visitor.visit(m_filter); |
43 | 0 | visitor.visit(m_root); |
44 | 0 | visitor.visit(m_reference.node); |
45 | |
|
46 | 0 | if (m_traversal_pointer.has_value()) |
47 | 0 | visitor.visit(m_traversal_pointer->node); |
48 | 0 | } |
49 | | |
50 | | // https://dom.spec.whatwg.org/#dom-document-createnodeiterator |
51 | | WebIDL::ExceptionOr<JS::NonnullGCPtr<NodeIterator>> NodeIterator::create(Node& root, unsigned what_to_show, JS::GCPtr<NodeFilter> filter) |
52 | 0 | { |
53 | | // 1. Let iterator be a new NodeIterator object. |
54 | | // 2. Set iterator’s root and iterator’s reference to root. |
55 | | // 3. Set iterator’s pointer before reference to true. |
56 | 0 | auto& realm = root.realm(); |
57 | 0 | auto iterator = realm.heap().allocate<NodeIterator>(realm, root); |
58 | | |
59 | | // 4. Set iterator’s whatToShow to whatToShow. |
60 | 0 | iterator->m_what_to_show = what_to_show; |
61 | | |
62 | | // 5. Set iterator’s filter to filter. |
63 | 0 | iterator->m_filter = filter; |
64 | | |
65 | | // 6. Return iterator. |
66 | 0 | return iterator; |
67 | 0 | } |
68 | | |
69 | | // https://dom.spec.whatwg.org/#dom-nodeiterator-detach |
70 | | void NodeIterator::detach() |
71 | 0 | { |
72 | | // The detach() method steps are to do nothing. |
73 | | // Its functionality (disabling a NodeIterator object) was removed, but the method itself is preserved for compatibility. |
74 | 0 | } |
75 | | |
76 | | // https://dom.spec.whatwg.org/#concept-nodeiterator-traverse |
77 | | JS::ThrowCompletionOr<JS::GCPtr<Node>> NodeIterator::traverse(Direction direction) |
78 | 0 | { |
79 | | // 1. Let node be iterator’s reference. |
80 | | // 2. Let beforeNode be iterator’s pointer before reference. |
81 | 0 | m_traversal_pointer = m_reference; |
82 | |
|
83 | 0 | JS::GCPtr<Node> candidate; |
84 | | |
85 | | // 3. While true: |
86 | 0 | while (true) { |
87 | | // 4. Branch on direction: |
88 | 0 | if (direction == Direction::Next) { |
89 | | // next |
90 | | // If beforeNode is false, then set node to the first node following node in iterator’s iterator collection. |
91 | | // If there is no such node, then return null. |
92 | 0 | if (!m_traversal_pointer->is_before_node) { |
93 | 0 | auto* next_node = m_traversal_pointer->node->next_in_pre_order(m_root.ptr()); |
94 | 0 | if (!next_node) |
95 | 0 | return nullptr; |
96 | 0 | m_traversal_pointer->node = *next_node; |
97 | 0 | } else { |
98 | | // If beforeNode is true, then set it to false. |
99 | 0 | m_traversal_pointer->is_before_node = false; |
100 | 0 | } |
101 | 0 | } else { |
102 | | // previous |
103 | | // If beforeNode is true, then set node to the first node preceding node in iterator’s iterator collection. |
104 | | // If there is no such node, then return null. |
105 | 0 | if (m_traversal_pointer->is_before_node) { |
106 | 0 | if (m_traversal_pointer->node.ptr() == m_root.ptr()) |
107 | 0 | return nullptr; |
108 | 0 | auto* previous_node = m_traversal_pointer->node->previous_in_pre_order(); |
109 | 0 | if (!previous_node) |
110 | 0 | return nullptr; |
111 | 0 | m_traversal_pointer->node = *previous_node; |
112 | 0 | } else { |
113 | | // If beforeNode is false, then set it to true. |
114 | 0 | m_traversal_pointer->is_before_node = true; |
115 | 0 | } |
116 | 0 | } |
117 | | |
118 | | // NOTE: If the NodeFilter deletes the iterator's current traversal pointer, |
119 | | // we will automatically retarget it. However, in that case, we're expected |
120 | | // to return the node passed to the filter, not the adjusted traversal pointer's |
121 | | // node after the filter returns! |
122 | 0 | candidate = m_traversal_pointer->node; |
123 | | |
124 | | // 2. Let result be the result of filtering node within iterator. |
125 | 0 | auto result = TRY(filter(*m_traversal_pointer->node)); |
126 | | |
127 | | // 3. If result is FILTER_ACCEPT, then break. |
128 | 0 | if (result == NodeFilter::Result::FILTER_ACCEPT) |
129 | 0 | break; |
130 | 0 | } |
131 | | |
132 | | // 4. Set iterator’s reference to node. |
133 | | // 5. Set iterator’s pointer before reference to beforeNode. |
134 | 0 | m_reference = m_traversal_pointer.release_value(); |
135 | | |
136 | | // 6. Return node. |
137 | 0 | return candidate; |
138 | 0 | } |
139 | | |
140 | | // https://dom.spec.whatwg.org/#concept-node-filter |
141 | | JS::ThrowCompletionOr<NodeFilter::Result> NodeIterator::filter(Node& node) |
142 | 0 | { |
143 | | // 1. If traverser’s active flag is set, then throw an "InvalidStateError" DOMException. |
144 | 0 | if (m_active) |
145 | 0 | return throw_completion(WebIDL::InvalidStateError::create(realm(), "NodeIterator is already active"_string)); |
146 | | |
147 | | // 2. Let n be node’s nodeType attribute value − 1. |
148 | 0 | auto n = node.node_type() - 1; |
149 | | |
150 | | // 3. If the nth bit (where 0 is the least significant bit) of traverser’s whatToShow is not set, then return FILTER_SKIP. |
151 | 0 | if (!(m_what_to_show & (1u << n))) |
152 | 0 | return NodeFilter::Result::FILTER_SKIP; |
153 | | |
154 | | // 4. If traverser’s filter is null, then return FILTER_ACCEPT. |
155 | 0 | if (!m_filter) |
156 | 0 | return NodeFilter::Result::FILTER_ACCEPT; |
157 | | |
158 | | // 5. Set traverser’s active flag. |
159 | 0 | m_active = true; |
160 | | |
161 | | // 6. Let result be the return value of call a user object’s operation with traverser’s filter, "acceptNode", and « node ». |
162 | | // If this throws an exception, then unset traverser’s active flag and rethrow the exception. |
163 | 0 | auto result = WebIDL::call_user_object_operation(m_filter->callback(), "acceptNode"_string, {}, &node); |
164 | 0 | if (result.is_abrupt()) { |
165 | 0 | m_active = false; |
166 | 0 | return result; |
167 | 0 | } |
168 | | |
169 | | // 7. Unset traverser’s active flag. |
170 | 0 | m_active = false; |
171 | | |
172 | | // 8. Return result. |
173 | 0 | auto result_value = TRY(result.value()->to_i32(vm())); |
174 | 0 | return static_cast<NodeFilter::Result>(result_value); |
175 | 0 | } |
176 | | |
177 | | // https://dom.spec.whatwg.org/#dom-nodeiterator-nextnode |
178 | | JS::ThrowCompletionOr<JS::GCPtr<Node>> NodeIterator::next_node() |
179 | 0 | { |
180 | 0 | return traverse(Direction::Next); |
181 | 0 | } |
182 | | |
183 | | // https://dom.spec.whatwg.org/#dom-nodeiterator-previousnode |
184 | | JS::ThrowCompletionOr<JS::GCPtr<Node>> NodeIterator::previous_node() |
185 | 0 | { |
186 | 0 | return traverse(Direction::Previous); |
187 | 0 | } |
188 | | |
189 | | void NodeIterator::run_pre_removing_steps_with_node_pointer(Node& to_be_removed_node, NodePointer& pointer) |
190 | 0 | { |
191 | | // NOTE: This function tries to match the behavior of other engines, but not the DOM specification |
192 | | // as it's a known issue that the spec doesn't match how major browsers behave. |
193 | | // Spec bug: https://github.com/whatwg/dom/issues/907 |
194 | |
|
195 | 0 | if (!to_be_removed_node.is_descendant_of(root())) |
196 | 0 | return; |
197 | | |
198 | 0 | if (!to_be_removed_node.is_inclusive_ancestor_of(pointer.node)) |
199 | 0 | return; |
200 | | |
201 | 0 | if (pointer.is_before_node) { |
202 | 0 | if (auto* node = to_be_removed_node.next_in_pre_order(root())) { |
203 | 0 | while (node && node->is_descendant_of(to_be_removed_node)) |
204 | 0 | node = node->next_in_pre_order(root()); |
205 | 0 | if (node) |
206 | 0 | pointer.node = *node; |
207 | 0 | return; |
208 | 0 | } |
209 | 0 | if (auto* node = to_be_removed_node.previous_in_pre_order()) { |
210 | 0 | if (to_be_removed_node.is_ancestor_of(pointer.node)) { |
211 | 0 | while (node && node->is_descendant_of(to_be_removed_node)) |
212 | 0 | node = node->previous_in_pre_order(); |
213 | 0 | } |
214 | 0 | if (node) { |
215 | 0 | pointer = { |
216 | 0 | .node = *node, |
217 | 0 | .is_before_node = false, |
218 | 0 | }; |
219 | 0 | } |
220 | 0 | } |
221 | 0 | return; |
222 | 0 | } |
223 | | |
224 | 0 | if (auto* node = to_be_removed_node.previous_in_pre_order()) { |
225 | 0 | if (to_be_removed_node.is_ancestor_of(pointer.node)) { |
226 | 0 | while (node && node->is_descendant_of(to_be_removed_node)) |
227 | 0 | node = node->previous_in_pre_order(); |
228 | 0 | } |
229 | 0 | if (node) |
230 | 0 | pointer.node = *node; |
231 | 0 | return; |
232 | 0 | } |
233 | 0 | auto* node = to_be_removed_node.next_in_pre_order(root()); |
234 | 0 | if (to_be_removed_node.is_ancestor_of(pointer.node)) { |
235 | 0 | while (node && node->is_descendant_of(to_be_removed_node)) |
236 | 0 | node = node->previous_in_pre_order(); |
237 | 0 | } |
238 | 0 | if (node) |
239 | 0 | pointer.node = *node; |
240 | 0 | } |
241 | | |
242 | | // https://dom.spec.whatwg.org/#nodeiterator-pre-removing-steps |
243 | | void NodeIterator::run_pre_removing_steps(Node& to_be_removed_node) |
244 | 0 | { |
245 | | // NOTE: If we're in the middle of traversal, we have to adjust the traversal pointer in response to node removal. |
246 | 0 | if (m_traversal_pointer.has_value()) |
247 | 0 | run_pre_removing_steps_with_node_pointer(to_be_removed_node, *m_traversal_pointer); |
248 | |
|
249 | 0 | run_pre_removing_steps_with_node_pointer(to_be_removed_node, m_reference); |
250 | 0 | } |
251 | | |
252 | | } |