Arcane.external

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

Syntax

Arcane.external

Member kind

Namespace

Description

Policy-restricted requests to open external resources.

Overview

Arcane.external requests a policy-validated operating-system handoff for an external URI. The current public contract accepts only a tightly validated mailto: URI. An opened result means the operating system accepted the handoff, not that a composer opened or a message was sent.

Availability and security

external.open requires the external.open capability on Core or Android. The host rejects whitespace, fragments, backslashes, malformed escapes, encoded controls, and unsupported schemes before any handoff.

Example

const access = await globalThis.Arcane.capabilities.list();
const canRequestExternalOpen = access.methods.includes('external.open');

console.log('External URI handoff admitted:', canRequestExternalOpen);

Members

• Arcane.external.open() — Hands a validated URI to the operating system's registered default application. opened: true means only that the OS accepted the handoff, not that a composer opened or a message was sent. Simulation fails explicitly instead of claiming a handoff. Requires external.open.

Reference group

Namespace, constructor, and values