From d0c70a65298437aa7bd21405018d40d96ad506c2 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Wed, 31 Jan 2024 12:48:58 +0800
Subject: [PATCH] [zh-cn]: Add translation for
 WorkerNavigator.{setAppBadge,clearAppBadge} (#18097)

---
 .../workernavigator/clearappbadge/index.md    | 53 ++++++++++++++++++
 .../api/workernavigator/setappbadge/index.md  | 56 +++++++++++++++++++
 2 files changed, 109 insertions(+)
 create mode 100644 files/zh-cn/web/api/workernavigator/clearappbadge/index.md
 create mode 100644 files/zh-cn/web/api/workernavigator/setappbadge/index.md

diff --git a/files/zh-cn/web/api/workernavigator/clearappbadge/index.md b/files/zh-cn/web/api/workernavigator/clearappbadge/index.md
new file mode 100644
index 00000000000000..73d10710eb05b6
--- /dev/null
+++ b/files/zh-cn/web/api/workernavigator/clearappbadge/index.md
@@ -0,0 +1,53 @@
+---
+title: WorkerNavigator：clearAppBadge() 方法
+slug: Web/API/WorkerNavigator/clearAppBadge
+l10n:
+  sourceCommit: dbfd14568c69f049452ab4fdc9c2629b63ca78d2
+---
+
+{{APIRef("Badging API")}}{{securecontext_header}}
+
+{{domxref("WorkerNavigator")}} 接口的 **`clearAppBadge()`** 方法通过将当前应用程序图标设置为 `nothing` 来清除当前应用程序图标上的徽章。`nothing` 表示当前没有设置徽章，并且徽章的状态为*已清除*。
+
+## 语法
+
+```js-nolint
+clearAppBadge()
+```
+
+### 参数
+
+无。
+
+### 返回值
+
+一个兑现为 {{jsxref("undefined")}} 的 {{jsxref("Promise")}}。
+
+### 异常
+
+- `InvalidStateError` {{domxref("DOMException")}}
+  - : 如果文档未完全激活，则抛出该异常。
+- `SecurityError` {{domxref("DOMException")}}
+  - : 如果调用被[同源策略](/zh-CN/docs/Web/Security/Same-origin_policy)阻止，则抛出该异常。
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : 如果 {{domxref('PermissionStatus.state')}} 不是 `granted`，则抛出该异常。
+
+## 示例
+
+读取应用程序中的所有消息后，调用 `clearAppBadge()` 方法以清除徽章并删除通知。
+
+```js
+navigator.clearAppBadge();
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- [应用程序图标的标记](https://developer.chrome.com/docs/capabilities/web-apis/badging-api/)
diff --git a/files/zh-cn/web/api/workernavigator/setappbadge/index.md b/files/zh-cn/web/api/workernavigator/setappbadge/index.md
new file mode 100644
index 00000000000000..2476554fc8bc4a
--- /dev/null
+++ b/files/zh-cn/web/api/workernavigator/setappbadge/index.md
@@ -0,0 +1,56 @@
+---
+title: WorkerNavigator：setAppBadge() 方法
+slug: Web/API/WorkerNavigator/setAppBadge
+l10n:
+  sourceCommit: dbfd14568c69f049452ab4fdc9c2629b63ca78d2
+---
+
+{{APIRef("Badging API")}}{{securecontext_header}}
+
+{{domxref("WorkerNavigator")}} 接口的 **`setAppBadge()`** 方法在与此应用关联的图标上设置徽章。如果将值传递给该方法，则该值将被设置为徽章的值。否则，徽章将显示为点或平台定义的其他指示器。
+
+## 语法
+
+```js-nolint
+setAppBadge()
+setAppBadge(contents)
+```
+
+### 参数
+
+- `contents` {{optional_inline}}
+  - : 一个将用作徽章值的{{jsxref("number", "数值", "", 1)}}。如果 `contents` 为 `0`，则徽章将设置为 `nothing`，表示已清除徽章。
+
+### 返回值
+
+一个兑现 {{jsxref("undefined")}} 的 {{jsxref("Promise")}}。
+
+### 异常
+
+- `InvalidStateError` {{domxref("DOMException")}}
+  - : 如果文档未完全激活，则抛出该异常。
+- `SecurityError` {{domxref("DOMException")}}
+  - : 如果调用被[同源策略](/zh-CN/docs/Web/Security/Same-origin_policy)阻止，则抛出该异常。
+- `NotAllowedError` {{domxref("DOMException")}}
+  - : 如果 {{domxref('PermissionStatus.state')}} 不是 `granted`，则抛出该异常。
+
+## 示例
+
+在下面的示例中，未读的计数被传递给 `setAppBadge()`。然后徽章应显示 `30`。
+
+```js
+const unread = 30;
+navigator.setAppBadge(unread);
+```
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- [应用程序图标的标记](https://developer.chrome.com/docs/capabilities/web-apis/badging-api/)