Reference
Arcane.permissions.status()
Gets permission/elevation status.
This focused page is derived from the mechanically checked full member inventory.
Syntax
Arcane.permissions.status()
Parameters
None
Return value
Promise<status>
Description
Gets permission/elevation status.
Overview
Arcane.permissions.status() refreshes the Core host's permission/elevation
observation. It requires system.read, is Core-only, changes no privilege, and
emits no event. A true canElevate value describes the host mechanism; it does
not mean this read prompted for or obtained elevation.
Result
The result is exactly {elevated, level, canElevate, mechanism, detectedBy, probes}. elevated and canElevate are booleans; mechanism may be null;
probes contains bounded host-specific diagnostic records.
Microsoft NT normally reports level as "standard", "administrator", or
"system", using UAC and an integrity-level probe. Linux reports "standard"
or "root" from the effective uid and also records whether its kernel peer
credential guard is available. Simulation returns explicitly simulated
mechanisms and probes. Never use a simulation result as evidence of real
administrator or root authority.
Errors and recovery
METHOD_NOT_ALLOWED means the application lacks system.read. A failed probe
normally remains visible in detectedBy and probes; a rejected request or
transport failure should be surfaced as unknown permission state, never treated
as elevated.
Example
const permissions = await Arcane.permissions.status();
if (!permissions.elevated) {
console.log('This host session is not elevated.', permissions.level);
}