ps-blitz-script 0.6.5

JavaScript execution for Blitz using the Boa engine
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
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

use std::sync::Arc;
use std::task::Context;

use blitz_dom::{DocGuard, DocGuardMut, Document, DocumentConfig};
use blitz_traits::events::UiEvent;

use crate::ScriptDocument;

#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
pub enum ScriptBackend {
    #[default]
    Boa,
    Custom,
}

/// A document backend selected before bootstrap or host installation.
pub trait ScriptDocumentBackend: Document + Sized {
    fn from_html(html: Arc<str>, config: DocumentConfig) -> Result<Self, String>;
    fn execute_scripts(&mut self) -> Result<(), String>;
}

impl ScriptDocumentBackend for ScriptDocument {
    fn from_html(html: Arc<str>, config: DocumentConfig) -> Result<Self, String> {
        Ok(Self::from_html(&html, config))
    }

    fn execute_scripts(&mut self) -> Result<(), String> {
        Self::execute_scripts(self);
        Ok(())
    }
}

/// Selection happens before either backend's bootstrap or host installers.
pub enum ApplicationDocument<D: ScriptDocumentBackend = ScriptDocument> {
    Boa(Box<ScriptDocument>),
    Custom(Box<D>),
}

impl<D: ScriptDocumentBackend> ApplicationDocument<D> {
    pub fn from_html(
        html: Arc<str>,
        config: DocumentConfig,
        backend: ScriptBackend,
    ) -> Result<Self, String> {
        match backend {
            ScriptBackend::Boa => Ok(Self::Boa(Box::new(ScriptDocument::from_html(
                &html, config,
            )))),
            ScriptBackend::Custom => {
                D::from_html(html, config).map(|document| Self::Custom(Box::new(document)))
            }
        }
    }

    pub fn backend(&self) -> ScriptBackend {
        match self {
            Self::Boa(_) => ScriptBackend::Boa,
            Self::Custom(_) => ScriptBackend::Custom,
        }
    }

    pub fn execute_scripts(&mut self) -> Result<(), String> {
        match self {
            Self::Boa(document) => {
                document.execute_scripts();
                Ok(())
            }
            Self::Custom(document) => document.execute_scripts(),
        }
    }
}

impl<D: ScriptDocumentBackend> Document for ApplicationDocument<D> {
    fn inner(&self) -> DocGuard<'_> {
        match self {
            Self::Boa(document) => document.inner(),
            Self::Custom(document) => document.inner(),
        }
    }
    fn inner_mut(&mut self) -> DocGuardMut<'_> {
        match self {
            Self::Boa(document) => document.inner_mut(),
            Self::Custom(document) => document.inner_mut(),
        }
    }
    fn handle_ui_event(&mut self, event: UiEvent) {
        match self {
            Self::Boa(document) => document.handle_ui_event(event),
            Self::Custom(document) => document.handle_ui_event(event),
        }
    }
    fn poll(&mut self, context: Option<Context>) -> bool {
        match self {
            Self::Boa(document) => document.poll(context),
            Self::Custom(document) => document.poll(context),
        }
    }
    fn poll_for_settle(&mut self, context: Option<Context>, timers: bool) -> bool {
        match self {
            Self::Boa(document) => document.poll_for_settle(context, timers),
            Self::Custom(document) => document.poll_for_settle(context, timers),
        }
    }
}