Signed-off-by: lifansheng <lifansheng1@huawei.com>

On branch master
 Your branch is up to date with 'origin/master'.
This commit is contained in:
lifansheng 2021-10-27 20:47:14 +08:00
parent 1930c459ef
commit e8a355a579
2 changed files with 250 additions and 231 deletions

478
api/@ohos.process.d.ts vendored
View File

@ -1,330 +1,348 @@
/*
* Copyright (c) 2021 Huawei Device Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
* Copyright (c) 2021 Huawei Device Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* The process is mainly used to obtain the relevant ID of the process, obtain and modify
* the working directory of the process, exit and close the process.
* @since 7
* @sysCap SystemCapability.CCRuntime
* @devices phone, tablet
* @import import url from '@ohos.process';
* @permission N/A
*/
* The process is mainly used to obtain the relevant ID of the process, obtain and modify
* the working directory of the process, exit and close the process.
* @since 7
* @sysCap SystemCapability.CCRuntime
* @devices phone, tablet, tv, wearable, car
* @import import url from '@ohos.process';
*/
declare namespace process {
export interface ChildProcess {
/**
* return pid is the pid of the current process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the pid of the current process.
*/
* return pid is the pid of the current process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return the pid of the current process.
*/
readonly pid: number;
/**
* return ppid is the pid of the current child process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the pid of the current child process.
*/
* return ppid is the pid of the current child process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return the pid of the current child process.
*/
readonly ppid: number;
/**
* return exitCode is the exit code of the current child process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the exit code of the current child process.
*/
* return exitCode is the exit code of the current child process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return the exit code of the current child process.
*/
readonly exitCode: number;
/**
* return boolean is whether the current process signal is sent successfully
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return whether the current process signal is sent successfully.
*/
* return boolean is whether the current process signal is sent successfully
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return whether the current process signal is sent successfully.
*/
readonly killed: boolean;
/**
* return 'number' is the targer process exit code
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the targer process exit code.
*/
* return 'number' is the targer process exit code
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return the targer process exit code.
*/
wait(): Promise<number>;
/**
* return it as 'Uint8Array' of the stdout until EOF
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return subprocess standard outpute.
*/
* return it as 'Uint8Array' of the stdout until EOF
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return subprocess standard outpute.
*/
getOutput(): Promise<Uint8Array>;
/**
* return it as 'Uint8Array of the stderr until EOF
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return subprocess standard error output.
*/
* return it as 'Uint8Array of the stderr until EOF
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return subprocess standard error output.
*/
getErrorOutput(): Promise<Uint8Array>;
/**
* close the target process
* @since 7
* @sysCap SystemCapability.CCRuntime
*/
* close the target process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
*/
close(): void;
/**
* send a signal to process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param signal number or string represents the signal sent.
*/
* send a signal to process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @param signal number or string represents the signal sent.
*/
kill(signal: number | string): void;
}
/**
* returns the numeric valid group ID of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the numeric valid group ID of the process.
*/
readonly getEgid: number;
* returns the numeric valid group ID of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return the numeric valid group ID of the process.
*/
const egid: number;
/**
* return the numeric valid user identity of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the numeric valid user identity of the process.
*/
readonly getEuid: number;
* return the numeric valid user identity of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return the numeric valid user identity of the process.
*/
const euid: number;
/**
* returns the numeric group id of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the numeric group if of the process.
*/
readonly getGid: number
* returns the numeric group id of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return the numeric group if of the process.
*/
const gid: number
/**
* returns the digital user id of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the digital user id of the process.
*/
readonly getUid: number;
* returns the digital user id of the process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return the digital user id of the process.
*/
const uid: number;
/**
* return an array with supplementary group id
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return an array with supplementary group id.
*/
readonly getGroups: number[];
* return an array with supplementary group id
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return an array with supplementary group id.
*/
const groups: number[];
/**
* return pid is The pid of the current process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return The pid of the current process.
*/
readonly getPid: number;
* return pid is The pid of the current process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return The pid of the current process.
*/
const pid: number;
/**
* return ppid is The pid of the current child process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return return The pid of the current child processs.
*/
readonly getPpid: number;
* return ppid is The pid of the current child process
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return return The pid of the current child processs.
*/
const ppid: number;
/**
* Returns the tid of the current thread.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return return the tid of the current thread.
*/
const tid: number;
/**
* Returns the tid of the current thread.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return return the tid of the current thread.
*/
function getTid(): number;
/**
* Returns a boolean whether the process is isolated.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return return boolean whether the process is isolated.
*/
* Returns a boolean whether the process is isolated.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return return boolean whether the process is isolated.
*/
function isIsolatedProcess(): boolean;
/**
* Returns a boolean whether the specified uid belongs to a particular application.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param v An id.
* @return return a boolean whether the specified uid belongs to a particular application.
*/
/**
* Returns a boolean whether the specified uid belongs to a particular application.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param v An id.
* @return return a boolean whether the specified uid belongs to a particular application.
*/
function isAppUid(v: number): boolean;
/**
* Returns a boolean whether the process is running in a 64-bit environment.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return return a boolean whether the process is running in a 64-bit environment.
*/
/**
* Returns a boolean whether the process is running in a 64-bit environment.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return return a boolean whether the process is running in a 64-bit environment.
*/
function is64Bit(): boolean;
/**
* Returns the uid based on the specified user name.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param v Process name.
* @return return the uid based on the specified user name.
*/
* Returns the uid based on the specified user name.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param v Process name.
* @return return the uid based on the specified user name.
*/
function getUidForName(v: string): number;
/**
* Returns the thread priority based on the specified tid.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param v The tid of the process.
* @return Return the thread priority based on the specified tid.
*/
* Returns the thread priority based on the specified tid.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param v The tid of the process.
* @return Return the thread priority based on the specified tid.
*/
function getThreadPriority(v: number): number;
/**
* Returns the elapsed real time (in milliseconds) taken from the start of the system to the start of the process.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return Return the start of the system to the start of the process.
*/
* Returns the elapsed real time (in milliseconds) taken from the start of the system to the start of the process.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return Return the start of the system to the start of the process.
*/
function getStartRealtime(): number;
/**
* Returns cpu cores available for the current process on a multi-core device.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return Return cpu cores available for the current process on a multi-core device.
*/
* Returns cpu cores available for the current process on a multi-core device.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return Return cpu cores available for the current process on a multi-core device.
*/
function getAvailableCores(): number[];
/**
* Returns the cpu time (in milliseconds) from the time when the process starts to the current time.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return Return the cpu time (in milliseconds) from the time when the process starts to the current time.
*/
* Returns the cpu time (in milliseconds) from the time when the process starts to the current time.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @return Return the cpu time (in milliseconds) from the time when the process starts to the current time.
*/
function getPastCpuTime(): number;
/**
* Returns the system configuration at runtime.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param name Parameters defined by the system configuration.
* @return Return the system configuration at runtime.
*/
* Returns the system configuration at runtime.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param name Parameters defined by the system configuration.
* @return Return the system configuration at runtime.
*/
function getSystemConfig(name: number): number;
/**
* Returns the system value for environment variables.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param name Parameters defined by the system environment variables.
* @Returns the system value for environment variables.
*/
function getEnvironmentVar(name: string): string;
/**
* Returns the system value for environment variables.
* @since 8
* @sysCap SystemCapability.CCRuntime
* @param name Parameters defined by the system environment variables.
* @Returns the system value for environment variables.
*/
function getEnvironmentVar(name: string): string;
type EventListener = (evt: Object) => void;
/**
* Return a child process object and spawns a new ChildProcess to run the command
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param command string of the shell commands executed by the child process.
* @param options This is an object. The object contains three parameters. Timeout is the running time of the child
* process, killSignal is the signal sent when the child process reaches timeout, and maxBuffer is the size of the
* maximum buffer area for standard input and output.
* @return Return a child process object.
*/
* Return a child process object and spawns a new ChildProcess to run the command
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param command string of the shell commands executed by the child process.
* @param options This is an object. The object contains three parameters. Timeout is the running time of the child
* process, killSignal is the signal sent when the child process reaches timeout, and maxBuffer is the size of the
* maximum buffer area for standard input and output.
* @systemapi Hide this for inner system use
* @return Return a child process object.
*/
function runCmd(command: string,
options?: { timeout : number, killSignal : number | string, maxBuffer : number }): ChildProcess;
/**
* Abort current process
* @since 7
* @sysCap SystemCapability.CCRuntime
*/
* Abort current process
* @since 7
* @sysCap SystemCapability.CCRuntime
*/
function abort(): void;
/**
* Register for an event
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param type Indicates the type of event registered.
* @param listener Represents the registered event function
*/
* Register for an event
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param type Indicates the type of event registered.
* @systemapi Hide this for inner system use
* @param listener Represents the registered event function
*/
function on(type: string, listener: EventListener): void;
/**
* Remove registered event
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param type Remove the type of registered event.
* @return Return removed result.
*/
* Remove registered event
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param type Remove the type of registered event.
* @systemapi Hide this for inner system use
* @return Return removed result.
*/
function off(type: string): boolean;
/**
* Process exit
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param code Process exit code.
*/
* Process exit
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param code Process exit code.
*/
function exit(code: number): void;
/**
* Return the current work directory;
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return Return the current work directory.
*/
* Return the current work directory;
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @return Return the current work directory.
*/
function cwd(): string;
/**
* Change current directory
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param dir The path you want to change.
*/
* Change current directory
* @since 7
* @sysCap SystemCapability.CCRuntime
* @systemapi Hide this for inner system use
* @param dir The path you want to change.
*/
function chdir(dir: string): void;
/**
* Returns the running time of the system
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return Return the running time of the system.
*/
* Returns the running time of the system
* @since 7
* @sysCap SystemCapability.CCRuntime
* @return Return the running time of the system.
*/
function uptime(): number;
/**
* Return whether the signal was sent successfully
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param signal Signal sent.
* @param pid Send signal to target pid.
* @return Return the result of the signal.
*/
* Return whether the signal was sent successfully
* @since 7
* @sysCap SystemCapability.CCRuntime
* @param signal Signal sent.
* @param pid Send signal to target pid.
* @return Return the result of the signal.
*/
function kill(signal: number, pid: number): boolean;
}
export default process;
export default process;

3
api/@ohos.url.d.ts vendored
View File

@ -76,8 +76,9 @@ declare namespace url {
* @param value Current traversal key value.
* @param key Indicates the name of the key that is traversed.
* @param searchParams The instance object that is currently calling the forEach method.
* @param thisArg to be used as this value for when callbackfn is called
*/
forEach(callbackfn: (value: string, key: string, searchParams: this) => void): void;
forEach(callbackfn: (value: string, key: string, searchParams: this) => void, thisArg?: Object): void;
/**
* Returns the first value associated to the given search parameter.