Skip to content

Commit

Permalink
zh-CN: create notifications.onClicked (#25076)
Browse files Browse the repository at this point in the history
  • Loading branch information
PassionPenguin authored Dec 27, 2024
1 parent 8eebac6 commit 6d19ced
Showing 1 changed file with 57 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
title: notifications.onClicked
slug: Mozilla/Add-ons/WebExtensions/API/notifications/onClicked
l10n:
sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
---

{{AddonSidebar}}

当用户点击通知并且点击的并不是通知的按钮时触发(对于点击按钮的事件,参见 {{WebExtAPIRef("notifications.onButtonClicked")}})。

## 语法

```js-nolint
browser.notifications.onClicked.addListener(listener)
browser.notifications.onClicked.removeListener(listener)
browser.notifications.onClicked.hasListener(listener)
```

事件有三个函数:

- `addListener(listener)`
- : 为此事件添加监听器。
- `removeListener(listener)`
- : 停止监听此事件。`listener` 参数是要移除的监听器。
- `hasListener(listener)`
- : 检查是否已为此事件注册了 `listener`。若正在监听,返回 `true`,否则返回 `false`

## addListener 语法

### 参数

- `listener`

- : 当此事件发生时调用的函数。该函数需要你传递下列参数:

- `notificationId`
- : `string`。用户点击的通知的 ID。

## 浏览器兼容性

{{Compat}}

## 示例

在下述简单示例中,我们为 `notifications.onClicked` 事件添加一个监听器,以监听用户点击系统通知。当这种情况发生时,我们会在控制台中打印相应的消息。

```js
browser.notifications.onClicked.addListener((notificationId) => {
console.log(`通知 ${notificationId} 被用户点击`);
});
```

{{WebExtExamples}}

> [!NOTE]
> 该 API 基于 Chromium 的 [`chrome.notifications`](https://developer.chrome.google.cn/docs/extensions/reference/api/notifications) API。

0 comments on commit 6d19ced

Please sign in to comment.