mirror of
https://gitee.com/openharmony/interface_sdk-js
synced 2024-11-23 07:10:52 +00:00
56011bdefb
Signed-off-by: wang-jingwu001 <wangjingwu4@huawei.com> https://gitee.com/openharmony/interface_sdk-js/issues/IB50HW
1250 lines
43 KiB
TypeScript
1250 lines
43 KiB
TypeScript
/*
|
||
* Copyright (c) 2021-2022 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.
|
||
*/
|
||
|
||
/**
|
||
* @file
|
||
* @kit ArkTS
|
||
*/
|
||
|
||
/**
|
||
* The url module provides utilities for URL resolution and parsing.
|
||
*
|
||
* @namespace url
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* The url module provides utilities for URL resolution and parsing.
|
||
*
|
||
* @namespace url
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* The url module provides utilities for URL resolution and parsing.
|
||
*
|
||
* @namespace url
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
declare namespace url {
|
||
/**
|
||
* The URLSearchParams interface defines some practical methods to process URL query strings.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams
|
||
* @name URLSearchParams
|
||
*/
|
||
class URLSearchParams {
|
||
/**
|
||
* A parameterized constructor used to create an URLSearchParams instance.
|
||
* As the input parameter of the constructor function, init supports four types.
|
||
* The input parameter is a character string two-dimensional array.
|
||
* The input parameter is the object list.
|
||
* The input parameter is a character string.
|
||
* The input parameter is the URLSearchParams object.
|
||
*
|
||
* @param { string[][] | Record<string, string> | string | URLSearchParams } init - init init
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.constructor
|
||
*/
|
||
constructor(init?: string[][] | Record<string, string> | string | URLSearchParams);
|
||
|
||
/**
|
||
* Appends a specified key/value pair as a new search parameter.
|
||
*
|
||
* @param { string } name - name name Key name of the search parameter to be inserted.
|
||
* @param { string } value - value value Values of search parameters to be inserted.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.append
|
||
*/
|
||
append(name: string, value: string): void;
|
||
|
||
/**
|
||
* Deletes the given search parameter and its associated value,from the list of all search parameters.
|
||
*
|
||
* @param { string } name - name name Name of the key-value pair to be deleted.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.delete
|
||
*/
|
||
delete(name: string): void;
|
||
|
||
/**
|
||
* Returns all key-value pairs associated with a given search parameter as an array.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key value.
|
||
* @returns { string[] } string[] Returns all key-value pairs with the specified name.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.getAll
|
||
*/
|
||
getAll(name: string): string[];
|
||
|
||
/**
|
||
* Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
*
|
||
* @returns { IterableIterator<[string, string]> } Returns an iterator for ES6.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.entries
|
||
*/
|
||
entries(): IterableIterator<[string, string]>;
|
||
|
||
/**
|
||
* Callback functions are used to traverse key-value pairs on the URLSearchParams instance object.
|
||
*
|
||
* @param { function } callbackFn - callbackFn callbackFn Current traversal key value.
|
||
* @param { Object } thisArg - thisArg thisArg thisArg to be used as this value for when callbackFn is called
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.forEach
|
||
*/
|
||
forEach(callbackFn: (value: string, key: string, searchParams: URLSearchParams) => void, thisArg?: Object): void;
|
||
|
||
/**
|
||
* Returns the first value associated to the given search parameter.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { string | null } Returns the first value found by name. If no value is found, null is returned.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.get
|
||
*/
|
||
get(name: string): string | null;
|
||
|
||
/**
|
||
* Returns a Boolean that indicates whether a parameter with the specified name exists.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { boolean } Returns a Boolean value that indicates whether a found
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.has
|
||
*/
|
||
has(name: string): boolean;
|
||
|
||
/**
|
||
* Sets the value associated with a given search parameter to the
|
||
* given value. If there were several matching values, this method
|
||
* deletes the others. If the search parameter doesn't exist, this
|
||
* method creates it.
|
||
*
|
||
* @param { string } name - name name Key name of the parameter to be set.
|
||
* @param { string } value - value value Indicates the parameter value to be set.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.set
|
||
*/
|
||
set(name: string, value: string): void;
|
||
|
||
/**
|
||
* Sort all key/value pairs contained in this object in place and return undefined.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.sort
|
||
*/
|
||
sort(): void;
|
||
|
||
/**
|
||
* Returns an iterator allowing to go through all keys contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the names of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.keys
|
||
*/
|
||
keys(): IterableIterator<string>;
|
||
|
||
/**
|
||
* Returns an iterator allowing to go through all values contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the values of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.values
|
||
*/
|
||
values(): IterableIterator<string>;
|
||
|
||
/**
|
||
* Returns an iterator allowing to go through all key/value
|
||
* pairs contained in this object.
|
||
* @returns { IterableIterator<[string, string]> } Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.[Symbol.iterator]
|
||
*/
|
||
[Symbol.iterator](): IterableIterator<[string, string]>;
|
||
|
||
/**
|
||
* Returns a query string suitable for use in a URL.
|
||
*
|
||
* @returns { string } Returns a search parameter serialized as a string, percent-encoded if necessary.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URLParams.toString
|
||
*/
|
||
toString(): string;
|
||
}
|
||
|
||
/**
|
||
* The URLParams interface defines some practical methods to process URL query strings.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
* @name URLParams
|
||
*/
|
||
/**
|
||
* The URLParams interface defines some practical methods to process URL query strings.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
* @name URLParams
|
||
*/
|
||
/**
|
||
* The URLParams interface defines some practical methods to process URL query strings.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
* @name URLParams
|
||
*/
|
||
class URLParams {
|
||
/**
|
||
* A parameterized constructor used to create an URLParams instance.
|
||
* As the input parameter of the constructor function, init supports four types.
|
||
* The input parameter is a character string two-dimensional array.
|
||
* The input parameter is the object list.
|
||
* The input parameter is a character string.
|
||
* The input parameter is the URLParams object.
|
||
*
|
||
* @param { string[][] | Record<string, string> | string | URLParams } [init] - init init
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Incorrect parameter types; 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* A parameterized constructor used to create an URLParams instance.
|
||
* As the input parameter of the constructor function, init supports four types.
|
||
* The input parameter is a character string two-dimensional array.
|
||
* The input parameter is the object list.
|
||
* The input parameter is a character string.
|
||
* The input parameter is the URLParams object.
|
||
*
|
||
* @param { string[][] | Record<string, string> | string | URLParams } [init] - init init
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Incorrect parameter types; 2.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* A parameterized constructor used to create an URLParams instance.
|
||
* As the input parameter of the constructor function, init supports four types.
|
||
* The input parameter is a character string two-dimensional array.
|
||
* The input parameter is the object list.
|
||
* The input parameter is a character string.
|
||
* The input parameter is the URLParams object.
|
||
*
|
||
* @param { string[][] | Record<string, string> | string | URLParams } [init] - init init
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Incorrect parameter types; 2.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
constructor(init?: string[][] | Record<string, string> | string | URLParams);
|
||
|
||
/**
|
||
* Appends a specified key/value pair as a new search parameter.
|
||
*
|
||
* @param { string } name - name name Key name of the search parameter to be inserted.
|
||
* @param { string } value - value value Values of search parameters to be inserted.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Appends a specified key/value pair as a new search parameter.
|
||
*
|
||
* @param { string } name - name name Key name of the search parameter to be inserted.
|
||
* @param { string } value - value value Values of search parameters to be inserted.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Appends a specified key/value pair as a new search parameter.
|
||
*
|
||
* @param { string } name - name name Key name of the search parameter to be inserted.
|
||
* @param { string } value - value value Values of search parameters to be inserted.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
append(name: string, value: string): void;
|
||
|
||
/**
|
||
* Deletes the given search parameter and its associated value,from the list of all search parameters.
|
||
*
|
||
* @param { string } name - name name Name of the key-value pair to be deleted.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Deletes the given search parameter and its associated value,from the list of all search parameters.
|
||
*
|
||
* @param { string } name - name name Name of the key-value pair to be deleted.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Deletes the given search parameter and its associated value,from the list of all search parameters.
|
||
*
|
||
* @param { string } name - name name Name of the key-value pair to be deleted.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
delete(name: string): void;
|
||
|
||
/**
|
||
* Returns all key-value pairs associated with a given search parameter as an array.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key value.
|
||
* @returns { string[] } string[] Returns all key-value pairs with the specified name.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns all key-value pairs associated with a given search parameter as an array.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key value.
|
||
* @returns { string[] } string[] Returns all key-value pairs with the specified name.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns all key-value pairs associated with a given search parameter as an array.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key value.
|
||
* @returns { string[] } string[] Returns all key-value pairs with the specified name.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
getAll(name: string): string[];
|
||
|
||
/**
|
||
* Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
*
|
||
* @returns { IterableIterator<[string, string]> } Returns an iterator for ES6.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
*
|
||
* @returns { IterableIterator<[string, string]> } Returns an iterator for ES6.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
*
|
||
* @returns { IterableIterator<[string, string]> } Returns an iterator for ES6.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
entries(): IterableIterator<[string, string]>;
|
||
|
||
/**
|
||
* Callback functions are used to traverse key-value pairs on the URLParams instance object.
|
||
*
|
||
* @param { function } callbackFn - callbackFn value Current traversal key value,
|
||
* key Indicates the name of the key that is traversed.
|
||
* @param { Object } [thisArg] - thisArg thisArg to be used as this value for when callbackFn is called
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Callback functions are used to traverse key-value pairs on the URLParams instance object.
|
||
*
|
||
* @param { function } callbackFn - callbackFn value Current traversal key value,
|
||
* key Indicates the name of the key that is traversed.
|
||
* @param { Object } [thisArg] - thisArg thisArg to be used as this value for when callbackFn is called
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Callback functions are used to traverse key-value pairs on the URLParams instance object.
|
||
*
|
||
* @param { function } callbackFn - callbackFn value Current traversal key value,
|
||
* key Indicates the name of the key that is traversed.
|
||
* @param { Object } [thisArg] - thisArg thisArg to be used as this value for when callbackFn is called
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
forEach(callbackFn: (value: string, key: string, searchParams: URLParams) => void, thisArg?: Object): void;
|
||
|
||
/**
|
||
* Returns the first value associated to the given search parameter.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { string | null } Returns the first value found by name. If no value is found, null is returned.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns the first value associated to the given search parameter.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { string | null } Returns the first value found by name. If no value is found, null is returned.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns the first value associated to the given search parameter.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { string | null } Returns the first value found by name. If no value is found, null is returned.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
get(name: string): string | null;
|
||
|
||
/**
|
||
* Returns a Boolean that indicates whether a parameter with the specified name exists.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { boolean } Returns a Boolean value that indicates whether a found
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns a Boolean that indicates whether a parameter with the specified name exists.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { boolean } Returns a Boolean value that indicates whether a found
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns a Boolean that indicates whether a parameter with the specified name exists.
|
||
*
|
||
* @param { string } name - name name Specifies the name of a key-value pair.
|
||
* @returns { boolean } Returns a Boolean value that indicates whether a found
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
has(name: string): boolean;
|
||
|
||
/**
|
||
* Sets the value associated with a given search parameter to the
|
||
* given value. If there were several matching values, this method
|
||
* deletes the others. If the search parameter doesn't exist, this
|
||
* method creates it.
|
||
*
|
||
* @param { string } name - name name Key name of the parameter to be set.
|
||
* @param { string } value - value value Indicates the parameter value to be set.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Sets the value associated with a given search parameter to the
|
||
* given value. If there were several matching values, this method
|
||
* deletes the others. If the search parameter doesn't exist, this
|
||
* method creates it.
|
||
*
|
||
* @param { string } name - name name Key name of the parameter to be set.
|
||
* @param { string } value - value value Indicates the parameter value to be set.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Sets the value associated with a given search parameter to the
|
||
* given value. If there were several matching values, this method
|
||
* deletes the others. If the search parameter doesn't exist, this
|
||
* method creates it.
|
||
*
|
||
* @param { string } name - name name Key name of the parameter to be set.
|
||
* @param { string } value - value value Indicates the parameter value to be set.
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
set(name: string, value: string): void;
|
||
|
||
/**
|
||
* Sort all key/value pairs contained in this object in place and return undefined.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Sort all key/value pairs contained in this object in place and return undefined.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Sort all key/value pairs contained in this object in place and return undefined.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
sort(): void;
|
||
|
||
/**
|
||
* Returns an iterator allowing to go through all keys contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the names of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns an iterator allowing to go through all keys contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the names of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns an iterator allowing to go through all keys contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the names of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
keys(): IterableIterator<string>;
|
||
|
||
/**
|
||
* Returns an iterator allowing to go through all values contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the values of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns an iterator allowing to go through all values contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the values of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns an iterator allowing to go through all values contained in this object.
|
||
*
|
||
* @returns { IterableIterator<string> } Returns an ES6 Iterator over the values of each name-value pair.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
values(): IterableIterator<string>;
|
||
|
||
/**
|
||
* Returns an iterator allowing to go through all key/value
|
||
* pairs contained in this object.
|
||
*
|
||
* @returns { IterableIterator<[string, string]> } Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns an iterator allowing to go through all key/value
|
||
* pairs contained in this object.
|
||
*
|
||
* @returns { IterableIterator<[string, string]> } Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns an iterator allowing to go through all key/value
|
||
* pairs contained in this object.
|
||
*
|
||
* @returns { IterableIterator<[string, string]> } Returns an ES6 iterator. Each item of the iterator is a JavaScript Array.
|
||
* The first item of Array is name, and the second item of Array is value.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
[Symbol.iterator](): IterableIterator<[string, string]>;
|
||
|
||
/**
|
||
* Returns a query string suitable for use in a URL.
|
||
*
|
||
* @returns { string } Returns a search parameter serialized as a string, percent-encoded if necessary.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Returns a query string suitable for use in a URL.
|
||
*
|
||
* @returns { string } Returns a search parameter serialized as a string, percent-encoded if necessary.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns a query string suitable for use in a URL.
|
||
*
|
||
* @returns { string } Returns a search parameter serialized as a string, percent-encoded if necessary.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
toString(): string;
|
||
}
|
||
|
||
/**
|
||
* The interface of URL is used to parse, construct, normalize, and encode URLs.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @name URL
|
||
*/
|
||
/**
|
||
* The interface of URL is used to parse, construct, normalize, and encode URLs.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
* @name URL
|
||
*/
|
||
/**
|
||
* The interface of URL is used to parse, construct, normalize, and encode URLs.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
* @name URL
|
||
*/
|
||
class URL {
|
||
/**
|
||
* URL constructor, which is used to instantiate a URL object.
|
||
* url: Absolute or relative input URL to resolve. Base is required if input is relative.
|
||
* If input is an absolute value, base ignores the value.
|
||
* base: Base URL to parse if input is not absolute.
|
||
*
|
||
* @param { string } url - url url
|
||
* @param { string | URL } base - base base
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URL.parseURL
|
||
*/
|
||
constructor(url: string, base?: string | URL);
|
||
|
||
/**
|
||
* URL constructor, which is used to instantiate a URL object.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* URL constructor, which is used to instantiate a URL object.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* URL constructor, which is used to instantiate a URL object.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
constructor();
|
||
|
||
/**
|
||
* Replaces the original constructor to process arguments and return a url object.
|
||
*
|
||
* @param { string } url - url url Absolute or relative input URL to resolve. Base is required if input is relative.
|
||
* If input is an absolute value, base ignores the value.
|
||
* @param { string | URL } [base] - base base Base URL to parse if input is not absolute.
|
||
* @returns { URL }
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @throws { BusinessError } 10200002 - Invalid url string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Replaces the original constructor to process arguments and return a url object.
|
||
*
|
||
* @param { string } url - url url Absolute or relative input URL to resolve. Base is required if input is relative.
|
||
* If input is an absolute value, base ignores the value.
|
||
* @param { string | URL } [base] - base base Base URL to parse if input is not absolute.
|
||
* @returns { URL }
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @throws { BusinessError } 10200002 - Invalid url string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Replaces the original constructor to process arguments and return a url object.
|
||
*
|
||
* @param { string } url - url url Absolute or relative input URL to resolve. Base is required if input is relative.
|
||
* If input is an absolute value, base ignores the value.
|
||
* @param { string | URL } [base] - base base Base URL to parse if input is not absolute.
|
||
* @returns { URL }
|
||
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
||
* 1.Mandatory parameters are left unspecified;
|
||
* 2.Incorrect parameter types;
|
||
* 3.Parameter verification failed.
|
||
* @throws { BusinessError } 10200002 - Invalid url string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
static parseURL(url: string, base?: string | URL): URL;
|
||
|
||
/**
|
||
* Returns the serialized URL as a string.
|
||
*
|
||
* @returns { string } Returns the serialized URL as a string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Returns the serialized URL as a string.
|
||
*
|
||
* @returns { string } Returns the serialized URL as a string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns the serialized URL as a string.
|
||
*
|
||
* @returns { string } Returns the serialized URL as a string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
toString(): string;
|
||
|
||
/**
|
||
* Returns the serialized URL as a string.
|
||
*
|
||
* @returns { string } Returns the serialized URL as a string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Returns the serialized URL as a string.
|
||
*
|
||
* @returns { string } Returns the serialized URL as a string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Returns the serialized URL as a string.
|
||
*
|
||
* @returns { string } Returns the serialized URL as a string.
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
toJSON(): string;
|
||
|
||
/**
|
||
* Gets and sets the fragment portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the fragment portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the fragment portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
hash: string;
|
||
|
||
/**
|
||
* Gets and sets the host portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the host portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the host portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
host: string;
|
||
|
||
/**
|
||
* Gets and sets the host name portion of the URL，not include the port.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the host name portion of the URL，not include the port.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the host name portion of the URL，not include the port.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
hostname: string;
|
||
|
||
/**
|
||
* Gets and sets the serialized URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the serialized URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the serialized URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
href: string;
|
||
|
||
/**
|
||
* Gets the read-only serialization of the URL's origin.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets the read-only serialization of the URL's origin.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets the read-only serialization of the URL's origin.
|
||
*
|
||
* @type { string }
|
||
* @readonly
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
readonly origin: string;
|
||
|
||
/**
|
||
* Gets and sets the password portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the password portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the password portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
password: string;
|
||
|
||
/**
|
||
* Gets and sets the path portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the path portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the path portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
pathname: string;
|
||
|
||
/**
|
||
* Gets and sets the port portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the port portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the port portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
port: string;
|
||
|
||
/**
|
||
* Gets and sets the protocol portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the protocol portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the protocol portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
protocol: string;
|
||
|
||
/**
|
||
* Gets and sets the serialized query portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the serialized query portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the serialized query portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
search: string;
|
||
|
||
/**
|
||
* Gets the URLSearchParams object that represents the URL query parameter.
|
||
* This property is read-only, but URLSearchParams provides an object that can be used to change
|
||
* the URL instance. To replace the entire query parameter for a URL, use url.searchsetter.
|
||
*
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
* @deprecated since 9
|
||
* @useinstead ohos.url.URL.params
|
||
*/
|
||
readonly searchParams: URLSearchParams;
|
||
|
||
/**
|
||
* Gets the URLParams object that represents the URL query parameter.
|
||
* This property is read-only, but URLParams provides an object that can be used to change
|
||
* the URL instance. To replace the entire query parameter for a URL, use url.searchsetter.
|
||
*
|
||
* @type { URLParams }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 9
|
||
*/
|
||
/**
|
||
* Gets the URLParams object that represents the URL query parameter.
|
||
* This property is read-only, but URLParams provides an object that can be used to change
|
||
* the URL instance. To replace the entire query parameter for a URL, use url.searchsetter.
|
||
*
|
||
* @type { URLParams }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets the URLParams object that represents the URL query parameter.
|
||
* This property is read-only, but URLParams provides an object that can be used to change
|
||
* the URL instance. To replace the entire query parameter for a URL, use url.searchsetter.
|
||
*
|
||
* @type { URLParams }
|
||
* @readonly
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
readonly params: URLParams;
|
||
|
||
/**
|
||
* Gets and sets the username portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @since 7
|
||
*/
|
||
/**
|
||
* Gets and sets the username portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @since 10
|
||
*/
|
||
/**
|
||
* Gets and sets the username portion of the URL.
|
||
*
|
||
* @type { string }
|
||
* @syscap SystemCapability.Utils.Lang
|
||
* @crossplatform
|
||
* @atomicservice
|
||
* @since 11
|
||
*/
|
||
username: string;
|
||
}
|
||
}
|
||
export default url;
|