Arcane.appearance.current()

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

Syntax

Arcane.appearance.current()

Parameters

None

Return value

Promise<{supported, platform, scheme, effectiveScheme, captionColor, textColor}>

Description

Gets the current native appearance state. Requires appearance.read; Linux currently reports supported:false.

Overview

Reads the native user-appearance state visible to the current host. This is separate from an application's own CSS: Arcane applications should still load the shared theme and ThemeBootstrap.js so saved appearance choices are applied consistently.

Return value and platforms

Requires appearance.read. Microsoft NT returns {supported:true,platform:'windows',scheme,effectiveScheme,captionColor,textColor}. scheme is system, light, or dark; effectiveScheme is light or dark. Linux currently reports an unsupported system appearance with null custom colors rather than claiming that native settings were changed.

Example

async function reportNativeAppearance() {
    const appearance = await Arcane.appearance.current();
    console.log(appearance.supported, appearance.effectiveScheme);
    return appearance;
}

await reportNativeAppearance();

Reference group

Filesystem, storage, preferences, and appearance