web-api-cat 0.1.0

Bindings between boa-cat (JS engine) and the DOM (html-cat tree) plus fetch (net-cat). Exposes `document`, `Element` methods, and `fetch` as boa-cat NativeFns so scripts can read/mutate a parsed HTML document and make synchronous HTTP requests. No mut, no Rc/Arc, no interior mutability, no panics. Seventh sub-crate of a Servo-replacement webview runtime targeting Tauri.
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

//! Integration tests covering document, element, and fetch bindings.

use boa_cat::env::Env;
use boa_cat::fuel::Fuel;
use boa_cat::heap::Heap;
use boa_cat::{Value, evaluate_program_with};
use ecma_lex_cat::lex;
use ecma_parse_cat::parse_script;
use web_api_cat::Error;

fn run(html: &str, script: &str) -> Result<Value, Error> {
    let html_doc = html_cat::parse(html)?;
    let (env, heap) = web_api_cat::install(Env::empty(), Heap::new(), &html_doc);
    let tokens = lex(script).map_err(boa_cat::Error::from)?;
    let program = parse_script(&tokens).map_err(boa_cat::Error::from)?;
    let (value, _heap) =
        evaluate_program_with(&program, env, heap, Fuel::new(100_000)).map_err(Error::from)?;
    Ok(value)
}

fn fail(_msg: &'static str) -> Error {
    Error::Engine(boa_cat::Error::Unsupported { feature: "test" })
}

#[test]
fn get_element_by_id_returns_element() -> Result<(), Error> {
    let value = run(
        "<html><body><p id='greet'>hello</p></body></html>",
        "document.getElementById('greet').textContent",
    )?;
    matches!(value, Value::String(ref s) if s == "hello")
        .then_some(())
        .ok_or_else(|| fail("expected 'hello'"))
}

#[test]
fn get_element_by_id_missing_returns_null() -> Result<(), Error> {
    let value = run(
        "<html><body><p>hi</p></body></html>",
        "document.getElementById('missing')",
    )?;
    matches!(value, Value::Null)
        .then_some(())
        .ok_or_else(|| fail("expected null for missing id"))
}

#[test]
fn query_selector_tag() -> Result<(), Error> {
    let value = run(
        "<html><body><span>x</span><p>y</p></body></html>",
        "document.querySelector('p').textContent",
    )?;
    matches!(value, Value::String(ref s) if s == "y")
        .then_some(())
        .ok_or_else(|| fail("expected 'y' for p match"))
}

#[test]
fn query_selector_class() -> Result<(), Error> {
    let value = run(
        "<html><body><p class='a'>1</p><p class='b'>2</p></body></html>",
        "document.querySelector('.b').textContent",
    )?;
    matches!(value, Value::String(ref s) if s == "2")
        .then_some(())
        .ok_or_else(|| fail("expected '2' for .b match"))
}

#[test]
fn element_tag_name_lowercased() -> Result<(), Error> {
    let value = run(
        "<html><body><P id='p'>hi</P></body></html>",
        "document.getElementById('p').tagName",
    )?;
    matches!(value, Value::String(ref s) if s == "p")
        .then_some(())
        .ok_or_else(|| fail("expected lowercase tagName"))
}

#[test]
fn element_class_name() -> Result<(), Error> {
    let value = run(
        "<html><body><p id='p' class='greeting big'>hi</p></body></html>",
        "document.getElementById('p').className",
    )?;
    matches!(value, Value::String(ref s) if s == "greeting big")
        .then_some(())
        .ok_or_else(|| fail("expected className 'greeting big'"))
}

#[test]
fn get_attribute_returns_value() -> Result<(), Error> {
    let value = run(
        "<html><body><a id='link' href='https://example.com'>x</a></body></html>",
        "document.getElementById('link').getAttribute('href')",
    )?;
    matches!(value, Value::String(ref s) if s == "https://example.com")
        .then_some(())
        .ok_or_else(|| fail("expected href"))
}

#[test]
fn get_attribute_missing_returns_null() -> Result<(), Error> {
    let value = run(
        "<html><body><p id='p'>x</p></body></html>",
        "document.getElementById('p').getAttribute('missing')",
    )?;
    matches!(value, Value::Null)
        .then_some(())
        .ok_or_else(|| fail("expected null for missing attr"))
}

#[test]
fn has_attribute_true_false() -> Result<(), Error> {
    let value = run(
        "<html><body><input id='i' disabled></body></html>",
        "const el = document.getElementById('i'); el.hasAttribute('disabled')",
    )?;
    matches!(value, Value::Boolean(true))
        .then_some(())
        .ok_or_else(|| fail("expected true for disabled"))
}

#[test]
fn set_attribute_round_trip() -> Result<(), Error> {
    let value = run(
        "<html><body><p id='p'>x</p></body></html>",
        "const el = document.getElementById('p'); el.setAttribute('data-x', '42'); el.getAttribute('data-x')",
    )?;
    matches!(value, Value::String(ref s) if s == "42")
        .then_some(())
        .ok_or_else(|| fail("expected '42' after setAttribute"))
}

#[test]
fn body_alias_resolves() -> Result<(), Error> {
    let value = run(
        "<html><body><p>x</p></body></html>",
        "document.body.tagName",
    )?;
    matches!(value, Value::String(ref s) if s == "body")
        .then_some(())
        .ok_or_else(|| fail("expected body tagName"))
}