aardio 文档

nodeJs.runtime 库模块帮助文档

轻量 Node.js 运行时

nodeJs.runtime 成员列表 #

独立 Node.js CLI 运行时;不导入 nodeJs 主库,不初始化 RPC/端口或修改父环境。
resolve/ensure 返回可跨线程传递的纯描述符,只有显式调用才检查/下载。

nodeJs.runtime.ensure() #

返回对象:nodeRuntimeDescriptorObject

nodeJs.runtime.ensure(options) #

优先复用 resolve;缺失/不兼容时在用户目录准备固定版本便携 Node。
不修改 PATH/NODE_PATH/npm配置,不替换显式 nodeExePath;固定version/arch并按SHA256校验ZIP后解压、校验和提交。
选项同resolve;可选 sha256(来自可信清单)、downloadUrl(必须同时传sha256)、onProgress(received,total)。
未指定sha256时从官方HTTPS SHASUMS256.txt获取;默认根目录io.appData("aardio/std/nodeJs/runtime")。
保留.cache归档;坏hash不解压、不提交;同步调用,耗时准备建议工作线程执行。

nodeJs.runtime.popen() #

返回对象:processPopenObject

nodeJs.runtime.popen(runtime,cmdArgs,startInfo) #

使用描述符启动Node,返回原生process.popen并设codepage=65001,不隐式ensure。
cmdArgs/startInfo原样交给process.popen;启动选项及子环境按其契约,不接受额外位置参数。
调用方排空双管道并close;需整树监管时使用独立job.popen(runtime.nodeExePath,cmdArgs,startInfo)。

nodeJs.runtime.resolve() #

返回对象:nodeRuntimeDescriptorObject

nodeJs.runtime.resolve(options) #

定位并运行校验现有 Node,不下载。失败 null,错误信息,错误码或类别。
options.nodeExePath 显式指定时仅检查此路径;否则 NODE_EXE→PATH→系统标准目录→便携目录。
arch 默认 x64(32位Windows为ia32),requireNpm 默认 true,useSystem=false 禁用系统复用。
version 默认24.22.2,仅固定便携版本;系统版本由可选 accept(runtime) 决定是否兼容。
可选 installRoot、probeTimeout(默认5000ms)、stop()。校验会运行候选 node.exe,不是安全沙箱。

nodeRuntimeDescriptorObject 成员列表 #

nodeRuntimeDescriptorObject.arch #

实际Node进程架构:x64、ia32或arm64。

nodeRuntimeDescriptorObject.nodeDir #

Node 安装目录。

nodeRuntimeDescriptorObject.nodeExePath #

node.exe 完整路径。

nodeRuntimeDescriptorObject.npmCliJsPath #

node.exe 同目录下 node_modules/npm/bin/npm-cli.js;requireNpm=false 时可能为 null。

nodeRuntimeDescriptorObject.source #

explicit、environment、path、system或portable。

nodeRuntimeDescriptorObject.version #

实际运行得到的 x.y.z 版本号,无v前缀。

Markdown 格式