From 6d19cedc68ccbf929eb41d268f0b520c99573b20 Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Fri, 27 Dec 2024 09:41:55 +0800
Subject: [PATCH] zh-CN: create `notifications.onClicked` (#25076)

---
 .../api/notifications/onclicked/index.md      | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md

diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md
new file mode 100644
index 00000000000000..8306dfe95cb0f5
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md
@@ -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。