獲取進程相關的信息

說明： 本模塊首批接口從API version 7開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

import process from '@ohos.process';

屬性

系統能力： 以下各項對應的系統能力均為SystemCapability.Utils.Lang。

ChildProcess

主進程可以獲取子進程的標準輸入輸出，以及發送信號和關閉子進程。

屬性

系統能力： 以下各項對應的系統能力均為SystemCapability.Utils.Lang。

wait

wait(): Promise

等待子進程運行結束，返回promise對象，其值為子進程的退出碼。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var child = process.runCmd('ls');
var result = child.wait();
result.then(val= >{
    console.log("result = " + val);
})

getOutput

getOutput(): Promise

獲取子進程的標準輸出。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var child = process.runCmd('ls');
var result = child.wait();
child.getOutput.then(val= >{
    console.log("child.getOutput = " + val);
})

getErrorOutput

getErrorOutput(): Promise

獲取子進程的標準錯誤輸出。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var child = process.runCmd('madir test.text');
var result = child.wait();
child.getErrorOutput.then(val= >{
    console.log("child.getErrorOutput= " + val);
})

close

close(): void

關閉正在運行的子進程。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

示例：

var child = process.runCmd('sleep 5; ls');
child.close();

kill

kill(signal: number | string): void

用于發送信號給子進程，結束指定進程。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

var child = process.runCmd('sleep 5; ls');
child.kill(9);

process.isIsolatedProcess8+

isIsolatedProcess(): boolean

判斷進程是否被隔離。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var result = process.isIsolatedProcess();

process.isAppUid8+

isAppUid(v: number): boolean

判斷uid是否屬于應用程序。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var result = process.isAppUid(688);

process.is64Bit8+

is64Bit(): boolean

判斷運行環境是否64位。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var ressult = process.is64Bit();

process.getUidForName8+

getUidForName(v: string): number

通過進程名獲取進程uid。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pres = process.getUidForName("tool")

process.getThreadPriority8+

getThreadPriority(v: number): number

根據指定的tid獲取線程優先級。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tid = process.getTid();
var pres = process.getThreadPriority(tid);

process.getStartRealtime8+

getStartRealtime(): number

獲取從系統啟動到進程啟動所經過的實時時間（以毫秒為單位）。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var realtime = process.getStartRealtime();

process.getPastCpuTime8+

getPastCpuTime(): number

獲取進程啟動到當前時間的CPU時間（以毫秒為單位）。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var result = process.getPastCpuTime() ;

process.getSystemConfig8+

getSystemConfig(name: number): number

獲取系統配置信息。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var _SC_ARG_MAX = 0
var pres = process.getSystemConfig(_SC_ARG_MAX)

process.getEnvironmentVar8+

getEnvironmentVar(name: string): string

用該方法獲取環境變量對應的值。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pres = process.getEnvironmentVar("PATH")

process.runCmd

runCmd(command: string, options?: { timeout : number, killSignal : number | string, maxBuffer : number }): ChildProcess

通過runcmd可以fork一個新的進程來運行一段shell，并返回ChildProcess對象。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

參數：

表1 options

返回值：

示例：

var child = process.runCmd('ls', { maxBuffer : 2 });
var result = child.wait();
child.getOutput.then(val= >{
    console.log("child.getOutput = " + val);
})

process.abort

abort(): void

該方法會導致進程立即退出并生成一個核心文件，謹慎使用。

系統能力： SystemCapability.Utils.Lang

示例：

process.abort();

process.on

on(type: string, listener: EventListener): void

存儲用戶所觸發的事件。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

參數：

表2 EventListener

示例：

process.on("data", (e)= >{
    console.log("data callback");
})

process.off

off(type: string): boolean

刪除用戶存儲的事件。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

process.on("data", (e)= >{
    console.log("data callback");
})
var result = process.off("data");

process.exit

exit(code: number): void

終止程序。

請謹慎使用此接口。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

process.exit(0);

process.cwd

cwd(): string

用該方法獲取進程的工作目錄。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

示例：

var path = process.cwd();

process.chdir

chdir(dir: string): void

更改進程的當前工作目錄。

該接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

process.chdir('/system');

process.uptime

uptime(): number

獲取當前系統已運行的秒數。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var time = process.uptime();

process.kill

kill(signal: number, pid: number): boolean

發送signal到指定的進程，結束指定進程。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pres = process.pid
var result = that.kill(28, pres)

審核編輯 黃宇