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

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

導(dǎo)入模塊

import process from '@ohos.process';

屬性

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

ChildProcess

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

屬性

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

wait

wait(): Promise

等待子進(jìn)程運(yùn)行結(jié)束，返回promise對(duì)象，其值為子進(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)錯(cuò)誤輸出。

該接口為系統(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)閉正在運(yù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ā)送信號(hào)給子進(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

判斷運(yùn)行環(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)先級(jí)。

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

參數(shù)：

返回值：

示例：

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

process.getStartRealtime8+

getStartRealtime(): number

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

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

返回值：

示例：

var realtime = process.getStartRealtime();

process.getPastCpuTime8+

getPastCpuTime(): number

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

系統(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)境變量對(duì)應(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一個(gè)新的進(jìn)程來運(yùn)行一段shell，并返回ChildProcess對(duì)象。

該接口為系統(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

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

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

示例：

process.abort();

process.on

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

存儲(chǔ)用戶所觸發(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

刪除用戶存儲(chǔ)的事件。

該接口為系統(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

終止程序。

請(qǐng)謹(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)已運(yùn)行的秒數(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)

審核編輯 黃宇