@ohos.process (获取进程相关的信息)

获取进程相关的信息，提供进程管理的相关功能。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { process } from '@kit.ArkTS';

属性

系统能力： SystemCapability.Utils.Lang

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

EventListener

type EventListener = (evt: Object) => void

用户存储的事件信息。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

process.isIsolatedProcess⁸⁺

isIsolatedProcess(): boolean

检查进程是否已被隔离。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

let result = process.isIsolatedProcess();

process.is64Bit⁸⁺

is64Bit(): boolean

检查运行环境是否为64位。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

let result = process.is64Bit();

process.getStartRealtime⁸⁺

getStartRealtime(): number

获取系统启动到进程启动的实时时间（以毫秒为单位）。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

let realtime = process.getStartRealtime();

process.getPastCpuTime⁸⁺

getPastCpuTime(): number

获取进程启动到当前时间的CPU时间（以毫秒为单位）。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

let result = process.getPastCpuTime();

process.abort

abort(): void

该方法会导致进程立即退出并生成一个核心文件，谨慎使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

示例：

process.abort();

process.uptime

uptime(): number

获取当前系统已运行的时间（以秒为单位）。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

返回值：

示例：

let time = process.uptime();

process.kill^(deprecated)

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

发送信号到指定进程，结束该进程。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用kill⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

let pres = process.pid;
let result = process.kill(28, pres);

process.exit^(deprecated)

exit(code: number): void

终止程序。

请谨慎使用此接口。调用此接口后应用将退出。如果输入参数非0，可能会导致数据丢失或出现异常。

说明：

从API version 7开始支持，从API version 9开始废弃，建议使用exit⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

示例：

process.exit(0);

process.getUidForName^(deprecated)

getUidForName(v: string): number

根据指定的用户名，从系统的用户数据库中获取该用户的uid。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用getUidForName⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

let pres = process.getUidForName("tool");

process.getThreadPriority^(deprecated)

getThreadPriority(v: number): number

根据指定的tid获取线程优先级。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用getThreadPriority⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

let tid = process.tid;
let pres = process.getThreadPriority(tid);

process.isAppUid^(deprecated)

isAppUid(v: number): boolean

判断uid是否属于应用程序。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用isAppUid⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

let result = process.isAppUid(688);

process.getSystemConfig^(deprecated)

getSystemConfig(name: number): number

获取系统配置信息。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用getSystemConfig⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

let _SC_ARG_MAX = 0;
let pres = process.getSystemConfig(_SC_ARG_MAX);

process.getEnvironmentVar^(deprecated)

getEnvironmentVar(name: string): string

获取环境变量名对应的值。

说明：

从API version 8开始支持，从API version 9开始废弃，建议使用getEnvironmentVar⁹⁺替代。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

示例：

let pres = process.getEnvironmentVar("PATH");

ProcessManager⁹⁺

提供用于新增进程的抛异常接口。

构造ProcessManager对象。

isAppUid⁹⁺

isAppUid(v: number): boolean

判断uid是否属于当前应用程序。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let pro = new process.ProcessManager();
// uid通过process.uid获取
let pres = process.uid;
let result = pro.isAppUid(pres);
console.log("result: " + result); // result: true

getUidForName⁹⁺

getUidForName(v: string): number

根据指定的用户名，从系统的用户数据库中获取该用户uid。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let pro = new process.ProcessManager();
let pres = pro.getUidForName("tool");

getThreadPriority⁹⁺

getThreadPriority(v: number): number

根据指定的tid获取线程优先级。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let pro = new process.ProcessManager();
let tid = process.tid;
let pres = pro.getThreadPriority(tid);

getSystemConfig⁹⁺

getSystemConfig(name: number): number

获取系统配置信息。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let pro = new process.ProcessManager();
let _SC_ARG_MAX = 0;
let pres = pro.getSystemConfig(_SC_ARG_MAX);

getEnvironmentVar⁹⁺

getEnvironmentVar(name: string): string

获取环境变量对应的值。

说明：

获取环境变量对应的值。如果环境变量不存在，返回undefined。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let pro = new process.ProcessManager();
let pres = pro.getEnvironmentVar("PATH");

exit⁹⁺

exit(code: number): void

终止程序。

请谨慎使用此接口，此接口调用后应用会退出，如果入参非0会产生数据丢失或者异常情况。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let pro = new process.ProcessManager();
pro.exit(0);

kill⁹⁺

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

发送signal到指定的进程，结束指定进程。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

返回值：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let pro = new process.ProcessManager();
let pres = process.pid;
let result = pro.kill(28, pres);

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkTS（方舟编程语言）

harmony 鸿蒙编译工具链错误码

harmony 鸿蒙Typescript Compiler错误码介绍

harmony 鸿蒙语言基础类库错误码

harmony 鸿蒙js-apis-arkts-collections

harmony 鸿蒙js-apis-arkts-decimal

harmony 鸿蒙@arkts.lang (ArkTS语言基础能力)

harmony 鸿蒙@arkts.utils (ArkTS工具库)

harmony 鸿蒙@ohos.util.ArrayList (线性容器ArrayList)

harmony 鸿蒙@ohos.buffer (Buffer)