diff --git a/en/application-dev/reference/apis/js-apis-system-notification.md b/en/application-dev/reference/apis/js-apis-system-notification.md new file mode 100644 index 0000000000000000000000000000000000000000..daa6d4aac0d3ea39560a13de07b37c51c8b9226a --- /dev/null +++ b/en/application-dev/reference/apis/js-apis-system-notification.md @@ -0,0 +1,68 @@ +# Notification + +> ![icon-note.gif]public_sys-resources/icon-note.gif) **NOTE**
+> - The APIs of this module are no longer maintained since API version 7. You are advised to use [`@ohos.notification`](js-apis-notification.md). +> +> - The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version. + + +## Modules to Import + + +``` +import notification from '@system.notification'; +``` + +## ActionResult + +**System capability**: SystemCapability.Notification.Notification + +| Name | Readable| Writable| Type | Mandatory| Description | +| ----------- | --- | ---- | ---------------------------------------------- | ---- | ------------------------- | +| bundleName | Yes | Yes | string | Yes | Name of the application bundle to which the notification will be redirected after being clicked. | +| abilityName | Yes | Yes | string | Yes | Name of the application ability to which the notification will be redirected after being clicked.| +| uri | Yes | Yes | string | No | URI of the page to be redirected to. | + + +## ShowNotificationOptions + +**System capability**: SystemCapability.Notification.Notification + +| Name | Readable| Writable| Type | Mandatory| Description | +| ------------- | --- | ---- | ---------------------------------------------- | ---- | ------------------------- | +| contentTitle | Yes | Yes | string | No | Notification title. | +| contentText | Yes | Yes | string | No | Notification content. | +| clickAction | Yes | Yes | ActionResult | No | Action triggered when the notification is clicked. | + + +## notification.show + +show(options?: ShowNotificationOptions): void + +Displays a notification. + +**System capability**: SystemCapability.Notification.Notification + +**Parameters** + +| Name| Type| Mandatory| Description| +| -------- | -------- | -------- | -------- | +| options | ShowNotificationOptions | No| Notification title.| + +**Example** +```javascript +export default { + show() { + notification.show({ + contentTitle: 'title info', + contentText: 'text', + clickAction: { + bundleName: 'com.example.testapp', + abilityName: 'notificationDemo', + uri: '/path/to/notification', + }, + }); + }, +} +; +``` diff --git a/en/application-dev/reference/apis/js-apis-system-request.md b/en/application-dev/reference/apis/js-apis-system-request.md index 53fa3bf82253930056ccd2caa524f24d85598046..18b94b676942abb856fa9bd709c1898a6f98588d 100644 --- a/en/application-dev/reference/apis/js-apis-system-request.md +++ b/en/application-dev/reference/apis/js-apis-system-request.md @@ -53,7 +53,7 @@ Uploads files. | name | string | Yes | Name of the form element | | value | string | Yes | Value of the form element | -The following values will be returned when the files are successfully uploaded. +When the files are successfully uploaded, the following values will be returned. | Name | Type | Description | | -------- | -------- | -------- | @@ -61,6 +61,8 @@ The following values will be returned when the files are successfully uploaded. | data | string | Content returned by the server. The value type is determined by the type in the returned headers. | | headers | Object | Headers returned by the server. | +When the files fail to be uploaded, an HTTP status code is returned in **code** of **data**. + **Example** ```