Coverage Report

Created: 2025-08-28 06:26

/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
}