Arcane.development.installNode()

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

Syntax

Arcane.development.installNode()

Parameters

None

Return value

Promise<{installed, simulated, node, operation}>

Description

Installs and verifies the supported Node.js 22+ development runtime on Microsoft NT. Developer-only privileged mutation; requires development.manage.

Overview

Installs the supported external Node.js development runtime through Arcane's owned Developer workflow. This is a privileged, exclusive mutation available only to the Developer application with development.manage, and only on Microsoft NT. Linux callers receive guidance to use the operating system's trusted package channel instead.

Result and operation lifecycle

The method takes no arguments and resolves to {installed,simulated,node,operation}. On a real host, Core verifies that a supported Node.js 22-or-newer runtime is usable after installation and rejects when the installation command finishes without producing that state.

This can start external package-management work. Require confirmation and keep the operation events visible rather than blocking the UI or promising a fixed completion time.

Example

async function installNodeAfterConfirmation() {
    const access = await Arcane.capabilities.list();
    if (!access.methods.includes('development.node.install')) {
        throw new Error('Managed Node.js installation is unavailable');
    }
    return Arcane.development.installNode();
}

document.querySelector('#install-node')?.addEventListener(
    'click',
    async function handleNodeInstallation() {
        const result = await installNodeAfterConfirmation();
        console.log(result.node.version);
    }
);

Reference group

Session, provisioning, diagnostics, and development