From fa01d0b8219a16fc6edc038f35d58c0e1e5c9967 Mon Sep 17 00:00:00 2001 From: xliu Date: Tue, 24 Aug 2021 16:21:38 +0800 Subject: [PATCH] add url/process d.ts Signed-off-by: xliu Change-Id: I5efec61e95d9a6b701f63c3b1b854071f2f8675f --- api/@ohos.process.d.ts | 80 ++++++++++++++++++++++++++ api/@ohos.url.d.ts | 125 +++++++++++++++++++++++++++++++++++++++++ api/@ohos.util.d.ts | 37 ++++++++++-- 3 files changed, 237 insertions(+), 5 deletions(-) create mode 100644 api/@ohos.process.d.ts create mode 100644 api/@ohos.url.d.ts diff --git a/api/@ohos.process.d.ts b/api/@ohos.process.d.ts new file mode 100644 index 0000000000..845c97fe98 --- /dev/null +++ b/api/@ohos.process.d.ts @@ -0,0 +1,80 @@ +/* +* 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. +*/ + +declare namespace process { + + export interface ChildProcess { + readonly pid: number; + readonly ppid: number; + readonly exitCode: number; + readonly killed: boolean; + + wait(): Promise; + /** + * Buffer the stdout until EOF and return it as 'Uint8Array' + */ + getOutput(): Promise; + /** + * Buffer the stderr until EOF and return it as 'Uint8Array' + */ + getErrorOutput(): Promise; + /** + * close the target process + */ + close(): void; + /** + * send a signal to process + */ + kill(signo: number): void; + } + /** + * spawns a new ChildProcess to run the command + */ + function runCmd(command: string, options?: RunOptions): ChildProcess; + + function getPid(): number; + function getPpid(): number; + + /** + *abort current process + *@return void + */ + function abort(): void; + + function on(type: string, listener: EventListener): void; + function exit(code?:number): void; + + /** + *get current work directory; + */ + function cwd(): string; + + /** + *change current directory + *@param dir + */ + function chdir(dir: string): void; + + function getEgid(): number; + function getEuid(): number; + + function getGid(): number + function getUid(): number; + function uptime(): number; + + function getGroups(): number[]; + function kill(signal?: number, pid?: number): boolean; +} +export default process; \ No newline at end of file diff --git a/api/@ohos.url.d.ts b/api/@ohos.url.d.ts new file mode 100644 index 0000000000..fa3cb00c50 --- /dev/null +++ b/api/@ohos.url.d.ts @@ -0,0 +1,125 @@ +/* +* 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. +*/ + +declare class URLSearchParams { + constructor(init ? : string[][] | Record | string | URLSearchParams +}; + +/** Appends a specified key/value pair as a new search parameter. + */ +append(name: string, value : string) : void; + +/** Delete the given search parameter and its associated value, + * from the list of all search parameters. + */ +delete(name: string) : void; + +/** Returns all the values associated with a given search parameter + * as an array. + */ +getAll(name: string) : string[]; + +/** Returns an iterator allowing to go through all key/value + * pairs contained in this object. + */ +entries() : IterableIterator<[string, string]>; + +/** Allows iteration through all values contained in this object via a callback function. + */ +forEach(callbackfn: (value: string, key : string, parent : this) = > void, thisArg ? : object) : void; + +/** Returns the first value associated to the given search parameter. + */ +get(name: string) : string | null; + +/** Returns a Boolean that indicates whether a parameter with the + * specified name exists. + */ +has(name: string) : boolean; + +/**Sets the value associated with a given search parameter to the + * given value.If there were several matching values, this methods + * deletes the others. If the search parameter doesn't exist, this + * methods creates it. + */ +set(name: string, value : string) : void; + +/** Sort all key/value pairs contained in this object in place and + * return undefined. + */ +sort() : void; + +/** Returns an iterator allowing to go through all keys contained + * in this object. + */ +keys() :IterableIterator; + +/** Returns an iterator allowing to go through all values contained + * in this object. + */ +values() : IterableIterator; + + +/** Returns an iterator allowing to go through all key/value + * pairs contained in this object. + */ +[Symbol.iterator]() : IterableIterator<[string, string]>; + +/** Returns a query string suitable for use in a URL. + */ +toString() :string; +} + +/* web api URL interface */ +declare class URL { + /** constructor of URL + * url:absolute URL string or a relative URL string + * base:base URL string + */ + constructor(url: string, base ? : string | URL); + + /* methods */ + createObjectURL(object: object) : string; + revokeObjectURL(url: string) : void; + toString() : string; + toJSON() : string; + + /* fragment identifier of URL */ +hash: string; + /* domain: port of URL */ +host: string; + /* domain of URL */ +hostname: string; + /* whole URL */ +href: string; + /* contain the origin of the URL, readonly */ + readonly origin : string; + /* password specified before the domain name */ +password: string; + /* an '/' followed by the path of the URL */ +pathname: string; + /* port of the URL */ +port: string; + /* the protocol scheme of the URL, readonly */ +protocol: string; + /* indicating the parameter string of the URL */ +search: string; + /* URLSearchParams object which used to access the individual query parameters */ + readonly searchParams : URLSearchParams; + /* the username before the domain name */ +username: string; +} + +export {URL, URLSearchParams}; \ No newline at end of file diff --git a/api/@ohos.util.d.ts b/api/@ohos.util.d.ts index 52e4389e63..8ff27facc7 100644 --- a/api/@ohos.util.d.ts +++ b/api/@ohos.util.d.ts @@ -4,7 +4,7 @@ * 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 +* 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, @@ -12,8 +12,36 @@ * See the License for the specific language governing permissions and * limitations under the License. */ - declare namespace util { + /** return a formatted string using the first argument as a printf-like format. */ + /** %s: String will be used to convert all values except BigInt, Object and -0. BigInt values will + be represented with an n and Objects that have no user defined toString function are inspected using + util.inspect() with options { depth: 0, colors: false, compact: 3 }. + %d: Number will be used to convert all values except BigInt and Symbol. + %i: parseInt(value, 10) is used for all values except BigInt and Symbol. + %f: parseFloat(value) is used for all values except Bigint and Symbol. + %j: JSON. Replaced whith the string '[Circular]' if the argument contains circular references. + %o: Object. A string representation of an object with generic JavaScript object formatting. + Similar to util.inspect() with options { showHidden: true, showProxy: true}. This will show the + full object including non-enumerable properties and proxies. + %O: Object. A string representation of an object with generic JavaScript object formatting. + Similar to util.inspect() without options. This will show the full object not including + non-enumerable properties and proxies. + %c: CSS. This specifier is ignored and will skip any CSS passed in. + %%: single percent sign ('%'). This does not consume an argument. + Returns: The formatted string */ + function printf(format: string, ...args: Object[]): string; + + /** return the string name of a system errno*/ + function getErrorString(errno: number): string; + + /** Takes an async function (or a function that returns a Promise) and returns a function following the + error-first callback style */ + function callbackWrapper(original: Function): (err: Object, value: Object) => void; + + /** Takes a function following the common error-first callback style, i.e taking an (err, value) => ... + callback as the last argument, and return a version that returns promises */ + function promiseWrapper(original: (err: Object, value: Object) => void): Object; /** * encoding name: support full encoding in ICU data utf-8 utf-16 iso8859 must support in all device @@ -32,8 +60,7 @@ declare namespace util { /** Returns the result of running encoding's decoder. */ decode(input?: ArrayBuffer | ArrayBufferView, options?: { stream?: false }): string; } - - /** + /** * TextEncoder takes a stream of code points as input and emits a stream of UTF-8 bytes. */ class TextEncoder { @@ -52,4 +79,4 @@ declare namespace util { } } -export default util; \ No newline at end of file +export default util; -- Gitee