Struct ScriptError 

pub struct ScriptError {
    pub kind: ScriptErrorKind,
    pub name: Option<String>,
    pub message: String,
    pub stack: Option<String>,
    pub line: Option<u32>,
    pub column: Option<u32>,
    pub source_snippet: Option<String>,
}

Structured error returned when a script fails.

line, column, and source_snippet are filled in whenever the QuickJS runtime exposes them (syntax and runtime errors); they are None for engine-level failures like timeouts.

Fields

kind: ScriptErrorKind

name: Option<String>

The thrown value’s JS constructor name (TypeError, …) when the failure came from a JS exception. Hosts render name: message the way every JS runtime does; None for engine-level failures.

message: String

stack: Option<String>

line: Option<u32>

column: Option<u32>

source_snippet: Option<String>

Implementations

impl ScriptError

pub fn redact(&mut self, redactor: &dyn Redactor)

Replace redacted values everywhere this error carries text.

source_snippet is the reason this cannot be left to the caller: it quotes the script’s own source around the throwing line, so a failure inside login('admin', 'hunter2') prints the credential back even when neither the message nor the stack mentions it.

pub fn internal(message: impl Into<String>) -> Self

pub fn named(name: impl Into<String>, message: impl Into<String>) -> Self

A failure carrying a specific JS-visible name, for a host that distinguishes its own refusals by name.

pub fn timeout(elapsed_ms: u64, limit_ms: u64) -> Self

pub fn memory_limit(limit_bytes: usize) -> Self

impl ScriptError

pub fn from_caught(ctx: &Ctx<'_>, caught: CaughtError<'_>, source: &str) -> Self

A caught JS failure as a ScriptError, with every frame of its stack mapped through whichever bundle registered it in this realm, and a source snippet around the throwing line when source is the text that ran.

pub fn from_caught_offset( ctx: &Ctx<'_>, caught: CaughtError<'_>, source: &str, line_offset: u32, ) -> Self

Self::from_caught for source the runtime wrapped: line_offset is how many lines the wrapper put before the user’s first line, so the reported position and snippet name the user’s line.

pub fn from_caught_unmapped( caught: CaughtError<'_>, source: &str, line_offset: u32, ) -> Self

Self::from_caught without the stack remap, for a realm with no bundle registered.

Trait Implementations

impl Clone for ScriptError

fn clone(&self) -> ScriptError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScriptError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ScriptError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ScriptError

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

Formats the value using the given formatter.

impl Error for ScriptError

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 From<Error> for ScriptError

An engine error outside any catch (a failed global write, a loader refusal) is an internal failure: it has no JS exception behind it to name.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl Serialize for ScriptError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.