nodeJs 库模块帮助文档

nodeJs 成员列表

Node.js 支持库,
可选使用 nodeJs.install 函数安装独立便携的 Node.js 环境,
默认优先使用系统安装的 Node.js 环境

此支持库可支持 web.rpc.externalServer 创建的 RPC 服务端

nodeJs.cmd("命令文件名",其他命令行参数...)

运行node命令,
此函数会打开控制台,

第一个参数指定cmd命令,可选自第二个参数开始指定命令行参数
多个命令行参数则调用 process.joinArguments 合并,
不在双引号内、且包含空白或需要转义的参数转义处理后首尾添加双引号

nodeJs.cmdget("命令文件名",其他命令行参数...)

运行node命令并获取输出字符串,n此函数不会打开控制台,

nodeJs.cnpm()

使用淘宝镜像执行npm命令,
此函数会打开控制台,

多个命令行参数则调用 process.joinArguments 合并,
不在双引号内、且包含空白或需要转义的参数转义处理后首尾添加双引号

nodeJs.cnpmSync()

参数指定包名,
淘宝镜像同步指定 Node.js 包到最新版本

nodeJs.config()

npm config edit编辑值

nodeJs.config(key)

npm config get获取值

nodeJs.config(key,value)

npm config set设置值

nodeJs.eval(js)

nodeJs.eval(`  
(function(){  
    return process.config;/*执行JS表达式并返回结果,  
返回值如果是字符串,必须放到对象或数组中返回*/  
})()  
`)

nodeJs.exec()

返回对象:processPopenObject

nodeJs.exec(JS代码)

运行JS代码，返回 process.popen 对象,
如果参数@1不为空,则返回进程对象会关闭目标进程的输入流。
参数 @2 开始可以指定一个或多个命令行参数。
命令行参数可以是一个以空格分开多个参数的字符串。
或者传入多个参数、表、数组等由 string.args 自动合成为单个命令行参数。
合成命令行将按需在首尾添加双引号，并处理必要的转义。

nodeJs.execFile()

返回对象:processPopenObject

nodeJs.execFile(JS代码文件,其他命令行参数...)

运行JS代码文件,返回process.popen对象,

第一个参数指定JS代码文件,可选自第二个参数开始指定命令行参数
多个命令行参数则调用 process.joinArguments 合并,
不在双引号内、且包含空白或需要转义的参数转义处理后首尾添加双引号

nodeJs.execLimit()

返回对象:processPopenObject

nodeJs.execLimit(JS代码)

运行JS代码，返回 process.popen 对象,
返回进程绑定 process.job.limitKill 在退出时自动关闭,
如果参数@1不为空,则返回进程对象会关闭目标进程的输入流。
参数 @2 开始可以指定一个或多个命令行参数。
命令行参数可以是一个以空格分开多个参数的字符串。
或者传入多个参数、表、数组等由 string.args 自动合成为单个命令行参数。
合成命令行将按需在首尾添加双引号，并处理必要的转义。

nodeJs.freePort()

分配新的服务端可用端口
在node.js中可使用process.env.PORT获取分配的端口号

nodeJs.getInstallPath()

如果系统已安装 Node.js,返回 node.exe 路径

nodeJs.install(portable)

检测并安装node环境
如果portable为true或指定node版本号，则忽略系统安装的node.exe
否则优先使用系统安装的node.exe
也可以在调用此函数以前在环境变量中使用NODE_EXE设置node.exe的路径
此函数会在执行其他node命令前自动调用

nodeJs.majorVersion

主版本号,数值
只有执行 nodeJs.install 函数以后才会设置此属性,
几乎所有 nodeJs 库函数执行前都会调用 nodeJs.install

nodeJs.nodeDir

node.exe所在目录
只有执行 nodeJs.install 函数以后才会设置此属性,
几乎所有 nodeJs 库函数执行前都会调用 nodeJs.install

nodeJs.nodeExePath

node.exe完整路径
只有执行 nodeJs.install 函数以后才会设置此属性,
几乎所有 nodeJs 库函数执行前都会调用 nodeJs.install

nodeJs.nodeModulesPath

全局模块安装目录
只有执行 nodeJs.install 函数以后才会设置此属性,
几乎所有 nodeJs 库函数执行前都会调用 nodeJs.install

nodeJs.npm()

执行npm命令,
此函数会打开控制台,

多个命令行参数则调用 process.joinArguments 合并,
不在双引号内、且包含空白或需要转义的参数转义处理后首尾添加双引号

nodeJs.npmCliJsPath

npm 位置
只有执行 nodeJs.install 函数以后才会设置此属性,
几乎所有 nodeJs 库函数执行前都会调用 nodeJs.install

nodeJs.npmget()

执行npm命令并获取输出字符串,
默认工作目录为 nodeJs.workDir
此函数不会打开控制台,

多个命令行参数则调用 process.joinArguments 合并,
不在双引号内、且包含空白或需要转义的参数转义处理后首尾添加双引号

nodeJs.options

默认 Node.js 启动命令行选项参数。
此选项参数添加于 js 代码或路径参数之前。
可以为 null 或 string.args 支持的表、数组。

nodeJs.pcmd("命令文件名",其他命令行参数...)

创建进程管道运行node命令,返回 process.popen 对象,
默认工作目录为 nodeJs.workDir
此函数会打开控制台,

nodeJs.pcmd()

返回对象:processPopenObject

nodeJs.pcnpm(echo,...)

执行npm命令,
此函数不打开控制台,使用echo指定的回调函数输出控制台回显信息,

多个命令行参数则调用 process.joinArguments 合并,
不在双引号内、且包含空白或需要转义的参数转义处理后首尾添加双引号

nodeJs.pget()

以管道方式打开node进程,并返回输出值,
支持不定个数启动参数,也可以在一个字符串参数中写多个参数

nodeJs.pnpm(echo,...)

执行npm命令,
此函数不打开控制台,使用echo指定的回调函数输出控制台回显信息,

多个命令行参数则调用 process.joinArguments 合并,
不在双引号内、且包含空白或需要转义的参数转义处理后首尾添加双引号

nodeJs.popen()

以管道方式打开node进程,
支持不定个数启动参数,也可以在一个字符串参数中写多个参数

返回对象:processPopenObject

nodeJs.port

aardio 为 Node.js 自动分配的空闲端口
调用 nodeJs.startEnviron 会自动设置此函数,
nodeJs.install 首次执行会自动调用 nodeJs.startEnviron,
几乎所有 nodeJs 库函数都会自动调用 nodeJs.install

nodeJs.prefix()

获取全局模块安装路径

nodeJs.prequire(echo,moduleName,...)

如果 @moduleName 参数指定的 Node.js 模块不存在，全局安装该模块,
可添加多个 Node.js 模块名参数,
如果系统已安装了node，可能会安装到系统目录
使用nodeJs.prefix函数获取全局模块安装路径
此函数会使用 process.popen 创建管理进程,
可使用 @echo 参数自定义回显函数或回显控件,
回显函数接受一个输出文本参数,
回显控件必须拥有名为 log 的回显函数

nodeJs.prequireByJs(echo,javaScript)

自动分析 @javaScript 参数指定的 JS 代码中的 require 语句,
如果 require 的模块不存在，全局安装该模
如果系统已安装了node，可能会安装到系统目录
使用nodeJs.prefix函数获取全局模块安装路径,
可使用 @echo 参数自定义回显函数或回显控件,
回显函数接受一个输出文本参数,
回显控件必须拥有名为 log 的回显函数

nodeJs.require()

参数输入一个或多个 Node.js 模块名,
如果参数指定的模块不存在，全局安装该模块名,
如果系统已安装了node，可能会安装到系统目录
使用nodeJs.prefix函数获取全局模块安装路径

nodeJs.requireByJs()

自动分析输入JS代码中的 require 语句,
如果 require 的模块不存在，全局安装该模块
如果系统已安装了node，可能会安装到系统目录
使用nodeJs.prefix函数获取全局模块安装路径

nodeJs.requireResolve()

参数输入 Node.js 模块名,
查找并返回该模块安装路径

nodeJs.start

执行 Node.js 代码。
返回 process.popen 对象。
此函数不会关闭 Node.js 的标准输入。

nodeJs.start()

返回对象:processPopenObject

nodeJs.start(code,...)

参数 @code 指定 Node.js 代码或代码文件。。
参数 @2 开始可以指定一个或多个命令行参数。
命令行参数可以是一个以空格分开多个参数的字符串。
或者传入多个参数、表、数组等由 string.args 自动合成为单个命令行参数。
合成命令行将按需在首尾添加双引号，并处理必要的转义。

nodeJs.startEnviron()

返回对象:nodeJsStartEnvironObject

nodeJs.startEnviron(环境变量表)

nodeJs.startEnviron(  
    appPath = io.fullpath("/");  
    /*在这里设置的启动参数对象，在node.js中使用 require('startEnviron')导入*/  
)

nodeJs.startLimit

执行 Node.js 代码，返回 process.popen 对象。
此函数不会关闭 Node.js 的标准输入。

当前进程退出时，Node.js 进程会自动退出。

nodeJs.startLimit()

返回对象:processPopenObject

nodeJs.startLimit(code,...)

nodeJs.startRpc

启动 Node.js 的 process.rpc 兼容服务端。
在当前进程退出时，Node.js 服务端进程会自动退出。
返回 process.rpc.jsonClient 对象，可用于调用 Node.js 全局对象或函数。
全局对象指 Node.js 中 global 对象的成员。
被调用的 Node.js 函数不能是异步函数。

RPC 协议会占用标准输出，JS 里其他 console.log 可能失效。

nodeJs.startRpc()

返回对象:processRpcJsonClientObject

nodeJs.startRpc(code,...)

返回 process.rpc.jsonClient 对象，可用于调用 Node.js 全局对象或函数。

nodeJs.version

node.js 运行时版本

版本号,字符串值
只有执行 nodeJs.install 函数以后才会设置此属性,
几乎所有 nodeJs 库函数执行前都会调用 nodeJs.install

nodeJs.workDir

设置 Node.js 的应用程序工作目录
默认已设置为 io.fullpath("/")

nodeJsStartEnvironObject 成员列表

nodeJsStartEnvironObject.?

startEnviron 启动参数

nodeJsStartEnvironObject.port

自动分配的端口号

Markdown 格式