Arcane.system.failurePolicy()

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

Syntax

Arcane.system.failurePolicy()

Parameters

None

Return value

Promise<{failFast:boolean}>

Description

Gets the user-wide verification behavior. failFast defaults to false; application-owned repository readers may use it to choose validated-subset warnings or immediate rejection. Settings only.

Overview

Arcane.system.failurePolicy() reads the user-wide verification behavior used by tracked Core operations. It requires preferences.read, app id settings, and a Core host. It has no side effect or event.

Result and behavior

The exact result is {failFast: boolean}. The default is false (warn-first) when no saved policy exists. Warn-first lets specifically classified verification warnings complete visibly; it never authorizes unverified bytes or bypasses a hard identity, privilege, capability, or transaction boundary. true turns eligible warnings into operation failures.

If Core cannot read a corrupt policy, it logs the problem internally and safely returns {failFast: false} for that process. Settings should present that value without claiming the saved file was healthy.

Errors and recovery

METHOD_NOT_ALLOWED means the caller is not Settings or lacks preferences.read. Transport failures leave the policy unknown. Use saveFailurePolicy() for an intentional change; do not mutate the returned object.

Example

const policy = await Arcane.system.failurePolicy();
console.log(policy.failFast ? 'Fail fast' : 'Warn first');

Reference group

Platform, installation, users, and system