Creates a new open-database error.
Human-readable failure description
Machine-readable failure category
Optionaloptions: { cause?: unknown; stage?: AcDbConversionStage }Optional conversion stage and original cause
Optional ReadonlycauseOriginal thrown value that was normalized into this error, when available.
ReadonlycodeMachine-readable failure category for programmatic handling.
OptionalstackOptional ReadonlystageConversion stage that was active when the failure occurred, when known.
Populated for failures raised during AcDbDatabase.read or AcDbDatabase.openUri pipeline tasks.
Static OptionalprepareOptional override for formatting stack traces
StaticstackStaticcaptureStaticclassifyClassifies a thrown value into an AcDbOpenDatabaseErrorCode.
Prefers a structured code on the error (for example
DwgConverterLicenseError.code), then the error name, then message
heuristics used for worker/postMessage failures.
Thrown value from an open or conversion operation
The inferred open-database error code
StaticclassifyClassifies a worker error message into an AcDbOpenDatabaseErrorCode.
Checks license markers, then out-of-memory patterns, then timeout wording,
and falls back to worker_error for all other messages.
Worker or postMessage error text to classify
The inferred open-database error code
StaticfromNormalizes any thrown value into an AcDbOpenDatabaseError.
Returns the input unchanged when it is already an instance of this class. Otherwise extracts a message, classifies it, and wraps it in a new error.
Thrown value from an open or conversion operation
Optionalstage: AcDbConversionStageConversion stage active when the failure occurred
A typed open-database error
StaticfromNormalizes a task scheduler failure into an AcDbOpenDatabaseError.
Uses the failed task name as the conversion stage.
Error emitted by AcCmTaskScheduler for a failed task
A typed open-database error with stage populated from the task name
StaticisReturns true when code is a license failure.
StaticisStaticthrowThrows an AcDbOpenDatabaseError when a worker parse result failed.
Acts as a type guard: when this method returns normally, result.success
is known to be true and AcDbWorkerResult.data is defined.
Worker task result to validate
Conversion stage to attach to the thrown error
AcDbOpenDatabaseError when result.success is false
Structured error thrown when opening a drawing database fails.
Callers can inspect code to distinguish worker out-of-memory failures from parse errors, timeouts, license failures, and other failure modes.