Arcane OS Docs Development only

Reference

Arcane.diagnostics.get()

Gets one current in-memory diagnostic record or rejects after it is evicted. Requires diagnostics.read.

  • Reference

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

Syntax

Arcane.diagnostics.get(diagnosticId)

Parameters

Opaque diagnostic ID from a recent error

Return value

Promise<diagnostic>

Description

Gets one current in-memory diagnostic record or rejects after it is evicted. Requires diagnostics.read.

Overview

Retrieves one complete in-memory diagnostic by the opaque ID returned through Arcane.diagnostics.recentErrors(), a rejected Arcane.Error.diagnosticId, or a core.error event. Use this only when the user asks to inspect the corresponding failure in detail.

Return value and errors

Requires diagnostics.read and resolves to the matching diagnostic record. It rejects with DIAGNOSTIC_NOT_FOUND after the record is evicted or Core restarts. Do not assume an ID is portable between host sessions.

Example

async function loadNewestDiagnostic() {
    const recent = await Arcane.diagnostics.recentErrors();
    if (recent.length === 0) return null;
    return Arcane.diagnostics.get(recent[0].id);
}

const diagnostic = await loadNewestDiagnostic();
if (diagnostic) console.log(diagnostic.code, diagnostic.resolution);

Reference group

Session, provisioning, diagnostics, and development

Repository and reviewed source access