Struct CompilerError 

pub struct CompilerError {
    pub details: Vec<CompilerErrorOrDiagnostic>,
    pub is_thrown: bool,
}

Aggregate compiler error - can contain multiple diagnostics. This is the main error type thrown/returned by the compiler.

Fields

details: Vec<CompilerErrorOrDiagnostic>

is_thrown: bool

When false, this error was accumulated on the Environment via record_error() / record_diagnostic() and returned at the end of the pipeline. In TS, CompileUnexpectedThrow is only emitted for errors that are thrown (not accumulated). Defaults to true because errors created directly (e.g., via ? from a pass) are analogous to thrown errors in the TS code.

Implementations

impl CompilerError

pub fn new() -> Self

pub fn push_diagnostic(&mut self, diagnostic: CompilerDiagnostic)

pub fn push_error_detail(&mut self, detail: CompilerErrorDetail)

pub fn has_errors(&self) -> bool

pub fn has_any_errors(&self) -> bool

pub fn has_invariant_errors(&self) -> bool

Check if any error detail has Invariant category.

pub fn merge(&mut self, other: CompilerError)

pub fn is_all_non_invariant(&self) -> bool

Check if all error details are non-invariant. In TS, this is used to determine if an error thrown during compilation should be logged as CompileUnexpectedThrow.

pub fn to_string_for_event(&self) -> String

Format as a string matching the TS CompilerError.toString() output. Used for the data field of CompileUnexpectedThrow events.

Format per detail: "Category: reason. Description. (line:column)" Multiple details are joined with "\n\n".

Trait Implementations

impl Clone for CompilerError

fn clone(&self) -> CompilerError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompilerError

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

Formats the value using the given formatter.

impl Default for CompilerError

fn default() -> Self

Returns the “default value” for a type.

impl Display for CompilerError

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

Formats the value using the given formatter.

impl Error for CompilerError

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<CompilerDiagnostic> for CompilerError

fn from(diagnostic: CompilerDiagnostic) -> Self

Converts to this type from the input type.

impl From<CompilerError> for CompilerDiagnostic

Allow ? to convert a CompilerError into a CompilerDiagnostic when the enclosing function returns Result<T, CompilerDiagnostic>.

This typically happens when record_error() returns Err(CompilerError) for an Invariant error, and the calling function already returns Result<T, CompilerDiagnostic>. The conversion extracts the first error detail from the aggregate error.

fn from(err: CompilerError) -> Self

Converts to this type from the input type.