Arcane OS Docs Development only

Reference

Arcane.Error

Normalized native/API error constructor with code, message, resolution, diagnosticId, and available technical diagnostic fields.

  • Reference

This focused page is derived from the mechanically checked full member inventory.

Syntax

Arcane.Error

Member kind

Constructor

Description

Normalized native/API error constructor with code, message, resolution, diagnosticId, and available technical diagnostic fields.

Overview

Arcane.Error is the normalized error constructor used for rejected native API requests. Instances always provide code and message; resolution, diagnosticId, technicalMessage, hresult, causeName, and other bounded diagnostic fields are present when the host supplied them. Native request failures reject with this type, while synchronous JavaScript argument checks can throw TypeError before a request is sent.

Error handling

Branch on code, retain diagnosticId for support, and show resolution when available. Do not match changing message prose or log sensitive request or result data merely because an error object contains technical context.

Example

try {
    await globalThis.Arcane.system.ping();
} catch (error) {
    if (error instanceof globalThis.Arcane.Error) {
        console.error(error.code, error.resolution ?? error.message);
    } else {
        throw error;
    }
}

Reference group

Namespace, constructor, and values

Repository and reviewed source access