Arcane OS Docs Development only

Reference

Arcane.network.status()

Counts interfaces with at least one non-loopback address. online does not claim Internet, DNS, captive-portal, route, or service reachability.

  • Reference

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

Syntax

Arcane.network.status()

Parameters

None

Return value

Promise<{online, interfaceCount}>

Description

Counts interfaces with at least one non-loopback address. online does not claim Internet, DNS, captive-portal, route, or service reachability.

Overview

Arcane.network.status() reports whether the host sees at least one network interface with a non-loopback address. It requires network.status.read and is available on Core and Android. It performs no network request, changes nothing, and emits no event.

Result and limits

The exact result is {online, interfaceCount}. interfaceCount is a safe integer from 0 through 64, and online is exactly interfaceCount > 0. It does not prove Internet, DNS, route, captive-portal, mail-gateway, or application-service reachability.

Use this result only as a coarse UI hint. A network operation still needs its own bounded timeout and surfaced error; do not suppress a retry solely because this snapshot says offline.

Errors and recovery

METHOD_NOT_ALLOWED or ANDROID_CAPABILITY_DENIED means the grant is absent. NETWORK_STATUS_UNAVAILABLE means Core observed more interfaces than its bounded contract accepts. METHOD_CONTRACT_OUTPUT_INVALID rejects a contradictory Android or Core result.

Example

const network = await Arcane.network.status();

console.log(
    network.online ? 'Interface present' : 'No non-loopback interface',
    network.interfaceCount
);

Reference group

Platform, installation, users, and system

Repository and reviewed source access