Reference
Arcane.filesystem
Native filesystem selection operations.
This focused page is derived from the mechanically checked full member inventory.
Syntax
Arcane.filesystem
Member kind
Namespace
Description
Native filesystem selection operations.
Overview
Arcane.filesystem owns native directory selection. It returns a host-reviewed
selection rather than granting arbitrary path traversal or a general-purpose
filesystem API. The optional picker argument must be a non-array object.
Availability and security
Directory selection requires filesystem.directory.select. The native picker,
host sandbox, and application policy remain authoritative for what can be
selected and what later operations may do with the returned path.
Example
const access = await globalThis.Arcane.capabilities.list();
const canSelectDirectory = access.methods.includes('filesystem.directory.select');
console.log('Directory picker admitted:', canSelectDirectory);
Members
Arcane.filesystem.selectDirectory()— Opens the native directory picker after a user action. It returns one canonical existing directory or explicit cancellation; it does not enumerate or grant access to directory contents. Requires filesystem.directory.select.