獲取進(jìn)程相關(guān)的信息

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

導(dǎo)入模塊

import process from '@ohos.process';

屬性

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

ChildProcess

主進(jìn)程可以獲取子進(jìn)程的標(biāo)準(zhǔn)輸入輸出，以及發(fā)送信號和關(guān)閉子進(jìn)程。

屬性

系統(tǒng)能力： 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

wait

wait(): Promise

等待子進(jìn)程運行結(jié)束，返回promise對象，其值為子進(jìn)程的退出碼。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getOutput

getOutput(): Promise

獲取子進(jìn)程的標(biāo)準(zhǔn)輸出。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

示例：

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

getErrorOutput

getErrorOutput(): Promise

獲取子進(jìn)程的標(biāo)準(zhǔn)錯誤輸出。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： 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

關(guān)閉正在運行的子進(jìn)程。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

示例：

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

kill

kill(signal: number | string): void

用于發(fā)送信號給子進(jìn)程，結(jié)束指定進(jìn)程。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

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

process.isIsolatedProcess8+

isIsolatedProcess(): boolean

判斷進(jìn)程是否被隔離。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

示例：

var result = process.isIsolatedProcess();

process.isAppUid8+

isAppUid(v: number): boolean

判斷uid是否屬于應(yīng)用程序。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

var result = process.isAppUid(688);

process.is64Bit8+

is64Bit(): boolean

判斷運行環(huán)境是否64位。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

示例：

var ressult = process.is64Bit();

process.getUidForName8+

getUidForName(v: string): number

通過進(jìn)程名獲取進(jìn)程uid。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

var pres = process.getUidForName("tool")

process.getThreadPriority8+

getThreadPriority(v: number): number

根據(jù)指定的tid獲取線程優(yōu)先級。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

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

process.getStartRealtime8+

getStartRealtime(): number

獲取從系統(tǒng)啟動到進(jìn)程啟動所經(jīng)過的實時時間（以毫秒為單位）。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

示例：

var realtime = process.getStartRealtime();

process.getPastCpuTime8+

getPastCpuTime(): number

獲取進(jìn)程啟動到當(dāng)前時間的CPU時間（以毫秒為單位）。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

示例：

var result = process.getPastCpuTime() ;

process.getSystemConfig8+

getSystemConfig(name: number): number

獲取系統(tǒng)配置信息。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

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

process.getEnvironmentVar8+

getEnvironmentVar(name: string): string

用該方法獲取環(huán)境變量對應(yīng)的值。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

var pres = process.getEnvironmentVar("PATH")

process.runCmd

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

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

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

表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

該方法會導(dǎo)致進(jìn)程立即退出并生成一個核心文件，謹(jǐn)慎使用。

系統(tǒng)能力： SystemCapability.Utils.Lang

示例：

process.abort();

process.on

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

存儲用戶所觸發(fā)的事件。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

表2 EventListener

示例：

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

process.off

off(type: string): boolean

刪除用戶存儲的事件。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

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

process.exit

exit(code: number): void

終止程序。

請謹(jǐn)慎使用此接口。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

process.exit(0);

process.cwd

cwd(): string

用該方法獲取進(jìn)程的工作目錄。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

示例：

var path = process.cwd();

process.chdir

chdir(dir: string): void

更改進(jìn)程的當(dāng)前工作目錄。

該接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

process.chdir('/system');

process.uptime

uptime(): number

獲取當(dāng)前系統(tǒng)已運行的秒數(shù)。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

示例：

var time = process.uptime();

process.kill

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

發(fā)送signal到指定的進(jìn)程，結(jié)束指定進(jìn)程。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

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

審核編輯 黃宇