Error base class for all errors thrown by this library.

Hierarchy (view full)

Constructors

  • Parameters

    • Optionalmessage: string

    Returns MatterError

  • Parameters

    • Optionalmessage: string
    • Optionaloptions: ErrorOptions

    Returns MatterError

Properties

formatterFor: ((formatName: string) => ((value: unknown, indents?: number) => unknown)) = MatterError.defaultFormatterFactory

The error formatter factory. The default formatter is replaced by Matter.js in ./Format.ts.

Methods

  • Node.js-style object inspection.

    Node's default inspection only prevents two levels of depth which may hide critical information. It's also considerably more verbose than native matter.js formatting. We therefore offer this custom implementation.

    Note that this conforms to Node's API but is not dependent on Node.

    Parameters

    • depth: number
    • OptionalinspectionOptions: {
          colors?: boolean;
      }
      • Optionalcolors?: boolean

    Returns unknown

  • Convert the error to formatted text.

    Matter encodes errors with modern JS features including Error#cause and AggregateError#errors subfields. You can use this function to ensure all error details are presented regardless of environment.

    Parameters

    • format: "plain" | "ansi" | "html" = "plain"
    • indents: number = 0

    Returns string

  • Rethrow an error unless it is an instance of this class.

    Type Parameters

    Parameters

    • this: (new (...args: any[]) => T)
        • new (...args): T
        • Parameters

          • Rest...args: any[]

          Returns T

    • error: unknown

    Returns asserts error is T

  • The fallback formatter factory. This produces a limited plaintext formatter.

    Returns ((value: unknown, indents?: number) => string)

      • (value, indents?): string
      • It's never reasonable to fail to present error information so we include this rudimentary fallback error formatter.

        Parameters

        • value: unknown
        • indents: number = 0

        Returns string