dom_testing_library 0.1.0

dom_testing_library is a lightweight front end testing toolkit for the rust frontend ecosystem. Heavily inspired by https://testing-library.com/ , write wasm_bindgen tests for your rust front end framework the same way your users will use it.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use super::*;

/// TestElement is a wrapper around web_sys::HtmlElement, we supply some helper functions while implementing Deref<HtmlElement>
/// so you can use any web_sys::HtmlElement method on TestElement.
#[derive(Clone, Debug, PartialEq)]
pub struct TestElement(pub HtmlElement);

impl TestElement {
    /// Click outside of an element. This will try to turn the parent node of the element into an HtmlElement and click on it. If the parent
    /// node isn't an HtmlElement this will panic.
    pub fn click_outside(&self) {
        self.0
            .parent_element()
            .expect("click_outside to be called on an element with a parent.")
            .unchecked_into::<HtmlElement>()
            .click()
    }

    /// Gets the html string of the element.
    pub fn as_html_string(&self) -> String {
        self.0.outer_html()
    }
    /// Gets the text the user would see. There might be multiple nodes, this will display all text
    pub fn display_text(&self) -> String {
        get_all_text_nodes(self.dyn_ref::<Node>().unwrap()).join_text(String::new())
    }
    ///Tries to parse the text context of an element
    pub fn parse<F>(&self) -> Result<F, <F as std::str::FromStr>::Err>
    where
        F: std::str::FromStr,
    {
        self.display_text().parse::<F>()
    }
    /// If the element is a Input, TextArea or Select Element this will set the display value. Otherwise it will panic.
    pub fn set_display_value<S: AsRef<str>>(&self, value: S) {
        if let Some(item) = self.dyn_ref::<web_sys::HtmlTextAreaElement>() {
            item.set_value(value.as_ref());
        } else if let Some(item) = self.dyn_ref::<web_sys::HtmlInputElement>() {
            item.set_value(value.as_ref());
        } else if let Some(item) = self.dyn_ref::<web_sys::HtmlSelectElement>() {
            item.set_value(value.as_ref());
        } else {
            panic!(
                "Expecting an input, textarea, or select element to set display value.
             If you want to set a non-display value just use .set_value() transparently."
            )
        }
    }
}

impl From<HtmlElement> for TestElement {
    fn from(value: HtmlElement) -> Self {
        Self(value)
    }
}

impl Deref for TestElement {
    type Target = web_sys::HtmlElement;

    fn deref(&self) -> &Self::Target {
        &self.0
    }
}