Skip to main content

script/dom/xpath/
xpathevaluator.rs

1/* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
4
5use dom_struct::dom_struct;
6use js::context::JSContext;
7use js::rust::HandleObject;
8use script_bindings::callback::RootedCallback;
9use script_bindings::codegen::GenericBindings::WindowBinding::WindowMethods;
10use script_bindings::reflector::{Reflector, reflect_dom_object_with_proto};
11
12use crate::dom::bindings::codegen::Bindings::XPathEvaluatorBinding::XPathEvaluatorMethods;
13use crate::dom::bindings::codegen::Bindings::XPathNSResolverBinding::XPathNSResolver;
14use crate::dom::bindings::error::Fallible;
15use crate::dom::bindings::root::{Dom, DomRoot};
16use crate::dom::bindings::str::DOMString;
17use crate::dom::node::Node;
18use crate::dom::window::Window;
19use crate::dom::xpathexpression::XPathExpression;
20use crate::dom::xpathresult::XPathResult;
21use crate::xpath::parse_expression;
22
23#[dom_struct]
24pub(crate) struct XPathEvaluator {
25    reflector_: Reflector,
26    window: Dom<Window>,
27}
28
29impl XPathEvaluator {
30    fn new_inherited(window: &Window) -> XPathEvaluator {
31        XPathEvaluator {
32            reflector_: Reflector::new(),
33            window: Dom::from_ref(window),
34        }
35    }
36
37    pub(crate) fn new(
38        cx: &mut JSContext,
39        window: &Window,
40        proto: Option<HandleObject>,
41    ) -> DomRoot<XPathEvaluator> {
42        reflect_dom_object_with_proto(
43            cx,
44            Box::new(XPathEvaluator::new_inherited(window)),
45            window,
46            proto,
47        )
48    }
49}
50
51impl XPathEvaluatorMethods<crate::DomTypeHolder> for XPathEvaluator {
52    /// <https://dom.spec.whatwg.org/#dom-xpathevaluator-xpathevaluator>
53    fn Constructor(
54        cx: &mut JSContext,
55        window: &Window,
56        proto: Option<HandleObject>,
57    ) -> DomRoot<XPathEvaluator> {
58        XPathEvaluator::new(cx, window, proto)
59    }
60
61    /// <https://dom.spec.whatwg.org/#dom-xpathevaluatorbase-createexpression>
62    fn CreateExpression(
63        &self,
64        cx: &mut JSContext,
65        expression: DOMString,
66        resolver: Option<RootedCallback<XPathNSResolver>>,
67    ) -> Fallible<DomRoot<XPathExpression>> {
68        let parsed_expression = parse_expression(
69            cx,
70            &expression.str(),
71            resolver,
72            self.window.Document().is_html_document(),
73        )?;
74        Ok(XPathExpression::new(
75            cx,
76            &self.window,
77            None,
78            parsed_expression,
79        ))
80    }
81
82    /// <https://dom.spec.whatwg.org/#dom-xpathevaluatorbase-creatensresolver>
83    fn CreateNSResolver(&self, node_resolver: &Node) -> DomRoot<Node> {
84        // Legacy: the spec tells us to just return `node_resolver` as-is
85        DomRoot::from_ref(node_resolver)
86    }
87
88    /// <https://dom.spec.whatwg.org/#dom-xpathevaluatorbase-evaluate>
89    fn Evaluate(
90        &self,
91        cx: &mut JSContext,
92        expression: DOMString,
93        context_node: &Node,
94        resolver: Option<RootedCallback<XPathNSResolver>>,
95        result_type: u16,
96        result: Option<&XPathResult>,
97    ) -> Fallible<DomRoot<XPathResult>> {
98        let parsed_expression = parse_expression(
99            cx,
100            &expression.str(),
101            resolver,
102            self.window.Document().is_html_document(),
103        )?;
104        let expression = XPathExpression::new(cx, &self.window, None, parsed_expression);
105        expression.evaluate_internal(cx, context_node, result_type, result)
106    }
107}