web-api-cat 0.6.7

Bindings between boa-cat (JS engine) and the DOM (html-cat tree) plus fetch (net-cat). v0.6.7 adds `Element.outerHTML` (getter wraps the existing innerHTML serialiser with the element's own tag; setter no-ops pending parent-backref infrastructure) and `Element.replaceChild(newChild, oldChild)` (in-place children-array swap, returns the old child, preserves length). 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

//! `Element.outerHTML` getter (v0.6.7): serialises `<tag attrs>
//! inner</tag>` for the element itself (not just its children).

use boa_cat::env::Env;
use boa_cat::evaluate_program_with;
use boa_cat::fuel::Fuel;
use boa_cat::heap::Heap;
use boa_cat::value::Value;
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(200_000)).map_err(Error::from)?;
    Ok(value)
}

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

#[test]
fn outer_html_includes_own_tag_for_leaf() -> Result<(), Error> {
    let value = run(
        "<html><body><span id='host'>hi</span></body></html>",
        "document.getElementById('host').outerHTML",
    )?;
    matches!(value, Value::String(ref s) if s == "<span id=\"host\">hi</span>")
        .then_some(())
        .ok_or_else(|| fail("expected outerHTML to wrap with own tag and attributes"))
}

#[test]
fn outer_html_recurses_for_children() -> Result<(), Error> {
    let value = run(
        "<html><body><div id='host'><a>x</a><b>y</b></div></body></html>",
        "document.getElementById('host').outerHTML",
    )?;
    matches!(value, Value::String(ref s) if s == "<div id=\"host\"><a>x</a><b>y</b></div>")
        .then_some(())
        .ok_or_else(|| fail("expected outerHTML to recurse into children"))
}

#[test]
fn outer_html_setter_is_a_noop() -> Result<(), Error> {
    let value = run(
        "<html><body><div id='host'><a>x</a></div></body></html>",
        "const host = document.getElementById('host');
        host.outerHTML = '<p>nope</p>';
        host.children[0].tagName",
    )?;
    matches!(value, Value::String(ref s) if s == "a")
        .then_some(())
        .ok_or_else(|| fail("expected outerHTML setter to be a v0 no-op"))
}

#[test]
fn outer_html_works_on_created_element() -> Result<(), Error> {
    let value = run(
        "<html><body></body></html>",
        "const el = document.createElement('p');
        el.setAttribute('id', 'src');
        el.outerHTML",
    )?;
    matches!(value, Value::String(ref s) if s == "<p id=\"src\"></p>")
        .then_some(())
        .ok_or_else(|| fail("expected outerHTML on createElement output"))
}