Enum SandboxError 

pub enum SandboxError {
    NotCompiledIn,
    BodyTooLarge,
    Timeout,
    OutOfMemory,
    StackOverflow,
    PhaseDenied(String),
    NoBindings,
    PanicCaptured(String),
    ScriptError(String),
}

Errors the runtime adapter can emit. Every variant is recoverable at the dispatch site — the parent flatten never aborts because of a sandbox error (S-17 fail-open).

Variants

NotCompiledIn

Cargo feature xfa-js-sandboxed not compiled in. Returned by the null::NullRuntime for every execute_script call.

BodyTooLarge

Script body exceeds the per-script size cap (S-11; default 64 KB).

Timeout

Per-script time budget exceeded (S-9; default 100 ms hard).

OutOfMemory

Per-document memory budget exceeded (S-10; default 32 MiB hard).

StackOverflow

Call stack depth exceeded the configured maximum (S-12; default 64).

PhaseDenied(String)

Activity not in the runtime allowlist for sandboxed dispatch (S-14). UI / submission activities skip the runtime entirely at the dispatch boundary and never reach this error path; this variant exists for explicit binding-level phase guards.

NoBindings

Phase B: no host bindings registered. Returned when a script attempts to read or write any xfa.* / field.* binding the adapter has not yet exposed.

PanicCaptured(String)

FFI panic captured via std::panic::catch_unwind. Used by the rquickjs backend to keep panics from crossing the FFI boundary into the Rust caller.

ScriptError(String)

Generic script-level error: parse, runtime, or thrown JS error.

Trait Implementations

impl Clone for SandboxError

fn clone(&self) -> SandboxError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SandboxError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for SandboxError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for SandboxError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for SandboxError

fn eq(&self, other: &SandboxError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SandboxError

impl StructuralPartialEq for SandboxError