timeZone
@@ -811,7 +615,7 @@ Provides the options for the **DateTimeFormat** object.
|
Yes
|
-Numbering system.
+ | Numbering system for the locale. The value can be any of the following: adlm, ahom, arab, arabext, bali, beng, bhks, brah, cakm, cham, deva, diak, fullwide, gong, gonm, gujr, guru, hanidec, hmng, hmnp, java, kali, khmr, knda, lana, lanatham, laoo, latn, lepc, limb, mathbold, mathdbl, mathmono, mathsanb, mathsans, mlym, modi, mong, mroo, mtei, mymr, mymrshan, mymrtlng, newa, nkoo, olck, orya, osma, rohg, saur, segment, shrd, sind, sinh, sora, sund, takr, talu, tamldec, telu, thai, tibt, tirh, vaii, wara, and wcho.
|
hour12
@@ -960,94 +764,291 @@ Provides the options for the **DateTimeFormat** object.
-## NumberOptions
+## NumberFormat
-Provides the device capability.
+### constructor
-
-Name
- |
-Parameter Type
- |
-Readable
- |
-Writable
- |
-Description
- |
-
|---|
-
-locale
- |
-string
- |
-Yes
- |
-No
- |
-Locale information.
- |
-
-currency
- |
-string
- |
-Yes
- |
-Yes
- |
-Currency for the specified locale.
- |
-
-currencySign
- |
-string
- |
-Yes
- |
-Yes
- |
-Currency symbol.
- |
-
-currencyDisplay
- |
-string
- |
-Yes
- |
-Yes
- |
-Currency display mode. The value can be symbol, narrowSymbol, code, or name.
- |
-
-unit
- |
-string
- |
-Yes
- |
-Yes
- |
-Currency unit.
- |
-
-unitDisplay
- |
-string
- |
-Yes
- |
-Yes
- |
-Currency unit display format. The value can be long, short, or medium.
- |
-
-signDisplay
- |
-string
- |
-Yes
+constructor\(locale: string, options?: NumberOptions\)
+
+Creates a **NumberFormat** object for the specified locale.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ locale
+ |
+ string
+ |
+ Yes
+ |
+ A string containing locale information, including the language, optional script, and locale.
+ |
+
+ options
+ |
+ NumberOptions
+ |
+ No
+ |
+ Options for creating a NumberFormat object.
+ |
+
+
+
+
+- Example
+
+ ```
+ var numfmt = new Intl.NumberFormat("en-GB", {style:'decimal', notation:"scientific"});
+ ```
+
+
+### constructor
+
+constructor\(locales: Array, options?: NumberOptions\)
+
+Creates a **NumberFormat** object for the specified array of locales.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ locales
+ |
+ Array<string>
+ |
+ Yes
+ |
+ An array of strings containing locale information.
+ |
+
+ options
+ |
+ NumberOptions
+ |
+ No
+ |
+ Options for creating a NumberFormat object.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
+ ```
+
+
+### format
+
+format\(number: number\): string;
+
+Formats a number.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ number
+ |
+ number
+ |
+ Yes
+ |
+ Number to be formatted.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ string
+ |
+ Formatted number.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
+ numfmt.format(1223);
+ ```
+
+
+### resolvedOptions
+
+resolvedOptions\(\): NumberOptions
+
+Obtains the options of the **NumberFormat** object.
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ NumberOptions
+ |
+ Options of the NumberFormat object.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
+ numfmt.resolvedOptions();
+ ```
+
+
+## NumberOptions
+
+Provides the device capability.
+
+
+Name
+ |
+Parameter Type
+ |
+Readable
+ |
+Writable
+ |
+Description
+ |
+
|---|
+
+locale
+ |
+string
+ |
+Yes
+ |
+No
+ |
+Locale, for example, zh-Hans-CN.
+ |
+
+currency
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Currency unit, for example, EUR, CNY, or USD.
+ |
+
+currencySign
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Currency unit symbol. The value can be symbol, narrowSymbol, code, or name.
+ |
+
+currencyDisplay
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Currency display mode. The value can be symbol, narrowSymbol, code, or name.
+ |
+
+unit
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Unit name, for example, meter, inch, or hectare.
+ |
+
+unitDisplay
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Unit display format. The value can be long, short, or medium.
+ |
+
+unitUsage
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Unit use case. The value can be any of the following: default, area-land-agricult, area-land-commercl, area-land-residntl, length-person, length-person-small, length-rainfall, length-road, length-road-small, length-snowfall, length-vehicle, length-visiblty, length-visiblty-small, length-person-informal, length-person-small-informal, length-road-informal, speed-road-travel, speed-wind, temperature-person, temperature-weather, and volume-vehicle-fuel.
+ |
+
+signDisplay
+ |
+string
+ |
+Yes
|
Yes
|
@@ -1106,7 +1107,7 @@ Provides the device capability.
Yes
|
-Numbering system.
+ | Numbering system for the locale. The value can be any of the following: adlm, ahom, arab, arabext, bali, beng, bhks, brah, cakm, cham, deva, diak, fullwide, gong, gonm, gujr, guru, hanidec, hmng, hmnp, java, kali, khmr, knda, lana, lanatham, laoo, latn, lepc, limb, mathbold, mathdbl, mathmono, mathsanb, mathsans, mlym, modi, mong, mroo, mtei, mymr, mymrshan, mymrtlng, newa, nkoo, olck, orya, osma, rohg, saur, segment, shrd, sind, sinh, sora, sund, takr, talu, tamldec, telu, thai, tibt, tirh, vaii, wara, and wcho.
|
useGrouping
@@ -1117,7 +1118,7 @@ Provides the device capability.
|
Yes
|
-Whether to enable grouping for display.
+ | Whether to use grouping for display.
|
miniumumIntegerDigits
@@ -1128,7 +1129,7 @@ Provides the device capability.
|
Yes
|
-Minimum number of integer digits.
+ | Minimum number of digits allowed in the integer part of a number. The value ranges from 1 to 21.
|
miniumumFractionDigits
@@ -1139,7 +1140,7 @@ Provides the device capability.
|
Yes
|
-Minimum number of fraction digits.
+ | Minimum number of digits in the fraction part of a number. The value ranges from 0 to 20.
|
maxiumumFractionDigits
@@ -1150,7 +1151,7 @@ Provides the device capability.
|
Yes
|
-Maximum number of fraction digits.
+ | Maximum number of digits in the fraction part of a number. The value ranges from 1 to 21.
|
miniumumSignificantDigits
@@ -1161,7 +1162,7 @@ Provides the device capability.
|
Yes
|
-Minimum number of significant digits.
+ | Minimum number of the least significant digits. The value ranges from 1 to 21.
|
maxiumumSignificantDigits
@@ -1172,9 +1173,824 @@ Provides the device capability.
|
Yes
|
-Maximum number of significant digits.
+ | Maximum number of the least significant digits. The value ranges from 1 to 21.
|
+## Collator8+
+
+### constructor8+
+
+constructor\(\)
+
+Creates a **Collator** object.
+
+- Example
+
+ ```
+ var collator = new Intl.Collator();
+ ```
+
+
+### constructor8+
+
+constructor\(locale: string | Array, options?: CollatorOptions\)
+
+Creates a **Collator** object based on the specified locale and options.
+
+Parameters
+
+
+Name
+ |
+Type
+ |
+Mandatory
+ |
+Description
+ |
+
|---|
+
+locale
+ |
+string|Array<string>
+ |
+Yes
+ |
+A string containing locale information, including the language, optional script, and locale.
+ |
+
+options
+ |
+CollatorOptions
+ |
+No
+ |
+Options for creating a Collator object.
+ |
+
+
+
+
+- Example
+
+ ```
+ var collator = new Intl.Collator("zh-CN", {"localeMatcher": "lookup", "usage": "sort"});
+ ```
+
+
+### compare8+
+
+compare\(first: string, second: string\): number
+
+Compares two strings based on the sorting policy of the **Collator**.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ first
+ |
+ string
+ |
+ Yes
+ |
+ First string to compare.
+ |
+
+ second
+ |
+ string
+ |
+ Yes
+ |
+ Second string to compare.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ number
+ |
+ Comparison result. If the value is a negative number, the first string is before the second string. If the value of number is 0, the first string is equal to the second string. If the value of number is a positive number, the first string is after the second string.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var collator = new intl.Collator("zh-Hans");
+ collator.compare("first", "second");
+ ```
+
+
+### resolvedOptions8+
+
+resolvedOptions\(\): CollatorOptions
+
+Returns properties reflecting the locale and collation options of a **Collator** object.
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ CollatorOptions
+ |
+ Properties of the Collator object.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var collator = new intl.Collator("zh-Hans");
+ var options = collator.resolvedOptions();
+ ```
+
+
+## CollatorOptions8+
+
+Represents the properties of a **Collator** object.
+
+
+Name
+ |
+Parameter Type
+ |
+Readable
+ |
+Writable
+ |
+Description
+ |
+
|---|
+
+localeMatcher
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Locale matching algorithm. The value can be lookup or best fit.
+ |
+
+usage
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Whether the comparison is for sorting or for searching. The value can be sort or search.
+ |
+
+sensitivity
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Differences in the strings that lead to non-zero return values. The value can be base, accent, case, or variant.
+ |
+
+ignorePunctuation
+ |
+boolean
+ |
+Yes
+ |
+Yes
+ |
+Whether punctuation is ignored. The value can be true or false.
+ |
+
+collation
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Sorting policy. The value can be any of the following: big5han, compat, dict, direct, ducet, eor, gb2312, phonebk, phonetic, pinyin, reformed, searchjl, stroke, trad, unihan, and zhuyin.
+ |
+
+numeric
+ |
+boolean
+ |
+Yes
+ |
+Yes
+ |
+Whether numeric collation is used. The value can be true or false.
+ |
+
+caseFirst
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Whether upper case or lower case is sorted first. The value can be upper, lower, or false.
+ |
+
+
+
+
+## PluralRules8+
+
+### constructor8+
+
+constructor\(\)
+
+Create a **PluralRules** object.
+
+- Example
+
+ ```
+ var pluralRules = new Intl.PluralRules();
+ ```
+
+
+### constructor8+
+
+constructor\(locale: string | Array, options?: PluralRulesOptions\)
+
+Creates a **PluralRules** object based on the specified locale and options.
+
+Parameters
+
+
+Name
+ |
+Type
+ |
+Mandatory
+ |
+Description
+ |
+
|---|
+
+locale
+ |
+string|Array<string>
+ |
+Yes
+ |
+A string containing locale information, including the language, optional script, and locale.
+ |
+
+options
+ |
+PluralRulesOptions
+ |
+No
+ |
+Options for creating a PluralRules object.
+ |
+
+
+
+
+- Example
+
+ ```
+ var pluralRules= new Intl.PluraRules("zh-CN", {"localeMatcher": "lookup", "type": "cardinal"});
+ ```
+
+
+### select8+
+
+select\(n: number\): string
+
+Obtains a string that represents the singular-plural type of the specified number.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ n
+ |
+ number
+ |
+ Yes
+ |
+ Number for which the singular-plural type is to be obtained.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ string
+ |
+ Singular-plural type. The options are as follows: zero, one, two, few, many, and others.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var pluralRules = new intl.PluralRules("zh-Hans");
+ pluralRules.select(1);
+ ```
+
+
+## PluralRulesOptions8+
+
+Represents the properties of a **PluralRules** object.
+
+
+Name
+ |
+Parameter Type
+ |
+Readable
+ |
+Writable
+ |
+Description
+ |
+
|---|
+
+localeMatcher
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Locale matching algorithm. The value can be lookup or best fit.
+ |
+
+type
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Sorting type. The value can be cardinal or ordinal.
+ |
+
+minimumIntegerDigits
+ |
+number
+ |
+Yes
+ |
+Yes
+ |
+Minimum number of digits allowed in the integer part of a number. The value ranges from 1 to 21.
+ |
+
+minimumFractionDigits
+ |
+number
+ |
+Yes
+ |
+Yes
+ |
+Minimum number of digits in the fraction part of a number. The value ranges from 0 to 20.
+ |
+
+maximumFractionDigits
+ |
+number
+ |
+Yes
+ |
+Yes
+ |
+Maximum number of digits in the fraction part of a number. The value ranges from 1 to 21.
+ |
+
+minimumSignificantDigits
+ |
+number
+ |
+Yes
+ |
+Yes
+ |
+Minimum number of the least significant digits. The value ranges from 1 to 21.
+ |
+
+maximumSignificantDigits
+ |
+number
+ |
+Yes
+ |
+Yes
+ |
+Maximum number of the least significant digits. The value ranges from 1 to 21.
+ |
+
+
+
+
+## RelativeTimeFormat8+
+
+### constructor8+
+
+constructor\(\)
+
+Creates a **RelativeTimeFormat** object.
+
+- Example
+
+ ```
+ var relativetimefmt = new Intl.RelativeTimeFormat();
+ ```
+
+
+### constructor8+
+
+constructor\(locale: string | Array, options?: RelativeTimeFormatInputOptions\)
+
+Creates a **RelativeTimeFormat** object based on the specified locale and options.
+
+Parameters
+
+
+Name
+ |
+Type
+ |
+Mandatory
+ |
+Description
+ |
+
|---|
+
+locale
+ |
+string|Array<string>
+ |
+Yes
+ |
+A string containing locale information, including the language, optional script, and locale.
+ |
+
+options
+ |
+RelativeTimeFormatInputOptions
+ |
+No
+ |
+Options for creating a RelativeTimeFormat object.
+ |
+
+
+
+
+- Example
+
+ ```
+ var relativeTimeFormat = new Intl.RelativeTimeFormat("zh-CN", {"localeMatcher": "lookup", "numeric": "always", "style": "long"});
+ ```
+
+
+### format8+
+
+format\(value: numeric, unit: string\): string
+
+Formats the value and unit based on the specified locale and formatting options.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ value
+ |
+ numeric
+ |
+ Yes
+ |
+ Value to format.
+ |
+
+ unit
+ |
+ string
+ |
+ Yes
+ |
+ Unit to format. The value can be year, quarter, month, week, day, hour, minute, or second.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ string
+ |
+ Relative time after formatting.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var relativetimefmt = new Intl.RelativeTimeFormat("zh-CN");
+ relativetimefmt.format(3, "quarter")
+ ```
+
+
+### formatToParts8+
+
+formatToParts\(value: numeric, unit: string\): Array
+
+Returns an array of **RelativeTimeFormat** objects in parts for locale-aware formatting.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ value
+ |
+ numeric
+ |
+ Yes
+ |
+ Value to format.
+ |
+
+ unit
+ |
+ string
+ |
+ Yes
+ |
+ Unit to format. The value can be year, quarter, month, week, day, hour, minute, or second.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ Array<Object>
+ |
+ An array of RelativeTimeFormat objects in parts.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var relativetimefmt = new Intl.RelativeTimeFormat("en", {"numeric": "auto"});
+ var parts = relativetimefmt.format(10, "seconds");
+ ```
+
+
+### resolvedOptions8+
+
+resolvedOptions\(\): RelativeTimeFormatResolvedOptions
+
+Obtains the formatting options for **RelativeTimeFormat** objects.
+
+- Return values
+
+
+
+
+
+- Example
+
+ ```
+ var relativetimefmt= new Intl.RelativeTimeFormat("en-GB");
+ relativetimefmt.resolvedOptions();
+ ```
+
+
+## RelativeTimeFormatInputOptions8+
+
+Represents the properties of a **RelativeTimeFormat** object.
+
+
+Name
+ |
+Parameter Type
+ |
+Readable
+ |
+Writable
+ |
+Description
+ |
+
|---|
+
+localeMatcher
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Locale matching algorithm. The value can be lookup or best fit.
+ |
+
+numeric
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Format of the output message. The value can be always or auto.
+ |
+
+style
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Length of the internationalized message. The value can be long, short, or narrow.
+ |
+
+
+
+
+## RelativeTimeFormatResolvedOptions8+
+
+Represents the properties of a **RelativeTimeFormat** object.
+
+
+Name
+ |
+Parameter Type
+ |
+Readable
+ |
+Writable
+ |
+Description
+ |
+
|---|
+
+locale
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+A string containing locale information, including the language, optional script, and locale.
+ |
+
+numeric
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Format of the output message. The value can be always or auto.
+ |
+
+style
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Length of the internationalized message. The value can be long, short, or narrow.
+ |
+
+numberingSystem
+ |
+string
+ |
+Yes
+ |
+Yes
+ |
+Numbering system.
+ |
+
+
+
diff --git a/en/application-dev/reference/apis/js-apis-notification.md b/en/application-dev/reference/apis/js-apis-notification.md
index 1e4bbafcd5e8928ab009a869bddfbb2debb8f1c4..1105fa9acb63775bd860a5cb611b65ebec77a255 100644
--- a/en/application-dev/reference/apis/js-apis-notification.md
+++ b/en/application-dev/reference/apis/js-apis-notification.md
@@ -1,88 +1,5 @@
# Notification Module
-## Applicable Devices
-
-| API | Phone | Tablet | Smart TV | Wearable |
-| ------------------------------------------------------------ | ---- | ---- | ------ | -------- |
-| Notification.publish(request: NotificationRequest, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.publish(request: NotificationRequest) | Yes | Yes | Yes | Yes |
-| Notification.cancel(id: number, label: string, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.cancel(id：number, label?：string） | Yes | Yes | Yes | Yes |
-| Notification.cancel(id: number, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.cancelAll(callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.cancelAll() | Yes | Yes | Yes | Yes |
-| Notification.addSlot(slot: NotificationSlot, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.addSlot(slot: NotificationSlot) | Yes | Yes | Yes | Yes |
-| Notification.addSlot(type: SlotType, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.addSlot(type: SlotType) | Yes | Yes | Yes | Yes |
-| Notification.addSlots(slots: Array\, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.addSlots(slots: Array\) | Yes | Yes | Yes | Yes |
-| Notification.getSlot(slotType: SlotType, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.getSlot(slotType: SlotType) | Yes | Yes | Yes | Yes |
-| Notification.getSlots(callback: AsyncCallback>) | Yes | Yes | Yes | Yes |
-| Notification.getSlots() | Yes | Yes | Yes | Yes |
-| Notification.removeSlot(slotType: SlotType, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.removeSlot(slotType: SlotType) | Yes | Yes | Yes | Yes |
-| Notification.removeAllSlots(callback: AsyncCallback\): void | Yes | Yes | Yes | Yes |
-| Notification.removeAllSlots(): Promise\ | Yes | Yes | Yes | Yes |
-| Notification.subscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.subscribe(subscriber: NotificationSubscriber, info: NotificationSubscribeInfo, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.subscribe(subscriber: NotificationSubscriber, info?: NotificationSubscribeInfo) | Yes | Yes | Yes | Yes |
-| Notification.unsubscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.unsubscribe(subscriber: NotificationSubscriber) | Yes | Yes | Yes | Yes |
-| Notification.enableNotification(bundle: BundleOption, enable: boolean, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.enableNotification(bundle: BundleOption, enable: boolean) | Yes | Yes | Yes | Yes |
-| Notification.isNotificationEnabled(bundle: BundleOption, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.isNotificationEnabled(bundle: BundleOption) | Yes | Yes | Yes | Yes |
-| Notification.isNotificationEnabled(callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.isNotificationEnabled() | Yes | Yes | Yes | Yes |
-| Notification.displayBadge(bundle: BundleOption, enable: boolean, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.displayBadge(bundle: BundleOption, enable: boolean) | Yes | Yes | Yes | Yes |
-| Notification.isBadgeDisplayed(bundle: BundleOption, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.isBadgeDisplayed(bundle: BundleOption) | Yes | Yes | Yes | Yes |
-| Notification.setSlotByBundle(bundle: BundleOption, slot: NotificationSlot, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.setSlotByBundle(bundle: BundleOption, slot: NotificationSlot) | Yes | Yes | Yes | Yes |
-| Notification.getSlotsByBundle(bundle: BundleOption, callback: AsyncCallback>) | Yes | Yes | Yes | Yes |
-| Notification.getSlotsByBundle(bundle: BundleOption) | Yes | Yes | Yes | Yes |
-| Notification.getSlotNumByBundle(bundle: BundleOption, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.getSlotNumByBundle(bundle: BundleOption) | Yes | Yes | Yes | Yes |
-| Notification.remove(bundle: BundleOption, notificationKey: NotificationKey, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.remove(bundle: BundleOption, notificationKey: NotificationKey) | Yes | Yes | Yes | Yes |
-| Notification.remove(hashCode: string, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.remove(hashCode: string) | Yes | Yes | Yes | Yes |
-| Notification.removeAll(bundle: BundleOption, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.removeAll(callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.removeAll(bundle?: BundleOption) | Yes | Yes | Yes | Yes |
-| Notification.getAllActiveNotifications(callback: AsyncCallback>) | Yes | Yes | Yes | Yes |
-| Notification.getAllActiveNotifications() | Yes | Yes | Yes | Yes |
-| Notification.getActiveNotificationCount(callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.getActiveNotificationCount() | Yes | Yes | Yes | Yes |
-| Notification.getActiveNotifications(callback: AsyncCallback>) | Yes | Yes | Yes | Yes |
-| Notification.getActiveNotifications() | Yes | Yes | Yes | Yes |
-| Notification.cancelGroup(groupName: string, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.cancelGroup(groupName: string) | Yes | Yes | Yes | Yes |
-| Notification.removeGroupByBundle(bundle: BundleOption, groupName: string, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.removeGroupByBundle(bundle: BundleOption, groupName: string) | Yes | Yes | Yes | Yes |
-| Notification.setDoNotDisturbDate(date: DoNotDisturbDate, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.setDoNotDisturbDate(date: DoNotDisturbDate) | Yes | Yes | Yes | Yes |
-| Notification.getDoNotDisturbDate(callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.getDoNotDisturbDate() | Yes | Yes | Yes | Yes |
-| Notification.supportDoNotDisturbMode(callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| Notification.supportDoNotDisturbMode() | Yes | Yes | Yes | Yes |
-| WantAgent.getWantAgent(info: WantAgentInfo, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| WantAgent.getWantAgent(info: WantAgentInfo): Promise\ | Yes | Yes | Yes | Yes |
-| WantAgent.getBundleName(agent: WantAgent, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| WantAgent.getBundleName(agent: WantAgent): Promise\ | Yes | Yes | Yes | Yes |
-| WantAgent.getUid(agent: WantAgent, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| WantAgent.getUid(agent: WantAgent): Promise\ | Yes | Yes | Yes | Yes |
-| WantAgent.getWant(agent: WantAgent, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| WantAgent.getWant(agent: WantAgent): Promise\ | Yes | Yes | Yes | Yes |
-| WantAgent.cancel(agent: WantAgent, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| WantAgent.cancel(agent: WantAgent): Promise\ | Yes | Yes | Yes | Yes |
-| WantAgent.trigger(agent: WantAgent, triggerInfo: TriggerInfo, callback?: Callback\) | Yes | Yes | Yes | Yes |
-| WantAgent.equal(agent: WantAgent, otherAgent: WantAgent, callback: AsyncCallback\) | Yes | Yes | Yes | Yes |
-| WantAgent.equal(agent: WantAgent, otherAgent: WantAgent): Promise\ | Yes | Yes | Yes | Yes |
-
## Required Permissions
diff --git a/en/application-dev/reference/apis/js-apis-particleAbility.md b/en/application-dev/reference/apis/js-apis-particleAbility.md
index 128d8282ba250fc4e887bd178e90308ee015b114..9d4a14ccbeaf81d49fc1de51156613cde3812bda 100644
--- a/en/application-dev/reference/apis/js-apis-particleAbility.md
+++ b/en/application-dev/reference/apis/js-apis-particleAbility.md
@@ -1,18 +1,5 @@
# ParticleAbility Module
-## Applicable Devices
-
-| API | Phone| Tablet| Smart TV| Wearable| Lite Wearable| SmartVision Device|
-| ------------------------------------------------------------ | ---- | ---- | ------ | -------- | -------------- | ------------ |
-| particleAbility.startAbility(parameter: StartAbilityParameter, callback: AsyncCallback\: void | Yes| Yes| Yes| Yes| No| No|
-| particleAbility.startAbility(parameter: StartAbilityParameter): Promise\ | Yes| Yes| Yes| Yes| No| No|
-| particleAbility.terminateSelf(callback: AsyncCallback\): void | Yes| Yes| Yes| Yes| No| No|
-| particleAbility.terminateSelf(): Promise\ | Yes| Yes| Yes| Yes| No| No|
-| particleAbility.acquireDataAbilityHelper(uri: string): DataAbilityHelper | Yes| Yes| Yes| Yes| No| No|
-| particleAbility.connectAbility(request: Want, options:ConnectOptions): number | Yes| Yes| Yes| Yes| No| No|
-| particleAbility.disconnectAbility(connection: number, callback:AsyncCallback\): void | Yes| Yes| Yes| Yes| No| No|
-| particleAbility.disconnectAbility(connection: number): Promise\ | Yes| Yes| Yes| Yes| No| No|
-
## Constraints
The ParticleAbility module is used to perform operations on abilities of the Data and Service types.
diff --git a/en/application-dev/reference/apis/js-apis-process.md b/en/application-dev/reference/apis/js-apis-process.md
index 34fc52c05097d07cd12caffa8f2952492cfc95b7..3d828c219c168585c2de6fdccbb29dc230073ff9 100644
--- a/en/application-dev/reference/apis/js-apis-process.md
+++ b/en/application-dev/reference/apis/js-apis-process.md
@@ -1,4 +1,4 @@
-# Obtaining Process Information
+# Obtaining Process Information
> **NOTE:**
>The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
@@ -80,7 +80,7 @@ None
|
No
|
-An array with supplementary group IDs.
+ | Array with supplementary group IDs.
|
pid
@@ -105,12 +105,23 @@ None
| Parent process ID (PPID) of a process.
|
+tid8+
+ |
+number
+ |
+Yes
+ |
+No
+ |
+Thread ID (TID) of a process.
+ |
+
## ChildProcess
-Allows a process to obtain the standard input and output of its child processes, send signals, and close its child processes.
+Provides methods for a process to obtain the standard input and output of its child processes, send signals, and close its child processes.
### Attributes
@@ -200,7 +211,6 @@ Waits until the child process ends. This method uses a promise to return the exi
- Example
```
- import process from '@ohos.process';
var child = process.runCmd('ls');
var result = child.wait();
result.then(val=>{
@@ -235,7 +245,6 @@ Obtains the standard output of the child process.
- Example
```
- import process from '@ohos.process';
var child = process.runCmd('ls');
var result = child.wait();
child.getOutput.then(val=>{
@@ -270,7 +279,6 @@ Obtains the standard error output of the child process.
- Example
```
- import process from '@ohos.process';
var child = process.runCmd('madir test.text');
var result = child.wait();
child.getErrorOutput.then(val=>{
@@ -288,7 +296,6 @@ Closes the child process in running.
- Example
```
- import process from '@ohos.process';
var child = process.runCmd('sleep 5; ls');
child.close();
```
@@ -328,12 +335,443 @@ Sends a signal to the specified child process to terminate it.
- Example
```
- import process from '@ohos.process';
var child = process.runCmd('sleep 5; ls');
child.kill(9);
```
+## process.isIsolatedProcess8+
+
+isIsolatedProcess\(\): boolean
+
+Checks whether the process is isolated.
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ boolean
+ |
+ Returns true if the process is isolated; returns false otherwise.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var result = process.isIsolatedProcess();
+ ```
+
+
+## process.isAppUid8+
+
+isAppUid\(v:number\): boolean
+
+Checks whether a UID belongs to this app.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ v
+ |
+ number
+ |
+ Yes
+ |
+ UID.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ boolean
+ |
+ Returns true if the UID is the app's UID; returns false otherwise.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var result = process.isAppUid(688);
+ ```
+
+
+## process.is64Bit8+
+
+is64Bit\(\): boolean
+
+Checks whether the operating environment is of 64-bit.
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ boolean
+ |
+ Returns true if the operating environment is of 64-bit; returns false otherwise.
+ |
+
+
+
+
+- Example
+
+ ```
+ var ressult = process.is64Bit();
+ ```
+
+
+## process.getUidForName8+
+
+getUidForName\(v:string\): number
+
+Obtains the process UID based on the process name.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ v
+ |
+ string
+ |
+ Yes
+ |
+ Process name.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ number
+ |
+ Process UID.
+ |
+
+
+
+
+- Example
+
+ ```
+ var pres = process.getUidForName("tool")
+ ```
+
+
+## process.getThreadPriority8+
+
+getThreadPriority\(v:number\): number
+
+Obtains the thread priority based on the specified TID.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ v
+ |
+ number
+ |
+ Yes
+ |
+ TID.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ number
+ |
+ Priority of the thread.
+ |
+
+
+
+
+- Example
+
+ ```
+ var tid = process.tid;
+ var pres = process.getThreadPriority(tid);
+ ```
+
+
+## process.getStartRealtime8+
+
+getStartRealtime\(\) :number
+
+Obtains the duration, in milliseconds, from the time the system starts to the time the process starts.
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ number
+ |
+ Time duration obtained.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var realtime = process.getStartRealtime();
+ ```
+
+
+## process.getAvailableCores8+
+
+getAvailableCores\(\) :number\[\]
+
+Obtains the number of CPU cores available for the current process on a multi-core device.
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ number[]
+ |
+ Number of cores available for the process.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var result = getAvailableCores();
+ ```
+
+
+## process.getPastCputime8+
+
+getPastCputime\(\) :number
+
+Obtains the CPU time \(in milliseconds\) from the time the process starts to the current time.
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ number
+ |
+ CPU time obtained.
+ |
+
+
+
+
+
+- Example
+
+ ```
+ var result = process.getPastCputime() ;
+ ```
+
+
+## process.getSystemConfig8+
+
+getSystemConfig\(name:number\): number
+
+Obtains the system configuration.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ name
+ |
+ number
+ |
+ Yes
+ |
+ System configuration parameter name.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ number
+ |
+ System configuration obtained.
+ |
+
+
+
+
+- Example
+
+ ```
+ var _SC_ARG_MAX = 0
+ var pres = process.getSystemConfig(_SC_ARG_MAX)
+ ```
+
+
+## process.getEnvironmentVar8+
+
+getEnvironmentVar\(name:string\): string
+
+Obtains the value of an environment variable.
+
+- Parameters
+
+
+ Name
+ |
+ Type
+ |
+ Mandatory
+ |
+ Description
+ |
+
|---|
+
+ name
+ |
+ string
+ |
+ Yes
+ |
+ Environment variable name.
+ |
+
+
+
+
+- Return values
+
+
+ Type
+ |
+ Description
+ |
+
|---|
+
+ string
+ |
+ Value of the environment variable.
+ |
+
+
+
+
+- Example
+
+ ```
+ var pres = process.getEnvironmentVar("PATH")
+ ```
+
+
## process.runCmd
runCmd\(command: string, options?: \{ timeout : number, killSignal : number | string, maxBuffer : number \}\) : ChildProcess
@@ -437,12 +875,11 @@ Forks a new process to run a shell command and returns the **ChildProcess** ob
- Example
```
- import process from '@ohos.process';
var child = process.runCmd('ls', { maxBuffer : 2 });
var result = child.wait();
child.getOutput.then(val=>{
console.log("child.getOutput = " + val);
- }
+ })
```
@@ -455,7 +892,6 @@ Aborts a process and generates a core file. This method will cause a process to
- Example
```
- import process from '@ohos.process';
process.abort();
```
@@ -520,7 +956,6 @@ Stores the events triggered by the user.
- Example
```
- import process from '@ohos.process';
process.on("data", (e)=>{
console.log("data callback");
})
@@ -569,7 +1004,7 @@ Deletes the event stored by the user.
|