From a75bf486fd88a3ac5be87e173e4d1dbf7c0712ad Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Mon, 9 Sep 2024 14:26:58 +0800
Subject: [PATCH 001/115] zh-CN: glossary/color_space (#20022)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
Co-authored-by: 720 <71604450+T34-active@users.noreply.github.com>
Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 files/zh-cn/glossary/color_space/index.md | 95 +++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 files/zh-cn/glossary/color_space/index.md

diff --git a/files/zh-cn/glossary/color_space/index.md b/files/zh-cn/glossary/color_space/index.md
new file mode 100644
index 00000000000000..7780fb8c3d9022
--- /dev/null
+++ b/files/zh-cn/glossary/color_space/index.md
@@ -0,0 +1,95 @@
+---
+title: 色彩空间
+slug: Glossary/Color_space
+l10n:
+  sourceCommit: 530c1f54e63834411aa38789b1ac82e3831c4dfa
+---
+
+{{GlossarySidebar}}
+
+**色彩空间**是对色彩的命名组织方式，用于基于坐标的色彩排列的基本色彩模型。色彩模型定义了色彩的组成部分（例如 [`hwb()`](/zh-CN/docs/Web/CSS/color_value/hwb) 色彩的 `h`、`w` 和 `b` 通道）与色彩空间之间的关系。多数色彩空间是表示色彩的三维或四维网格，其中各维度（轴）对应色彩空间中的一个通道。一个色彩可以在保持看起来仍然一样的情况下在多个色彩空间中表达，或者从一个色彩空间转换到另一个色彩空间。
+
+色彩空间对特定范围的色彩进行分类和定义。每个色彩空间由数学模型和相关的规则集定义。每个色彩空间都有一个定义好的{{glossary("gamut", "色域")}}（它指的是它能表示的特定范围的色彩）。这些规则使得跨不同设备和软件的色彩表现一致且可重现。
+
+_sRGB_ 色彩空间（标准红绿蓝）是为 Web 创建的，但我们不再局限于这个色彩空间。[CSS 色彩模块第 4 版](https://drafts.csswg.org/css-color-4)指定了几种预定义的色彩空间，而 [CSS 色彩模块第 5 版](https://drafts.csswg.org/css-color-5/)则进一步规定了用于定义自定义色彩空间的特性。
+
+## 具名色彩空间
+
+预定义的 [RGB 色彩空间](#rgb_色彩空间)包括 `srgb`、`srgb-linear`、`display-p3`、`a98-rgb`、`prophoto-rgb` 和 `rec2020`。预定义的 [CIELAB 色彩空间](#cielab_色彩空间)包括 `lab-d50` 和 `lab-d65`。预定义的 [XYZ 色彩空间](#xyz_色彩空间)包括 `xyz-d50` 和 `xyz-d65`（以及作为其别名的 `xyz`）。
+
+色彩空间可以是[矩形或极坐标的](https://ericportis.com/posts/2024/okay-color-spaces/)。矩形色彩空间包括 `srgb`、`srgb-linear`、`display-p3`、`a98-rgb`、`prophoto-rgb`、`rec2020`、`lab`、`oklab`、`xyz-d50` 和 `xyz-d65`（或 `xyz`）。极坐标色彩空间包括 `hsl`、`hwb`、`lch` 和 `oklch`。
+
+### RGB 色彩空间
+
+RGB 是一种色彩模型，将色彩表示为三个基本成分（红色、绿色和蓝色色彩通道）的混合，产生各种色调。sRGB（标准 RGB）是 {{Glossary("RGB")}} 色彩的底层色彩空间。sRGB 旨在编纂个人电脑及{{glossary("world wide web", "万维网")}}成像系统的显示规范。目前，sRGB 通常是那些没有标记或没有嵌入色彩配置文件的默认色彩空间。
+
+RGB 色彩空间有几种，如可以表示比 _sRGB_ 色彩空间更广泛的{{glossary("gamut", "色域")}}的 _Adobe RGB_ 色彩空间。_sRGB_ 和 _Adobe RGB_（`a98-rgb`）中的坐标是不同的。有很多种方式来描述色彩的 RGB 成分：在 {{Glossary("CSS")}} 中，色彩可以表示为十六进制表示法的单个 24 位整数（如淡蓝色 `#add8e6`），或者在 [`rgb()`](/zh-CN/docs/Web/CSS/color_value/rgb) 函数表示法中表示为 0 到 255 之间的三个独立数字（如，`rgb(46 139.5 87)`）。
+
+在 sRGB 色彩空间中，CSS `<color>` 值包括{{cssxref("hex-color", "十六进制色彩")}}、{{cssxref("named-color", "具名色彩")}}、{{cssxref("color_value/rgb", "rgb()")}}、{{cssxref("color_value/hsl", "hsl()")}}（色调、饱和度、亮度）和{{cssxref("color_value/hwb", "hwb()")}}（色调、白度、黑度）。[`color`](/zh-CN/docs/Web/CSS/color_value/color) 函数还支持 `srgb`、`srgb-linear`、`a98-rgb` 和 `prophoto-rgb` 色彩空间。
+
+HSV（色调、饱和度和值）色彩空间及其同义词 HSB（色调、饱和度和亮度）在 CSS 中都用 [`hwb()`](/zh-CN/docs/Web/CSS/color_value/hwb) 表示。命名色彩只是与特定十六进制值相对应的关键字。将这些不同的色彩表示法转换为 `sRGB` 的数学方法是直观的。请注意，{{cssxref("&lt;color&gt;", "currentcolor", "#currentcolor_关键字")}} 可以是任何色彩，而不仅限于 `sRGB` 色彩空间。
+
+`rgb` 色彩函数不是可以用于表示 _sRGB_ 色彩空间的唯一色彩函数。圆柱坐标系，如 [`HSL`](/zh-CN/docs/Web/CSS/color_value/hsl)（_色调—饱和度—亮度_）或 [`HWB`](/zh-CN/docs/Web/CSS/color_value/hwb)（_色调—白度—黑度_）色彩模型也用于在 Web 上表示 sRGB 色彩。
+
+- `sRGB` 色彩空间
+  - : sRGB 色彩空间（“标准 RGB”），是标准的 RGB（红、绿、蓝）色彩空间，用于显示器、打印机和 Web 中。它是使用最广泛的色彩空间，受到大多数操作系统、软件程序、显示器和打印机的支持。sRGB 以 `r`、`g` 和 `b` 为基础，色域范围为 `0` 至 `1`。它的白点为 D65。
+- `srgb-linear` 色彩空间
+  - : 预定义的线性光 sRGB 色彩空间 `srgb-linear` 与 `srgb`相同，只是传输函数是没有伽玛编码的线性光。`srgb-linear` 色彩空间接受三个 `r`、`g` 和 `b` 值作为数值参数，色域范围为 `0` 至 `1`。它的白点为 D65。
+- `display-p3` 色彩空间
+  - : **Display P3** 色彩空间由苹果公司定义，结合了 DCI-P3 色域、D65 白点和 sRGB 伽马曲线。它是一种典型的宽色域空间，适用于当前的宽色域显示器，能呈现出比 sRGB 色域更鲜艳的绿色和红色。`display-p3` 基于 `r`、`g` 和 `b`，伽玛值范围为 `0` 至 `1`。它的白点为 D65。
+- `a98-rgb` 色彩空间
+  - : `a98-rgb` 是 Adobe® 1998 RGB 色彩空间，旨在将所有 CMYK 颜色表示为 RGB。它可实现 [CIELab 色彩空间](#cielab_色彩空间)指定的约 50% 的可见色彩，比其他 RGB 色彩空间包含更多的青绿色调。伽玛内的 `r`、`g` 和 `b` 值范围从 `0` 到 `1`。它的传输曲线是一个伽马函数，不完全地接近于 1/2.2。它的白点为 D65。
+- `prophoto-rgb`
+  - : `prophotoo-rgb` 色彩空间由柯达公司开发，可以表示自然界中可能出现的所有颜色和大约 90% 的 [CIElab 颜色](#cielab_色彩空间)。色域范围的 `r`、`g` 和 `b` 值范围从 `0` 至 `1`。转移曲线是一个伽马函数，值为 1/1.8，其中在黑色附近有一小段线性。它的白点为 D50，与 CIELab 使用的白点相同。
+- `rec2020`
+  - : `rec2020` 是超高清 4k 和 8k 电视的广播行业标准。超宽色域空间能够呈现现实世界中几乎所有可见的颜色，超出了目前大多数显示器的能力。随着显示器的不断改进，预计覆盖范围会逐渐扩大。色域内的 `r`、`g` 和 `b` 值从 `0` 至 `1`。它的白点为 D65。
+
+> [!NOTE]
+> CSS 规范中没有的其他圆柱形 RGB 空间，如 `HSI`（色调、饱和度和强度）、`Okhsv`、`Okhsl`、`HSLuv`、`HPLuv` 和 `Cubehelix`。
+
+### CIELAB 色彩空间
+
+CIELAB（或 CIELab）色彩空间，也称为 L\*a\*b*（简称 Lab*），表示人类可以看到的所有色彩范围。这个色彩空间是由国际照明委员会（CIE）定义的。它将色彩表示为三个值：L\* 表示感知亮度，a\* 和 b\* 表示人类视觉的四种独特色彩：红、绿、蓝和黄。
+
+Lab 是一个矩形坐标系统，有一个中央的亮度 `L` 轴。`a` 轴上的正值是紫红色，而负值是其补色绿色。`b` 轴上的正值是黄色，负值是蓝色/紫罗兰色。不饱和的色彩具有小的 `a` 和 `b` 值，而绝对值更大的更饱和。
+
+CIELAB 色彩函数包括 {{CSSXref("color_value/lab", "lab()")}}（亮度、a 轴、b 轴）和 {{CSSXref("color_value/lch", "lch()")}}（亮度、色度、色调），以及 {{CSSXref("color_value/oklab", "oklab()")}} 和 {{CSSXref("color_value/oklch", "oklch()")}}。它们的亮度值是相同的，但是 `lch()` 和 `oklch` 是一个 `C`（色度）和 `H`（色调）使用极坐标而不是轴的极坐标柱面坐标系统。
+
+> [!NOTE]
+> 函数 `lch()` 和 `oklch` 中的色调和亮度与 {{cssxref("color_value/hsl", "hsl()")}} 或其他 sRGB 色彩空间中同名值不同。
+
+CIELab 色彩空间包括 Lab、Lch、Oklab 和 Oklch，是设备无关的色彩空间。
+
+- `lab-d50` 色彩空间
+
+  - : 将色彩表示为 `L` 在 `0` 到 `100` 范围内，并且 `a` 和 `b` 范围在 `-125` 到 `125` 之间的色彩空间。`a` 和 `b` 轴不受这些范围值的限制，这些值是在与 `Display P3` 色彩空间相关的百分比输入和输出中使用的参考点。它的白点是 D50。
+
+- `lab-d65` 色彩空间
+
+  - : 除使用 D65 作为白点外，与 `lab-d50` 相同。
+
+- `oklab` 色彩空间
+
+  - : 类似于 `lab-d65`，但 `L` 的范围是 `0` 到 `1`，`a` 和 `b` 的范围是 `-0.4` 到 `0.4`。
+
+### XYZ 色彩空间
+
+尽管红、绿和蓝的组合在屏幕上表示色彩效果很好，但 sRGB 并不直接对应于人类感知的色彩。CIEXYZ（或 XYZ）色彩空间是由国际照明委员会（CIE）在 1931 年定义的。它是电磁可见光谱中波长分布与人类视觉中感知色彩之间的第一个定义的定量联系。
+
+视力正常的人有三种对不同波长的光谱具有峰值敏感度的感光锥细胞。CIE X、Y 和 Z 参数对应于三种视锥细胞的刺激水平，原则上可以描述每一种可见光颜色。`Y` 通道代表一种颜色的亮度。`Z` 通道反映颜色中蓝色的含量（但与 RGB 中的 B 不同）。`X` 轴与 XYZ 色彩三维坐标系的 Y 轴和 Z 轴正交。
+
+- `xyz` 和 `xyz-d65` 色彩空间
+
+  - : `xyz` 标识符是 `xyz-d65` 色彩空间的同义词。由于色彩空间不限于此范围，因而轴不限于 `0` 到 `1` 的范围；这些值只在定义输入输出的百分比时使用作为参考点。它的白点是 D65。
+
+- `xyz-d50` 色彩空间
+  - : 除使用 `d50` 作为白点外，与 `xyz-d65` 相同。
+
+## 参见
+
+- {{cssxref("@media/color-gamut", "color-gamut")}} `@media` 特性
+- [CSS 数据类型：`<color>`](/zh-CN/docs/Web/CSS/color_value)
+- [sRGB 色彩空间](https://webstore.iec.ch/en/publication/6168)
+- 维基百科上的 [CIELAB 色彩空间](https://zh.wikipedia.org/wiki/CIELAB色彩空间)
+- 维基百科上的 [CIE 1931 色彩空间](https://zh.wikipedia.org/wiki/CIE_1931色彩空间)
+- [Oklab](https://bottosson.github.io/posts/oklab/) 色彩空间

From 3d0baa0907b59b12d532b9548f8d69abb410d07e Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Mon, 9 Sep 2024 14:33:44 +0800
Subject: [PATCH 002/115] zh-CN: create Glossary/Canonical_order (#23351)

Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 files/zh-cn/glossary/canonical_order/index.md | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 files/zh-cn/glossary/canonical_order/index.md

diff --git a/files/zh-cn/glossary/canonical_order/index.md b/files/zh-cn/glossary/canonical_order/index.md
new file mode 100644
index 00000000000000..3a62c23616024b
--- /dev/null
+++ b/files/zh-cn/glossary/canonical_order/index.md
@@ -0,0 +1,28 @@
+---
+title: 规范顺序
+slug: Glossary/Canonical_order
+l10n:
+  sourceCommit: 7a551aaa034fbada3eb99e6fc924a0313b78307f
+---
+
+{{GlossarySidebar}}
+
+CSS **规范顺序**是指需要指定（或{{Glossary("parse", "解析")}}）或作为 CSS 属性值的一部分进行{{Glossary("serialization", "序列化")}}的单独值的顺序。它由属性的正式{{Glossary("syntax", "语法")}}定义，通常指的是应该在单个简写值的一部分中指定全称值的顺序。
+
+例如，{{cssxref("background")}} 简写属性值由几个 `background-*` 全称属性组成。这些全称值的规范顺序定义如下：
+
+1. {{cssxref("background-image")}}
+2. {{cssxref("background-position")}}
+3. {{cssxref("background-size")}}
+4. {{cssxref("background-repeat")}}
+5. {{cssxref("background-attachment")}}
+6. {{cssxref("background-origin")}}
+7. {{cssxref("background-clip")}}
+8. {{cssxref("background-color")}}
+
+另外，它的语法规定如果给出了 {{cssxref("background-size")}} 的值，则这个值**必须**在 {{cssxref("background-position")}} 的值**之后**指定，并用斜杠分隔。其他值则可以以任何顺序出现。
+
+## 参见
+
+- [CSS 值定义语法](/zh-CN/docs/Web/CSS/Value_definition_syntax)
+- StackOverflow 上的[“规范顺序”对 CSS 属性的意义有什么？](https://stackoverflow.com/questions/28963536/what-does-canonical-order-mean-with-respect-to-css-properties)给出了进一步有意义的讨论。

From 32b5677d2dffdffdd9f37661ffd7139058e0b70b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=87=AA=E7=94=B1=E7=9A=84=E4=B8=96=E7=95=8C=E4=BA=BA?=
 <144885467+Pleasurecruise@users.noreply.github.com>
Date: Mon, 9 Sep 2024 15:52:50 +0800
Subject: [PATCH 003/115] [zh-cn] create the translation of "Attribution
 Reporting API" (#23368)

Co-authored-by: Allo <yin199909@aliyun.com>
---
 .../generating_reports/index.md               | 308 ++++++++++++++++++
 .../api/attribution_reporting_api/index.md    | 117 +++++++
 .../registering_sources/index.md              | 287 ++++++++++++++++
 .../registering_triggers/index.md             | 231 +++++++++++++
 4 files changed, 943 insertions(+)
 create mode 100644 files/zh-cn/web/api/attribution_reporting_api/generating_reports/index.md
 create mode 100644 files/zh-cn/web/api/attribution_reporting_api/index.md
 create mode 100644 files/zh-cn/web/api/attribution_reporting_api/registering_sources/index.md
 create mode 100644 files/zh-cn/web/api/attribution_reporting_api/registering_triggers/index.md

diff --git a/files/zh-cn/web/api/attribution_reporting_api/generating_reports/index.md b/files/zh-cn/web/api/attribution_reporting_api/generating_reports/index.md
new file mode 100644
index 00000000000000..1586a30982b5aa
--- /dev/null
+++ b/files/zh-cn/web/api/attribution_reporting_api/generating_reports/index.md
@@ -0,0 +1,308 @@
+---
+title: 生成归因报告
+slug: Web/API/Attribution_Reporting_API/Generating_reports
+l10n:
+  sourceCommit: f430d277573ba0b06b1ac33ae8017fd90f170bef
+---
+
+{{SeeCompatTable}}{{DefaultAPISidebar("Attribution Reporting API")}}
+
+本文介绍了[归因报告 API](/zh-CN/docs/Web/API/Attribution_Reporting_API) 如何生成报告——包括归因报告和调试报告——以及如何控制生成的报告。内容包括处理噪声、报告优先级、过滤报告和生成调试报告。
+
+## 基本流程
+
+当触发器和来源匹配时，浏览器会生成报告，并通过无凭证的 [`POST`](/zh-CN/docs/Web/HTTP/Methods/POST) 请求将报告发送到报告来源的特定端点：
+
+- 对于事件级报告，端点为 `<reporting-origin>/.well-known/attribution-reporting/report-event-attribution`。
+- 对于汇总报告，端点为 `<reporting-origin>/.well-known/attribution-reporting/report-aggregate-attribution`。
+
+`<reporting-origin>` 与注册的来源（source）和触发器同源（same-origin）。
+
+报告数据包含在一个 JSON 结构中。
+
+## 事件级报告
+
+事件级报告会在其包含的**报告窗口**结束时生成并计划发送。报告窗口的长度由来源的 {{httpheader("Attribution-Reporting-Register-Source")}} 标头中的 [`"event_report_window"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#event_report_window) 或 [`"event_report_windows"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#event_report_windows) 字段决定。
+
+如果未指定这些字段，报告窗口将回退到以下默认值：
+
+- 对于[基于事件的来源](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于事件的归因来源)，默认报告窗口在来源的 `"expiry"` 到期时结束，该值在 `Attribution-Reporting-Register-Source` 的 [`"expiry"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#expiry) 字段中设置。如果未显式设置，则默认为注册后 30 天。
+- 对于[基于导航的来源](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于导航的归因来源)，默认报告窗口分别为 2 天、7 天和来源的 `"expiry"`。
+
+有关详细信息，请参阅[自定义报告窗口](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/custom-report-windows)。
+
+一旦事件级报告到达相应的端点，数据如何处理、存储和显示完全取决于开发者。一个典型的事件级报告可能如下所示：
+
+```json
+{
+  "attribution_destination": "https://advertiser.example",
+  "source_event_id": "412444888111012",
+  "trigger_data": "4",
+  "report_id": "123e4567-e89b-12d3-a456-426614174000",
+  "source_type": "navigation",
+  "randomized_trigger_rate": 0.34,
+  "scheduled_report_time": "1692255696",
+  "source_debug_key": 647775351539539,
+  "trigger_debug_key": 647776891539539
+}
+```
+
+属性如下：
+
+- `"attribution_destination"`
+  - : 一个字符串，或者是一个包含 2-3 个字符串的数组，取决于来源是否注册了多个目标。这些字符串代表在来源注册时通过关联的 {{httpheader("Attribution-Reporting-Register-Source")}} 响应标头中设置的归因 [`"destination"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#destination) 站点。
+- `"source_event_id"`
+  - : 一个表示归因来源 ID 的字符串。这等同于在来源注册时通过关联的 {{httpheader("Attribution-Reporting-Register-Source")}} 响应标头中设置的 [`"source_event_id"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#source_event_id)。
+- `"trigger_data"`
+  - : 一个表示归因触发器来源数据的字符串，在触发器注册时设置（通过关联的 {{httpheader("Attribution-Reporting-Register-Trigger")}} 响应标头设置的 [`"trigger_data"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger#trigger_data)）。
+- `"report_id"`
+  - : 一个表示此报告的[通用唯一标识符（UUID）](/zh-CN/docs/Glossary/UUID)的字符串，可用于防止重复计算。
+- `"source_type"`
+  - : 一个字符串，值为 `"navigation"` 或 `"event"`，分别表示相关的归因来源是[基于导航的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于导航的归因来源)，还是[基于事件的](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于事件的归因来源)。
+- `"randomized_trigger_rate"`
+  - : 一个介于 0 和 1 之间的随机数，表示此特定来源配置应用[噪声](#为报告添加噪声)的频率。
+- `"scheduled_report_time"`
+  - : 一个字符串，表示从 Unix 纪元开始到浏览器最初计划发送报告的秒数（以避免因设备离线导致报告延迟而产生的不准确性）。
+- `"source_debug_key"` {{optional_inline}}
+  - : 一个 64 位无符号整数，表示归因来源的调试密钥。此值与关联的 {{httpheader("Attribution-Reporting-Register-Source")}} 标头中的 [`"debug_key"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#debug_key) 字段中设置的值相同。有关更多信息，请参阅[调试报告](#调试报告)。
+- `"trigger_debug_key"` {{optional_inline}}
+  - : 一个 64 位无符号整数，表示归因触发器的调试密钥。此值与关联的 {{httpheader("Attribution-Reporting-Register-Trigger")}} 标头中的 `"debug_key"` 字段中设置的值相同。有关更多信息，请参阅[调试报告](#调试报告)。
+
+## 汇总报告
+
+汇总报告是从收到的多个可汇总报告创建的，并随后[批处理](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/summary-reports-intro#batching)以准备由[汇总服务](https://developers.google.com/privacy-sandbox/private-advertising/aggregation-service)处理。此后，数据如何处理、存储和显示完全取决于开发者。
+
+默认情况下，可汇总报告是在触发器交互后生成并计划发送的，带有随机延迟以帮助模糊时序并提高隐私性。对于给定的已注册归因来源，从注册到来源过期期间会记录归因来源事件——这称为**报告窗口**。
+
+到期时间由关联的 {{httpheader("Attribution-Reporting-Register-Source")}} 标头中的 `expiry` 值定义，如果未明确设置，则默认为注册后 30 天。请注意，可以通过在 `Attribution-Reporting-Register-Source` 标头中设置 `aggregatable_report_window` 值来进一步修改报告窗口的长度。有关详细信息，请参阅[自定义报告窗口](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/custom-report-windows)。
+
+> [!NOTE]
+> 为了进一步保护用户隐私，每个归因来源相关的汇总报告值具有有限的总值——这称为**贡献预算**。此值可能因 API 的不同实现而有所不同；在 Chrome 中为 65,536。任何会生成报告从而导致的总值超出此限制的转化将不被记录。请确保跟踪预算并在你尝试测量的不同指标之间共享它。
+
+典型的可汇总报告可能如下所示：
+
+```json
+{
+  "shared_info": "{\"api\":\"attribution-reporting\",\"attribution_destination\":\"https://advertiser.example\",\"report_id\":\"123e4567-e89b-12d3-a456-426614174000\",\"reporting_origin\":\"https://reporter.example\",\"scheduled_report_time\":\"1692255696\",\"source_registration_time\":\"1692230400\",\"version\":\"3\"}",
+  "aggregation_service_payloads": [
+    {
+      "payload": "[base64 编码的 HPKE 加密数据，仅供汇总服务读取]",
+      "key_id": "[标识用于加密有效负载的公钥的字符串]",
+      "debug_cleartext_payload": "[base64 编码的未加密有效负载]"
+    }
+  ],
+  "aggregation_coordinator_origin": "https://publickeyservice.aws.privacysandboxservices.com",
+  "source_debug_key": 647775351539539,
+  "trigger_debug_key": 647776891539539
+}
+```
+
+属性如下：
+
+- `"shared_info"`
+  - : 这是一个序列化的 JSON 对象，提供汇总服务使用的信息。这些数据使用 [AEAD](https://zh.wikipedia.org/wiki/认证加密) 进行加密，以防篡改。序列化字符串中包含以下属性：
+    - `"api"`
+      - : 表示触发报告生成的 API 的枚举值。目前，这个值将始终等于 `"attribution-reporting"`，但将来可能会扩展以支持其他 API。
+    - `"attribution_destination"`
+      - : 一个表示归因 [`"destination"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#destination) URL 的字符串，该 URL 在来源注册时通过相关的 {{httpheader("Attribution-Reporting-Register-Source")}} 响应标头设置。
+    - `"report_id"`
+      - : 一个表示此报告的[全局唯一标识符（UUID）](/zh-CN/docs/Glossary/UUID)的字符串，可用于防止重复计数。
+    - `"reporting_origin"`
+      - : 触发报告生成的来源。
+    - `"scheduled_report_time"`
+      - : 一个字符串，表示从 Unix 纪元到浏览器最初计划发送报告的时间，以秒为单位（避免由于设备离线导致的报告延迟）。
+    - `"source_registration_time"`
+      - : 一个字符串，表示从 Unix 纪元到归因来源注册的时间，四舍五入到整天。
+    - `"version"`
+      - : 一个表示生成报告的 API 版本的字符串。
+- `"aggregation_service_payloads"`
+
+  - : 一个对象数组，表示汇总服务用来组装报告中数据的直方图贡献的有效负载对象。目前，每个报告只支持一个由浏览器配置的有效负载。将来可能会支持多个可定制的有效负载。每个有效负载对象包含以下属性：
+
+    - `"payload"`
+
+      - : 一个通过 [HPKE](https://datatracker.ietf.org/doc/rfc9180/) 加密并经过 [base64](/zh-CN/docs/Glossary/Base64) 编码的 [CBOR](https://cbor.io/) 映射，结构如下：
+
+        ```js
+        {
+          "operation": "histogram",  // 允许服务支持将来其他操作
+          "data": [{
+            "bucket": <分桶，编码为 16 字节（即 128 位）的大端字节串>,
+            "value": <桶值，编码为 4 字节（即 32 位）的大端字节串>
+          }, ...]
+        }
+        ```
+
+    - `"key_id"`
+      - : 一个字符串，标识用于加密有效负载的公钥。
+    - `"debug_cleartext_payload"` {{optional_inline}}
+      - : 可选的调试信息。
+
+- `"aggregation_coordinator_origin"`
+  - : 汇总服务的部署选项。
+- `"source_debug_key"` {{optional_inline}}
+  - : 一个 64 位无符号整数，表示归因来源的调试密钥。此值与相关 {{httpheader("Attribution-Reporting-Register-Source")}} 标头的 [`"debug_key"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#debug_key) 字段中的值一致。更多信息请参见[调试报告](#调试报告)。
+- `"trigger_debug_key"` {{optional_inline}}
+  - : 一个 64 位无符号整数，表示归因触发器的调试密钥。此值与相关 {{httpheader("Attribution-Reporting-Register-Trigger")}} 标头的 `"debug_key"` 字段中的值一致。更多信息请参见[调试报告](#调试报告)。
+
+## 为报告添加噪声
+
+噪声被添加到报告中，以模糊与特定来源相关的输出，从而保护用户隐私。确切的来源数据无法被识别并归因到用户个体，但从数据中提取的总体模式仍然可以提供相同的意义。
+
+关于归因报告中噪声的工作原理，请参见：
+
+- [理解汇总报告中的噪声](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/understanding-noise)
+- [数据限制和噪声](https://github.com/WICG/attribution-reporting-api/blob/main/EVENT.md#data-limits-and-noise)
+- [处理噪声](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/working-with-noise)
+
+## 报告优先级和限制
+
+默认情况下，所有归因来源的优先级相同，并且归因模型是最后接触（last-touch）模型，这意味着转化被归因到最新的匹配来源事件。对于事件级和可汇总的报告，你可以通过在相关 {{httpheader("Attribution-Reporting-Register-Source")}} 标头中设置 `"priority"` 字段的新值来更改来源优先级。默认值为 `0`；如果你将特定来源的 `"priority"` 值设置为 `1`，则该来源将首先匹配，优先于任何优先级为 `0` 的来源。优先级为 `2` 的来源将在优先级为 `1` 的来源之前匹配，依此类推。
+
+归因触发器优先级的工作方式相同；你也可以通过在相关 {{httpheader("Attribution-Reporting-Register-Trigger")}} 标头中添加 `"priority"` 字段来设置触发器优先级，但仅适用于事件级报告。
+
+不同的来源类型有不同的默认限制：
+
+- [基于导航的归因来源](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于导航的归因来源)默认限制为三个报告。例如，如果用户点击了一个广告并进行了四次转化：他们访问了广告商网站主页，然后访问了产品页面，注册了时事通讯，最后进行了购买。由于这是第四次转化，购买报告将被丢弃。
+- [基于事件的归因来源](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources#基于事件的归因来源)默认限制为一个报告。
+
+> [!NOTE]
+> 可以通过在关联的 `Attribution-Reporting-Register-Source` 标头的 `"event_report_windows"` 字段中设置不同的 `"end_times"` 来调整报告限制。
+
+当为给定的来源事件触发归因时，如果该来源已达到最大归因次数（点击为 3 次，图像/脚本为 1 次），浏览器将：
+
+- 将新报告的优先级与同一来源的现有计划报告的优先级进行比较。
+- 删除优先级最低的报告以安排新的报告。如果新报告的优先级最低，则忽略新报告，不会收到它。
+
+如果未设置优先级，浏览器将回退到其默认行为：在点击后的第三次转化或查看后的第一次转化后发生的任何转化都将被丢弃。
+
+## 过滤器
+
+你可以使用过滤器定义哪些转化会生成报告。例如，你可以选择只计算特定产品类别的转化，并过滤掉其他类别的转化。
+
+要声明过滤器：
+
+1. 在来源注册时，将 `filter_data` 字段添加到 {{httpheader("Attribution-Reporting-Register-Source")}} 标头中，该字段定义了你将在触发端用于过滤转化的过滤键。这些是完全自定义的字段。例如，要指定仅特定子域名和特定产品的转化：
+
+   ```json
+   "filter_data": {
+     "conversion_subdomain": ["electronics.megastore", "electronics2.megastore"],
+     "product": ["1234"]
+   }
+   ```
+
+2. 在触发注册时，将 `filters` 字段添加到 {{httpheader("Attribution-Reporting-Register-Trigger")}} 标头中。例如，以下内容会使触发交互匹配上述来源注册，因为它们都包含 `"electronics.megastore"` 的 `"conversion_subdomain"` 字段。而 `"directory"` 过滤器则在尝试匹配时被忽略，因为它未包含在上述来源注册中。
+
+   ```json
+   "filters": {
+     "conversion_subdomain": ["electronics.megastore"],
+     "directory": ["/store/electronics"]
+   }
+   ```
+
+如果 `"filter_data"` 和 `"filters"` 字段包含匹配的子字段（如上例中的 `"conversion_subdomain"`），但这些子字段的值没有匹配项，则会忽略触发器，导致没有匹配。
+
+### 过滤触发数据
+
+可以扩展 {{httpheader("Attribution-Reporting-Register-Trigger")}} 标头中的 `event_trigger_data` 字段，以根据在 {{httpheader("Attribution-Reporting-Register-Source")}} 标头中定义的 `filter_data` 选择性地设置 `trigger_data`、`priority` 或 `deduplication_key`。
+
+例如：
+
+```json
+{
+  "event_trigger_data": [
+    {
+      "trigger_data": "2",
+      "filters": { "source_type": ["navigation"] }
+    },
+    {
+      "trigger_data": "1",
+      "filters": { "source_type": ["event"] }
+    }
+  ]
+}
+```
+
+> **备注：** `"source_type"` 是在来源的 `"filter_data"` 上自动填充的字段。
+
+> **备注：** `not_filters`，即否定过滤器，也受支持。
+
+在此上下文中，`filters` 可以是对象或对象数组。当指定列表时，只需一个字典匹配即可将触发器视为匹配。
+
+```json
+{
+  "event_trigger_data": [
+    {
+      "trigger_data": "2",
+      "filters": [
+        {
+          "product": ["1234"],
+          "conversion_subdomain": ["electronics.megastore"]
+        },
+        {
+          "product": ["4321"],
+          "conversion_subdomain": ["electronics4.megastore"]
+        }
+      ]
+    }
+  ]
+}
+```
+
+如果事件触发器的过滤器都不匹配，则不会创建事件级报告。如果过滤器匹配多个事件触发器，则使用第一个匹配的事件触发器。
+
+## 调试报告
+
+你可以启用调试报告，以返回有关归因报告的故障排除信息。这些报告可用于检查你的设置是否正常工作，并了解基于 cookie 的旧实现和新归因报告实现之间的测量结果差距。调试报告会立即发送；它们不受事件级和汇总报告相同的调度约束。
+
+有两种不同类型的调试报告：
+
+- **成功调试报告**跟踪特定归因报告的成功生成。成功调试报告在注册相应触发器后立即生成并发送。
+- **详细调试报告**为与归因报告关联的归因来源和归因触发事件提供更多可见性。它们使你能够确保来源已成功注册，或跟踪丢失的报告并确定其原因（例如，由于来源或触发事件注册失败或发送或生成报告时失败）。详细调试报告在来源或触发器注册时立即发送。
+
+> [!NOTE]
+> 要使用调试报告，报告来源（origin）需要设置 cookie。如果配置为接收报告的来源是第三方，则该 cookie 将是[第三方 cookie](/zh-CN/docs/Web/Privacy/Third-party_cookies)，这意味着在禁用/不可用第三方 cookie 的浏览器中将无法使用调试报告。
+
+### 使用调试报告
+
+要使用调试报告，你需要：
+
+1. 在报告来源上设置 `ar_debug` cookie。在来源和触发注册期间，该 cookie 需要存在：
+
+   ```http
+   Set-Cookie: ar_debug=1; SameSite=None; Secure; Path=/; HttpOnly
+   ```
+
+2. 在与你希望为其公开调试信息的归因报告相关的所有 {{httpheader("Attribution-Reporting-Register-Source")}} 和 {{httpheader("Attribution-Reporting-Register-Trigger")}} 响应标头中设置 `debug_key` 字段。每个 `debug_key` 值必须是格式为十进制字符串的 64 位无符号整数。使每个调试键成为唯一的 ID——例如，可以将每个键设置为 cookie ID + 来源/触发时间戳（如果希望将其与旧的基于 cookie 的系统进行比较，则可以在旧系统中捕获相同的时间戳）。
+
+   ```json
+   {
+     "debug_key": "647775351539539"
+   }
+   ```
+
+   > [!NOTE]
+   > 使来源端的调试键与 `source_event_id` 不同，以便区分具有相同来源事件 ID 的单个报告。
+
+3. 可选地，在 `Attribution-Reporting-Register-Source` 和 `Attribution-Reporting-Register-Trigger` 标头中将 `debug_reporting` 字段设置为 `true`。如果执行此操作，将生成详细的调试报告。如果不执行此操作，将生成反映你正在生成的归因报告类型（事件级或汇总）的成功调试报告。
+
+   ```json
+   {
+     "debug_key": "647775351539539",
+     "debug_reporting": true
+   }
+   ```
+
+4. 设置适当的端点以接收你希望生成的调试报告。调试报告发送到报告来源中的三个单独端点：
+
+   - 事件级成功调试报告的端点：`<reporting-origin>/.well-known/attribution-reporting/debug/report-event-attribution`
+   - 汇总成功调试报告的端点：`<reporting-origin>/.well-known/attribution-reporting/debug/report-aggregate-attribution`
+   - 详细调试报告的端点：`<reporting-origin>/.well-known/attribution-reporting/debug/verbose`
+
+生成的成功调试报告与归因报告相同，并包含来源端和触发器端的调试键（分别位于 `"source_debug_key"` 和 `"trigger_debug_key"` 字段中）。
+
+有关更多信息和示例，请参见：
+
+- developers.google.com 上的[调试报告介绍](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/attribution-reporting-debugging/)（2023）
+- developers.google.com 上的[设置调试报告](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/attribution-reporting-debugging/part-2/)（2023）
+- developers.google.com 上的[调试宝典](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/attribution-reporting-debugging/part-3/)（2023）
diff --git a/files/zh-cn/web/api/attribution_reporting_api/index.md b/files/zh-cn/web/api/attribution_reporting_api/index.md
new file mode 100644
index 00000000000000..22dc0fa6fb70c8
--- /dev/null
+++ b/files/zh-cn/web/api/attribution_reporting_api/index.md
@@ -0,0 +1,117 @@
+---
+title: 归因报告 API
+slug: Web/API/Attribution_Reporting_API
+l10n:
+  sourceCommit: f430d277573ba0b06b1ac33ae8017fd90f170bef
+---
+
+{{SeeCompatTable}}{{securecontext_header}}{{DefaultAPISidebar("Attribution Reporting API")}}
+
+**归因报告 API**（Attribution Reporting API）使开发者能够衡量转化——比如当用户点击嵌入在某个网站上的广告，然后在供应商的网站上购买商品——并随后访问这些转化的报告。它在不依赖第三方跟踪 cookie 的情况下完成这一过程。
+
+## 概念和用法
+
+广告主通常希望衡量有多少用户看到了广告后，接着查看并购买了产品（转化）。这使他们能够了解哪些广告投放带来了最大的投资回报率（ROI），从而可以相应地调整他们的广告策略。衡量转化的过程通常包括捕捉以下数据：
+
+- 哪些用户进行了转化（例如购买了商品或注册了服务），以及转化的数量。
+- 他们所在的地理区域。
+- 广告投放的位置。
+- 销售了多少产品、注册了多少服务等。
+- 产生了多少收入。
+
+传统上，Web 上的转化测量依赖于第三方跟踪 cookie。广告通常嵌入在网页的一个 {{htmlelement("iframe")}} 中，这样可以设置一个包含用户及其与广告互动信息的 cookie。
+
+之后，当用户决定访问广告主的网站时，只要该网站来自与广告相同的域名，该网站就可以访问之前由广告设置的第三方 cookie。广告主可以将广告的数据与自己的第一方数据关联起来，以回答诸如“用户在与另一个网站的产品广告互动后是否购买了该产品？”的问题。
+
+这对用户[隐私](/zh-CN/docs/Web/Privacy)不友好。在这种情况下，来自相同域名的任何页面都可以访问该 cookie，以及嵌入这些页面的网站的信息。许多方可以访问这些数据，并根据用户的浏览习惯推测其他数据。
+
+归因报告 API 提供了一种保护用户隐私的广告转化测量方式。
+
+### 它是如何工作的？
+
+让我们通过一个例子来说明归因报告 API 的工作原理。
+
+假设我们有一个在线商店 `shop.example`（即广告主），它在一个内容网站 `news.example`（即发布者）上嵌入了一个关于其产品的广告。广告内容位于 `ad.shop.example`。
+
+在线商店的拥有者希望衡量从与广告互动、查看其网站上的产品页面并将产品放入购物车的用户那里获得多少转化。
+
+![下面图像表示了描述的步骤](ara-flow.png)
+
+涉及的步骤如下：
+
+1. 当用户访问 `news.example` 网站时，可以为与嵌入广告的特定用户交互注册一个**归因来源**。用户可以通过多种方式与页面上的广告互动。为了使广告交互注册归因来源，广告必须发送一个带有 {{httpheader("Attribution-Reporting-Eligible")}} 标头的请求，以表明响应有资格注册归因来源。如果响应中包含适当的 {{httpheader("Attribution-Reporting-Register-Source")}} 标头，则完成归因来源的注册。归因来源可以是，例如：
+   - 一个链接。在这种情况下，交互是用户点击链接（直接通过 {{htmlelement("a")}} 元素，或通过 {{domxref("Window.open()")}} 调用）。通过对导航请求的响应来注册来源。
+   - 一张图片，例如广告横幅或 1x1 透明跟踪像素。在这种情况下，交互是用户访问页面。图片加载时，即服务器响应图片请求时，注册来源。
+   - 一个 fetch 请求（即 {{domxref("Window/fetch", "fetch()")}} 或 {{domxref("XMLHttpRequest")}}）。在这种情况下，交互可以根据你的应用程序的需要进行指定——例如，fetch 请求可以由 `click` 或 `submit` 事件触发。来源在响应返回时注册。
+2. 当归因来源交互发生时，{{httpheader("Attribution-Reporting-Register-Source")}} 标头中返回的来源数据会存储在仅浏览器可访问的私有本地缓存中。此数据包括页面和广告主可用的上下文和第一方数据、收集转化数据的广告技术公司的来源以及一个或多个期望从该广告发生转化的目标（[eTLD+1](/zh-CN/docs/Glossary/eTLD)）（即广告主的网站，例如 `shop.example`）。
+3. 当用户稍后访问 `shop.example` 时，当交互指示转化发生时，该网站可以注册一个**归因触发器**（例如，用户点击 `shop.example` 上的“添加到购物车”按钮）。浏览器将发送一个带有 {{httpheader("Attribution-Reporting-Eligible")}} 标头的请求，以表明响应有资格注册归因触发器，如果响应中包含适当的 {{httpheader("Attribution-Reporting-Register-Trigger")}} 标头，则完成注册。归因触发器可以是，例如：
+   - 一张图片，例如购物车图标或 1x1 透明跟踪像素。在这种情况下，交互是用户访问页面。触发器在图片加载时注册，即当服务器响应图片请求时。
+   - 一个 fetch 请求（即 {{domxref("Window/fetch", "fetch()")}} 或 {{domxref("XMLHttpRequest")}}）。在这种情况下，交互可以根据你的应用程序的需要进行指定——例如，fetch 请求可以由 `click` 或 `submit` 事件触发。触发器在响应返回时注册。
+4. 当触发器归因完成后，浏览器会尝试将 [Attribution-Reporting-Register-Trigger](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger) 标头中的数据与私有本地缓存中保存的来源数据条目进行匹配（见第 2 步）。有关匹配方法和要求，请参阅[注册归因触发器](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers)。
+5. 如果找到匹配，浏览器将把报告数据发送到通常由广告技术提供商拥有的报告服务器上的端点，在那里可以安全地进行分析。与 cookie 不同，这些数据仅对你发送数据的特定网站可用——不会在其他地方共享数据。这些报告可以是：
+   - **事件级报告**：基于归因来源事件的报告，其中详细的来源数据与粗略的触发器数据相关联。例如，报告可能看起来像“`ad.shop.example` 上的点击 ID 200498 导致了 `shop.example` 的购买”，其中“点击 ID 200498”是详细的来源数据，“购买”是粗略的触发器数据。详细的来源数据可能包含来源页面的第一方或上下文数据，而触发器数据可能编码来自触发器页面的事件。
+   - **汇总报告**：更详细的报告，结合来自来源和触发器侧的多个转化数据。例如“`news.example` 上的广告活动 ID 774653 导致了 `shop.example` 上来自意大利用户的 654 笔销售，总收入为 $9540。”汇总报告的编制需要使用聚合服务（例如 [Google 聚合服务](https://github.com/privacysandbox/aggregation-service)）。
+
+有关实现上述步骤所需功能的更多信息，请参阅：
+
+1. [注册归因来源](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources)
+2. [注册归因触发器](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers)
+3. [生成报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports)
+
+## 接口
+
+归因报告 API 并未定义任何独立的接口。
+
+### 其他接口的扩展
+
+- {{domxref("HTMLAnchorElement.attributionSrc")}}、{{domxref("HTMLImageElement.attributionSrc")}}、{{domxref("HTMLScriptElement.attributionSrc")}}
+  - : `attributionSrc` 属性允许你以编程方式获取和设置 {{htmlelement("a")}}、{{htmlelement("img")}}、和 {{htmlelement("script")}} 元素上的 `attributionsrc` 属性。它反映了该属性的值。
+- {{domxref("Window/fetch", "fetch()")}} 和 {{domxref("Request.Request", "Request()")}} 构造函数中的 `attributionReporting` 选项
+  - : 当通过 {{domxref("Window/fetch", "fetch()")}} 生成请求时，这表示你希望响应能够注册归因来源或触发器。
+- {{domxref("XMLHttpRequest.setAttributionReporting()")}}
+  - : 当通过 {{domxref("XMLHttpRequest")}} 生成请求时，这表示你希望响应能够注册归因来源或触发器。
+- {{domxref("Window.open()")}} 中的 `attributionsrc` 特性关键字
+  - : 当 `open()` 方法完成时，完成归因来源的注册*并*触发浏览器存储相关的来源数据（如 {{httpheader("Attribution-Reporting-Register-Source")}} 响应标头中提供的）。请注意，`Window.open()` 调用不能用于注册归因触发器。
+
+## HTML 元素
+
+- {{htmlelement("a")}}、{{htmlelement("img")}} 和 {{htmlelement("script")}}——`attributionsrc` 属性
+  - : 指定你希望浏览器在相关资源请求中发送 {{httpheader("Attribution-Reporting-Eligible")}} 标头。在服务器端，此标头用于触发发送 {{httpheader("Attribution-Reporting-Register-Source")}} 或 {{httpheader("Attribution-Reporting-Register-Trigger")}} 响应标头。当注册归因来源时，这是必需的；当注册归因触发器时，只有在你希望指定与 `src` 属性指向的资源不同的注册服务器时才需要。请注意，`<a>` 元素不能用于注册归因触发器。
+
+## HTTP 标头
+
+- {{httpheader("Attribution-Reporting-Eligible")}}
+  - : 表示相应响应有资格注册归因来源或触发器的 HTTP 请求。
+- {{httpheader("Attribution-Reporting-Register-Source")}}
+  - : 注册页面特性作为归因来源的 HTTP 响应。这作为对包含 `Attribution-Reporting-Eligible` 标头的请求的响应的一部分。
+- {{httpheader("Attribution-Reporting-Register-Trigger")}}
+  - : 注册页面特性作为归因触发器的 HTTP 响应。这作为对包含 `Attribution-Reporting-Eligible` 标头的请求的响应的一部分。
+- {{httpheader("Permissions-Policy")}} {{httpheader('Permissions-Policy/attribution-reporting','attribution-reporting')}} 指令
+  - : 控制当前文档是否被允许使用归因报告。
+
+## 注册和本地测试
+
+要在你的网站上使用归因报告 API，你必须在[隐私沙盒注册过程](/zh-CN/docs/Web/Privacy/Privacy_sandbox/Enrollment)中指定它。如果不这样做，API 流程将在响应时被阻止，即响应标头将被忽略，来源和触发器将不会被注册。
+
+你仍然可以在没有注册的情况下本地测试你的归因报告 API 代码。要允许本地测试，请启用以下 Chrome 开发者标志：
+
+`chrome://flags/#privacy-sandbox-enrollment-overrides`
+
+## 示例
+
+请参阅[演示：归因报告 API](https://arapi-home.web.app/) 以获取示例实现（也可查看[源代码](https://github.com/GoogleChromeLabs/trust-safety-demo/tree/main/attribution-reporting)）。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- [归因报告标头验证工具](https://wicg.github.io/attribution-reporting-api/validate-headers)
+- developers.google.com 上的[归因报告](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/)（2023）
+- developers.google.com 上的[启用转化测量](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/enable-conversion-measurement)（2023）
+- developers.google.com 上的[隐私沙盒](https://developers.google.com/privacy-sandbox/)（2023）
diff --git a/files/zh-cn/web/api/attribution_reporting_api/registering_sources/index.md b/files/zh-cn/web/api/attribution_reporting_api/registering_sources/index.md
new file mode 100644
index 00000000000000..a29cfa83d150b3
--- /dev/null
+++ b/files/zh-cn/web/api/attribution_reporting_api/registering_sources/index.md
@@ -0,0 +1,287 @@
+---
+title: 注册归因来源
+slug: Web/API/Attribution_Reporting_API/Registering_sources
+l10n:
+  sourceCommit: ec1006afdf68a5808a48ab6301f9ccff3cd7ecc2
+---
+
+{{SeeCompatTable}}{{DefaultAPISidebar("Attribution Reporting API")}}
+
+本文解释了如何在使用[归因报告 API](/zh-CN/docs/Web/API/Attribution_Reporting_API) 时注册归因来源。
+
+## 基本方法
+
+归因来源的形式包括链接、图片或脚本，它们会被包含在你想要衡量交互行为的内容中（例如，想要衡量转化的广告）。当发生特定用户交互时，浏览器会将来源数据存储在一个私有的本地缓存中（仅浏览器可访问）。不同的归因来源类型有不同的注册和信号交互方式，它们可以分为以下几类：
+
+- 导航来源，指浏览器在响应导航时存储源数据。例如，当用户点击链接或用键盘激活它时，或者通过 {{domxref("Window.open()")}} 调用发生导航时。有关示例，请参见[基于导航的归因来源](#基于导航的归因来源)。
+- 事件来源，指浏览器在事件触发时存储源数据。有关示例，请参见[基于事件的归因来源](#基于事件的归因来源)。
+
+注册来源和检索、存储来源数据的过程在这两种情况下是相同的：
+
+1. 当用户与归因来源进行交互时，它会在请求中发送 {{httpheader("Attribution-Reporting-Eligible")}} 标头给测量交互的服务器（通常是广告主的服务器），以表明响应有资格注册来源。例如：
+
+   ```http
+   Attribution-Reporting-Eligible: navigation-source
+   ```
+
+2. 当服务器接收到包含 `Attribution-Reporting-Eligible` 标头的请求时，它可以在响应中包含 {{httpheader("Attribution-Reporting-Register-Source")}} 标头以完成来源注册。其值是一个 JSON 字符串，提供了浏览器应存储的有关与之交互的归因来源的信息。该标头中包含的信息还决定了浏览器生成哪些类型的报告：
+
+   - 以下示例将导致在[触发器](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_triggers)与来源匹配时生成一个[事件级报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#事件级报告)：
+
+     ```js
+     res.set(
+       "Attribution-Reporting-Register-Source",
+       JSON.stringify({
+         source_event_id: "412444888111012",
+         destination: "https://advertiser.example",
+         trigger_data: [0, 1, 2, 3, 4],
+         trigger_data_matching: "exact",
+         expiry: "604800",
+         priority: "100",
+         debug_key: "122939999",
+         event_report_window: "86400",
+       }),
+     );
+     ```
+
+     在这种情况下，唯一必需的字段是 `destination`，它指定 1–3 个触发器预期触发的站点。它们用于在与触发器交互时将归因触发器与来源进行匹配。上述指定的其他字段如下：
+
+     - `"source_event_id"`：一个表示归因来源的 ID 的字符串，可以用于在归因来源被交互时将其映射到其他信息，或在报告端点（见[生成报告 > 基本流程](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#基本流程)获取端点信息）聚合信息。
+     - `"trigger_data"`：一个 32 位无符号整数数组，表示可能匹配此来源的不同触发事件的数据。例如，“用户将商品添加到购物车”或“用户注册了邮件列表”可以是触发站点上发生的事件，这些事件可以匹配此来源并表示广告主试图衡量的某种转化。它们必须与[触发器](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger#trigger_data)中指定的 `"trigger_data"` 匹配，以便进行事件级归因。
+       > [!NOTE]
+       > 用于表示每个事件的值，以及数组中的元素数量，都是完全任意的，由作为开发者的你定义。数组中可以包含未使用的值，但必须存在值，以便浏览器在触发器注册时将其归因于来源。
+     - `"trigger_data_matching"`：一个字符串，指定如何将触发器的 `"trigger_data"` 与来源的 `"trigger_data"` 匹配。`"exact"` 是你几乎总是会使用的值，它匹配精确值。
+     - `"expiry"`：一个表示归因来源过期时间的字符串，以秒为单位，过期后该源将不再有效（即，后续触发器将无法归因到此来源）。
+     - `"priority"`：一个表示归因来源优先级的字符串值。有关更多信息，请参见[报告优先级和限制](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#报告优先级和限制)。
+     - `"debug_key"`：一个以十进制格式表示的 64 位无符号整数，表示调试密钥。如果你希望生成一个[调试报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#调试报告)以配合关联的归因报告，则设置此项。
+     - `"event_report_window"`：一个表示时间的字符串（以秒为单位），在此时间后，后续触发器将无法归因到此来源（以生成事件级报告）。
+
+     参见 {{httpheader("Attribution-Reporting-Register-Source")}} 以获取此标头中所有可用字段的详细描述。
+
+   - 要使浏览器在触发器匹配到来源时生成[汇总报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#汇总报告)，需要在生成事件级报告所需的字段*之外*，额外包含一些字段。
+
+     ```js
+     res.set(
+       "Attribution-Reporting-Register-Source",
+       JSON.stringify({
+         source_event_id: "412444888111012",
+         destination: "https://advertiser.example",
+         trigger_data: [0, 1, 2, 3, 4],
+         trigger_data_matching: "exact",
+         expiry: "604800",
+         priority: "100",
+         debug_key: "122939999",
+         event_report_window: "86400",
+
+         aggregation_keys: {
+           campaignCounts: "0x159",
+           geoValue: "0x5",
+         },
+         aggregatable_report_window: "86400",
+       }),
+     );
+     ```
+
+     在此示例中，额外的字段包括：
+
+     - `"aggregation_keys"`：一个包含用户提供的键的对象，表示在生成的报告值下汇总不同数据点。
+     - `"aggregatable_report_window"`：一个表示时间的字符串（以秒为单位），在此时间后，触发数据将不再包含在生成的可汇总报告中。
+
+     同样，请参见 {{httpheader("Attribution-Reporting-Register-Source")}} 以获取此标头中所有字段的详细描述。
+
+3. 成功注册来源后，浏览器将提供的来源数据存储在其私有本地缓存中。
+
+## 基于导航的归因来源
+
+导航来源对于测量与链接的交互非常有用——例如，用户可能在发布者页面上看到广告，然后点击它以导航到希望发生转化的广告主的页面。
+
+有几种不同类型的基于导航的归因来源（例如，点击广告）可以注册——基于 HTML 的（使用 `attributionsrc` 属性）和基于 {{domxref("Window.open()")}} 调用的（使用 `attributionsrc` 窗口特性）。
+
+### 基于 HTML 的导航来源
+
+要注册基于导航的归因来源，你可以将 `attributionsrc` 属性添加到适当的 {{htmlelement("a")}} 元素中，这指定了注册请求将被发送到的位置。
+
+如果你将属性值留空，则注册请求将发送到链接到的位置。也可以在值中指定一个或多个额外的 URL 以发送注册请求；有关详细信息，请参见[在 attributionsrc 中指定 URL](#在_attributionsrc_中指定_url)。
+
+`attributionsrc` 可以通过声明的方式添加：
+
+```html
+<a href="https://shop.example" attributionsrc target="_blank">
+  点击访问我们的商店
+</a>
+```
+
+或者通过 {{domxref("HTMLAnchorElement.attributionSrc")}} 属性：
+
+```js
+const aElem = document.querySelector("a");
+aElem.attributionSrc = "";
+```
+
+在这种情况下，交互发生时，浏览器在用户点击链接并且浏览器接收到响应时，会存储与基于导航的归因来源（如在 {{httpheader("Attribution-Reporting-Register-Source")}} 响应标头中提供的）相关的来源数据。
+
+### 基于 Window.open() 的导航来源
+
+你还可以将 `attributionsrc` 特性关键字添加到 {{domxref("Window.open()")}} 调用的特性属性中。在此示例中，我们在响应 `click` 事件时运行它：
+
+```js
+elem.addEventListener("click", () => {
+  window.open("https://shop.example", "targetWindow", "attributionsrc");
+});
+```
+
+> [!NOTE]
+> 在设置像上面示例中的 [`click`](/zh-CN/docs/Web/API/Element/click_event) 事件时，建议将其设置在预期会点击的控件上，例如 {{htmlelement("button")}} 或 {{htmlelement("a")}} 元素上。这在语义上更合理，并且对屏幕阅读器和键盘用户更友好。
+
+> [!NOTE]
+> 要通过 `open()` 注册归因来源，必须在[瞬态激活](/zh-CN/docs/Glossary/Transient_activation)（即用户交互事件处理程序内部，如 `click`）中调用，并且必须在用户交互后的五秒内完成。
+
+## 基于事件的归因来源
+
+基于事件的归因来源会在某些事件——例如在 `<img>` 或 `<script>` 元素中使用 `attributionsrc` 属性时（如上文中 `<a>` 元素的示例）的 `load` 事件，或在你的 JavaScript 中设置的自定义事件——触发时让浏览器存储来源数据。
+
+### 基于 HTML 的事件来源
+
+基于 HTML 的事件来源可以用于在页面首次加载时——更准确地说，是在 `<img>` 或 `<script>` 加载时——测量与发布者页面的交互。要通过 HTML 注册基于事件的归因来源，你可以将 `attributionsrc` 属性添加到适当的元素中——例如 {{htmlelement("img")}} 或 {{htmlelement("script")}}。
+
+如果你将属性值留空，注册请求将发送到托管请求资源的服务器。也可以在值中指定一个或多个额外的 URL，以便将注册请求发送到其他服务器；详情请参见[在 attributionsrc 中指定 URL](#在_attributionsrc_中指定_url)。
+
+让我们看看一个 `<img>` 元素的示例：
+
+```html
+<img src="advertising-image.png" attributionsrc />
+```
+
+你也可以通过 {{domxref("HTMLImageElement.attributionSrc")}} 属性实现：
+
+```js
+const imgElem = document.querySelector("img");
+imgElem.attributionSrc = "";
+```
+
+当浏览器接收到包含图像文件的响应时（即发生 `load` 事件时），浏览器会存储归因来源数据。请记住，用户可能根本无法感知到图像——这可能是一个 1x1 的透明跟踪像素，仅用于归因报告。
+
+{{htmlelement("script")}} 的示例可能如下所示：
+
+```html
+<script src="advertising-script.js" attributionsrc />
+```
+
+或者通过 {{domxref("HTMLScriptElement.attributionSrc")}} 属性：
+
+```js
+const scriptElem = document.querySelector("script");
+scriptElem.attributionSrc = "";
+```
+
+在这种情况下，当浏览器接收到包含脚本的响应时，交互发生，浏览器存储来源数据。
+
+### 基于 JavaScript 的事件来源
+
+基于脚本的归因来源比基于 HTML 的归因来源更灵活。你可以设置脚本来根据适合你的应用的请求发起注册归因来源的请求。这是一种灵活的方法，适合在响应自定义交互（例如点击自定义元素或提交表单）时存储来源数据。
+
+要设置基于脚本的归因来源，你可以：
+
+- 发送包含 `attributionReporting` 选项的 {{domxref("Window/fetch", "fetch()")}} 请求：
+
+  ```js
+  const attributionReporting = {
+    eventSourceEligible: true,
+    triggerEligible: false,
+  };
+
+  // 可选地设置 keepalive 以确保请求的生命周期脱离页面
+  function triggerSourceInteraction() {
+    fetch("https://shop.example/endpoint", {
+      keepalive: true,
+      attributionReporting,
+    });
+  }
+
+  // 将交互触发器与适合你的代码的事件关联
+  // （不必是 DOM 事件/用户交互）
+  elem.addEventListener("click", triggerSourceInteraction);
+  ```
+
+- 发送 {{domxref("XMLHttpRequest")}} 并在请求对象上调用 {{domxref("XMLHttpRequest.setAttributionReporting", "setAttributionReporting()")}}：
+
+  ```js
+  const attributionReporting = {
+    eventSourceEligible: true,
+    triggerEligible: false,
+  };
+
+  function triggerSourceInteraction() {
+    const req = new XMLHttpRequest();
+    req.open("GET", "https://shop.example/endpoint");
+    // 在调用前检查 setAttributionReporting 的可用性
+    if (typeof req.setAttributionReporting === "function") {
+      req.setAttributionReporting(attributionReporting);
+      req.send();
+    } else {
+      throw new Error("Attribution reporting not available");
+      // 在此处包含适当的恢复代码
+    }
+  }
+
+  // 将交互触发器与适合你的代码的事件关联
+  // （不必是 DOM 事件/用户交互）
+  elem.addEventListener("click", triggerSourceInteraction);
+  ```
+
+在这种情况下，当浏览器接收到 fetch 请求的响应时，交互发生，浏览器存储来源数据。
+
+> [!NOTE]
+> 请求可针对任何资源。它不需要直接与归因报告 API 相关，可以是 JSON、纯文本、图像 blob 或其他适合你的应用的请求。
+
+## 在 attributionsrc 中指定 URL
+
+到目前为止，在我们看到的所有示例中，`attributionsrc` 属性/特性或 `attributionSrc` 属性都被留空，值为空字符串。如果托管请求资源的服务器也是你希望处理注册的服务器（即接收 {{httpheader("Attribution-Reporting-Eligible")}} 标头并响应 {{httpheader("Attribution-Reporting-Register-Source")}} 标头的服务器），这是可以的。
+
+然而，可能请求的资源不在你控制的服务器上，或者你只是希望在不同的服务器上处理注册。在这种情况下，你可以在 `attributionsrc` 的值中指定一个或多个 URL。当资源请求发生时，{{httpheader("Attribution-Reporting-Eligible")}} 标头将发送到 `attributionsrc` 中指定的 URL 以及资源的来源；这些 URL 可以响应 {{httpheader("Attribution-Reporting-Register-Source")}} 以注册来源。
+
+例如，对于 `<a>` 元素，你可以在 `attributionsrc` 属性中声明 URL：
+
+```html
+<a
+  href="https://shop.example"
+  attributionsrc="https://a.example/register-source">
+  点击访问我们的商店
+</a>
+```
+
+或者通过 JavaScript 使用 `attributionSrc` 属性：
+
+```js
+// 编码 URL 以防它们包含特殊字符
+// 如“=”，否则会被错误解析。
+const encodedUrlA = encodeURIComponent("https://a.example/register-source");
+const encodedUrlB = encodeURIComponent("https://b.example/register-source");
+
+const aElem = document.querySelector("a");
+aElem.attributionSrc = `${encodedUrlA} ${encodedUrlB}`;
+```
+
+在调用 {{domxref("Window.open()")}} 时，不同的 URL 必须在 [`windowFeatures`](/zh-CN/docs/Web/API/Window/open#windowfeatures) 参数中列为多个独立的 `attributionsrc` 特性，用逗号或空格分隔：
+
+```js
+// 编码 URL 以防它们包含特殊字符
+// 如“=”，否则会被错误解析。
+const encodedUrlA = encodeURIComponent("https://a.example/register-source");
+const encodedUrlB = encodeURIComponent("https://b.example/register-source");
+
+elem.addEventListener("click", () => {
+  window.open(
+    "https://ourshop.example",
+    "_blank",
+    `attributionsrc=${encodedUrlA},attributionsrc=${encodedUrlB}`,
+  );
+});
+```
+
+> [!NOTE]
+> 指定多个 URL 意味着可以在同一特性上注册多个归因来源。例如，你可能有不同的活动需要测量其成功率，这些活动涉及在不同数据上生成不同的报告。
+
+## 参见
+
+- [归因报告标头验证工具](https://wicg.github.io/attribution-reporting-api/validate-headers)
diff --git a/files/zh-cn/web/api/attribution_reporting_api/registering_triggers/index.md b/files/zh-cn/web/api/attribution_reporting_api/registering_triggers/index.md
new file mode 100644
index 00000000000000..b0863f67f8cc77
--- /dev/null
+++ b/files/zh-cn/web/api/attribution_reporting_api/registering_triggers/index.md
@@ -0,0 +1,231 @@
+---
+title: 注册归因触发器
+slug: Web/API/Attribution_Reporting_API/Registering_triggers
+l10n:
+  sourceCommit: f430d277573ba0b06b1ac33ae8017fd90f170bef
+---
+
+{{SeeCompatTable}}{{DefaultAPISidebar("Attribution Reporting API")}}
+
+本文解释了如何注册归因触发器。
+
+## 基本方法
+
+在[注册归因来源](/zh-CN/docs/Web/API/Attribution_Reporting_API/Registering_sources)之后，你需要注册归因触发器。这些是网站上的交互事件，用于测量转换（例如，点击广告商网站上的“购买”按钮可以表示可能发生了转换）。浏览器会尝试将归因触发器与存储在私有本地存储分区中的归因来源条目进行匹配，并在找到匹配项时[生成报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports)。
+
+不同的归因触发器类型以不同的方式注册，详见以下部分——请参阅[基于 HTML 的归因触发器](#基于_html_的归因触发器)和[基于 JavaScript 的归因触发器](#基于_javascript_的归因触发器)。
+
+但是，无论背后发生了什么来注册触发器、查找匹配等，过程都是相同的。
+
+1. 所有触发器类型都会在请求中发送 {{httpheader("Attribution-Reporting-Eligible")}} 标头，指示响应有资格注册触发器。例如：
+
+   ```http
+   Attribution-Reporting-Eligible: trigger
+   ```
+
+2. 当服务器收到包含 `Attribution-Reporting-Eligible` 标头的请求时，它可以在响应中包含 {{httpheader("Attribution-Reporting-Register-Trigger")}}。其值是一个 JSON 字符串，其中包含可以包含在生成报告中的数据，例如触发器的 ID、优先级和去重值。
+
+   以下示例意在与[事件级报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#事件级报告)归因来源匹配：
+
+   ```js
+   res.set(
+     "Attribution-Reporting-Register-Trigger",
+     JSON.stringify({
+       "event_trigger_data": [
+         {
+           "trigger_data": "4",
+           "priority": "1000000000000",
+           "deduplication_key": "2345698765",
+         },
+       ],
+       "debug_key": "1115698977",
+     });
+   );
+   ```
+
+   这里指定的字段如下：
+
+   - `"event_trigger_data"`：一个表示触发器数据的对象。包括：
+     - `"trigger_data"`：与触发器相关的数据，通常用于指示事件，如“用户将物品添加到购物车”或“用户注册到邮件列表”。此值将包含在生成的报告中（如果有），尽管它将根据归因来源的 [`"trigger_data_matching"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#trigger_data_matching) 字段进行修改。
+       > [!NOTE]
+       > 用于表示每个事件的值以及数组中的元素数量完全是任意的，由作为开发人员的你定义。数组可以包含未使用的值，但在触发器注册时，必须在数组中存在值，以便浏览器将其归因于来源。
+     - `"priority"`：表示归因触发器优先级的字符串值。有关更多信息，请参见[报告优先级和限制](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#报告优先级和限制)。
+     - `"deduplication_key"`：表示唯一键的字符串，用于防止归因重复——例如，如果用户多次将同一项添加到购物车。有关更多信息，请参见[防止报告重复](https://developers.google.com/privacy-sandbox/private-advertising/attribution-reporting/prevent-duplication)。
+   - `"debug_key"`：表示调试键的数字。如果你希望生成[调试报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#调试报告)，请设置此项。
+
+   请参见 {{httpheader("Attribution-Reporting-Register-Trigger")}} 以获取所有可用字段的详细描述。
+
+   旨在与[汇总报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#汇总报告)归因来源匹配的触发器需要以下字段：
+
+   ```js
+   res.set(
+     "Attribution-Reporting-Register-Trigger",
+     JSON.stringify({
+       "aggregatable_trigger_data": [
+         {
+           "key_piece": "0x400",
+           "source_keys": ["campaignCounts"]
+         },
+         {
+           "key_piece": "0xA80",
+           "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
+         }
+       ],
+       "aggregatable_values": {
+         "campaignCounts": 32768,
+         "geoValue": 1664
+       },
+       "debug_key": "1115698977"
+     });
+   );
+   ```
+
+   此示例中的字段为：
+
+   - `"aggregatable_trigger_data"`：一个对象数组，每个对象定义了一个聚合键，用于应用到不同的来源键上。
+   - `"aggregatable_values"`：一个对象，包含 `"aggregatable_trigger_data"` 中定义的每个数据点的值。
+
+   同样，请参见 {{httpheader("Attribution-Reporting-Register-Trigger")}} 以获取所有可用字段的详细描述。
+
+3. 当用户与归因触发器交互时，浏览器会尝试将触发器与浏览器私有本地缓存中存储的任何归因来源条目进行匹配。要成功匹配，`Attribution-Reporting-Register-Trigger` 的 [`"trigger_data"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Trigger#trigger_data) 必须与 {{httpheader("Attribution-Reporting-Register-Source")}} 的 [`"trigger_data"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#trigger_data) 中提供的一个值匹配，并且注册触发器的顶级页面的站点（方案 + [eTLD+1](/zh-CN/docs/Glossary/eTLD)）必须：
+
+   - 与来源的相关数据中指定的 `destination` 的站点之一匹配。
+   - 与指定来源注册的请求同源。
+
+   > [!NOTE]
+   > 这些要求提供了隐私保护，但也提供了灵活性——来源*和*触发器可以嵌入在 {{htmlelement("iframe")}} 中或位于顶级站点上。
+
+   还有许多其他因素会阻碍匹配的成功；例如：
+
+   - 触发器的过滤器与来源的过滤器数据不匹配（有关详细信息，请参见[过滤器](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#过滤器)）。
+   - 来源的 [`"trigger_data_matching"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#trigger_data_matching) 设置导致没有匹配发生。
+   - 来源的 [`"max_event_level_reports"`](/zh-CN/docs/Web/HTTP/Headers/Attribution-Reporting-Register-Source#max_event_level_reports) 限制已达到。
+   - 由于浏览器的随机响应算法，没有报告成功的匹配。有关详细信息，请参见[为报告添加噪声](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports#为报告添加噪声)。
+
+4. 如果找到成功的匹配项，浏览器将根据来源和触发器数据[生成报告](/zh-CN/docs/Web/API/Attribution_Reporting_API/Generating_reports)并将其发送到报告端点。
+
+> [!NOTE]
+> 归因触发器不能像归因来源一样在 {{htmlelement("a")}} 元素或 {{domxref("Window.open()")}} 调用上注册。
+
+## 基于 HTML 的归因触发器
+
+基于 HTML 的归因触发器可用于在页面首次加载时检测转化——更准确地说，是在 `<img>` 或 `<script>` 加载时。例如，如果用户点击了发布者页面上的归因来源链接并导航到广告商页面，你可以在广告商页面加载时注册归因触发器，并让浏览器尝试与存储的来源条目进行匹配。
+
+你可以通过将 `attributionsrc` 属性添加到适当的元素来注册归因触发器。可以在 {{htmlelement("img")}} 和 {{htmlelement("script")}} 元素上执行此操作。
+
+如果将属性值留空，注册请求将发送到托管请求资源的服务器。还可以在值中指定附加的 URL 以发送注册请求；有关更多详细信息，请参阅[在 attributionsrc 中指定 URL](#在_attributionsrc_中指定_url)。
+
+以下是 `<img>` 元素的示例：
+
+```html
+<img
+  src="https://shop.example/conversion/4rghshdh5"
+  width="1"
+  height="1"
+  attributionsrc />
+```
+
+你也可以通过 {{domxref("HTMLImageElement.attributionSrc")}} 属性实现此目的：
+
+```js
+const imgElem = document.querySelector("img");
+imgElem.attributionSrc = "";
+```
+
+在这种情况下，当浏览器接收到包含图像文件的响应时（当 `load` 事件触发时），浏览器将尝试将触发器与存储的归因来源进行匹配。请记住，用户可能根本无法感知到图像——这可能是一个仅用于归因报告的 1x1 透明追踪像素。
+
+{{htmlelement("script")}} 的示例可能如下所示：
+
+```html
+<script src="advertising-script.js" attributionsrc />
+```
+
+```js
+const scriptElem = document.querySelector("script");
+scriptElem.attributionSrc = "";
+```
+
+在这种情况下，当浏览器接收到包含脚本的响应时，浏览器将尝试将触发器与存储的归因来源进行匹配。
+
+## 基于 JavaScript 的归因触发器
+
+基于 JavaScript 的归因触发器比基于 HTML 的触发器更具灵活性。你可以根据自定义交互（例如，点击自定义元素或提交表单）触发浏览器尝试与存储的来源进行匹配。
+
+要注册基于脚本的归因触发器，你可以：
+
+- 发送包含 `attributionReporting` 选项的 {{domxref("Window/fetch", "fetch()")}} 请求：
+
+  ```js
+  const attributionReporting = {
+    eventSourceEligible: false,
+    triggerEligible: true,
+  };
+
+  // 可选设置 keepalive 以确保请求在页面结束后仍然存在
+  function triggerMatching() {
+    fetch("https://shop.example/endpoint", {
+      keepalive: true,
+      attributionReporting,
+    });
+  }
+
+  // 将交互触发器与你的代码中适当的元素和事件关联
+  elem.addEventListener("click", triggerMatching);
+  ```
+
+- 发送 {{domxref("XMLHttpRequest")}} 请求，并在请求对象上调用 {{domxref("XMLHttpRequest.setAttributionReporting", "setAttributionReporting()")}}：
+
+  ```js
+  const attributionReporting = {
+    eventSourceEligible: false,
+    triggerEligible: true,
+  };
+
+  function triggerMatching() {
+    const req = new XMLHttpRequest();
+    req.open("GET", "https://shop.example/endpoint");
+    // 检查 setAttributionReporting() 的可用性再调用
+    if (typeof req.setAttributionReporting === "function") {
+      req.setAttributionReporting(attributionReporting);
+      req.send();
+    } else {
+      throw new Error("归因报告不可用");
+      // 根据需要包括恢复代码
+    }
+  }
+
+  // 将交互触发器与你的代码中适当的元素和事件关联
+  elem.addEventListener("click", triggerMatching);
+  ```
+
+在这种情况下，当浏览器接收到来自 fetch 请求的响应时，浏览器将尝试将触发器与存储的归因来源进行匹配。
+
+> [!NOTE]
+> 请求可针对任何资源。不需要直接与归因报告 API 相关，可以是 JSON 请求、纯文本、图像 blob 或其他适合你应用的内容。
+
+## 在 attributionsrc 中指定 URL
+
+在上述示例中，`attributionsrc` 属性被留空，取值为空字符串。如果请求的资源所在的服务器是你也想处理注册的服务器，即接收 {{httpheader("Attribution-Reporting-Eligible")}} 标头并响应 {{httpheader("Attribution-Reporting-Register-Trigger")}} 标头，这样的做法是合适的。
+
+然而，可能请求的资源不在你控制的服务器上，或者你只希望在不同的服务器上处理注册归因触发器。在这种情况下，你可以将一个或多个 URL 指定为 `attributionsrc` 的值。当资源请求发生时，`attributionsrc` 中指定的 URL 将接收到 {{httpheader("Attribution-Reporting-Eligible")}} 标头，除此之外还会发送到资源原点；这些 URL 可以响应 {{httpheader("Attribution-Reporting-Register-Trigger")}} 以完成注册。
+
+以 `<img>` 元素为例，你可以在 `attributionsrc` 属性中声明 URL：
+
+```html
+<img
+  src="https://shop.example/conversion/4rghshdh5"
+  attributionsrc="https://my-separate-tracking-site.example.com"
+  width="1"
+  height="1" />
+```
+
+或者在 JavaScript 中通过 `attributionSrc` 属性：
+
+```js
+const imgElem = document.querySelector("img");
+imgElem.attributionSrc = "https://my-separate-tracking-site.example.com";
+```
+
+## 参见
+
+- [归因报告标头验证工具](https://wicg.github.io/attribution-reporting-api/validate-headers)

From d5ff03b788c1a0e15a8924a15c4c9e2fd6970fae Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Mon, 9 Sep 2024 19:19:20 +0800
Subject: [PATCH 004/115] chore: update CONTRIBUTING.md (#23442)

Update CONTRIBUTING.md
---
 CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8568bf437711a7..8513c932dedfb0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -34,7 +34,7 @@ See the [Creating a pull request](#creating-a-pull-request) for more details on
 
 If you're not certain of the changes that you want to make, [get in touch with us][]!
 
-> **Note:** You can click the **View the source on GitHub** or **Edit the page on GitHub** link at the bottom of an MDN page to jump directly to the page source on GitHub.
+> **Note:** You may click the **View this page on GitHub** or **Report a problem with this content** link at the bottom of an MDN page, to either jump directly to the page source or raise an issue on GitHub.
 
 ### Forking and cloning the repository
 

From a766dd54d11abbe4eba5f2272227cc1dab4c9eb1 Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Mon, 9 Sep 2024 22:04:48 +0800
Subject: [PATCH 005/115] zh-cn: update the translation of the web/tutorials
 article (#23484)

---
 files/zh-cn/web/tutorials/index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/files/zh-cn/web/tutorials/index.md b/files/zh-cn/web/tutorials/index.md
index 52aa78b5dc12ed..ad6adaf9c84331 100644
--- a/files/zh-cn/web/tutorials/index.md
+++ b/files/zh-cn/web/tutorials/index.md
@@ -18,7 +18,7 @@ l10n:
 
 ### 初级
 
-- [介绍 HTML](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
+- [HTML 简介](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
   - : 本模块分为几个阶段：熟悉重要的概念和语法、在文本中应用 HTML、创建超链接、使用 HTML 构建网页。
 - [MDN 的 HTML 元素参考](/zh-CN/docs/Web/HTML/Element)
   - : 完整的 HTML 元素参考以及不同浏览器的兼容性信息。
@@ -51,7 +51,7 @@ l10n:
   - : CSS（层叠样式表）用于为网页添加样式，对网页进行布局——例如，修改内容的字体、颜色、大小和间距，将内容分成多列，或添加动画和其它装饰特性。在前往掌握 CSS 基础知识（CSS 的运作方式，CSS 语法是什么样子，在 HTML 中如何使用 CSS 添加样式）的道路上，本模块是一个很好的开始。
 - [CSS 构建块](/zh-CN/docs/Learn/CSS/Building_blocks)
 
-  - : 本模块承接 [CSS 入门](/zh-CN/docs/Learn/CSS/First_steps)——这时你已经熟悉 CSS 语言及其语法、有了基本的使用经验，是时候再深入一些。在本模块中，你会学习层叠和继承、可用的选择器类型、单位、大小、为背景和边框添加样式、调试，以及其它内容。
+  - : 本模块承接 [CSS 第一步](/zh-CN/docs/Learn/CSS/First_steps)——这时你已经熟悉 CSS 语言及其语法，有了基本的使用经验，是时候再深入一些。在本模块中，你会学习层叠和继承、可用的选择器类型、单位、大小、为背景和边框添加样式、调试，以及其它内容。
 
     本文的目的是，在了解诸如[为文本添加样式](/zh-CN/docs/Learn/CSS/Styling_text)和 [CSS 布局](/zh-CN/docs/Learn/CSS/CSS_layout)等特定领域的知识之前，提供一个能让你编写合格 CSS 的工具集并帮助你理解基本的理论。
 

From 45b6ee69fb2fbe55347027f8eb58dce8f4f41ffb Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Mon, 9 Sep 2024 22:05:48 +0800
Subject: [PATCH 006/115] zh-cn: update the translation of the "Web form
 building blocks" article (#23445)

---
 files/zh-cn/learn/forms/index.md | 61 +++++++++++++++++---------------
 1 file changed, 32 insertions(+), 29 deletions(-)

diff --git a/files/zh-cn/learn/forms/index.md b/files/zh-cn/learn/forms/index.md
index c2d2a13017d6bb..3513c63a95cc8c 100644
--- a/files/zh-cn/learn/forms/index.md
+++ b/files/zh-cn/learn/forms/index.md
@@ -1,68 +1,71 @@
 ---
-title: Web 表单指南
+title: Web 表单构建块
 slug: Learn/Forms
+l10n:
+  sourceCommit: b76266228bd0900aa1256902c7858971156a58c9
 ---
 
 {{LearnSidebar}}
 
-这个模块提供了一系列帮助你掌握 web 表单的文章。web 表单是与用户交互的强大工具，它们经常用于收集用户的数据，或允许他们控制用户界面。然而，由于历史和技术上的原因，如何充分发挥它们的潜力并不总是显而易见的。在下方列出的文章中，我们将介绍 Web 表单的各个方面：HTML 结构、样式、验证表单数据，以及提交数据到服务器。
+本模块提供的系列文章意在帮助你掌握 Web 表单的基本知识。Web 表单是用于和用户交互的强大工具——其常用于收集用户数据和控制用户界面。然而，出于历史和技术原因，如何发挥 Web 表单的全部潜力并不总是显而易见的。在下面的文章中，你会学习 Web 表单的全部基本内容，包括：标记表单的 HTML 结构、为表单控件添加样式、验证表单数据，以及向服务器提交数据。
 
 ## 前提
 
-在开始这个模块之前，你至少应该熟悉[对 HTML 的介绍](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)系列。此时此刻，你应该会发现[基本指南](#基本指南)很容易理解，并且能够使用我们的[原生表单控件](/zh-CN/docs/Learn/Forms/Basic_native_form_controls)指南。
+在开始本模块之前，你应该至少学习过 [HTML 简介](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)。此时此刻，你应该会发现[入门指南](#入门指南)很容易理解，并且也能够使用[基本的原生表单控件](/zh-CN/docs/Learn/Forms/Basic_native_form_controls)指南。
 
-然而，掌握表单需要的不仅仅是 HTML 知识——你还需要学习一些特定的技术来设置表单控件的样式，并且需要一些编码知识来处理诸如验证和创建自定义表单控件之类的事情。因此，在你查看下面列出的其他部分之前，我们建议你先离开，并学习一些 [CSS](/zh-CN/docs/Learn/CSS) 和 [JavaScript](/zh-CN/docs/Learn/JavaScript)。
+然而，掌握表单需要的不仅仅是 HTML 知识——你还需要学习一些为表单控件添加样式的特定技术，一些用于处理诸如验证和创建自定义表单控件等内容的脚本知识。因此，在学习下列其他文章之前，我们会建议你先离开去学习一些 [CSS](/zh-CN/docs/Learn/CSS) 和 [JavaScript](/zh-CN/docs/Learn/JavaScript)。
 
-以上内容明确地说明了为什么我们将 web 表单独立放在一个模块中，而不是将其与 HTML、CSS 和 JavaScript 这些模块放在一起——表单元素比绝大多数其他的 HTML 元素都要复杂，并且它们还需要与相关的 CSS 和 JavaScript 技术紧密集合才能充分利用它们。
+以上内容很好地表明了我们为什么将 Web 表单放在单独模块中，而不是将其混入 HTML、CSS 和 JavaScript 专题中——表单元素比大多数其他的 HTML 元素要复杂，并且它们还需要与相关的 CSS 和 JavaScript 技术紧密配合才能充分利用。
 
 > [!NOTE]
-> 如果你正在使用一个无法创建自己的文件的计算机、平板电脑或其他设备，那么你可以尝试（大多数）在线编码程序中的代码示例，例如 [JSBin](https://jsbin.com/) 或 [Glitch](https://glitch.com/)。
+> 如果你工作的计算机/掌上电脑/其他设备无法创建文件，可以使用在线编码程序（例如，[JSBin](https://jsbin.com/) 或者 [Glitch](https://glitch.com/)）实验（大多数）代码示例。
 
-## 基本指南
+## 入门指南
 
 - [你的第一个表单](/zh-CN/docs/Learn/Forms/Your_first_form)
-  - : 本系列的第一篇文章提供了第一次创建 HTML 表单的经验，包括设计一个简单表单、使用正确的 HTML 元素实现它、通过 CSS 添加一些非常简单的样式，以及如何将数据发送到服务器。
-- [如何构造 HTML 表单](/zh-CN/docs/Learn/Forms/How_to_structure_a_web_form)
-  - : 有了基础知识，我们现在更详细地了解了用于为表单的不同部分提供结构和意义的元素。
+  - : 本系列的第一篇文章让你拥有第一次创建 Web 表单的体验，包括，设计一个简单表单、使用正确的 HTML 元素实现表单、通过 CSS 添加一些非常简单的样式，以及向服务器发送数据。
+- [如何构造 Web 表单](/zh-CN/docs/Learn/Forms/How_to_structure_a_web_form)
+  - : 已经有了基础知识，现在深入学习为表单的不同部分提供结构和含义的元素。
 
 ## 不同的表单控件
 
-- [原生表单控件](/zh-CN/docs/Learn/Forms/Basic_native_form_controls)
-  - : 我们从详细了解原始 HTML {{htmlelement("input")}} 元素的类型开始，同时学习在收集不同类型数据时可用的选择。
-- [HTML5 input 的类型](/zh-CN/docs/Learn/Forms/HTML5_input_types)
-  - : 在这里，我们深入挖掘 `<input>` 元素，了解 HTML5 发布时提供的其他 input 类型，以及它们提供的各种 UI 控件和数据收集增强功能。此外，我们可以了解 {{htmlelement('output')}} 元素。
+- [基本的原生表单控件](/zh-CN/docs/Learn/Forms/Basic_native_form_controls)
+  - : 从详细学习原始 HTML {{htmlelement("input")}} 类型的功能开始，同时学习在收集不同类型的数据时，还有哪些可用的选择。
+- [HTML5 input 类型](/zh-CN/docs/Learn/Forms/HTML5_input_types)
+  - : 继续深入学习 `<input>` 元素，了解 HTML5 发布时提供的其他 input 类型，以及这些类型提供的各种 UI 控件和数据收集增强功能。此外，还会学习 {{htmlelement('output')}} 元素。
 - [其他表单控件](/zh-CN/docs/Learn/Forms/Other_form_controls)
-  - : 接下来，我们学习所有非 `<input>` 表单控件，以及相关的工具，如：{{htmlelement('select')}}、{{htmlelement('textarea')}}、{{htmlelement('meter')}} 和 {{htmlelement('progress')}}。
+  - : 接下来学习所有非 `<input>` 表单控件，以及相关的工具，例如：{{htmlelement('select')}}、{{htmlelement('textarea')}}、{{htmlelement('meter')}} 和 {{htmlelement('progress')}}。
 
 ## 表单样式指南
 
-- [HTML 表单样式](/zh-CN/docs/Learn/Forms/Styling_web_forms)
-  - : 本文介绍了如何使用 CSS 为表单赋予样式，包括可能需要了解的基本样式任务的所有基础知识。
+- [为 Web 表单添加样式](/zh-CN/docs/Learn/Forms/Styling_web_forms)
+  - : 本文介绍如何使用 CSS 为表单添加样式，包括完成基本样式任务所需了解的全部基础知识。
 - [高级表单样式](/zh-CN/docs/Learn/Forms/Advanced_form_styling)
-  - : 在这里，我们将看到一些更高级的表单样式技术，这些技术需要在处理一些更难以设置样式的元素时使用。
+  - : 在这里学习一些更高级的表单样式技术，用于处理一些很难设置样式的表单元素。
 - [UI 伪类](/zh-CN/docs/Learn/Forms/UI_pseudo-classes)
-  - : 这是一篇对 UI 伪类的介绍，使 HTML 表单控件能够根据当前状态进行定位。
+  - : 一篇 UI 伪类的介绍——根据表单的当前状态定位到 HTML 表单控件。
 
 ## 验证和提交表单数据
 
 - [客户端表单验证](/zh-CN/docs/Learn/Forms/Form_validation)
-  - : 仅仅发送数据还不够——我们还需要确保用户填写表单的数据格式是正确的，以在后续流程中正确处理它，而且它不会破坏我们的应用程序。我们还希望帮助用户正确填写表单，让他们在使用应用程序时不会感到困扰。表单验证可以帮助我们实现这些目标，本文将告诉你需要了解的内容。
+  - : 仅仅发送数据还不够——还需要确保用户填写的表单数据的格式是正确的，以便后续能正确处理，也要确保数据不会破坏应用程序。我们也想帮助用户正确填写表单，让用户在使用应用程序时不会感到困扰。表单验证帮助我们实现这些目标——本文讲解你需要了解的内容。
 - [发送表单数据](/zh-CN/docs/Learn/Forms/Sending_and_retrieving_form_data)
-  - : 本文讨论当用户提交一个表单时，会发生什么情况——表单数据的去向，以及当表单数据到达指定位置时我们如何处理？我们还研究了与发送表单数据相关的一些安全问题。
+  - : 本文讨论的是当用户提交表单时，会发生什么——表单数据的去向，以及当表单数据到达之后如何处理？还研究一些与发送表单数据有关联的安全问题。
 
-## 高级指南
+## 高级文章
 
-以下文章对于学习路径来说没那么重要，但是当你掌握了上述技术并向了解更多内容时，它们会变得有趣且实用。
+以下文章对于学习路径来说没那么重要，但是当你掌握了上述技术并想了解更多内容时，它们会变得有趣且实用。
 
 - [如何构建自定义表单控件](/zh-CN/docs/Learn/Forms/How_to_build_custom_form_controls)
-  - : 在某些情况下，可能出于样式或功能的原因，原生表单部件无法提供你所需要的东西。在这种情况下，你可能需要使用原生 HTML 构建自己的表单小部件。本文将讲述一个实例，说明你将如何做到这一点，以及在实际操作时需要注意的事项。
+  - : 在某些情况下，出于样式或功能的原因，原生表单微件无法提供你所需的东西。在这种情况下，你会需要使用原生 HTML 构建表单微件。本文通过一个案例研究说明你将如何做到这一点，以及在实际操作时需要注意的事项。
 - [通过 JavaScript 发送表单](/zh-CN/docs/Learn/Forms/Sending_forms_through_JavaScript)
-  - : 本文将讨论如何使用表单来构建 HTTP 请求，并通过定制的 JavaScript 发送它，而不是标准的表单提交。它还说明了为什么要这么做，以及这样做的意义。（请参阅[使用 FormData 对象](/zh-CN/docs/Web/API/XMLHttpRequest_API/Using_FormData_Objects)。）
+  - : 本文将讨论如何使用表单来构建 HTTP 请求，并通过自定义的 JavaScript 而不是标准的表单提交发送请求。本文还说明为什么要这么做，以及这样做的意图。（参见[使用 FormData 对象](/zh-CN/docs/Web/API/XMLHttpRequest_API/Using_FormData_Objects)。）
 - [表单控件的 CSS 属性兼容性表](/zh-CN/docs/Learn/Forms/Property_compatibility_table_for_form_controls)
-  - : 最后一篇文章提供了一个方便的参考，以确定 CSS 属性与表单元素的兼容性关系。
+  - : 最后一篇文章提供的参考意在方便查找 CSS 属性与表单元素的兼容性关系。
 
 ## 参见
 
-- [HTML 表单元素](/zh-CN/docs/Web/HTML/Element#表单)
-- [HTML \<input> 元素](/zh-CN/docs/Web/HTML/Element/Input)
-- [HTML 属性](/zh-CN/docs/Web/HTML/Attributes)
+- [HTML 表单元素参考](/zh-CN/docs/Web/HTML/Element#表单)
+- [HTML \<input> 类型参考](/zh-CN/docs/Web/HTML/Element/Input)
+- [HTML 属性参考](/zh-CN/docs/Web/HTML/Attributes)
+- [用户输入方式和控件](/zh-CN/docs/Learn/Forms/User_input_methods)

From b76cf17b28aa454d92c158dfc3035e1f4599978b Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Mon, 9 Sep 2024 23:52:28 +0900
Subject: [PATCH 007/115] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0=20(#23413)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 2024/07/26 時点の英語版に基づき更新

* Update index.md
---
 files/ja/web/api/pluginarray/index.md | 81 ++++++++++++++++++++++-----
 1 file changed, 68 insertions(+), 13 deletions(-)

diff --git a/files/ja/web/api/pluginarray/index.md b/files/ja/web/api/pluginarray/index.md
index 50ce956299cdc2..424c27a82d38d6 100644
--- a/files/ja/web/api/pluginarray/index.md
+++ b/files/ja/web/api/pluginarray/index.md
@@ -1,23 +1,78 @@
 ---
 title: PluginArray
 slug: Web/API/PluginArray
+l10n:
+  sourceCommit: 802b6063046dffb7634d2138aadcd92cb22ed40c
 ---
 
-{{ApiRef}} {{non-standard_header}}
+{{APIRef("HTML DOM")}}{{deprecated_header}}
 
-`PluginArray` インターフェースには使用可能なプラグインのリストが格納されています。 {{domxref("window.navigator.plugins")}} プロパティによって返されます。
+`PluginArray` インターフェイスは、利用可能な[プラグイン](/ja/docs/Mozilla/Add-ons/Plugins)を記述する {{DOMxRef("Plugin")}} のリストを格納するために使用されます。これは {{DOMxRef("Navigator.plugins", "navigator.plugins")}} プロパティから返されます。`PluginArray` は JavaScript の配列ではありませんが、`length` プロパティがあり、それぞれのアイテムにブラケット記法 (`plugins[2]`) を使用すると、`item(index)` や `namedItem("name")` メソッドと同様にアクセスできます。
 
-## プロパティ
+> [!NOTE]
+> 最新バージョンのブラウザーでは、`PluginArray` オブジェクトの自分自身でプロパティを列挙できなくなくなりました。
 
-| プロパティ名                      | 説明                                                 | 戻り値の型    | 可用性 |
-| --------------------------------- | ---------------------------------------------------- | ------------- | ------ |
-| {{domxref("PluginArray.length")}} | プラグインリスト配列中のプラグイン数。**読取専用**。 | unsigned long | DOM 0  |
+## インスタンスプロパティ
 
-## メソッド
+- {{DOMxRef("PluginArray.length")}} {{ReadOnlyInline}} {{Deprecated_Inline}}
+  - : この配列内のプラグインの数です。
 
-- {{domxref("PluginArray.item")}}
-  - : プラグインリスト配列中の指定したインデックスにある {{domxref("Plugin")}} を返す
-- {{domxref("PluginArray.namedItem")}}
-  - : プラグインリスト配列中の指定した名称の {{domxref("Plugin")}} を返す
-- {{domxref("PluginArray.refresh")}}
-  - : 現在のページの全てのプラグインを更新。必要に応じて文書を再読み込みします。
+## インスタンスメソッド
+
+- {{DOMxRef("PluginArray.item")}} {{Deprecated_Inline}}
+  - : プラグインリスト配列中の指定したインデックスにある {{DOMxRef("Plugin")}} を返す
+- {{DOMxRef("PluginArray.namedItem")}} {{Deprecated_Inline}}
+  - : プラグインリスト配列中の指定した名称の {{DOMxRef("Plugin")}} を返す
+- {{DOMxRef("PluginArray.refresh")}} {{Deprecated_Inline}}
+  - : 現在のページの全てのプラグインを更新します。必要に応じて文書を再読み込みします。
+
+## 例
+
+次の例の関数は、Shockwave Flash プラグインのバージョンを返します。
+
+```js
+const pluginsLength = navigator.plugins.length;
+
+document.body.innerHTML =
+  `${pluginsLength} Plugin(s)<br>` +
+  `<table id="pluginTable"><thead>` +
+  `<tr><th>Name</th><th>Filename</th><th>description</th><th>version</th></tr>` +
+  `</thead><tbody></tbody></table>`;
+
+const table = document.getElementById("pluginTable");
+
+for (let i = 0; i < pluginsLength; i++) {
+  let newRow = table.insertRow();
+  newRow.insertCell().textContent = navigator.plugins[i].name;
+  newRow.insertCell().textContent = navigator.plugins[i].filename;
+  newRow.insertCell().textContent = navigator.plugins[i].description;
+  newRow.insertCell().textContent = navigator.plugins[i].version ?? "";
+}
+```
+
+次の例は、インストールされているプラグインに関する情報を表示します。
+
+```js
+const pluginsLength = navigator.plugins.length;
+
+document.write(
+  `${pluginsLength.toString()} Plugin(s)<br>` +
+    `Name | Filename | description<br>`,
+);
+
+for (let i = 0; i < pluginsLength; i++) {
+  document.write(
+    `${navigator.plugins[i].name} | ${navigator.plugins[i].filename} | ${navigator.plugins[i].description} | ${navigator.plugins[i].version}<br>`,
+  );
+}
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+Firefox では、ゼロインデックスの数値プロパティによる擬似配列として各プラグインが掲載されていることに加え、PluginArray オブジェクトにプラグイン名が直接指定されたプロパティが提供されています。

From 01e97630dc53a32f2dcd4997f6e596ba2e8ff649 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Thu, 5 Sep 2024 22:44:16 +0900
Subject: [PATCH 008/115] =?UTF-8?q?2024/08/30=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pointerevent/index.md | 44 +++++++++++++++-----------
 1 file changed, 25 insertions(+), 19 deletions(-)

diff --git a/files/ja/web/api/pointerevent/index.md b/files/ja/web/api/pointerevent/index.md
index 252626895d325d..daf91187c04b3f 100644
--- a/files/ja/web/api/pointerevent/index.md
+++ b/files/ja/web/api/pointerevent/index.md
@@ -2,14 +2,14 @@
 title: PointerEvent
 slug: Web/API/PointerEvent
 l10n:
-  sourceCommit: c5240154445333f79ea4fc8a4c9843da99a198b2
+  sourceCommit: ba77b09c606b1b5fdea532e84b980cd0e79f226d
 ---
 
 {{ APIRef("Pointer Events") }}
 
 **`PointerEvent`** インターフェイスは、接触点の形状、イベントを生成した機器の種類、接触面に加えられた圧力の量など、ポインターによって生成された DOM イベントの状態を表します。
 
-*ポインター*は、入力機器（マウス、ペン、またはタッチ可能な面の上の接触点など）のハードウェアにとらわれない表現です。 ポインターは、画面などの接触面上の特定の座標（または座標の集合）をターゲットにすることができます。
+*ポインター*は、入力機器（マウス、ペン、またはタッチパネルの上の接触点など）のハードウェアにとらわれない表現です。 ポインターは、画面などの接触面上の特定の座標（または座標の集合）をターゲットにすることができます。
 
 ポインターの*ヒットテスト*は、ブラウザーがポインターイベントのターゲット要素を決定するために使用する手続です。通常、これはポインターの位置と、画面媒体上の文書内の要素の視覚的なレイアウトを考慮して決定します。
 
@@ -24,40 +24,46 @@ l10n:
 
 _このインターフェイスは、{{domxref("MouseEvent")}} および {{domxref("Event")}} からプロパティを継承しています。_
 
-- {{ domxref('PointerEvent.pointerId')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.altitudeAngle')}} {{ReadOnlyInline}} {{experimental_inline}}
+  - : トランスデューサー（ポインターまたはスタイラス）の軸と機器の画面の X-Y 平面のなす角度を表します。
+- {{domxref('PointerEvent.azimuthAngle')}} {{ReadOnlyInline}} {{experimental_inline}}
+  - : Y-Z 平面と、トランスデューサー（ポインターまたはスタイラス）の軸と Y 軸の両方を格納する平面との間の角度を表します。
+- {{domxref('PointerEvent.persistentDeviceId')}} {{ReadOnlyInline}} {{experimental_inline}}
+  - : `PointerEvent` を生成するポインティングデバイス用の固有の識別子。
+- {{domxref('PointerEvent.pointerId')}} {{ReadOnlyInline}}
   - : イベントの原因となっているポインターの一意の識別子。
-- {{ domxref('PointerEvent.width')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.width')}} {{ReadOnlyInline}}
   - : ポインターの接触形状の幅（X 軸上の大きさ、CSS ピクセル単位）。
-- {{ domxref('PointerEvent.height')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.height')}} {{ReadOnlyInline}}
   - : ポインターの接触形状の高さ（Y 軸上の大きさ、CSS ピクセル単位）。
-- {{ domxref('PointerEvent.pressure')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.pressure')}} {{ReadOnlyInline}}
   - : 0 から 1 の範囲のポインター入力の正規化された圧力。 ここで、0 と 1 は、それぞれハードウェアが検出できる最小圧力と最大圧力を表します。
-- {{ domxref('PointerEvent.tangentialPressure')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.tangentialPressure')}} {{ReadOnlyInline}}
   - : ポインター入力の正規化された接線圧力（バレル圧力またはシリンダー応力（[cylinder stress](https://en.wikipedia.org/wiki/Cylinder_stress)）とも呼ばれます）は `-1` から `1` の範囲で、 `0` はコントロールの中立位置です。
-- {{ domxref('PointerEvent.tiltX')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.tiltX')}} {{ReadOnlyInline}}
   - : Y-Z 平面と、ポインター（ペン/スタイラスなど）軸と Y 軸の両方を含む平面との間の平面角度（度単位、`-90` から `90` の範囲）。
-- {{ domxref('PointerEvent.tiltY')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.tiltY')}} {{ReadOnlyInline}}
   - : X-Z 平面と、ポインター（ペン/スタイラスなど）軸と X 軸の両方を含む平面との間の平面角度（度単位、`-90` から `90` の範囲）。
-- {{ domxref('PointerEvent.twist')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.twist')}} {{ReadOnlyInline}}
   - : ポインター（ペン/スタイラスなど）の長軸を中心とした時計回りの回転の度数（`0` から `359` の範囲の値）。
-- {{ domxref('PointerEvent.pointerType')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.pointerType')}} {{ReadOnlyInline}}
   - : イベントの原因となった機器の種類（マウス、ペン、タッチなど）を示します。
-- {{ domxref('PointerEvent.isPrimary')}} {{ReadOnlyInline}}
+- {{domxref('PointerEvent.isPrimary')}} {{ReadOnlyInline}}
   - : ポインターがこのポインターの種類の主ポインターを表しているかどうかを示します。
 
 ## メソッド
 
-- {{DOMxRef('PointerEvent.getCoalescedEvents()')}}
+- {{DOMxRef('PointerEvent.getCoalescedEvents()')}} {{SecureContext_Inline}}
   - : 配信された {{domxref("Element/pointermove_event", "pointermove")}} イベントに結合されたすべての `PointerEvent` インスタンスの列を返します。
 - {{DOMxRef('PointerEvent.getPredictedEvents()')}}
   - : 配信された {{domxref("Element/pointermove_event", "pointermove")}} イベントの結合イベントの後に続くとブラウザーが予測した `PointerEvent` インスタンスの列を返します。
 
 ## ポインターイベントの種類
 
-`PointerEvent` インターフェイスには、複数の種類のイベントがあります。 どのイベントが発生したかを判断するには、イベントの {{ domxref("Event.type", "type") }} プロパティを調べてください。
+`PointerEvent` インターフェイスには、複数の種類のイベントがあります。 どのイベントが発生したかを判断するには、イベントの {{domxref("Event.type", "type")}} プロパティを調べてください。
 
 > [!NOTE]
-> 多くの場合、ポインターとマウスの両方のイベントが送信されることに注意することが重要です（ポインター固有でないコードでもユーザーと対話できるようにするため）。 ポインターイベントを使用する場合は、{{ domxref("event.preventDefault()") }} を呼び出してマウスイベントが共に送信されないようにする必要があります。
+> 多くの場合、ポインターとマウスの両方のイベントが送信されることに注意することが重要です（ポインター固有でないコードでもユーザーと対話できるようにするため）。ポインターイベントを使用する場合は、{{domxref("Event.preventDefault()")}} を呼び出してマウスイベントが共に送信されないようにする必要があります。
 
 - {{domxref('Element/pointerover_event', 'pointerover')}}
   - : このイベントは、ポインティングデバイスが要素のヒットテスト境界内に移動したときに発生します。
@@ -67,11 +73,11 @@ _このインターフェイスは、{{domxref("MouseEvent")}} および {{domxr
 
   - : このイベントは、ポインターが*アクティブ*になると発生します。 マウスの場合、ボタンが押されていない状態から少なくとも 1 つのボタンが押された状態に移行したときに発生します。タッチの場合、物理的な接触がデジタイザーとなされたときに発生します。 ペンの場合、スタイラスがデジタイザーと物理的に接触したときに発生します。
 
-    > **メモ:** [直接操作](https://w3c.github.io/pointerevents/#dfn-direct-manipulation)を受け付けるタッチ画面のブラウザーでは、 `pointerdown` イベントにより[暗黙的なポインターキャプチャ](https://w3c.github.io/pointerevents/#dfn-implicit-pointer-capture)が行われ、以降のすべてのポインターイベントが、キャプチャターゲット上で発生したかのようにターゲットに捕捉されます。そのため `pointerover`、`pointerenter`、`pointerleave`、`pointerout` はキャプチャが設定されている間は**発生しません**。キャプチャはターゲット要素上で {{ domxref('element.releasePointerCapture') }} を呼び出すことで手動で解除することができ、また `pointerup` または `pointercancel` イベントの後で暗黙的に解放されます。
+    > **メモ:** [直接操作](https://w3c.github.io/pointerevents/#dfn-direct-manipulation)を受け付けるタッチ画面のブラウザーでは、 `pointerdown` イベントにより[暗黙的なポインターキャプチャ](https://w3c.github.io/pointerevents/#dfn-implicit-pointer-capture)が行われ、以降のすべてのポインターイベントが、キャプチャターゲット上で発生したかのようにターゲットに捕捉されます。そのため `pointerover`、`pointerenter`、`pointerleave`、`pointerout` はキャプチャが設定されている間は**発生しません**。キャプチャはターゲット要素上で {{domxref('element.releasePointerCapture') }} を呼び出すことで手動で解除することができ、また `pointerup` または `pointercancel` イベントの後で暗黙的に解放されます。
 
 - {{domxref('Element/pointermove_event', 'pointermove')}}
   - : このイベントは、ポインターが座標を変更したときに発生します。
-- {{domxref('HTMLElement/pointerrawupdate_event', 'pointerrawupdate')}} {{Experimental_Inline}}
+- {{domxref('Element/pointerrawupdate_event', 'pointerrawupdate')}} {{experimental_inline}}
   - : このイベントは、ポインターのいずれかのプロパティが変更されたときに発生します。
 - {{domxref('Element/pointerup_event', 'pointerup')}}
   - : このイベントは、ポインターが*アクティブ*でなくなったときに発生します。
@@ -100,6 +106,6 @@ _このインターフェイスは、{{domxref("MouseEvent")}} および {{domxr
 
 ## 関連情報
 
-- {{ domxref("Touch_events","タッチイベント", "", 1) }}
-- {{ domxref("GestureEvent") }}
+- [タッチイベント](/ja/docs/Web/API/Touch_events)
+- {{domxref("GestureEvent")}}
 - {{cssxref("touch-action")}}

From e504ddb9c7ce1ab21b24233f32606d10ed649c9d Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Thu, 5 Sep 2024 22:46:05 +0900
Subject: [PATCH 009/115] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pointerevent/pointerevent/index.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/files/ja/web/api/pointerevent/pointerevent/index.md b/files/ja/web/api/pointerevent/pointerevent/index.md
index ff6b0d6cb38a2b..34959b4bed745f 100644
--- a/files/ja/web/api/pointerevent/pointerevent/index.md
+++ b/files/ja/web/api/pointerevent/pointerevent/index.md
@@ -1,8 +1,9 @@
 ---
-title: PointerEvent()
+title: "PointerEvent: PointerEvent() コンストラクター"
+short-title: PointerEvent()
 slug: Web/API/PointerEvent/PointerEvent
 l10n:
-  sourceCommit: 2b8f5d9a29f00aea5d2edfa78d1fb90c51752858
+  sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e
 ---
 
 {{APIRef("Pointer Events")}}

From 290b1a864c7615d40a635e771b00ac6b02b03bef Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Thu, 5 Sep 2024 23:33:02 +0900
Subject: [PATCH 010/115] =?UTF-8?q?2023/12/14=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../altitudeangle/azimuth_altitude_angles.svg | 18 +++++++
 .../api/pointerevent/altitudeangle/index.md   | 49 +++++++++++++++++++
 2 files changed, 67 insertions(+)
 create mode 100644 files/ja/web/api/pointerevent/altitudeangle/azimuth_altitude_angles.svg
 create mode 100644 files/ja/web/api/pointerevent/altitudeangle/index.md

diff --git a/files/ja/web/api/pointerevent/altitudeangle/azimuth_altitude_angles.svg b/files/ja/web/api/pointerevent/altitudeangle/azimuth_altitude_angles.svg
new file mode 100644
index 00000000000000..52d4ccaf0b3ef3
--- /dev/null
+++ b/files/ja/web/api/pointerevent/altitudeangle/azimuth_altitude_angles.svg
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg clip-rule="evenodd" stroke-linecap="round" stroke-linejoin="round" stroke-miterlimit="10" version="1.1" viewBox="0 0 567.66 536.1" xml:space="preserve" xmlns="http://www.w3.org/2000/svg">
+  <path d="M0 0h567.658v536.105H0V0Z" fill="#fff"/>
+  <path d="m137.08 389.54c0-35.62 62.296-64.495 139.14-64.495s139.14 28.875 139.14 64.495c0 35.619-62.296 64.494-139.14 64.494s-139.14-28.875-139.14-64.494z" fill="#d6d2d2"/>
+  <path d="m256.25 386.88c0-7.118 13.28-12.889 29.661-12.889s29.66 5.771 29.66 12.889-13.279 12.888-29.66 12.888-29.661-5.77-29.661-12.888z" fill="none" stroke="#1ec94b" stroke-dasharray="2" stroke-linecap="butt" stroke-width="2"/>
+  <path d="m110.84 200.98c0-4.917 2.955-8.903 6.6-8.903h291.78c3.645 0 6.6 3.986 6.6 8.903s-2.955 8.902-6.6 8.902h-291.78c-3.645 0-6.6-3.985-6.6-8.902z" fill="#e2e2e2"/>
+  <path d="m327.422 95.13 7.909-7.948c3.775-3.793 3.943-8.298.27-11.953l-3.492-3.595c-3.613-3.655-8.237-3.283-12.012.39l-7.909 7.888 15.234 15.218Zm-79.864 80.324 72.435-72.917-15.294-15.158-72.435 72.918-6.025 16.412c-1.193 3.246 2.057 6.061 4.878 5.033l16.441-6.288Z" fill="#726a6a"/>
+  <path d="m357.38 180.29c2.869-13.723 9.024-55.293-12.9-87.22" fill="none" stroke="#1e23c9" stroke-dasharray="2.711" stroke-linecap="butt" stroke-width="1.355"/>
+  <path d="m345.181 94.031 5.929.068-9.432-4.852 1.778 10.457 1.725-5.673Zm12.471 85.109-3.807-4.547 2.453 10.319 6.784-8.153-5.43 2.381Z" fill="#1e23c9"/><g fill="none" stroke-linecap="butt">
+  <path d="m275.29 156.37-27.63 28.549h39.949" stroke="#1e23c9" stroke-width="1.228"/>
+  <path d="m261.65 170.64c7.947 5.031 4.432 14.097 4.432 14.097" stroke="#1e23c9" stroke-width="1.228"/>
+  
+  <path d="m94.298 200.98h334.7m-78.739 135.79-152.26 104.66" stroke="#c91e3e" stroke-dasharray="2" stroke-width="2"/>
+  <path d="m163.39 350.82 238.49 65.255" stroke="#1ec9c7" stroke-dasharray="2" stroke-width="2"/>
+  </g><path d="m379.1 321.83 7.903-6.262c3.772-2.989 4.372-7.029 1.432-10.74l-2.784-3.637c-2.887-3.704-7.083-3.895-10.843-1.015l-7.898 6.208 12.19 15.446zm-79.819 63.292 72.4-57.463-12.249-15.399-72.401 57.464-7.051 14.103c-1.396 2.789 1.248 5.696 3.887 5.09l15.414-3.795z" fill="#726a6a" opacity=".667"/>
+  <path d="m251.62 425.82c25.527 3.681 122.45 13.608 117.38-48.87" fill="none" stroke="#1ec94b" stroke-dasharray="3.521" stroke-linecap="butt" stroke-width="1.761"/>
+  <path d="m369.19 378.48 6.701 3.799-7.683-11.439-4.541 13.01 5.523-5.37zm-116.06 47.584 5.534-5.358-13.141 4.146 11.201 8.025-3.594-6.813z" fill="#1ec94b"/><g fill="#726a6a" font-family="Sans" text-anchor="middle">
+<text x="441.33179" y="124.00669" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="441.33179" y="124.00669" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">高度角</tspan><tspan x="441.33179" y="147.34007" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">(Altitude angle)</tspan></text><text x="425.94598" y="444.20673" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="425.94598" y="444.20673" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">方位角</tspan><tspan x="425.94598" y="467.5401" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">(Azimuth angle)</tspan></text><text x="462.24237" y="208.61484" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="462.24237" y="208.61484" fill="#726a6a" font-family="Sans" font-size="18.667px" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">X 軸</tspan></text><text x="164.24571" y="465.02307" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="164.24571" y="465.02307" fill="#726a6a" font-family="Sans" font-size="18.667px" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">X 軸</tspan></text><text x="130.58543" y="336.59485" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="130.58543" y="336.59485" fill="#726a6a" font-family="Sans" font-size="18.667px" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">Y 軸</tspan></text></g></svg>
diff --git a/files/ja/web/api/pointerevent/altitudeangle/index.md b/files/ja/web/api/pointerevent/altitudeangle/index.md
new file mode 100644
index 00000000000000..192fed6f686487
--- /dev/null
+++ b/files/ja/web/api/pointerevent/altitudeangle/index.md
@@ -0,0 +1,49 @@
+---
+title: "PointerEvent: altitudeAngle プロパティ"
+short-title: altitudeAngle
+slug: Web/API/PointerEvent/altitudeAngle
+l10n:
+  sourceCommit: 6636dfb792a72346c68e44c9d042e3c2219e522b
+---
+
+{{ APIRef("Pointer Events") }}{{SeeCompatTable}}
+
+**`altitudeAngle`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用のプロパティで、トランスデューサー（ポインターまたはスタイラス）の軸と端末画面の X-Y 平面の間の角度を表します。
+高度角 (altitude angle) は、トランスデューサーが画面に対して垂直であるか、平行であるか、またはその中間の角度であるかを示します。
+
+特定のハードウェアやプラットフォームによっては、ユーザーエージェントが画面平面に相対するトランスデューサーの方向として、{{domxref("PointerEvent.tiltx", "tiltX")}} と {{domxref("PointerEvent.tilty", "tiltY")}}、または `altitudeAngle` と {{domxref("PointerEvent.azimuthAngle", "azimuthAngle")}} のいずれか一組の値しか受け取らない可能性があります。
+
+![ポインターの方位角と高度角の比較](./azimuth_altitude_angles.svg)
+
+このプロパティの追加の説明については、[仕様書の Figure 4](https://w3c.github.io/pointerevents/#figure_altitudeAngle) を参照してください。
+
+## 値
+
+`0` から `π/2` までのラジアンにおける角度で、`0` は機器の表面（X-Y 平面）と平行であり、 `π/2` は表面に対して垂直です。
+既定では `π/2`（表面に対して垂直）となり、[タッチイベントにおける `altitudeAngle`](https://w3c.github.io/touch-events/#dom-touch-altitudeangle) の既定値である `0`（表面に対して並列）とは異なります。傾きや角度を報告しないハードウェアやプラットフォームでは、値は `π/2` となります。
+
+## 例
+
+```js
+someElement.addEventListener(
+  "pointerdown",
+  (event) => {
+    process_angles(event.altitudeAngle, event.azimuthAngle);
+  },
+  false,
+);
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{ domxref("PointerEvent.azimuthAngle") }}
+- {{ domxref("PointerEvent.tiltX") }}
+- {{ domxref("PointerEvent.tiltY") }}

From ba651ec8438937e4221397c3570ea551fed253b1 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Thu, 5 Sep 2024 23:58:11 +0900
Subject: [PATCH 011/115] =?UTF-8?q?2023/12/14=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../azimuthangle/azimuth_altitude_angles.svg  | 18 +++++++
 .../api/pointerevent/azimuthangle/index.md    | 50 +++++++++++++++++++
 2 files changed, 68 insertions(+)
 create mode 100644 files/ja/web/api/pointerevent/azimuthangle/azimuth_altitude_angles.svg
 create mode 100644 files/ja/web/api/pointerevent/azimuthangle/index.md

diff --git a/files/ja/web/api/pointerevent/azimuthangle/azimuth_altitude_angles.svg b/files/ja/web/api/pointerevent/azimuthangle/azimuth_altitude_angles.svg
new file mode 100644
index 00000000000000..52d4ccaf0b3ef3
--- /dev/null
+++ b/files/ja/web/api/pointerevent/azimuthangle/azimuth_altitude_angles.svg
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg clip-rule="evenodd" stroke-linecap="round" stroke-linejoin="round" stroke-miterlimit="10" version="1.1" viewBox="0 0 567.66 536.1" xml:space="preserve" xmlns="http://www.w3.org/2000/svg">
+  <path d="M0 0h567.658v536.105H0V0Z" fill="#fff"/>
+  <path d="m137.08 389.54c0-35.62 62.296-64.495 139.14-64.495s139.14 28.875 139.14 64.495c0 35.619-62.296 64.494-139.14 64.494s-139.14-28.875-139.14-64.494z" fill="#d6d2d2"/>
+  <path d="m256.25 386.88c0-7.118 13.28-12.889 29.661-12.889s29.66 5.771 29.66 12.889-13.279 12.888-29.66 12.888-29.661-5.77-29.661-12.888z" fill="none" stroke="#1ec94b" stroke-dasharray="2" stroke-linecap="butt" stroke-width="2"/>
+  <path d="m110.84 200.98c0-4.917 2.955-8.903 6.6-8.903h291.78c3.645 0 6.6 3.986 6.6 8.903s-2.955 8.902-6.6 8.902h-291.78c-3.645 0-6.6-3.985-6.6-8.902z" fill="#e2e2e2"/>
+  <path d="m327.422 95.13 7.909-7.948c3.775-3.793 3.943-8.298.27-11.953l-3.492-3.595c-3.613-3.655-8.237-3.283-12.012.39l-7.909 7.888 15.234 15.218Zm-79.864 80.324 72.435-72.917-15.294-15.158-72.435 72.918-6.025 16.412c-1.193 3.246 2.057 6.061 4.878 5.033l16.441-6.288Z" fill="#726a6a"/>
+  <path d="m357.38 180.29c2.869-13.723 9.024-55.293-12.9-87.22" fill="none" stroke="#1e23c9" stroke-dasharray="2.711" stroke-linecap="butt" stroke-width="1.355"/>
+  <path d="m345.181 94.031 5.929.068-9.432-4.852 1.778 10.457 1.725-5.673Zm12.471 85.109-3.807-4.547 2.453 10.319 6.784-8.153-5.43 2.381Z" fill="#1e23c9"/><g fill="none" stroke-linecap="butt">
+  <path d="m275.29 156.37-27.63 28.549h39.949" stroke="#1e23c9" stroke-width="1.228"/>
+  <path d="m261.65 170.64c7.947 5.031 4.432 14.097 4.432 14.097" stroke="#1e23c9" stroke-width="1.228"/>
+  
+  <path d="m94.298 200.98h334.7m-78.739 135.79-152.26 104.66" stroke="#c91e3e" stroke-dasharray="2" stroke-width="2"/>
+  <path d="m163.39 350.82 238.49 65.255" stroke="#1ec9c7" stroke-dasharray="2" stroke-width="2"/>
+  </g><path d="m379.1 321.83 7.903-6.262c3.772-2.989 4.372-7.029 1.432-10.74l-2.784-3.637c-2.887-3.704-7.083-3.895-10.843-1.015l-7.898 6.208 12.19 15.446zm-79.819 63.292 72.4-57.463-12.249-15.399-72.401 57.464-7.051 14.103c-1.396 2.789 1.248 5.696 3.887 5.09l15.414-3.795z" fill="#726a6a" opacity=".667"/>
+  <path d="m251.62 425.82c25.527 3.681 122.45 13.608 117.38-48.87" fill="none" stroke="#1ec94b" stroke-dasharray="3.521" stroke-linecap="butt" stroke-width="1.761"/>
+  <path d="m369.19 378.48 6.701 3.799-7.683-11.439-4.541 13.01 5.523-5.37zm-116.06 47.584 5.534-5.358-13.141 4.146 11.201 8.025-3.594-6.813z" fill="#1ec94b"/><g fill="#726a6a" font-family="Sans" text-anchor="middle">
+<text x="441.33179" y="124.00669" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="441.33179" y="124.00669" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">高度角</tspan><tspan x="441.33179" y="147.34007" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">(Altitude angle)</tspan></text><text x="425.94598" y="444.20673" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="425.94598" y="444.20673" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">方位角</tspan><tspan x="425.94598" y="467.5401" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">(Azimuth angle)</tspan></text><text x="462.24237" y="208.61484" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="462.24237" y="208.61484" fill="#726a6a" font-family="Sans" font-size="18.667px" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">X 軸</tspan></text><text x="164.24571" y="465.02307" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="164.24571" y="465.02307" fill="#726a6a" font-family="Sans" font-size="18.667px" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">X 軸</tspan></text><text x="130.58543" y="336.59485" font-size="18.667px" text-align="center" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal" xml:space="preserve"><tspan x="130.58543" y="336.59485" fill="#726a6a" font-family="Sans" font-size="18.667px" style="font-variant-caps:normal;font-variant-east-asian:normal;font-variant-ligatures:normal;font-variant-numeric:normal">Y 軸</tspan></text></g></svg>
diff --git a/files/ja/web/api/pointerevent/azimuthangle/index.md b/files/ja/web/api/pointerevent/azimuthangle/index.md
new file mode 100644
index 00000000000000..f5617f6db4dd19
--- /dev/null
+++ b/files/ja/web/api/pointerevent/azimuthangle/index.md
@@ -0,0 +1,50 @@
+---
+title: "PointerEvent: azimuthAngle プロパティ"
+short-title: azimuthAngle
+slug: Web/API/PointerEvent/azimuthAngle
+l10n:
+  sourceCommit: 6636dfb792a72346c68e44c9d042e3c2219e522b
+---
+
+{{ APIRef("Pointer Events") }}{{SeeCompatTable}}
+
+**`azimuthAngle`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、 Y-Z 平面と、トランスデューサー（ポインターまたはスタイラス）の軸および Y 軸の両方を含む平面との間の角度を表します。
+
+特定のハードウェアやプラットフォームによっては、ユーザーエージェントが画面平面に相対するトランスデューサーの方向として、{{domxref("PointerEvent.tiltx", "tiltX")}} と {{domxref("PointerEvent.tilty", "tiltY")}}、または {{domxref("PointerEvent.altitudeAngle", "altitudeAngle")}} と `azimuthAngle` のいずれか一組の値しか受け取らない可能性があります。
+
+![ポインターの方位角と高度角の比較](./azimuth_altitude_angles.svg)
+
+このプロパティの追加の説明については、[仕様書の Figure 5](https://w3c.github.io/pointerevents/#figure_azimuthAngle) を参照してください。
+
+## 値
+
+`0` から `2π` までのラジアンによる角度で、`0` は X-Y 平面上で、キャップが X 値の増加方向（真下に見て「3 時」の方向）を向いているトランスデューサーを表します。時計回りに進むにつれて値が徐々に増加します（「6 時」の位置で`π/2`、「9 時」の位置で`π`、「12 時」の位置で`3π/2`）。
+
+トランスデューサーが表面に対して垂直（{{domxref("PointerEvent.altitudeAngle", "altitudeAngle")}} が `π/2`）の場合、値は 0 になります。
+傾きや角度を報告しないハードウェアやプラットフォームでは、値は `0` です。
+
+## 例
+
+```js
+someElement.addEventListener(
+  "pointerdown",
+  (event) => {
+    process_angles(event.altitudeAngle, event.azimuthAngle);
+  },
+  false,
+);
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{ domxref("PointerEvent.altitudeAngle") }}
+- {{ domxref("PointerEvent.tiltX") }}
+- {{ domxref("PointerEvent.tiltY") }}

From 4e0421f58f99d4a6ae75df2dc79338f51f6f0f82 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 6 Sep 2024 00:04:38 +0900
Subject: [PATCH 012/115] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pointerevent/height/index.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/files/ja/web/api/pointerevent/height/index.md b/files/ja/web/api/pointerevent/height/index.md
index 373b8734ae53d3..04726a3589a83e 100644
--- a/files/ja/web/api/pointerevent/height/index.md
+++ b/files/ja/web/api/pointerevent/height/index.md
@@ -1,25 +1,26 @@
 ---
-title: PointerEvent.height
+title: "PointerEvent: height プロパティ"
+short-title: height
 slug: Web/API/PointerEvent/height
 l10n:
-  sourceCommit: 4b4638246aad5d39b9a2e5c572b179b4c39c0a84
+  sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e
 ---
 
 {{ APIRef("Pointer Events") }}
 
-{{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティである **`height`** は、ポインターの接触ジオメトリーの高さを y 軸に従って表します (CSS ピクセル単位)。またポインターデバイスのソース (指など) によっては、与えられたポインターに対して、各イベントが異なる値を生成することがあります。
+**`height`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、ポインターの接触形状の y 軸方向の高さを（CSS ピクセル単位で）表します。またポインター機器のソース (指など) によっては、与えられたポインターに対して、各イベントが異なる値を生成することがあります。
 
-入力ハードウェアが接触ジオメトリーをブラウザーに報告できない場合、高さはデフォルトで `1` になります。
+入力ハードウェアが接触形状をブラウザーに報告できない場合、高さは既定で `1` になります。
 
 ## 値
 
-イベントの接触ジオメトリーの高さ (CSS ピクセル単位)。
+イベントの接触領域の高さ（CSS ピクセル単位）。
 
 ## 例
 
 このプロパティの例は [PointerEvent.width の例](/ja/docs/Web/API/PointerEvent/width#例)に含まれています。
 
-## 仕様
+## 仕様書
 
 {{Specifications}}
 

From 44ed6ba08cf7a76f2e5bf1bab4ea2996407a496b Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 6 Sep 2024 00:07:21 +0900
Subject: [PATCH 013/115] =?UTF-8?q?2024/07/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pointerevent/isprimary/index.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/files/ja/web/api/pointerevent/isprimary/index.md b/files/ja/web/api/pointerevent/isprimary/index.md
index 8752eb049395e2..142389502bca35 100644
--- a/files/ja/web/api/pointerevent/isprimary/index.md
+++ b/files/ja/web/api/pointerevent/isprimary/index.md
@@ -1,8 +1,9 @@
 ---
-title: PointerEvent.isPrimary
+title: "PointerEvent: isPrimary プロパティ"
+short-title: isPrimary
 slug: Web/API/PointerEvent/isPrimary
 l10n:
-  sourceCommit: c244d3b2cb6c17e6ba8692e3faec393afd9988ca
+  sourceCommit: c29cee3dcb0d0e66093dd0c18aa82e0eab9d6d14
 ---
 
 {{ APIRef("Pointer Events") }}
@@ -13,7 +14,7 @@ l10n:
 
 ポインターがマウスを表している場合、そのポインターが主と見なされます。 ペン入力を表すポインターは、その {{domxref("Element/pointerdown_event", "pointerdown")}} イベントが、ペン入力を表す他のアクティブなポインターがないときに送出された場合、主ペン入力と見なされます。タッチ入力を表すポインターは、その {{domxref("Element/pointerdown_event", "pointerdown")}} イベントが、タッチ入力を表す他のアクティブなポインターが存在しないときに送出された場合、主タッチ入力と見なされます。
 
-2 種類以上のポインター機器が同時に使用されている場合、複数のポインター（{{domxref("PointerEvent.pointerType", "pointerType")}} ごとに 1 つ）が主と見なされます。 例えば、タッチ接触とマウスカーソルが同時に動かされると、両方とも主と見なされるポインターが生成されます。 複数の主ポインターがある場合、これらのポインターはすべて*互換マウスイベント*を生成します（ポインター、マウス、およびタッチの相互作用の詳細については、{{domxref("Pointer_events", "ポインターイベント", "", 1)}} を参照）。
+2 種類以上のポインター機器が同時に使用されている場合、複数のポインター（{{domxref("PointerEvent.pointerType", "pointerType")}} ごとに 1 つ）が主と見なされます。 例えば、タッチ接触とマウスカーソルが同時に動かされると、両方とも主と見なされるポインターが生成されます。 複数の主ポインターがある場合、これらのポインターはすべて*互換マウスイベント*を生成します（ポインター、マウス、およびタッチの相互作用の詳細については、[ポインターイベント](/ja/docs/Web/API/Pointer_events)を参照）。
 
 ## 値
 

From 6894a3b6660902d5aa3e3432abc2de169e49ca72 Mon Sep 17 00:00:00 2001
From: yyss <yyss@users.noreply.github.com>
Date: Sat, 7 Sep 2024 12:51:35 +0900
Subject: [PATCH 014/115] =?UTF-8?q?Firefox=20130=20for=20developers=20?=
 =?UTF-8?q?=E3=82=92=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Sep 6, 2024 の英語版に対応。
---
 .../ja/mozilla/firefox/releases/130/index.md  | 75 +++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 files/ja/mozilla/firefox/releases/130/index.md

diff --git a/files/ja/mozilla/firefox/releases/130/index.md b/files/ja/mozilla/firefox/releases/130/index.md
new file mode 100644
index 00000000000000..e4ee83bc16d851
--- /dev/null
+++ b/files/ja/mozilla/firefox/releases/130/index.md
@@ -0,0 +1,75 @@
+---
+title: Firefox 130 for developers
+slug: Mozilla/Firefox/Releases/130
+l10n:
+  sourceCommit: 2cca85442dcfa50e82bffb7e2c0dbae4c5158256
+---
+
+{{FirefoxSidebar}}
+
+このページでは、開発者に影響する Firefox 130 の変更点をまとめています。Firefox 130 は、米国時間 [2024 年 9 月 3 日](https://whattrainisitnow.com/release/?version=130) にリリースされました。
+
+## ウェブ開発者向けの変更点一覧
+
+### HTML
+
+- `<details>` 要素の [`name`](/ja/docs/Web/HTML/Element/details#name) 属性で、`<details>` 要素のグループ化が可能になりました。グループの中で同時にひとつの要素だけを開くことができます。これにより、JavaScript を使用せずに排他的なアコーディオンを作成できます ([Firefox bug 1856460](https://bugzil.la/1856460)、[Firefox bug 1909613](https://bugzil.la/1909613))。
+- [シャドウ DOM](/ja/docs/Web/API/Web_components/Using_shadow_DOM#attribute_inheritance) における動作など、[`dir`](/ja/docs/Web/HTML/Global_attributes/dir) および [`lang`](/ja/docs/Web/HTML/Global_attributes/lang) [グローバル属性](/ja/docs/Web/HTML/Global_attributes) の継承を改良しました ([Firefox bug 1876163](https://bugzil.la/1876163))。
+
+### CSS
+
+- [`hyphens`](/ja/docs/Web/CSS/hyphens) CSS プロパティで、チェコ語とスロバキア語を適切にサポートしました。
+  特に、単語が音節で分けられることがなくなりました ([Firefox bug 1908931](https://bugzil.la/1908931))。
+
+### API
+
+- [X25519](/ja/docs/Web/API/SubtleCrypto/deriveKey#x25519) デジタル署名アルゴリズムを [Web Crypto API](/ja/docs/Web/API/Web_Crypto_API) でサポートして、{{domxref("SubtleCrypto")}} の {{domxref("SubtleCrypto.deriveKey()", "deriveKey()")}}、{{domxref("SubtleCrypto.deriveBits()", "deriveBits()")}}、{{domxref("SubtleCrypto.generateKey()", "generateKey()")}}、{{domxref("SubtleCrypto.importKey()", "importKey()")}}、{{domxref("SubtleCrypto.exportKey()", "exportKey()")}} メソッドで使用可能になりました ([Firefox bug 1904836](https://bugzil.la/1904836))。
+- [Web Codecs API](/ja/docs/Web/API/WebCodecs_API) をデスクトップ版でサポートしました。動画の個々のフレームや音声チャンクに対して、ウェブ開発者が低水準でアクセスできます。Android 版のサポートは Nightly リリースで有効です。新たに [`VideoEncoder`](/ja/docs/Web/API/VideoEncoder)、[`VideoDecoder`](/ja/docs/Web/API/VideoDecoder)、[`EncodedVideoChunk`](/ja/docs/Web/API/EncodedVideoChunk)、[`VideoFrame`](/ja/docs/Web/API/VideoFrame)、[`VideoColorSpace`](/ja/docs/Web/API/VideoColorSpace) インターフェイスをサポートしました ([Firefox bug 1908572](https://bugzil.la/1908572))。
+
+#### 廃止
+
+- {{domxref('WebGLRenderingContext.drawingBufferColorSpace')}} および [`WebGL2RenderingContext.drawingBufferColorSpace`](/ja/docs/Web/API/WebGL2RenderingContext) を [Firefox 127](/ja/docs/Mozilla/Firefox/Releases/127) で (実装がなく) 早期リリースしていましたが、削除しました ([Firefox bug 1909559](https://bugzil.la/1909559))。
+
+### WebAssembly
+
+#### 一般
+
+- デフォルトでシステムアドオンが完全に無効化されるようになりました ([Firefox bug 1904310](https://bugzil.la/1904310))。
+- Android で、内部プロンプトリスナーが適切なユーザープロンプトを正しく選択するように不具合を修正しました ([Firefox bug 1902264](https://bugzil.la/1902264))。
+
+#### WebDriver BiDi
+
+- ナビゲーションの試行が完了しないときに発生する、`browsingContext.navigationFailed` イベントをサポートしました ([Firefox bug 1846601](https://bugzil.la/1846601))。
+- `network.setCacheBehavior` コマンドで、ネットワークキャッシュの動作をグローバルおよび個々のナビゲーブルの両方で同時に定義可能になりました ([Firefox bug 1905307](https://bugzil.la/1905307))。
+- `network.responseCompleted` および `network.fetchError` イベントが実際のリクエストが停止したときに発生するようになり、`network.responseCompleted` イベントの前に `browsingContext.domContentLoaded` および `browsingContext.load` イベントが発生する競合状態が解消しました ([Firefox bug 1882803](https://bugzil.la/1882803))。
+- Data URL (たとえば背景画像やフェッチ要求のため) を、すべてのネットワークイベントにわたって完全にサポートしました ([Firefox bug 1904343](https://bugzil.la/1904343))。
+- `network.continueWithAuth` コマンドを呼び出すごとに、`network.authRequired` イベントが複数回送信される不具合を修正しました ([Firefox bug 1899711](https://bugzil.la/1899711))。
+
+#### Marionette
+
+- 要素がまた表示されていない場合に限りスクロールして表示するように、`WebDriver:ElementSendKeys` の不具合を修正しました ([Firefox bug 1906095](https://bugzil.la/1906095))。
+
+## アドオン開発者向けの変更点一覧
+
+- {{WebExtAPIRef("webRequest.getSecurityInfo")}} の引数 `options` が省略可能になりました ([Firefox bug 1909474](https://bugzil.la/1909474))。
+- {{WebExtAPIRef("runtime.getURL")}} (および非推奨の {{WebExtAPIRef("extension.getURL")}}) が、追加の正規化を行わずに拡張機能のオリジンを常にパスの先頭へ追加するようになりました。以前は絶対 URL が与えられたときに、相対的な URL ではなく絶対 URL を返していました ([Firefox bug 1795082](https://bugzil.la/1795082))。
+
+## 実験的なウェブ機能
+
+以下の機能は Firefox 130 で新たに導入しましたが、デフォルトで無効です。これらを実験するには、`about:config` ページで適切な設定項目を検索して `true` に設定してください。[実験的機能](/ja/docs/Mozilla/Firefox/Experimental_features) のページで、さらに多くの機能を確認できます。
+
+- **動画フレームのコールバックを要求する:** `media.rvfc.enabled`。
+
+  {{domxref('HTMLVideoElement')}} インターフェイスの {{domxref('HTMLVideoElement/requestVideoFrameCallback','requestVideoFrameCallback()')}} メソッドは、新しい動画フレームがコンポジターへ送信されたときに実行するコールバック関数を登録します。これは動画の分析、キャンバスへの描画、外部音声ソースとの同期など、開発者がそれぞれの動画フレームで効率的に処理を行うことを可能にします。このメソッドは、未処理のコールバック要求をキャンセルするために {{domxref('HTMLVideoElement.cancelVideoFrameCallback()')}} へ渡すことができるコールバックハンドラーを返します。
+  どちらのメソッドも、Nightly ビルドではデフォルトで使用可能です ([Firefox bug 1800882](https://bugzil.la/1800882))。
+
+- **Reporting API を使用した CSP 違反報告:** `dom.reporting.enabled`。
+
+  [Content Security Policy (CSP)](/ja/docs/Web/HTTP/CSP) 違反の報告に [Reporting API](/ja/docs/Web/API/Reporting_API) が使用可能になりました。
+  これは値が `"csp-violation"` である `type` プロパティと {{domxref('CSPViolationReportBody')}} のインスタンスである `body` プロパティを持つ {{domxref('Report')}} オブジェクト、{{httpheader('Content-Security-Policy')}} HTTP レスポンスヘッダーの {{CSP("report-to")}} ディレクティブ、{{httpheader('Reporting-Endpoints')}} HTTP レスポンスヘッダー、{{httpheader('Report-To')}} HTTP レスポンスヘッダーのサポートを含みます。
+  この機能はデフォルトで無効です 
+  ([Firefox bug 1391243](https://bugzil.la/1391243))。
+
+## 過去のバージョン
+
+{{Firefox_for_developers}}

From 58d8104ea5dbcc543b53d1d41b2467503d467f13 Mon Sep 17 00:00:00 2001
From: yyss <yyss@users.noreply.github.com>
Date: Sat, 7 Sep 2024 12:54:38 +0900
Subject: [PATCH 015/115] Update index.md

---
 files/ja/mozilla/firefox/releases/130/index.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/files/ja/mozilla/firefox/releases/130/index.md b/files/ja/mozilla/firefox/releases/130/index.md
index e4ee83bc16d851..c8dda68123f7cf 100644
--- a/files/ja/mozilla/firefox/releases/130/index.md
+++ b/files/ja/mozilla/firefox/releases/130/index.md
@@ -67,8 +67,7 @@ l10n:
 
   [Content Security Policy (CSP)](/ja/docs/Web/HTTP/CSP) 違反の報告に [Reporting API](/ja/docs/Web/API/Reporting_API) が使用可能になりました。
   これは値が `"csp-violation"` である `type` プロパティと {{domxref('CSPViolationReportBody')}} のインスタンスである `body` プロパティを持つ {{domxref('Report')}} オブジェクト、{{httpheader('Content-Security-Policy')}} HTTP レスポンスヘッダーの {{CSP("report-to")}} ディレクティブ、{{httpheader('Reporting-Endpoints')}} HTTP レスポンスヘッダー、{{httpheader('Report-To')}} HTTP レスポンスヘッダーのサポートを含みます。
-  この機能はデフォルトで無効です 
-  ([Firefox bug 1391243](https://bugzil.la/1391243))。
+  この機能はデフォルトで無効です ([Firefox bug 1391243](https://bugzil.la/1391243))。
 
 ## 過去のバージョン
 

From 5e4da8143a0cb4b9a7df9d9fc65534b7150c0823 Mon Sep 17 00:00:00 2001
From: Minoru Takai <main.coeurl@gmail.com>
Date: Sat, 7 Sep 2024 19:21:53 +0900
Subject: [PATCH 016/115] =?UTF-8?q?typo=20=E3=82=92=E4=BF=AE=E6=AD=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/html/attributes/disabled/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/ja/web/html/attributes/disabled/index.md b/files/ja/web/html/attributes/disabled/index.md
index dd5dd921d31bb4..7a5822239e5fb5 100644
--- a/files/ja/web/html/attributes/disabled/index.md
+++ b/files/ja/web/html/attributes/disabled/index.md
@@ -47,7 +47,7 @@ Firefox は他のブラウザーとは異なり、ページを再読み込みし
 
 ## 例
 
-フォームコントロールが無効になったとき、多くのブラウザーは既定で、より薄いグレーアウトした色で表示します。ここでは、無効になったチェックボックス、ラジオボタン、 {{ HTMLElement("option") }} と {{ HTMLElement("optgroup") }} の例と、祖先の {{HTMLElement("fieldset")}} 要素に設定された disabled 属性によって無効にされているいくつかのフォーム制御の例を示します。 {{ HTMLElement("option") }} は無効になっていますが、 {{ HTMLElement("select") }} 自体は無効になっていません。 {{ HTMLElement("select") }} 是t内を無効にするには、子孫ではなく、その要素にこの属性を追加します。
+フォームコントロールが無効になったとき、多くのブラウザーは既定で、より薄いグレーアウトした色で表示します。ここでは、無効になったチェックボックス、ラジオボタン、 {{ HTMLElement("option") }} と {{ HTMLElement("optgroup") }} の例と、祖先の {{HTMLElement("fieldset")}} 要素に設定された disabled 属性によって無効にされているいくつかのフォーム制御の例を示します。 {{ HTMLElement("option") }} は無効になっていますが、 {{ HTMLElement("select") }} 自体は無効になっていません。 {{ HTMLElement("select") }} 自体を無効にするには、子孫ではなく、その要素にこの属性を追加します。
 
 ```html-nolint
 <fieldset>

From de272ae41eaa12764e39d05f0dbd0961609d2106 Mon Sep 17 00:00:00 2001
From: Leonid Vinogradov <win.leon@protonmail.com>
Date: Mon, 9 Sep 2024 22:42:14 +0300
Subject: [PATCH 017/115] [ru] remove deprecated `{{no_tag_omission}}` macro
 usages (#23477)

* [ru] remove deprecated {{no_tag_omission}} macro usages

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 files/ru/web/html/element/abbr/index.md             | 2 +-
 files/ru/web/html/element/address/index.md          | 2 +-
 files/ru/web/html/element/article/index.md          | 2 +-
 files/ru/web/html/element/aside/index.md            | 2 +-
 files/ru/web/html/element/b/index.md                | 2 +-
 files/ru/web/html/element/bdi/index.md              | 2 +-
 files/ru/web/html/element/bdo/index.md              | 2 +-
 files/ru/web/html/element/blockquote/index.md       | 2 +-
 files/ru/web/html/element/button/index.md           | 2 +-
 files/ru/web/html/element/canvas/index.md           | 2 +-
 files/ru/web/html/element/cite/index.md             | 2 +-
 files/ru/web/html/element/code/index.md             | 2 +-
 files/ru/web/html/element/data/index.md             | 2 +-
 files/ru/web/html/element/datalist/index.md         | 2 +-
 files/ru/web/html/element/del/index.md              | 2 +-
 files/ru/web/html/element/details/index.md          | 2 +-
 files/ru/web/html/element/dfn/index.md              | 2 +-
 files/ru/web/html/element/dialog/index.md           | 2 +-
 files/ru/web/html/element/dl/index.md               | 2 +-
 files/ru/web/html/element/em/index.md               | 2 +-
 files/ru/web/html/element/fieldset/index.md         | 2 +-
 files/ru/web/html/element/figcaption/index.md       | 2 +-
 files/ru/web/html/element/figure/index.md           | 2 +-
 files/ru/web/html/element/footer/index.md           | 2 +-
 files/ru/web/html/element/header/index.md           | 2 +-
 files/ru/web/html/element/heading_elements/index.md | 2 +-
 files/ru/web/html/element/ins/index.md              | 2 +-
 files/ru/web/html/element/kbd/index.md              | 2 +-
 files/ru/web/html/element/label/index.md            | 2 +-
 files/ru/web/html/element/legend/index.md           | 2 +-
 files/ru/web/html/element/map/index.md              | 2 +-
 files/ru/web/html/element/mark/index.md             | 2 +-
 files/ru/web/html/element/menu/index.md             | 2 +-
 files/ru/web/html/element/meter/index.md            | 2 +-
 files/ru/web/html/element/nav/index.md              | 2 +-
 files/ru/web/html/element/noscript/index.md         | 2 +-
 files/ru/web/html/element/ol/index.md               | 2 +-
 files/ru/web/html/element/output/index.md           | 2 +-
 files/ru/web/html/element/picture/index.md          | 2 +-
 files/ru/web/html/element/pre/index.md              | 2 +-
 files/ru/web/html/element/progress/index.md         | 2 +-
 files/ru/web/html/element/ruby/index.md             | 2 +-
 files/ru/web/html/element/slot/index.md             | 2 +-
 files/ru/web/html/element/span/index.md             | 2 +-
 files/ru/web/html/element/style/index.md            | 2 +-
 files/ru/web/html/element/template/index.md         | 2 +-
 files/ru/web/html/element/time/index.md             | 2 +-
 files/ru/web/html/element/ul/index.md               | 2 +-
 files/ru/web/html/element/video/index.md            | 2 +-
 49 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/files/ru/web/html/element/abbr/index.md b/files/ru/web/html/element/abbr/index.md
index 2466c99cdcdbdc..3e2fb04bd4b188 100644
--- a/files/ru/web/html/element/abbr/index.md
+++ b/files/ru/web/html/element/abbr/index.md
@@ -14,7 +14,7 @@ slug: Web/HTML/Element/abbr
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [текстовый контент](/ru/docs/Web/Guide/HTML/Content_categories/#Фразовый_контент), явный контент |
 | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories/#Фразовый_контент)                                                                                              |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                           |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                              |
 | Допустимые родители                                              | Любые, поддерживающие [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories/#Фразовый_контент).                                                                       |
 | Допустимые ARIA-роли                                             | Любые                                                                                                                                                                         |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                                                                                                                                                    |
diff --git a/files/ru/web/html/element/address/index.md b/files/ru/web/html/element/address/index.md
index a02bffed241066..671edba785aa69 100644
--- a/files/ru/web/html/element/address/index.md
+++ b/files/ru/web/html/element/address/index.md
@@ -10,7 +10,7 @@ slug: Web/HTML/Element/address
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#%D0%9E%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D0%BE%D0%B9_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA), palpable content.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Разрешённый контент                                    | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#%D0%9E%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D0%BE%D0%B9_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA), но без вложенного элемента \<address>, без элементов заголовка ({{HTMLElement("hgroup")}}, {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}}), без секционного контента ({{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("section")}}, {{HTMLElement("nav")}}) и без {{HTMLElement("header")}} или {{HTMLElement("footer")}} элементов. |
-| Опускание тегов                                        | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| Опускание тегов                                        | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | Разрешённые родительские элементы                      | Любой элемент, который принимает [flow content](/ru/docs/HTML/Content_categories#Flow_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | DOM интерфейс                                          | {{domxref("HTMLElement")}} Prior to Gecko 2.0 (Firefox 4), Gecko implemented this element using the {{domxref("HTMLSpanElement")}} interface                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 
diff --git a/files/ru/web/html/element/article/index.md b/files/ru/web/html/element/article/index.md
index 6626626272b92a..6825e7c010f6b5 100644
--- a/files/ru/web/html/element/article/index.md
+++ b/files/ru/web/html/element/article/index.md
@@ -14,7 +14,7 @@ slug: Web/HTML/Element/article
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [секционный контент](/ru/docs/Web/Guide/HTML/Content_categories#Секционный_контент), [явный контент](/ru/docs/Web/Guide/HTML/Content_categories#Явный_контент).                                                                                                                                                                                                                                                                                                   |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток).                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | Допустимые родители                                              | Любой элемент, который разрешает [контент основного потока](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток) в качестве содержимого. Обратите внимание, что элемент `<article>` не должен быть потомком элемента {{HTMLElement("address")}}.                                                                                                                                                                                                                                                                                         |
 | Допустимые ARIA-роли                                             | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/application_role">application</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/document_role">document</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/feed_role">feed</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/main_role">main</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/region_role">region</a></code> |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
diff --git a/files/ru/web/html/element/aside/index.md b/files/ru/web/html/element/aside/index.md
index 5d4031dcea68a1..481688c5a744ce 100644
--- a/files/ru/web/html/element/aside/index.md
+++ b/files/ru/web/html/element/aside/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/aside
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [секционный контент](/ru/docs/Web/Guide/HTML/Content_categories#Секционный_контент), [явный контент](/ru/docs/Web/Guide/HTML/Content_categories#Явный_контент).                                                                                                                                                                                                |
 | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток).                                                                                                                                                                                                                                                                                                                                                                |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                            |
 | Допустимые родители                                              | Любой элемент, который разрешает [контент основного потока](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток) в качестве содержимого. Обратите внимание, что элемент `<aside>` не должен быть потомком элемента {{HTMLElement("address")}}.                                                                                                                                                                                        |
 | Допустимые ARIA-роли                                             | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/feed_role">feed</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/note_role">note</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/region_role">region</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/search_role">search</a></code> |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                                                                                                                                                                                                                                                                                                                                                                                                                  |
diff --git a/files/ru/web/html/element/b/index.md b/files/ru/web/html/element/b/index.md
index 9851a64f02ea18..359de0eedd65be 100644
--- a/files/ru/web/html/element/b/index.md
+++ b/files/ru/web/html/element/b/index.md
@@ -10,7 +10,7 @@ slug: Web/HTML/Element/b
 | [Content categories](/ru/docs/HTML/Content_categories) | [Flow content](/ru/docs/HTML/Content_categories#Flow_content), [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content), palpable content.       |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Разрешённый контент                                    | [Phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                        |
-| Tag omission                                           | {{no_tag_omission}}                                                                                                                                           |
+| Tag omission                                           | Нет, открывающий и закрывающий теги обязательны.                                                                                                              |
 | Permitted parents                                      | Any element that accepts [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                               |
 | Permitted ARIA roles                                   | Any                                                                                                                                                           |
 | DOM interface                                          | {{domxref("HTMLElement")}} Up to Gecko 1.9.2 (Firefox 4) inclusive, Firefox implements the [`HTMLSpanElement`](/ru/docs/DOM/span) interface for this element. |
diff --git a/files/ru/web/html/element/bdi/index.md b/files/ru/web/html/element/bdi/index.md
index bf698961ff1ec9..3b644517873c13 100644
--- a/files/ru/web/html/element/bdi/index.md
+++ b/files/ru/web/html/element/bdi/index.md
@@ -17,7 +17,7 @@ slug: Web/HTML/Element/bdi
 | [Content categories](/ru/docs/HTML/Content_categories) | [Flow content](/ru/docs/HTML/Content_categories#Flow_content), [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content), palpable content. |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Permitted content                                      | [Phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                  |
-| Tag omission                                           | {{no_tag_omission}}                                                                                                                                     |
+| Tag omission                                           | Нет, открывающий и закрывающий теги обязательны.                                                                                                        |
 | Permitted parent elements                              | Any element that accepts [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                         |
 | DOM interface                                          | {{domxref("HTMLElement")}}                                                                                                                              |
 
diff --git a/files/ru/web/html/element/bdo/index.md b/files/ru/web/html/element/bdo/index.md
index 9582bbc4f50128..78ec144373bbcd 100644
--- a/files/ru/web/html/element/bdo/index.md
+++ b/files/ru/web/html/element/bdo/index.md
@@ -14,7 +14,7 @@ slug: Web/HTML/Element/bdo
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Потоковый контент](/ru/docs/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content), palpable content.              |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                     | [Фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                                    |
-| Закрывающий тег                                        | {{no_tag_omission}}                                                                                                                                                       |
+| Закрывающий тег                                        | Нет, открывающий и закрывающий теги обязательны.                                                                                                                          |
 | Допустимые родители                                    | Все элементы, принимающие [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content),                                                                          |
 | Допустимые ARIA-роли                                   | Любые                                                                                                                                                                     |
 | DOM-интерфейс                                          | {{domxref("HTMLElement")}} до Gecko 1.9.2 (Firefox 4) включительно, Firefox реализует интерфейс [`HTMLSpanElement`](/ru/docs/Web/API/HTMLSpanElement) для этого элемента. |
diff --git a/files/ru/web/html/element/blockquote/index.md b/files/ru/web/html/element/blockquote/index.md
index 470eb8ed670524..b66c4639a1a460 100644
--- a/files/ru/web/html/element/blockquote/index.md
+++ b/files/ru/web/html/element/blockquote/index.md
@@ -14,7 +14,7 @@ slug: Web/HTML/Element/blockquote
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной контент](/ru/docs/Web/Guide/HTML/Content_categories#Основной_контент), секционный корень, явный контент. |
 | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
 | Допустимое содержимое                                            | [Основной контент](/ru/docs/Web/Guide/HTML/Content_categories#Основной_контент).                                   |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                   |
 | Допустимые родители                                              | Любой элемент, который принимает [основной контент](/ru/docs/Web/Guide/HTML/Content_categories#Основной_контент).  |
 | Допустимые ARIA-роли                                             | Любые                                                                                                              |
 | DOM-интерфейс                                                    | {{domxref("HTMLQuoteElement")}}                                                                                    |
diff --git a/files/ru/web/html/element/button/index.md b/files/ru/web/html/element/button/index.md
index d006d580df9dfa..7ef5af6b5795e6 100644
--- a/files/ru/web/html/element/button/index.md
+++ b/files/ru/web/html/element/button/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/button
 | [Категории контента](/ru/docs/HTML/Content_categories/) | [Общий поток](/ru/docs/HTML/Content_categories#Flow_content), [текстовый контент](/ru/docs/HTML/Content_categories#Phrasing_content), [интерактивный контент](/ru/docs/HTML/Content_categories#Interactive_content), [listed](/ru/docs/HTML/Content_categories#Form_listed), [labelable](/ru/docs/HTML/Content_categories#Form_labelable), и [submittable](/ru/docs/HTML/Content_categories#Form_submittable) [form-associated](/ru/docs/HTML/Content_categories#Form-associated_) элемент, очевидный контент.                                                                                                                                                                                                                       |
 | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Допустимое содержимое                                   | [Текстовый контент](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| Пропуск тегов                                           | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| Пропуск тегов                                           | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | Допустимые родители                                     | Любой элемент с поддержкой [текстового контента](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | Допустимые ARIA-роли                                    | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/checkbox_role">checkbox</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/link_role">link</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menuitem_role">menuitem</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menuitemcheckbox_role">menuitemcheckbox</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menuitemradio_role">menuitemradio</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/radio_role">radio</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/switch_role">switch</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/tab_role">tab</a></code> |
 | DOM-интерфейс                                           | {{domxref("HTMLButtonElement")}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
diff --git a/files/ru/web/html/element/canvas/index.md b/files/ru/web/html/element/canvas/index.md
index 09e59ebca298eb..08c0df7749a657 100644
--- a/files/ru/web/html/element/canvas/index.md
+++ b/files/ru/web/html/element/canvas/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/canvas
 | [Content categories](/ru/docs/HTML/Content_categories) | [Flow content](/ru/docs/HTML/Content_categories#Flow_content), [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content), [embedded content](/ru/docs/HTML/Content_categories#Embedded_content), palpable content.                                                                                                            |
 | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Permitted content                                      | Transparent но без [interactive content](/ru/docs/HTML/Content_categories#Interactive_content) descendants except(соглашаться?) для {{HTMLElement("a")}} элементы, {{HTMLElement("button")}} элементы, {{HTMLElement("input")}} элементы как [`type`](/ru/docs/Web/HTML/Element/input#type) атрибут is `checkbox`, `radio`, или `button`. |
-| Tag omission                                           | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                       |
+| Tag omission                                           | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                          |
 | Permitted parent elements                              | Any element that accepts [phrasing_content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                                                                                                                                                                           |
 | DOM interface                                          | {{domxref("HTMLCanvasElement")}}                                                                                                                                                                                                                                                                                                          |
 
diff --git a/files/ru/web/html/element/cite/index.md b/files/ru/web/html/element/cite/index.md
index 70a217bf486ce5..956400341d53a3 100644
--- a/files/ru/web/html/element/cite/index.md
+++ b/files/ru/web/html/element/cite/index.md
@@ -18,7 +18,7 @@ slug: Web/HTML/Element/cite
 | [Content categories](/ru/docs/HTML/Content_categories) | [Flow content](/ru/docs/HTML/Content_categories#Flow_content), [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content), palpable content. |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Permitted content                                      | [Phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                  |
-| Tag omission                                           | {{no_tag_omission}}                                                                                                                                     |
+| Tag omission                                           | Нет, открывающий и закрывающий теги обязательны.                                                                                                        |
 | Permitted parent elements                              | Any element that accepts [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                         |
 | DOM interface                                          | {{domxref("HTMLElement")}} Up to Gecko 1.9.2 (Firefox 4) inclusive, Firefox implements the {{domxref("HTMLSpanElement")}} interface for this element.   |
 
diff --git a/files/ru/web/html/element/code/index.md b/files/ru/web/html/element/code/index.md
index 1473b232b2e6f5..44689d899b44f1 100644
--- a/files/ru/web/html/element/code/index.md
+++ b/files/ru/web/html/element/code/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/code
 | [Content categories](/ru/docs/Web/HTML/Content_categories) | [Flow content](/ru/docs/Web/HTML/Content_categories#Flow_content), [phrasing content](/ru/docs/Web/HTML/Content_categories#Phrasing_content), palpable content. |
 | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Permitted content                                          | [Phrasing content](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                                                      |
-| Tag omission                                               | {{no_tag_omission}}                                                                                                                                             |
+| Tag omission                                               | Нет, открывающий и закрывающий теги обязательны.                                                                                                                |
 | Permitted parents                                          | Any element that accepts [phrasing content](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                             |
 | Implicit ARIA role                                         | [No corresponding role](https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role)                                                                             |
 | Permitted ARIA roles                                       | Any                                                                                                                                                             |
diff --git a/files/ru/web/html/element/data/index.md b/files/ru/web/html/element/data/index.md
index 37bc6aece33471..c218c8a33a2fb1 100644
--- a/files/ru/web/html/element/data/index.md
+++ b/files/ru/web/html/element/data/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/data
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/Guide/HTML/Content_categories#Потоковый_контент), [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content), явный контент. |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Разрешённое содержимое                                           | [Фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content).                                                                                                   |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                   |
 | Разрешённые родители                                             | Любой элемент который принимает [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content).                                                                   |
 | DOM-интерфейс                                                    | {{domxref("HTMLDataElement")}}                                                                                                                                                     |
 
diff --git a/files/ru/web/html/element/datalist/index.md b/files/ru/web/html/element/datalist/index.md
index af6a029d7035bd..369dd4f40aad3b 100644
--- a/files/ru/web/html/element/datalist/index.md
+++ b/files/ru/web/html/element/datalist/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/datalist
 | [Категория контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/Guide/HTML/Content_categories#Потоковый_контент), [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content). |
 | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | Либо фразовый контент, либо ноль или более элементов {{HTMLElement("option")}}.                                                                                     |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                 |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                    |
 | Допустимые родители                                              | Любой элемент, который может содержать [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content).                                             |
 | Допустимые ARIA-роли                                             | Нет                                                                                                                                                                 |
 | DOM-интерфейс                                                    | {{domxref("HTMLDataListElement")}}                                                                                                                                  |
diff --git a/files/ru/web/html/element/del/index.md b/files/ru/web/html/element/del/index.md
index 26107b6a7d5bb0..fc107094d4bb5c 100644
--- a/files/ru/web/html/element/del/index.md
+++ b/files/ru/web/html/element/del/index.md
@@ -14,7 +14,7 @@ slug: Web/HTML/Element/del
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content) или [потоковый контент](/ru/docs/HTML/Content_categories#Flow_content). |
 | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                  | [Прозрачный](/ru/docs/HTML/Content_categories#Transparent_content_model).                                                                     |
-| Пропуск тегов                                          | {{no_tag_omission}}                                                                                                                           |
+| Пропуск тегов                                          | Нет, открывающий и закрывающий теги обязательны.                                                                                              |
 | Допустимые родители                                    | Любой элемент, который принимает [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content).                                       |
 | Допустимые ARIA-роли                                   | Любые                                                                                                                                         |
 | DOM-интерфейс                                          | {{domxref("HTMLModElement")}}                                                                                                                 |
diff --git a/files/ru/web/html/element/details/index.md b/files/ru/web/html/element/details/index.md
index e6c6c28c075f34..39756be0190fa0 100644
--- a/files/ru/web/html/element/details/index.md
+++ b/files/ru/web/html/element/details/index.md
@@ -14,7 +14,7 @@ HTML-элемент **`<details>`** используется для раскры
 | [Content categories](/ru/docs/Web/HTML/Content_categories) | [Flow content](/ru/docs/Web/HTML/Content_categories#Flow_content), sectioning root, interactive content, palpable content. |
 | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
 | Permitted content                                          | One {{HTMLElement("summary")}} element followed by [flow content](/ru/docs/Web/HTML/Content_categories#Flow_content).      |
-| Tag omission                                               | {{no_tag_omission}}                                                                                                        |
+| Tag omission                                               | Нет, открывающий и закрывающий теги обязательны.                                                                           |
 | Permitted parents                                          | Any element that accepts [flow content](/ru/docs/Web/HTML/Content_categories#Flow_content).                                |
 | Permitted ARIA roles                                       | None                                                                                                                       |
 | DOM interface                                              | {{domxref("HTMLDetailsElement")}}                                                                                          |
diff --git a/files/ru/web/html/element/dfn/index.md b/files/ru/web/html/element/dfn/index.md
index a2f0a4ca8ee6ab..439de22d719539 100644
--- a/files/ru/web/html/element/dfn/index.md
+++ b/files/ru/web/html/element/dfn/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/dfn
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), явный контент. |
 | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                         | [Фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), но ни один {{HTMLElement("dfn")}} элемент не должен быть потомком.                     |
-| Пропуск тега                                               | {{no_tag_omission}}                                                                                                                                               |
+| Пропуск тега                                               | Нет, открывающий и закрывающий теги обязательны.                                                                                                                  |
 | Допустимые родители                                        | Любой элемент, который принимает [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                       |
 | Допустимые ARIA-роли                                       | Любые                                                                                                                                                             |
 | DOM-интерфейс                                              | {{domxref("HTMLElement")}}                                                                                                                                        |
diff --git a/files/ru/web/html/element/dialog/index.md b/files/ru/web/html/element/dialog/index.md
index f701c543b36224..0959d9469c37a7 100644
--- a/files/ru/web/html/element/dialog/index.md
+++ b/files/ru/web/html/element/dialog/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/dialog
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [секционный контент](/ru/docs/Web/Guide/HTML/Content_categories#Секционный_контент) |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Разрешённый контент                                              | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток)                                                                                      |
-| Опускание тегов                                                  | {{no_tag_omission}}                                                                                                                                              |
+| Опускание тегов                                                  | Нет, открывающий и закрывающий теги обязательны.                                                                                                                 |
 | Разрешённые родительские элементы                                | Любой элемент, в котором разрешён [основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток)                                                    |
 | DOM-интерфейс                                                    | {{domxref("HTMLDialogElement")}}                                                                                                                                 |
 
diff --git a/files/ru/web/html/element/dl/index.md b/files/ru/web/html/element/dl/index.md
index 8ee8c4b65959c2..b6d516e7963fee 100644
--- a/files/ru/web/html/element/dl/index.md
+++ b/files/ru/web/html/element/dl/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/dl
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/Guide/HTML/Content_categories#Потоковый_контент), и если потомки элемента `<dl>` включают одну группу имя-значение явный контент.                                                                                                                                                                                                                                                             |
 | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Допустимое содержимое                                            | Либо: Ноль или более групп каждая из которых состоит из одного или более элементов {{HTMLElement("dt")}} за которым следует один или более элементов {{HTMLElement("dd")}}, необязательно смешанных с элементами {{HTMLElement("script")}} и {{HTMLElement("template")}}. Либо: Один или более элементов {{HTMLElement("div")}}, необязательно смешанных с элементами {{HTMLElement("script")}} и {{HTMLElement("template")}}. |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                            |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                               |
 | Допустимые родители                                              | Любой элемент который принимает [потоковый контент](/ru/docs/Web/Guide/HTML/Content_categories#Потоковый_контент).                                                                                                                                                                                                                                                                                                             |
 | Допустимые ARIA-роли                                             | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>                                                                                                                                                                                                                                             |
 | DOM-интерфейс                                                    | {{domxref("HTMLDListElement")}}                                                                                                                                                                                                                                                                                                                                                                                                |
diff --git a/files/ru/web/html/element/em/index.md b/files/ru/web/html/element/em/index.md
index bf318efa89c332..d5f3190a78f5da 100644
--- a/files/ru/web/html/element/em/index.md
+++ b/files/ru/web/html/element/em/index.md
@@ -10,7 +10,7 @@ slug: Web/HTML/Element/em
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), явный контент. |
 | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                         | [Фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                                                        |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                               |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                                  |
 | Допустимые родители                                        | Любой элемент, который принимает [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                       |
 | Допустимые ARIA-роли                                       | Любые                                                                                                                                                             |
 | DOM-интерфейс                                              | {{domxref ("HTMLElement")}} до Gecko 1.9.2 (Firefox 4) включительно Firefox реализует интерфейс {{domxref ("HTMLSpanElement")}} для этого элемента.               |
diff --git a/files/ru/web/html/element/fieldset/index.md b/files/ru/web/html/element/fieldset/index.md
index fadd253f053acf..b26e09c562e2aa 100644
--- a/files/ru/web/html/element/fieldset/index.md
+++ b/files/ru/web/html/element/fieldset/index.md
@@ -77,7 +77,7 @@ slug: Web/HTML/Element/fieldset
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#%D0%9E%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D0%BE%D0%B9_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA), [корневой раздел](/ru/docs/Web/Guide/HTML/Sections_and_Outlines_of_an_HTML5_document), [listed](/ru/docs/HTML/Content_categories#form_listed), [контент форм](/ru/docs/Web/Guide/HTML/Content_categories#%D0%9A%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82_%D1%84%D0%BE%D1%80%D0%BC), явный контент. |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                  | Необязательный элемент {{HTMLElement("legend")}}, следующий в основном потоке.                                                                                                                                                                                                                                                                                                                                                              |
-| Пропуск тегов                                          | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Пропуск тегов                                          | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                            |
 | Допустимые родители                                    | Любой элемент основного потока                                                                                                                                                                                                                                                                                                                                                                                                              |
 | Допустимые ARIA-роли                                   | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>                                                                                                                                                                                                                                                          |
 | DOM-интерфейс                                          | {{domxref("HTMLFieldSetElement")}}                                                                                                                                                                                                                                                                                                                                                                                                          |
diff --git a/files/ru/web/html/element/figcaption/index.md b/files/ru/web/html/element/figcaption/index.md
index 2a5aae1d0e2aca..0e31e17a45ac32 100644
--- a/files/ru/web/html/element/figcaption/index.md
+++ b/files/ru/web/html/element/figcaption/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/figcaption
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | Нет                                                                                                                                                                                |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Потоковый контент](/ru/docs/Web/Guide/HTML/Content_categories#Потоковый_контент)                                                                                                  |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                   |
 | Допустимые родители                                              | Элемент {{HTMLElement("figure")}}; элемент `<figcaption>` должен быть первым или последним потомком.                                                                               |
 | Допустимые ARIA-роли                                             | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code> |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                                                                                                                                                         |
diff --git a/files/ru/web/html/element/figure/index.md b/files/ru/web/html/element/figure/index.md
index 51a06e3f895df1..87a3b9453026fd 100644
--- a/files/ru/web/html/element/figure/index.md
+++ b/files/ru/web/html/element/figure/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/figure
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [секционный корень](/ru/docs/Web/Guide/HTML/Content_categories#Прочие_модели_контента), явный контент                                                         |
 | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Допустимое содержимое                                            | Элемент {{HTMLElement("figcaption")}} за которым следует [основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток); или поточный контент за которым следует элемент {{HTMLElement("figcaption")}}; или поточный контент. |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                        |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                           |
 | Допустимые родители                                              | Любые элементы принимающие [основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток).                                                                                                                                    |
 | Допустимые ARIA-роли                                             | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>                                                         |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                                                                                                                                                                                                                 |
diff --git a/files/ru/web/html/element/footer/index.md b/files/ru/web/html/element/footer/index.md
index 1a26787f9c8bde..f381ddf6c4b704 100644
--- a/files/ru/web/html/element/footer/index.md
+++ b/files/ru/web/html/element/footer/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/footer
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [явный контент](/ru/docs/Web/Guide/HTML/Content_categories#Явный_контент).                                                                                                                                                          |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Контент основного потока](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), кроме `<footer>` и {{HTMLElement("header")}}.                                                                                                                                                                             |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                                                                                              |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                 |
 | Допустимые родители                                              | Любой элемент, который разрешает [Контент основного потока](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток) в качестве содержимого. Обратите внимание, что элемент `<footer>` не должен быть потомком элемента {{HTMLElement("address")}}, {{HTMLElement("header")}} или другого элемента `<footer>`. |
 | Допустимые ARIA-роли                                             | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>                                                                                                                               |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                                                                                                                                                                                                                                                                                       |
diff --git a/files/ru/web/html/element/header/index.md b/files/ru/web/html/element/header/index.md
index ffd83a7a6ad928..284ab6098ff248 100644
--- a/files/ru/web/html/element/header/index.md
+++ b/files/ru/web/html/element/header/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/header
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [явный контент](/ru/docs/Web/Guide/HTML/Content_categories#Явный_контент).                                                                                                                                                          |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), кроме `<header>` и {{HTMLElement("footer")}}                                                                                                                                                                                        |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                                                                                              |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                 |
 | Допустимые родители                                              | Любой элемент, который разрешает [контент основного потока](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток) в качестве содержимого. Обратите внимание, что элемент `<header>` не должен быть потомком элемента {{HTMLElement("address")}}, {{HTMLElement("footer")}} или другого элемента `<header>`. |
 | Допустимые ARIA-роли                                             | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>                                                                                                                               |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                                                                                                                                                                                                                                                                                       |
diff --git a/files/ru/web/html/element/heading_elements/index.md b/files/ru/web/html/element/heading_elements/index.md
index d7819f28f8420b..5f226d3f9607e3 100644
--- a/files/ru/web/html/element/heading_elements/index.md
+++ b/files/ru/web/html/element/heading_elements/index.md
@@ -29,7 +29,7 @@ l10n:
     </tr>
     <tr>
       <th scope="row">Пропуск тегов</th>
-      <td>{{no_tag_omission}}</td>
+      <td>Нет, открывающий и закрывающий теги обязательны.</td>
     </tr>
     <tr>
       <th scope="row">Допустимые родители</th>
diff --git a/files/ru/web/html/element/ins/index.md b/files/ru/web/html/element/ins/index.md
index a0002dd182be36..42568b070568c9 100644
--- a/files/ru/web/html/element/ins/index.md
+++ b/files/ru/web/html/element/ins/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<ins>`** представляет диапазон тек
 | [Содержимое категорий](/ru/docs/HTML/Content_categories) | [Фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content) or [содержимое потока](/ru/docs/HTML/Content_categories#Flow_content). |
 | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                    | [Прозрачный](/ru/docs/HTML/Content_categories#Transparent_content_model).                                                                    |
-| Пропуск тегов                                            | {{no_tag_omission}}                                                                                                                          |
+| Пропуск тегов                                            | Нет, открывающий и закрывающий теги обязательны.                                                                                             |
 | Допустимые родители                                      | Любой элемент, который принимает [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content).                                      |
 | Допустимые ARIA-роли                                     | Любые                                                                                                                                        |
 | DOM-интерфейс                                            | {{domxref("HTMLModElement")}}                                                                                                                |
diff --git a/files/ru/web/html/element/kbd/index.md b/files/ru/web/html/element/kbd/index.md
index 59ab9238c4867a..b20d06e954566d 100644
--- a/files/ru/web/html/element/kbd/index.md
+++ b/files/ru/web/html/element/kbd/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<kbd>`** указывает на то, что текст
 | [Content categories](/ru/docs/HTML/Content_categories) | [Flow content](/ru/docs/HTML/Content_categories#Flow_content), [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content), palpable content. |
 | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Permitted content                                      | [Phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                  |
-| Tag omission                                           | {{no_tag_omission}}                                                                                                                                     |
+| Tag omission                                           | Нет, открывающий и закрывающий теги обязательны.                                                                                                        |
 | Permitted parents                                      | Any element that accepts [phrasing content](/ru/docs/HTML/Content_categories#Phrasing_content).                                                         |
 | Permitted ARIA roles                                   | Any                                                                                                                                                     |
 | DOM interface                                          | {{domxref("HTMLElement")}}                                                                                                                              |
diff --git a/files/ru/web/html/element/label/index.md b/files/ru/web/html/element/label/index.md
index d3dd978e5cbc56..d216d82c159891 100644
--- a/files/ru/web/html/element/label/index.md
+++ b/files/ru/web/html/element/label/index.md
@@ -10,7 +10,7 @@ HTML-элемент **`<label>`** представляет собой подпи
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Общий поток](/ru/docs/Web/HTML/Content_categories#Flow_content), [текстовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), [интерактивный контент, элемент формы](/ru/docs/Web/HTML/Content_categories#Interactive_content), ощутимый контент. |
 | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                         | [Текстовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), но без вложенных элементов `label`. Недопустимы другие оборачиваемые в `label` элементы помимо целевого.                                                                              |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                                                                                                                               |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                  |
 | Допустимые родители                                        | Любой элемент, разрешающий [текстовый контент.](/ru/docs/Web/HTML/Content_categories#Phrasing_content)                                                                                                                                                            |
 | Допустимые ARIA-роли                                       | Нет                                                                                                                                                                                                                                                               |
 | DOM-интерфейс                                              | {{domxref("HTMLLabelElement")}}                                                                                                                                                                                                                                   |
diff --git a/files/ru/web/html/element/legend/index.md b/files/ru/web/html/element/legend/index.md
index 4ce7e7e17fb82e..69b8bc5702b5dc 100644
--- a/files/ru/web/html/element/legend/index.md
+++ b/files/ru/web/html/element/legend/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<legend>`** представляет собой заго
 | [Категории контента](/ru/docs/HTML/Content_categories) | Нет                                                                    |
 | ------------------------------------------------------ | ---------------------------------------------------------------------- |
 | Допустимый контент                                     | [Фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content). |
-| Пропуск тегов                                          | {{no_tag_omission}}                                                    |
+| Пропуск тегов                                          | Нет, открывающий и закрывающий теги обязательны.                       |
 | Допустимые родители                                    | Является дочерним элементом тега {{HTMLElement("fieldset")}}           |
 | Допустимые ARIA-роли                                   | Нет                                                                    |
 | DOM-интерфейс                                          | {{domxref("HTMLLegendElement")}}                                       |
diff --git a/files/ru/web/html/element/map/index.md b/files/ru/web/html/element/map/index.md
index c24fd2a6d155c0..0ad098660f6feb 100644
--- a/files/ru/web/html/element/map/index.md
+++ b/files/ru/web/html/element/map/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<map>`** используется с элементами
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Потоковый контент](/ru/docs/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content), явный контент.                                                                  |
 | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                  | Любой [прозрачный](/ru/docs/Web/Guide/HTML/Content_categories#%D0%9F%D1%80%D0%BE%D0%B7%D1%80%D0%B0%D1%87%D0%BD%D0%B0%D1%8F_%D0%BC%D0%BE%D0%B4%D0%B5%D0%BB%D1%8C_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0) элемент. |
-| Пропуск тегов                                          | {{no_tag_omission}}                                                                                                                                                                                                        |
+| Пропуск тегов                                          | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                           |
 | Допустимые родители                                    | Любые элементы, которые принимают [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                                                   |
 | Допустимые ARIA-роли                                   | Нет                                                                                                                                                                                                                        |
 | DOM-интерфейс                                          | {{domxref("HTMLMapElement")}}                                                                                                                                                                                              |
diff --git a/files/ru/web/html/element/mark/index.md b/files/ru/web/html/element/mark/index.md
index 8b0a4c36cec62c..a868c3e9fb8778 100644
--- a/files/ru/web/html/element/mark/index.md
+++ b/files/ru/web/html/element/mark/index.md
@@ -10,7 +10,7 @@ slug: Web/HTML/Element/mark
 | [Категории содержимого](/ru/docs/HTML/Content_categories) | [Содержимое потока](/ru/docs/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content), ощутимое содержимое. |
 | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                     | [Фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                          |
-| Пропуск тегов                                             | {{no_tag_omission}}                                                                                                                                             |
+| Пропуск тегов                                             | Нет, открывающий и закрывающий теги обязательны.                                                                                                                |
 | Допустимые родители                                       | Любой элемент, который принимает [фразовый контент](/ru/docs/HTML/Content_categories#Phrasing_content).                                                         |
 | Допустимые ARIA-роли                                      | Любые                                                                                                                                                           |
 | DOM-интерфейс                                             | {{domxref("HTMLElement")}}                                                                                                                                      |
diff --git a/files/ru/web/html/element/menu/index.md b/files/ru/web/html/element/menu/index.md
index 283a03c5282fe1..eadaea8580d12a 100644
--- a/files/ru/web/html/element/menu/index.md
+++ b/files/ru/web/html/element/menu/index.md
@@ -10,7 +10,7 @@ HTML-элемент **`<menu>`** представляет группу кома
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Flow content](/ru/docs/Web/HTML/Content_categories#Flow_content). If the element's children include at least one {{HTMLElement("li")}} element: [Palpable content](/ru/docs/Web/Guide/HTML/Content_categories#Palpable_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                      | If the element is in the _list menu_ state: [flow content](/ru/docs/Web/HTML/Content_categories#Flow_content), or alternatively, zero or more occurrences of {{HTMLElement("li")}}, {{HTMLElement("script")}}, and {{HTMLElement("template")}}. (_list menu_ is the default state, unless the parent element is a {{HTMLElement("menu")}} in the _context menu_ state.)If the element is in the _context menu_ state: zero or more occurrences, in any order, of {{HTMLElement("menu")}} (_context menu_ state only), {{HTMLElement("menuitem")}}, {{HTMLElement("hr")}}, {{HTMLElement("script")}}, and {{HTMLElement("template")}}.                                                                                                                                                                                                                                                                                                                                  |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | Допустимые родители                                        | Любой элемент, который поддерживает [основной поток](/ru/docs/Web/HTML/Content_categories#Flow_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | Неявные ARIA-роли                                          | [`list`](/ru/docs/Web/Accessibility/ARIA/Roles/List_role)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | Допустимые ARIA-роли                                       | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/directory_role">directory</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, [`listbox`](/ru/docs/Web/Accessibility/ARIA/Roles/listbox_role), <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menu_role">menu</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menubar_role">menubar</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/none_role">none</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/radiogroup_role">radiogroup</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/tablist_role">tablist</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/toolbar_role">toolbar</a></code> или <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/tree_role">tree</a></code> |
diff --git a/files/ru/web/html/element/meter/index.md b/files/ru/web/html/element/meter/index.md
index 33cf97894d618d..74b09381c704cd 100644
--- a/files/ru/web/html/element/meter/index.md
+++ b/files/ru/web/html/element/meter/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<meter>`** представляет собой скаля
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), контент, ассоциированный с label, явный контент. |
 | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                  | [Фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), но среди его потомков не должно быть элемента `<meter>`.                                                                 |
-| Пропуск тегов                                          | {{no_tag_omission}}                                                                                                                                                                                 |
+| Пропуск тегов                                          | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                    |
 | Допустимые родители                                    | Любой элемент, который принимает [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                                                         |
 | Допустимые ARIA-роли                                   | Нет                                                                                                                                                                                                 |
 | DOM-интерфейс                                          | {{domxref("HTMLMeterElement")}}                                                                                                                                                                     |
diff --git a/files/ru/web/html/element/nav/index.md b/files/ru/web/html/element/nav/index.md
index e16f17b956fc1e..cc29b5ad9c98e2 100644
--- a/files/ru/web/html/element/nav/index.md
+++ b/files/ru/web/html/element/nav/index.md
@@ -10,7 +10,7 @@ slug: Web/HTML/Element/nav
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | Потоковый контент, секционный контент, явный контент. |
 | ---------------------------------------------------------------- | ----------------------------------------------------- |
 | Допустимое содержимое                                            | Потоковый контент.                                    |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                   |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.      |
 | Допустимые родители                                              | Любой элемент, содержащий потоковый контент.          |
 | Допустимые ARIA-роли                                             | Нет                                                   |
 | DOM-интерфейс                                                    | {{domxref("HTMLElement")}}                            |
diff --git a/files/ru/web/html/element/noscript/index.md b/files/ru/web/html/element/noscript/index.md
index 8d13b0093a3d30..fcf41ef92aa661 100644
--- a/files/ru/web/html/element/noscript/index.md
+++ b/files/ru/web/html/element/noscript/index.md
@@ -10,7 +10,7 @@ slug: Web/HTML/Element/noscript
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [метаданные](/ru/docs/Web/HTML/Content_categories#метаданные), [основной поток](/ru/docs/Web/HTML/Content_categories#основной_поток), [фразовый контент](/ru/docs/Web/HTML/Content_categories#фразовый_контент).                                                                                                                                                                                                                                                                                                                                                                              |
 | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                         | Когда выполнение JavaScript отключено и когда он вложен в элемент {{HTMLElement("head")}}: в любом порядке, ноль или более элементов {{HTMLElement("link")}}, ноль или более элементов {{HTMLElement("style")}} и ноль или более элементов {{HTMLElement("meta")}}. <br> Когда выполнение JavaScript отключено и когда он не вложен в элемент {{HTMLElement("head")}}: любой [прозрачный контент](/ru/docs/Web/HTML/Content_categories#прозрачная_модель_контента), но среди его потомков не должно быть элемента `<noscript>`. <br> В противном случае: основной поток или фразовый контент. |
-| Пропуск тега                                               | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| Пропуск тега                                               | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | Допустимые родители                                        | Любой элемент, который принимает [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content) или элемент {{HTMLElement("head")}} (только для HTML-документа). Оба варианта возможны только если нет элемента-предка `<noscript>`.                                                                                                                                                                                                                                                                                                                                               |
 | Неявная ARIA-роль                                          | [нет роли](https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | Допустимые ARIA-роли                                       | нет                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
diff --git a/files/ru/web/html/element/ol/index.md b/files/ru/web/html/element/ol/index.md
index 5ed8a5cdbf2d10..6a270ed0557064 100644
--- a/files/ru/web/html/element/ol/index.md
+++ b/files/ru/web/html/element/ol/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<ol>`** используется для упорядоч
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Flow_content), и если дочерний элемент `<ol>` включает в себя хотя бы один элемент {{HTMLElement("li")}}, [явный контент](/ru/docs/Web/Guide/HTML/Content_categories#Palpable_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                  | Ноль или больше {{HTMLElement("li")}} элементов, которые, в свою очередь, содержат вложенные элементы {{ HTMLElement("ol") }} или {{ HTMLElement("ul") }}.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| Пропуск тегов                                          | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| Пропуск тегов                                          | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Допустимые родители                                    | Любой элемент, который принимает [основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Flow_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | Допустимые ARIA-роли                                   | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/directory_role">directory</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/listbox_role">listbox</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menu_role">menu</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menubar_role">menubar</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/radiogroup_role">radiogroup</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/tablist_role">tablist</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/toolbar_role">toolbar</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/tree_role">tree</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code> |
 | DOM-интерфейс                                          | {{DOMxRef("HTMLOListElement")}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
diff --git a/files/ru/web/html/element/output/index.md b/files/ru/web/html/element/output/index.md
index aa2919531d1517..1227a4e898483e 100644
--- a/files/ru/web/html/element/output/index.md
+++ b/files/ru/web/html/element/output/index.md
@@ -10,7 +10,7 @@ HTML-элемент **`<output>`** является контейнерным э
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), [перечисляемые](/ru/docs/Web/HTML/Content_categories#Form_listed), [лэйбловые](/ru/docs/Web/HTML/Content_categories#Form_labelable), [сбрасываемые форма-ассоциированные элементы](/ru/docs/Web/HTML/Content_categories#Form_resettable), явный контент. |
 | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                         | [Фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                                                                                                                                                                                                                                                                                                  |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                         |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                            |
 | Допустимые родители                                        | Все элементы, которые принимают [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                                                                                                                                                                                                                                                                  |
 | Допустимые ARIA-роли                                       | Любые                                                                                                                                                                                                                                                                                                                                                                                                       |
 | DOM-интерфейс                                              | {{domxref("HTMLOutputElement")}}                                                                                                                                                                                                                                                                                                                                                                            |
diff --git a/files/ru/web/html/element/picture/index.md b/files/ru/web/html/element/picture/index.md
index 0cbeb5f089be18..403d181afb4a8b 100644
--- a/files/ru/web/html/element/picture/index.md
+++ b/files/ru/web/html/element/picture/index.md
@@ -14,7 +14,7 @@ HTML-элемент **`<picture>`** служит контейнером для 
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/HTML/Content_categories#Flow_content), фразовый контент, встроенный контент                                                 |
 | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Допустимый контент                                         | Ноль или более элементов {{HTMLElement("source")}}, затем один элемент {{HTMLElement("img")}}, при необходимости смешанный с элементами поддержки сценариев. |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                          |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                             |
 | Допустимые родители                                        | Любой элемент, который разрешает встроенный контент                                                                                                          |
 | Допустимые ARIA-роли                                       | Нет                                                                                                                                                          |
 | DOM-интерфейс                                              | {{domxref("HTMLPictureElement")}}                                                                                                                            |
diff --git a/files/ru/web/html/element/pre/index.md b/files/ru/web/html/element/pre/index.md
index e3d7f620122b81..f0cea3177b1696 100644
--- a/files/ru/web/html/element/pre/index.md
+++ b/files/ru/web/html/element/pre/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<pre>`** представляет собой предва
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#%D0%9E%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D0%BE%D0%B9_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA), [Явный контент](/ru/docs/Web/Guide/HTML/Content_categories#%D0%AF%D0%B2%D0%BD%D1%8B%D0%B9_%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82) |
 | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content)                                                                                                                                                                                                     |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                                                                 |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                    |
 | Допустимые родители                                              | Любой элемент, который принимает [содержимое потока](/ru/docs/Web/Guide/HTML/Content_categories#%D0%9E%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D0%BE%D0%B9_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA)                                                                                                    |
 | Неявные ARIA-роли                                                | [Нет соответствующей роли](https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role)                                                                                                                                                                                              |
 | Допустимые ARIA-роли                                             | Любые                                                                                                                                                                                                                                                                               |
diff --git a/files/ru/web/html/element/progress/index.md b/files/ru/web/html/element/progress/index.md
index 0697bcd101a52b..b4825749966300 100644
--- a/files/ru/web/html/element/progress/index.md
+++ b/files/ru/web/html/element/progress/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<progress>`** отображает индикатор, п
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/HTML/Content_categories#Flow_content), [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), контент, ассоциированный с label, явный контент. |
 | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                         | [Фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content), но среди его потомков не должно быть элемента `<progress>`.                                                              |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                                                                 |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                    |
 | Допустимые родители                                        | Любой элемент, который принимает [фразовый контент](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                                                         |
 | Допустимые ARIA-роли                                       | Нет                                                                                                                                                                                                 |
 | DOM-интерфейс                                              | {{domxref("HTMLProgressElement")}}                                                                                                                                                                  |
diff --git a/files/ru/web/html/element/ruby/index.md b/files/ru/web/html/element/ruby/index.md
index 2c2f156da1fded..780637952cec9b 100644
--- a/files/ru/web/html/element/ruby/index.md
+++ b/files/ru/web/html/element/ruby/index.md
@@ -10,7 +10,7 @@ HTML-элемент **`<ruby>`** предназначен для добавле
 | [Категории контента](/ru/docs/Web/HTML/Content_categories) | [Основной поток(Flow content)](/ru/docs/Web/HTML/Content_categories#Flow_content), [текстовой контент(phrasing content)](/ru/docs/Web/HTML/Content_categories#Phrasing_content), явный контент(palpable content). |
 | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                      | [Текстовый контент(phrasing content)](/ru/docs/Web/HTML/Content_categories#Phrasing_content).                                                                                                                     |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                                                                               |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                  |
 | Допустимые родители                                        | Любой элемент который согласован с [текстовым контентом(phrasing content)](/ru/docs/HTML/Content_categories#Phrasing_content).                                                                                    |
 | Допустимые ARIA-роли                                       | Любые                                                                                                                                                                                                             |
 | DOM-интерфейс                                              | {{domxref("HTMLElement")}}                                                                                                                                                                                        |
diff --git a/files/ru/web/html/element/slot/index.md b/files/ru/web/html/element/slot/index.md
index abe0c26a0e4e64..d50e36cfb5651a 100644
--- a/files/ru/web/html/element/slot/index.md
+++ b/files/ru/web/html/element/slot/index.md
@@ -11,7 +11,7 @@ HTML-элемент **`<slot>`** является частью набора те
 | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                      | [Прозрачный](/ru/docs/Web/HTML/Content_categories#Transparent_content_model)                                                                          |
 | События                                                    | {{event("slotchange")}}                                                                                                                               |
-| Пропуск тегов                                              | {{no_tag_omission}}                                                                                                                                   |
+| Пропуск тегов                                              | Нет, открывающий и закрывающий теги обязательны.                                                                                                      |
 | Допустимые родители                                        | Любой элемент, который принимает[содержание формулировки](/ru/docs/Web/HTML/Content_categories#Phrasing_content)                                      |
 | Допустимые ARIA-роли                                       | Нет                                                                                                                                                   |
 | DOM-интерфейс                                              | {{domxref("HTMLSlotElement")}}                                                                                                                        |
diff --git a/files/ru/web/html/element/span/index.md b/files/ru/web/html/element/span/index.md
index b79c7926ee7ed9..5f8997890932d6 100644
--- a/files/ru/web/html/element/span/index.md
+++ b/files/ru/web/html/element/span/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<span>`** является основным строко
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Потоковый контент](/ru/docs/Web/Guide/HTML/Content_categories#Потоковый_контент), [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content).                                                    |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                            | [Фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content).                                                                                                                                       |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                    |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                       |
 | Допустимые родители                                              | Любой элемент, который разрешает [фразовый](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content) или [потоковый](/ru/docs/Web/Guide/HTML/Content_categories#Потоковый_контент) контент в качестве содержимого. |
 | Допустимые ARIA-роли                                             | Любые                                                                                                                                                                                                                  |
 | DOM-интерфейс                                                    | {{domxref("HTMLSpanElement")}} (до {{glossary("HTML5")}}, интерфейсом был {{domxref("HTMLElement")}})                                                                                                                  |
diff --git a/files/ru/web/html/element/style/index.md b/files/ru/web/html/element/style/index.md
index 76cee38d1fd610..29533d2631e998 100644
--- a/files/ru/web/html/element/style/index.md
+++ b/files/ru/web/html/element/style/index.md
@@ -9,7 +9,7 @@ HTML-элемент **`<style>`** содержит стилевую информ
 
 - _[Категории содержимого](/ru/docs/HTML/Content_categories)_[Metadata content](/ru/docs/Web/HTML/Content_categories#Metadata_content), and if the `scoped` attribute is present: [flow content](/ru/docs/Web/HTML/Content_categories#Flow_content).
 - _Permitted content_ Style information matching the language of the `type` attribute.
-- _Tag omission_ {{no_tag_omission}}
+- _Tag omission_ Нет, открывающий и закрывающий теги обязательны.
 - _Допустимые родительские элементы_ ...
 - _Интерфейс DOM_ {{domxref("HTMLStyleElement")}}
 
diff --git a/files/ru/web/html/element/template/index.md b/files/ru/web/html/element/template/index.md
index aba0b93f93e1c1..f6a818fd52cfd9 100644
--- a/files/ru/web/html/element/template/index.md
+++ b/files/ru/web/html/element/template/index.md
@@ -12,7 +12,7 @@ slug: Web/HTML/Element/template
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Метаданные](/ru/docs/Web/Guide/HTML/Content_categories#метаданные), [основной поток](/ru/docs/Web/Guide/HTML/Content_categories#основной_поток), [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#phrasing_content), [элементы поддержки скриптов](/ru/docs/Web/Guide/HTML/Content_categories#элементы_поддержки_скриптов)                                                                                                                  |
 | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                               | Нет ограничений                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                          |
 | Допустимые родители                                              | Любые элементы, которые могут содержать [метаданные](/ru/docs/Web/Guide/HTML/Content_categories#метаданные), [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#phrasing_content) или [элементы поддержки скриптов](/ru/docs/Web/Guide/HTML/Content_categories#элементы_поддержки_скриптов). Допускается вкладывать элемент в {{HTMLElement("colgroup")}}, у которого _отсутствует_ атрибут [`span`](/ru/docs/Web/HTML/Element/colgroup#span). |
 | Неявные ARIA-роли                                                | [Нет соответствующей роли](https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role)                                                                                                                                                                                                                                                                                                                                                                    |
 | Допустимые ARIA-роли                                             | Нет                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
diff --git a/files/ru/web/html/element/time/index.md b/files/ru/web/html/element/time/index.md
index 31c15281745d26..88571c67006df1 100644
--- a/files/ru/web/html/element/time/index.md
+++ b/files/ru/web/html/element/time/index.md
@@ -15,7 +15,7 @@ HTML-элемент **`<time>`** используется для предста
 | [Категории контента](/ru/docs/Web/Guide/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Основной_поток), [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content), явный контент. |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимый контент                                               | [Фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content).                                                                                             |
-| Пропуск тегов                                                    | {{no_tag_omission}}                                                                                                                                                          |
+| Пропуск тегов                                                    | Нет, открывающий и закрывающий теги обязательны.                                                                                                                             |
 | Допустимые родители                                              | Любой элемент, который принимает [фразовый контент](/ru/docs/Web/Guide/HTML/Content_categories#Phrasing_content).                                                            |
 | Допустимые ARIA-роли                                             | Любые                                                                                                                                                                        |
 | DOM-интерфейс                                                    | {{domxref("HTMLTimeElement")}}                                                                                                                                               |
diff --git a/files/ru/web/html/element/ul/index.md b/files/ru/web/html/element/ul/index.md
index e6f6c2165e0962..6099b6732f1bd5 100644
--- a/files/ru/web/html/element/ul/index.md
+++ b/files/ru/web/html/element/ul/index.md
@@ -12,7 +12,7 @@ HTML-элемент **`<ul>`** используется для неупоряд
 | [Категории контента](/ru/docs/HTML/Content_categories) | [Основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Flow_content), и если дочерний элемент `<ol>` включает в себя хотя бы один элемент {{HTMLElement("li")}}, [явный контент](/ru/docs/Web/Guide/HTML/Content_categories#Palpable_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Допустимое содержимое                                  | Ноль или больше {{ HTMLElement("li") }} элементов, содержат вложенные элементы {{ HTMLElement("ol") }} или {{ HTMLElement("ul") }}.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| Пропуск тегов                                          | {{no_tag_omission}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| Пропуск тегов                                          | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | Допустимые родители                                    | Любой элемент, который принимает [основной поток](/ru/docs/Web/Guide/HTML/Content_categories#Flow_content).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | Допустимые ARIA-роли                                   | <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/directory_role">directory</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/group_role">group</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/listbox_role">listbox</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menu_role">menu</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/menubar_role">menubar</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/radiogroup_role">radiogroup</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/tablist_role">tablist</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/toolbar_role">toolbar</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/tree_role">tree</a></code>, <code><a href="/ru/docs/Web/Accessibility/ARIA/Roles/presentation_role">presentation</a></code> |
 | DOM-интерфейс                                          | {{domxref("HTMLUListElement")}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
diff --git a/files/ru/web/html/element/video/index.md b/files/ru/web/html/element/video/index.md
index 655e5646985b4b..6d256ffb128db1 100644
--- a/files/ru/web/html/element/video/index.md
+++ b/files/ru/web/html/element/video/index.md
@@ -16,7 +16,7 @@ slug: Web/HTML/Element/video
 
 | [Content categories](/ru/docs/Web/HTML/Content_categories) | [Flow content](/ru/docs/Web/HTML/Content_categories#Flow_content), содержание фраз, встроенный контент. Если имеет атрибут [`controls`](/ru/docs/Web/HTML/Element/video#controls): становится интерактивным элементом с осязаемым содержанием. |
 | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Tag omission                                               | {{no_tag_omission}}                                                                                                                                                                                                                            |
+| Tag omission                                               | Нет, открывающий и закрывающий теги обязательны.                                                                                                                                                                                               |
 | Допустимые родительские элементы                           | Любой элемент, который принимает встроенный контент.                                                                                                                                                                                           |
 | DOM интерфейс                                              | {{domxref("HTMLVideoElement")}}                                                                                                                                                                                                                |
 

From 3304fc8d4adc9ddcebaa01a3e6c635be6ee6b336 Mon Sep 17 00:00:00 2001
From: Leonid Vinogradov <win.leon@protonmail.com>
Date: Mon, 9 Sep 2024 22:43:08 +0300
Subject: [PATCH 018/115] [ru] update `Web/API/Window/gamepadconnected_event`
 translation (#23479)

[ru] update 'Web/API/Window/gamepadconnected_event' translation
---
 files/ru/_redirects.txt                       |  1 -
 files/ru/web/api/gamepad/index.md             |  2 +-
 files/ru/web/api/gamepad_api/index.md         |  4 +-
 .../using_the_gamepad_api/index.md            |  4 +-
 .../ru/web/api/gamepadevent/gamepad/index.md  |  2 +-
 files/ru/web/api/gamepadevent/index.md        |  4 +-
 .../window/gamepadconnected_event/index.md    | 60 +++++++++----------
 files/ru/web/events/index.md                  |  2 +-
 8 files changed, 36 insertions(+), 43 deletions(-)

diff --git a/files/ru/_redirects.txt b/files/ru/_redirects.txt
index e61691e3132aa8..3d7f7e146b5eac 100644
--- a/files/ru/_redirects.txt
+++ b/files/ru/_redirects.txt
@@ -613,7 +613,6 @@
 /ru/docs/Web/Events/focusin	/ru/docs/Web/API/Element/focusin_event
 /ru/docs/Web/Events/focusout	/ru/docs/Web/API/Element/focusout_event
 /ru/docs/Web/Events/gamepadconnected	/ru/docs/Web/API/Window/gamepadconnected_event
-/ru/docs/Web/Events/gamepaddisconnected	/ru/docs/Web/API/Window/gamepaddisconnected_event
 /ru/docs/Web/Events/hashchange	/ru/docs/Web/API/Window/hashchange_event
 /ru/docs/Web/Events/invalid	/ru/docs/Web/API/HTMLInputElement/invalid_event
 /ru/docs/Web/Events/keypress	/ru/docs/Web/API/Element/keypress_event
diff --git a/files/ru/web/api/gamepad/index.md b/files/ru/web/api/gamepad/index.md
index 3a6fcfbc6d72cc..72d059bc734fa2 100644
--- a/files/ru/web/api/gamepad/index.md
+++ b/files/ru/web/api/gamepad/index.md
@@ -7,7 +7,7 @@ slug: Web/API/Gamepad
 
 Интерфейс **`Gamepad`** [Gamepad API](/ru/docs/Web/API/Gamepad_API) определяет отдельный геймпад или контроллер, предоставляющий доступ к такой информации, как: нажатие кнопок, позиции осей, и id.
 
-Объект `Gamepad` может быть возвращён в одном из двух случаев: как свойство `gamepad` событий {{event("gamepadconnected")}} и {{event("gamepaddisconnected")}}, или считыванием любой позиции в массиве, возвращённом методом {{domxref("Navigator.getGamepads()")}}.
+Объект `Gamepad` может быть возвращён в одном из двух случаев: как свойство `gamepad` событий {{event("gamepadconnected")}} и {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}, или считыванием любой позиции в массиве, возвращённом методом {{domxref("Navigator.getGamepads()")}}.
 
 ## Свойства
 
diff --git a/files/ru/web/api/gamepad_api/index.md b/files/ru/web/api/gamepad_api/index.md
index 766f4cd5960a1f..a6829911a0c84e 100644
--- a/files/ru/web/api/gamepad_api/index.md
+++ b/files/ru/web/api/gamepad_api/index.md
@@ -37,9 +37,7 @@ API Gamepad - это простой и последовательный спос
 - {{domxref("Window.ongamepadconnected")}}
   - : Представляет собой обработчик событий, который будет выполняться при подключении геймпада (когда срабатывает событие {{event('gamepadconnected')}}).
 - {{domxref("Window.ongamepaddisconnected")}}
-  - : Представляет собой обработчик событий, который будет выполняться при отключении геймпада (когда срабатывает событие {{event('gamepaddisconnected')}}).
-
-<!---->
+  - : Представляет собой обработчик событий, который будет выполняться при отключении геймпада (когда срабатывает событие {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}).
 
 ## Учебные пособия и руководства
 
diff --git a/files/ru/web/api/gamepad_api/using_the_gamepad_api/index.md b/files/ru/web/api/gamepad_api/using_the_gamepad_api/index.md
index af0e1db811abd1..775e47dd84e894 100644
--- a/files/ru/web/api/gamepad_api/using_the_gamepad_api/index.md
+++ b/files/ru/web/api/gamepad_api/using_the_gamepad_api/index.md
@@ -34,7 +34,7 @@ window.addEventListener("gamepadconnected", function (e) {
 
 ## Отключение геймпада
 
-When a gamepad is disconnected, and if a page has previously received data for that gamepad (e.g. {{ domxref("Window/gamepadconnected_event", "gamepadconnected") }}), a second event is dispatched to the focused window, {{ event("gamepaddisconnected") }}:
+When a gamepad is disconnected, and if a page has previously received data for that gamepad (e.g. {{domxref("Window/gamepadconnected_event", "gamepadconnected")}}), a second event is dispatched to the focused window, {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}:
 
 ```js
 window.addEventListener("gamepaddisconnected", function (e) {
@@ -46,7 +46,7 @@ window.addEventListener("gamepaddisconnected", function (e) {
 });
 ```
 
-The gamepad's {{domxref("Gamepad.index", "index")}} property will be unique per-device connected to the system, even if multiple controllers of the same type are used. The `index` property also functions as the index into the {{jsxref("Array")}} returned by {{ domxref("Navigator.getGamepads()") }}.
+The gamepad's {{domxref("Gamepad.index", "index")}} property will be unique per-device connected to the system, even if multiple controllers of the same type are used. The `index` property also functions as the index into the {{jsxref("Array")}} returned by {{domxref("Navigator.getGamepads()")}}.
 
 ```js
 var gamepads = {};
diff --git a/files/ru/web/api/gamepadevent/gamepad/index.md b/files/ru/web/api/gamepadevent/gamepad/index.md
index 0050fc7f3ceb7a..1f2ea4a6f15402 100644
--- a/files/ru/web/api/gamepadevent/gamepad/index.md
+++ b/files/ru/web/api/gamepadevent/gamepad/index.md
@@ -5,7 +5,7 @@ slug: Web/API/GamepadEvent/gamepad
 
 {{APIRef("Gamepad API")}}
 
-Свойство **`GamepadEvent.gamepad`**, интерфейса **{{domxref("GamepadEvent")}},** возвращает объект {{domxref("Gamepad")}}, предоставляющий доступ к данным геймпада для событий [`gamepadconnected`](/ru/docs/Web/Events/gamepadconnected) и [`gamepaddisconnected`](/ru/docs/Web/Events/gamepaddisconnected).
+Свойство **`GamepadEvent.gamepad`**, интерфейса **{{domxref("GamepadEvent")}},** возвращает объект {{domxref("Gamepad")}}, предоставляющий доступ к данным геймпада для событий [`gamepadconnected`](/ru/docs/Web/Events/gamepadconnected) и {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}.
 
 > [!NOTE]
 > Эти события не возникают Chrome, только в Firefox. В Chrome вы должны использовать {{domxref("Navigator.getGamepads")}} для доступа к объекту {{domxref("Gamepad")}}.
diff --git a/files/ru/web/api/gamepadevent/index.md b/files/ru/web/api/gamepadevent/index.md
index 3e0c7701b4c891..98df25bbd11cf4 100644
--- a/files/ru/web/api/gamepadevent/index.md
+++ b/files/ru/web/api/gamepadevent/index.md
@@ -5,7 +5,7 @@ slug: Web/API/GamepadEvent
 
 {{APIRef("Gamepad API")}}
 
-`GamepadEvent` интерфейс {{ domxref("Gamepad API")}} содержит ссылки на геймпады, подключённые к системе, передающиеся при возникновении событий [Window.gamepadconnected](/ru/docs/Web/Events/gamepadconnected) и [Window.gamepaddisconnected](/ru/docs/Web/Events/gamepaddisconnected).
+`GamepadEvent` интерфейс {{ domxref("Gamepad API")}} содержит ссылки на геймпады, подключённые к системе, передающиеся при возникновении событий [Window.gamepadconnected](/ru/docs/Web/Events/gamepadconnected) и {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}.
 
 ## Свойства
 
@@ -28,7 +28,7 @@ window.addEventListener("gamepadconnected", function (e) {
 });
 ```
 
-И события [Window.gamepaddisconnected](/ru/docs/Web/Events/gamepaddisconnected).
+И события {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}.
 
 ```js
 window.addEventListener("gamepaddisconnected", function (e) {
diff --git a/files/ru/web/api/window/gamepadconnected_event/index.md b/files/ru/web/api/window/gamepadconnected_event/index.md
index 8b4e189dc3978d..e61d8fc59e33a6 100644
--- a/files/ru/web/api/window/gamepadconnected_event/index.md
+++ b/files/ru/web/api/window/gamepadconnected_event/index.md
@@ -1,51 +1,47 @@
 ---
-title: gamepadconnected
+title: "Window: событие gamepadconnected"
 slug: Web/API/Window/gamepadconnected_event
+l10n:
+  sourceCommit: 33cada2d06f8d0cd009d9d5348de6e3165bba67f
 ---
 
 {{APIRef}}
 
-Событие `gamepadconnected` вызывается, когда браузер обнаруживает подключение геймпада или первое использование кнопки/стика.
+Событие `gamepadconnected` возникает, когда браузер обнаруживает подключение геймпада или первое использование кнопки/стика.
 
-## Основная информация
+Событие не возникает, если оно запрещено заголовком {{httpheader("Permissions-Policy/gamepad", "gamepad")}} [Политики разрешений](/ru/docs/Web/HTTP/Permissions_Policy) документа.
 
-- Спецификация
-  - : [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepadconnected-event)
-- Интерфейс
-  - : Event
-- Всплывающее
-  - : Нет
-- Отменяемое
-  - : Нет
-- Цель
-  - : DefaultView (`<window>`)
-- Действие по умолчанию
-  - : Отсутствует
+Это событие не является отменяемым и не всплывает.
 
-## Свойства
+## Примеры
 
-| Свойство                        | Тип                        | Описание                                                                          |
-| ------------------------------- | -------------------------- | --------------------------------------------------------------------------------- |
-| `target` {{readonlyInline}}     | {{domxref("EventTarget")}} | Цель события (самый верхний элемент DOM дерева).                                  |
-| `type` {{readonlyInline}}       | {{domxref("DOMString")}}   | Тип события.                                                                      |
-| `bubbles` {{readonlyInline}}    | {{jsxref("Boolean")}}      | Является ли событие всплывающим.                                                  |
-| `cancelable` {{readonlyInline}} | {{jsxref("Boolean")}}      | Является ли событие отменяемым.                                                   |
-| `gamepad` {{readonlyInline}}    | {{domxref("Gamepad")}}     | Единственный атрибут, предоставляющий доступ к данным геймпада для этого события. |
-
-## Пример
+Для того, чтобы узнать о подключении геймпада, можно добавить обработчик события, используя {{domxref("EventTarget.addEventListener", "addEventListener()")}}:
 
 ```js
-// Обратите внимание, что API всё ещё использует вендорные префиксы в браузерах, которые его реализуют
-window.addEventListener("gamepadconnected", function (event) {
-  // Все значения кнопок и стиков доступны через:
-  event.gamepad;
+window.addEventListener("gamepadconnected", (event) => {
+  // Состояния всех кнопок и стиков можно получить с помощью
+  const gamepad = event.gamepad;
 });
 ```
 
-## Связанные события
+Также можно использовать свойство `window.ongamepadconnected` для установления обработчика события `gamepadconnected`:
+
+```js
+window.ongamepadconnected = (event) => {
+  // Состояния всех кнопок и стиков можно получить с помощью
+  const gamepad = event.gamepad;
+};
+```
+
+## Спецификации
+
+{{Specifications}}
+
+## Совместимость с браузерами
 
-- {{event("gamepaddisconnected")}}
+{{Compat}}
 
 ## Смотрите также
 
-- [Using Gamepad API](/ru/docs/API/Gamepad/Using_Gamepad_API)
+- [gamepaddisconnected](/ru/docs/Web/API/Window/gamepaddisconnected_event)
+- [Использование Gamepad API](/ru/docs/Web/API/Gamepad_API/Using_the_Gamepad_API)
diff --git a/files/ru/web/events/index.md b/files/ru/web/events/index.md
index 961f552f16866b..9cd6ab3fc89cc9 100644
--- a/files/ru/web/events/index.md
+++ b/files/ru/web/events/index.md
@@ -429,7 +429,7 @@ slug: Web/Events
 | {{Event("fullscreenchange")}}                                                       | {{DOMxRef("Event")}}                                                                                     | [Full Screen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api)                                                                                                                               | An element was turned to fullscreen mode or back to normal mode.                                                                                                                                                                     |
 | {{Event("fullscreenerror")}}                                                        | {{DOMxRef("Event")}}                                                                                     | [Full Screen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api)                                                                                                                               | It was impossible to switch to fullscreen mode for technical reasons or because the permission was denied.                                                                                                                           |
 | {{Event("gamepadconnected")}}                                                       | {{DOMxRef("GamepadEvent")}} {{Experimental_Inline}}                                                      | [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepadconnected-event)                                                                                                                                           | A gamepad has been connected.                                                                                                                                                                                                        |
-| {{Event("gamepaddisconnected")}}                                                    | {{DOMxRef("GamepadEvent")}} {{Experimental_Inline}}                                                      | [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepaddisconnected-event)                                                                                                                                        | A gamepad has been disconnected.                                                                                                                                                                                                     |
+| {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}              | {{DOMxRef("GamepadEvent")}} {{Experimental_Inline}}                                                      | [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepaddisconnected-event)                                                                                                                                        | A gamepad has been disconnected.                                                                                                                                                                                                     |
 | {{Event("gotpointercapture")}}                                                      | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-gotpointercapture-event)                                                                                                                             | Element receives pointer capture.                                                                                                                                                                                                    |
 | {{Event("hashchange")}}                                                             | {{DOMxRef("HashChangeEvent")}}                                                                           | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-hashchange)                                                                                                            | The fragment identifier of the URL has changed (the part of the URL after the #).                                                                                                                                                    |
 | {{Event("lostpointercapture")}}                                                     | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-lostpointercapture-event)                                                                                                                            | Element lost pointer capture.                                                                                                                                                                                                        |

From 90c5069dc263ef0905b419ab06bda4ccb67405b1 Mon Sep 17 00:00:00 2001
From: Leonid Vinogradov <win.leon@protonmail.com>
Date: Mon, 9 Sep 2024 22:49:26 +0300
Subject: [PATCH 019/115] [ru] remove deprecated `{{event}}` macro usage for
 `languagechange` event (#23480)

[ru] remove deprecated {{event}} macro usage for 'languagechange' event
---
 files/ru/mozilla/firefox/releases/32/index.md |   2 +-
 files/ru/web/api/htmlbodyelement/index.md     |   2 +-
 files/ru/web/api/window/index.md              |   2 +-
 files/ru/web/events/index.md                  | 378 +++++++++---------
 4 files changed, 192 insertions(+), 192 deletions(-)

diff --git a/files/ru/mozilla/firefox/releases/32/index.md b/files/ru/mozilla/firefox/releases/32/index.md
index dce6d1b3169acd..5fd25f14f7aaea 100644
--- a/files/ru/mozilla/firefox/releases/32/index.md
+++ b/files/ru/mozilla/firefox/releases/32/index.md
@@ -45,7 +45,7 @@ slug: Mozilla/Firefox/Releases/32
 
 ### Интерфейсы/APIs/DOM
 
-- Реализованы свойство {{domxref("navigator.languages")}} и событие {{event("languagechange")}} ([Firefox bug 889335](https://bugzil.la/889335)).
+- Реализованы свойство {{domxref("navigator.languages")}} и событие {{domxref("Window.languagechange_event", "languagechange")}} ([Firefox bug 889335](https://bugzil.la/889335)).
 - В методы {{domxref("KeyboardEvent.getModifierState")}}() и {{domxref("MouseEvent.getModifierState")}}() добавлена поддержка виртуального модификатора `Accel` ([Firefox bug 1009388](https://bugzil.la/1009388)).
 - Добавлена экспериментальная реализация свойства {{domxref("KeyboardEvent.code")}}: она отключена в Release сборках ([Firefox bug 865649](https://bugzil.la/865649)).
 
diff --git a/files/ru/web/api/htmlbodyelement/index.md b/files/ru/web/api/htmlbodyelement/index.md
index e060e69303b91c..739fe0b3686806 100644
--- a/files/ru/web/api/htmlbodyelement/index.md
+++ b/files/ru/web/api/htmlbodyelement/index.md
@@ -41,7 +41,7 @@ _Не имеет специфичных обработчиков событий;
 - {{domxref("WindowEventHandlers.onhashchange")}}
   - : Это {{event("Event_handlers", "event handler")}} представляющее собой код который будет вызван когда событие {{event("hashchange")}} вызвано.
 - {{domxref("WindowEventHandlers.onlanguagechange")}} {{experimental_inline}}
-  - : Это {{event("Event_handlers", "event handler")}} представляющее собой код который будет вызван когда событие {{event("languagechange")}} вызвано.
+  - : Это {{event("Event_handlers", "event handler")}} представляющее собой код, который будет вызван при появлении события {{domxref("Window.languagechange_event", "languagechange")}}.
 - {{domxref("WindowEventHandlers.onmessage")}}
   - : Это {{event("Event_handlers", "event handler")}} представляющее собой код который будет вызван когда событие {{event("message")}} вызвано.
 - {{domxref("WindowEventHandlers.onoffline")}}
diff --git a/files/ru/web/api/window/index.md b/files/ru/web/api/window/index.md
index 99e3e315e914f7..6b2322d964c318 100644
--- a/files/ru/web/api/window/index.md
+++ b/files/ru/web/api/window/index.md
@@ -330,7 +330,7 @@ _Этот интерфейс наследует методы от интерфе
 - {{domxref("GlobalEventHandlers.onkeyup")}}
   - : Свойство обработчика событий для события {{event("keyup")}} в окне.
 - {{domxref("WindowEventHandlers.onlanguagechange")}}
-  - : Свойство обработчика событий для события {{event("languagechange")}} в окне.
+  - : Свойство обработчика события {{domxref("Window.languagechange_event", "languagechange")}} в окне.
 - {{domxref("GlobalEventHandlers.onload")}}
   - : Свойство обработчика событий для загрузки окна.
 - {{domxref("WindowEventHandlers.onmessage")}}
diff --git a/files/ru/web/events/index.md b/files/ru/web/events/index.md
index 9cd6ab3fc89cc9..4c42dc2e4e926a 100644
--- a/files/ru/web/events/index.md
+++ b/files/ru/web/events/index.md
@@ -349,195 +349,195 @@ slug: Web/Events
 
 Эти события определены в официальных веб-спецификациях и должны быть общими для всех браузеров. Каждое событие перечисляется вместе с интерфейсом, представляющим объект, отправленный получателям события (так что вы можете найти информацию о том, какие данные предоставляются с каждым событием), а также ссылку на спецификацию или спецификации, которые определяют событие.
 
-| Имя события                                                                         | Тип события                                                                                              | Спецификация                                                                                                                                                                                                  | Происходит когда...                                                                                                                                                                                                                  |
-| ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| {{Event("abort")}}                                                                  | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-abort)                                                                                                                                           | The loading of a resource has been aborted.                                                                                                                                                                                          |
-| [`abort`](</ru/docs/Web/Reference/Events/abort_(ProgressEvent)>)                    | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-abort)                                                                                  | Progression has been terminated (not due to an error).                                                                                                                                                                               |
-| [`abort`](/ru/docs/Web/Reference/Events/abort_indexedDB)                            | {{DOMxRef("Event")}}                                                                                     | [IndexedDB](http://www.w3.org/TR/IndexedDB/#database-interface)                                                                                                                                               | A transaction has been aborted.                                                                                                                                                                                                      |
-| {{Event("afterprint")}}                                                             | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.w3.org/TR/html5/webappapis.html#printing)                                                                                                                                                  | The associated document has started printing or the print preview has been closed.                                                                                                                                                   |
-| {{Event("animationcancel")}}                                                        | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) has aborted.                                                                                                                                                                          |
-| {{Event("animationend")}}                                                           | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) has completed.                                                                                                                                                                        |
-| {{Event("animationiteration")}}                                                     | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) is repeated.                                                                                                                                                                          |
-| {{Event("animationstart")}}                                                         | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) has started.                                                                                                                                                                          |
-| {{Event("appinstalled")}}                                                           | {{DOMxRef("Event")}}                                                                                     | [Web App Manifest](/ru/docs/Web/Manifest)                                                                                                                                                                     | A web application is successfully installed as a [progressive web app](/en-US/Apps/Progressive).                                                                                                                                     |
-| {{Event("audioprocess")}}                                                           | {{DOMxRef("AudioProcessingEvent")}} {{Deprecated_Inline}}                                                | [Web Audio API](https://www.w3.org/TR/webaudio/#AudioProcessingEvent)                                                                                                                                         | The input buffer of a {{DOMxRef("ScriptProcessorNode")}} is ready to be processed.                                                                                                                                                   |
-| {{Event("audioend")}} {{Experimental_Inline}}                                       | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The user agent has finished capturing audio for speech recognition.                                                                                                                                                                  |
-| {{Event("audiostart")}} {{Experimental_Inline}}                                     | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The user agent has started to capture audio for speech recognition.                                                                                                                                                                  |
-| {{Event("beforeprint")}}                                                            | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.w3.org/TR/html5/webappapis.html#printing)                                                                                                                                                  | The associated document is about to be printed or previewed for printing.                                                                                                                                                            |
-| {{Event("beforeunload")}}                                                           | {{DOMxRef("BeforeUnloadEvent")}}                                                                         | [HTML5](http://www.w3.org/TR/html5/browsers.html#unloading-documents)                                                                                                                                         | The window, the document and its resources are about to be unloaded.                                                                                                                                                                 |
-| {{Event("beginEvent")}}                                                             | {{DOMxRef("TimeEvent")}}                                                                                 | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | A [SMIL](/ru/docs/SVG/SVG_animation_with_SMIL) animation element begins.                                                                                                                                                             |
-| [`blocked`](/ru/docs/Web/Reference/Events/blocked_indexedDB)                        |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | An open connection to a database is blocking a `versionchange` transaction on the same database.                                                                                                                                     |
-| {{Event("blur")}}                                                                   | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-blur)                                                                                                                                            | An element has lost focus (does not bubble).                                                                                                                                                                                         |
-| {{Event("boundary")}} {{Experimental_Inline}}                                       | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The spoken utterance reaches a word or sentence boundary                                                                                                                                                                             |
-| {{Event("canplay")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-canplay)                                                                                         | The user agent can play the media, but estimates that not enough data has been loaded to play the media up to its end without having to stop for further buffering of content.                                                       |
-| {{Event("canplaythrough")}}                                                         | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-canplaythrough)                                                                                  | The user agent can play the media up to its end without having to stop for further buffering of content.                                                                                                                             |
-| {{Event("change")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [DOM L2](http://www.w3.org/TR/DOM-Level-2-Events/events.html), [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/common-input-element-attributes.html#event-input-change)                   | The `change` event is fired for {{HTMLElement("input")}}, {{HTMLElement("select")}}, and {{HTMLElement("textarea")}} elements when a change to the element's value is committed by the user.                                         |
-| {{Event("chargingchange")}}                                                         | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The battery begins or stops charging.                                                                                                                                                                                                |
-| {{Event("chargingtimechange")}}                                                     | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The `chargingTime` attribute has been updated.                                                                                                                                                                                       |
-| {{Event("click")}}                                                                  | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-click)                                                                                                                                           | A pointing device button has been pressed and released on an element.                                                                                                                                                                |
-| [`close`](/ru/docs/Web/Reference/Events/close_websocket)                            | {{DOMxRef("Event")}}                                                                                     | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A WebSocket connection has been closed.                                                                                                                                                                                              |
-| [`complete`](/ru/docs/Web/Reference/Events/complete_indexedDB)                      |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#transaction)                                                                                                                                                      | A transaction successfully completed.                                                                                                                                                                                                |
-| {{Event("complete")}}                                                               | {{DOMxRef("OfflineAudioCompletionEvent")}} {{Deprecated_Inline}}                                         | [Web Audio API](https://www.w3.org/TR/webaudio/#OfflineAudioCompletionEvent-section)                                                                                                                          | The rendering of an {{DOMxRef("OfflineAudioContext")}} is terminated.                                                                                                                                                                |
-| {{Event("compositionend")}}                                                         | {{DOMxRef("CompositionEvent")}}                                                                          | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-compositionend)                                                                                                                                  | The composition of a passage of text has been completed or canceled.                                                                                                                                                                 |
-| {{Event("compositionstart")}}                                                       | {{DOMxRef("CompositionEvent")}}                                                                          | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-compositionstart)                                                                                                                                | The composition of a passage of text is prepared (similar to keydown for a keyboard input, but works with other inputs such as speech recognition).                                                                                  |
-| {{Event("compositionupdate")}}                                                      | {{DOMxRef("CompositionEvent")}}                                                                          | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-compositionupdate)                                                                                                                               | A character is added to a passage of text being composed.                                                                                                                                                                            |
-| {{Event("contextmenu")}}                                                            | {{DOMxRef("MouseEvent")}}                                                                                | [HTML5](https://html.spec.whatwg.org/multipage/forms.html#context-menus)                                                                                                                                      | The right button of the mouse is clicked (before the context menu is displayed).                                                                                                                                                     |
-| {{Event("copy")}}                                                                   | {{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}}                                                    | [Clipboard](http://www.w3.org/TR/clipboard-apis/#copy-event)                                                                                                                                                  | The text selection has been added to the clipboard.                                                                                                                                                                                  |
-| {{Event("cut")}}                                                                    | {{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}}                                                    | [Clipboard](http://www.w3.org/TR/clipboard-apis/#cut-event)                                                                                                                                                   | The text selection has been removed from the document and added to the clipboard.                                                                                                                                                    |
-| {{Event("dblclick")}}                                                               | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-dblclick)                                                                                                                                        | A pointing device button is clicked twice on an element.                                                                                                                                                                             |
-| {{Event("devicechange")}}                                                           | {{DOMxRef("Event")}}                                                                                     | [Media Capture and Streams](https://w3c.github.io/mediacapture-main/)                                                                                                                                         | A media device such as a camera, microphone, or speaker is connected or removed from the system.                                                                                                                                     |
-| {{Event("devicemotion")}}                                                           | {{DOMxRef("DeviceMotionEvent")}} {{Experimental_Inline}}                                                 | [Device Orientation Events](http://dev.w3.org/geo/api/spec-source-orientation.html)                                                                                                                           | Fresh data is available from a motion sensor.                                                                                                                                                                                        |
-| {{Event("deviceorientation")}}                                                      | {{DOMxRef("DeviceOrientationEvent")}} {{Experimental_Inline}}                                            | [Device Orientation Events](http://dev.w3.org/geo/api/spec-source-orientation.html)                                                                                                                           | Fresh data is available from an orientation sensor.                                                                                                                                                                                  |
-| {{Event("dischargingtimechange")}}                                                  | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The `dischargingTime` attribute has been updated.                                                                                                                                                                                    |
-| `DOMActivate` {{Deprecated_Inline}}                                                 | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMActivate)                                                                                                                                     | A button, link or state changing element is activated (use {{Event("click")}} instead).                                                                                                                                              |
-| [`DOMAttributeNameChanged`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}     | {{DOMxRef("MutationNameEvent")}}                                                                         | [DOM L3](http://www.w3.org/TR/2011/WD-DOM-Level-3-Events-20110531/#event-type-DOMAttributeNameChanged) Removed                                                                                                | The name of an attribute changed (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                                  |
-| [`DOMAttrModified`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}             | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttrModified)                                                                                                                                 | The value of an attribute has been modified (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                       |
-| [`DOMCharacterDataModified`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}    | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMCharacterDataModified)                                                                                                                        | A text or another [CharacterData](/ru/docs/DOM/CharacterData) has changed (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                         |
-| {{Event("DOMContentLoaded")}}                                                       | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-end.html#the-end)                                                                                                                     | The document has finished loading (but not its dependent resources).                                                                                                                                                                 |
-| [`DOMElementNameChanged`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}       | {{DOMxRef("MutationNameEvent")}}                                                                         | [DOM L3](http://www.w3.org/TR/2011/WD-DOM-Level-3-Events-20110531/#event-type-DOMElementNameChanged) Removed                                                                                                  | The name of an element changed (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                                    |
-| `DOMFocusIn` {{Deprecated_Inline}}                                                  | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMFocusIn)                                                                                                                                      | An element has received focus (use {{Event("focus")}} or {{Event("focusin")}} instead).                                                                                                                                              |
-| `DOMFocusOut` {{Deprecated_Inline}}                                                 | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMFocusOut)                                                                                                                                     | An element has lost focus (use {{Event("blur")}} or {{Event("focusout")}} instead).                                                                                                                                                  |
-| [`DOMNodeInserted`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}             | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeInserted)                                                                                                                                 | A node has been added as a child of another node (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                  |
-| [`DOMNodeInsertedIntoDocument`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}} | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeInsertedIntoDocument)                                                                                                                     | A node has been inserted into the document (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                        |
-| [`DOMNodeRemoved`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}              | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeRemoved)                                                                                                                                  | A node has been removed from its parent node (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                      |
-| [`DOMNodeRemovedFromDocument`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}  | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeRemovedFromDocument)                                                                                                                      | A node has been removed from the document (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                         |
-| [`DOMSubtreeModified`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}          | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMSubtreeModified)                                                                                                                              | A change happened in the document (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                                 |
-| {{Event("drag")}}                                                                   | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-drag)                                                                                                                      | An element or text selection is being dragged (every 350ms).                                                                                                                                                                         |
-| {{Event("dragend")}}                                                                | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragend)                                                                                                                   | A drag operation is being ended (by releasing a mouse button or hitting the escape key).                                                                                                                                             |
-| {{Event("dragenter")}}                                                              | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragenter)                                                                                                                 | A dragged element or text selection enters a valid drop target.                                                                                                                                                                      |
-| {{Event("dragleave")}}                                                              | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragleave)                                                                                                                 | A dragged element or text selection leaves a valid drop target.                                                                                                                                                                      |
-| {{Event("dragover")}}                                                               | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragover)                                                                                                                  | An element or text selection is being dragged over a valid drop target (every 350ms).                                                                                                                                                |
-| {{Event("dragstart")}}                                                              | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragstart)                                                                                                                 | The user starts dragging an element or text selection.                                                                                                                                                                               |
-| {{Event("drop")}}                                                                   | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-drop)                                                                                                                      | An element is dropped on a valid drop target.                                                                                                                                                                                        |
-| {{Event("durationchange")}}                                                         | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-durationchange)                                                                                  | The `duration` attribute has been updated.                                                                                                                                                                                           |
-| {{Event("emptied")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-emptied)                                                                                         | The media has become empty; for example, this event is sent if the media has already been loaded (or partially loaded), and the [`load()`](/ru/docs/XPCOM_Interface_Reference/NsIDOMHTMLMediaElement) method is called to reload it. |
-| {{Event("end_(SpeechRecognition)","end")}} {{Experimental_Inline}}                  | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service has disconnected.                                                                                                                                                                                     |
-| {{Event("end_(SpeechSynthesis)","end")}} {{Experimental_Inline}}                    | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The utterance has finished being spoken.                                                                                                                                                                                             |
-| {{Event("ended")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-ended)                                                                                           | Playback has stopped because the end of the media was reached.                                                                                                                                                                       |
-| {{Event("ended_(Web_Audio)", "ended")}}                                             | {{DOMxRef("Event")}}                                                                                     | [Web Audio API](https://www.w3.org/TR/webaudio/)                                                                                                                                                              | Playback has stopped because the end of the media was reached.                                                                                                                                                                       |
-| {{Event("endEvent")}}                                                               | {{DOMxRef("TimeEvent")}}                                                                                 | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | A [SMIL](/ru/docs/SVG/SVG_animation_with_SMIL) animation element ends.                                                                                                                                                               |
-| {{Event("error")}}                                                                  | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-error)                                                                                                                                           | A resource failed to load.                                                                                                                                                                                                           |
-| {{Event("error")}}                                                                  | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-error)                                                                                  | Progression has failed.                                                                                                                                                                                                              |
-| {{Event("error")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A WebSocket connection has been closed with prejudice (some data couldn't be sent for example).                                                                                                                                      |
-| {{Event("error")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [Server Sent Events](http://dev.w3.org/html5/eventsource/)                                                                                                                                                    | An event source connection has been failed.                                                                                                                                                                                          |
-| {{Event("error")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | A request caused an error and failed.                                                                                                                                                                                                |
-| {{Event("error_(SpeechRecognitionError)","error")}} {{Experimental_Inline}}         | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | A speech recognition error occurs.                                                                                                                                                                                                   |
-| {{Event("error_(SpeechSynthesisError)","error")}}                                   | {{DOMxRef("SpeechSynthesisErrorEvent")}}                                                                 | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | An error occurs that prevents the utterance from being successfully spoken.                                                                                                                                                          |
-| {{Event("focus")}}                                                                  | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-focus)                                                                                                                                           | An element has received focus (does not bubble).                                                                                                                                                                                     |
-| {{Event("focusin")}}                                                                | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-focusIn)                                                                                                                                         | An element is about to receive focus (bubbles).                                                                                                                                                                                      |
-| {{Event("focusout")}}                                                               | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-focusout)                                                                                                                                        | An element is about to lose focus (bubbles).                                                                                                                                                                                         |
-| {{Event("fullscreenchange")}}                                                       | {{DOMxRef("Event")}}                                                                                     | [Full Screen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api)                                                                                                                               | An element was turned to fullscreen mode or back to normal mode.                                                                                                                                                                     |
-| {{Event("fullscreenerror")}}                                                        | {{DOMxRef("Event")}}                                                                                     | [Full Screen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api)                                                                                                                               | It was impossible to switch to fullscreen mode for technical reasons or because the permission was denied.                                                                                                                           |
-| {{Event("gamepadconnected")}}                                                       | {{DOMxRef("GamepadEvent")}} {{Experimental_Inline}}                                                      | [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepadconnected-event)                                                                                                                                           | A gamepad has been connected.                                                                                                                                                                                                        |
-| {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}              | {{DOMxRef("GamepadEvent")}} {{Experimental_Inline}}                                                      | [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepaddisconnected-event)                                                                                                                                        | A gamepad has been disconnected.                                                                                                                                                                                                     |
-| {{Event("gotpointercapture")}}                                                      | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-gotpointercapture-event)                                                                                                                             | Element receives pointer capture.                                                                                                                                                                                                    |
-| {{Event("hashchange")}}                                                             | {{DOMxRef("HashChangeEvent")}}                                                                           | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-hashchange)                                                                                                            | The fragment identifier of the URL has changed (the part of the URL after the #).                                                                                                                                                    |
-| {{Event("lostpointercapture")}}                                                     | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-lostpointercapture-event)                                                                                                                            | Element lost pointer capture.                                                                                                                                                                                                        |
-| {{Event("input")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.w3.org/TR/html5/forms.html#common-event-behaviors)                                                                                                                                         | The value of an element changes or the content of an element with the attribute [contenteditable](/ru/docs/DOM/Element.contentEditable) is modified.                                                                                 |
-| {{Event("invalid")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/association-of-controls-and-forms.html#constraint-validation)                                                                             | A submittable element has been checked and doesn't satisfy its constraints.                                                                                                                                                          |
-| {{Event("keydown")}}                                                                | {{DOMxRef("KeyboardEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-keydown)                                                                                                                                         | A key is pressed down.                                                                                                                                                                                                               |
-| {{Event("keypress")}} {{Deprecated_Inline}}                                         | {{DOMxRef("KeyboardEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-keypress)                                                                                                                                        | A key is pressed down and that key normally produces a character value (use input instead).                                                                                                                                          |
-| {{Event("keyup")}}                                                                  | {{DOMxRef("KeyboardEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-keyup)                                                                                                                                           | A key is released.                                                                                                                                                                                                                   |
-| {{Event("languagechange")}} {{Experimental_Inline}}                                 | {{DOMxRef("Event")}}                                                                                     | [HTML 5.1](https://www.w3.org/TR/html51/#dom-navigator-languages)                                                                                                                                             | The user's preferred languages have changed.                                                                                                                                                                                         |
-| {{Event("levelchange")}}                                                            | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The `level` attribute has been updated.                                                                                                                                                                                              |
-| {{Event("load")}}                                                                   | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-load)                                                                                                                                            | A resource and its dependent resources have finished loading.                                                                                                                                                                        |
-| [`load`](</ru/docs/Web/Reference/Events/load_(ProgressEvent)>)                      | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-load)                                                                                   | Progression has been successful.                                                                                                                                                                                                     |
-| {{Event("loadeddata")}}                                                             | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-loadeddata)                                                                                      | The first frame of the media has finished loading.                                                                                                                                                                                   |
-| {{Event("loadedmetadata")}}                                                         | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-loadedmetadata)                                                                                  | The metadata has been loaded.                                                                                                                                                                                                        |
-| {{Event("loadend")}}                                                                | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-loadend)                                                                                | Progress has stopped (after "error", "abort" or "load" have been dispatched).                                                                                                                                                        |
-| {{Event("loadstart")}}                                                              | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-loadstart)                                                                              | Progress has begun.                                                                                                                                                                                                                  |
-| {{Event("mark")}} {{Experimental_Inline}}                                           | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The spoken utterance reaches a named SSML "mark" tag.                                                                                                                                                                                |
-| [`message`](/ru/docs/Web/Reference/Events/message_websocket)                        | {{DOMxRef("MessageEvent")}}                                                                              | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A message is received through a WebSocket.                                                                                                                                                                                           |
-| [`message`](/ru/docs/Web/Reference/Events/message_webworker)                        | {{DOMxRef("MessageEvent")}}                                                                              | [Web Workers](http://www.w3.org/TR/workers/#communicating-with-a-dedicated-worker)                                                                                                                            | A message is received from a Web Worker.                                                                                                                                                                                             |
-| [`message`](/ru/docs/Web/Reference/Events/message_webmessaging)                     | {{DOMxRef("MessageEvent")}}                                                                              | [Web Messaging](http://www.w3.org/TR/webmessaging/)                                                                                                                                                           | A message is received from a child (i)frame or a parent window.                                                                                                                                                                      |
-| [`message`](/ru/docs/Web/Reference/Events/message_serversentevents)                 | {{DOMxRef("MessageEvent")}}                                                                              | [Server Sent Events](http://dev.w3.org/html5/eventsource/)                                                                                                                                                    | A message is received through an event source.                                                                                                                                                                                       |
-| {{Event("messageerror")}}                                                           | {{DOMxRef("MessageEvent")}}                                                                              | {{DOMxRef("MessagePort")}}, [Web Workers](/ru/docs/Web/API/Web_Workers_API), [Broadcast Channel](/ru/docs/Web/API/Broadcast_Channel_API), {{DOMxRef("Window")}}                                               | A message error is raised when a message is received by an object.                                                                                                                                                                   |
-| {{Event("message_(ServiceWorker)","message")}} {{Experimental_Inline}}              | {{DOMxRef("ServiceWorkerMessageEvent")}} or {{DOMxRef("ExtendableMessageEvent")}}, depending on context. | [Service Workers](/ru/docs/Web/API/Service_Worker_API)                                                                                                                                                        | A message is received from a service worker, or a message is received in a service worker from another context.                                                                                                                      |
-| {{Event("mousedown")}}                                                              | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mousedown)                                                                                                                                       | A pointing device button (usually a mouse) is pressed on an element.                                                                                                                                                                 |
-| {{Event("mouseenter")}}                                                             | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseenter)                                                                                                                                      | A pointing device is moved onto the element that has the listener attached.                                                                                                                                                          |
-| {{Event("mouseleave")}}                                                             | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseleave)                                                                                                                                      | A pointing device is moved off the element that has the listener attached.                                                                                                                                                           |
-| {{Event("mousemove")}}                                                              | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mousemove)                                                                                                                                       | A pointing device is moved over an element.                                                                                                                                                                                          |
-| {{Event("mouseout")}}                                                               | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseout)                                                                                                                                        | A pointing device is moved off the element that has the listener attached or off one of its children.                                                                                                                                |
-| {{Event("mouseover")}}                                                              | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseover)                                                                                                                                       | A pointing device is moved onto the element that has the listener attached or onto one of its children.                                                                                                                              |
-| {{Event("mouseup")}}                                                                | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseup)                                                                                                                                         | A pointing device button is released over an element.                                                                                                                                                                                |
-| {{Event("nomatch")}} {{Experimental_Inline}}                                        | {{DOMxRef("SpeechRecognitionEvent")}}                                                                    | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service returns a final result with no significant recognition.                                                                                                                                               |
-| {{Event("notificationclick")}}                                                      | {{DOMxRef("NotificationEvent")}} {{Experimental_Inline}}                                                 | [Notifications API](https://notifications.spec.whatwg.org/#dom-serviceworkerglobalscope-onnotificationclick)                                                                                                  | A system notification spawned by {{DOMxRef("ServiceWorkerRegistration.showNotification()")}} has been clicked.                                                                                                                       |
-| {{Event("offline")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 offline](http://www.whatwg.org/specs/web-apps/current-work/multipage/offline.html#event-offline)                                                                                                       | The browser has lost access to the network.                                                                                                                                                                                          |
-| {{Event("online")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 offline](http://www.whatwg.org/specs/web-apps/current-work/multipage/offline.html#event-online)                                                                                                        | The browser has gained access to the network (but particular websites might be unreachable).                                                                                                                                         |
-| [`open`](/ru/docs/Web/Reference/Events/open_websocket)                              | {{DOMxRef("Event")}}                                                                                     | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A WebSocket connection has been established.                                                                                                                                                                                         |
-| [`open`](/ru/docs/Web/Reference/Events/open_serversentevents)                       | {{DOMxRef("Event")}}                                                                                     | [Server Sent Events](http://dev.w3.org/html5/eventsource/)                                                                                                                                                    | An event source connection has been established.                                                                                                                                                                                     |
-| {{Event("orientationchange")}}                                                      | {{DOMxRef("Event")}}                                                                                     | [Screen Orientation](http://www.w3.org/TR/screen-orientation/)                                                                                                                                                | The orientation of the device (portrait/landscape) has changed                                                                                                                                                                       |
-| {{Event("pagehide")}}                                                               | {{DOMxRef("PageTransitionEvent")}}                                                                       | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-pagehide)                                                                                                              | A session history entry is being traversed from.                                                                                                                                                                                     |
-| {{Event("pageshow")}}                                                               | {{DOMxRef("PageTransitionEvent")}}                                                                       | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-pageshow)                                                                                                              | A session history entry is being traversed to.                                                                                                                                                                                       |
-| {{Event("paste")}}                                                                  | {{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}}                                                    | [Clipboard](http://www.w3.org/TR/clipboard-apis/#paste-event)                                                                                                                                                 | Data has been transferred from the system clipboard to the document.                                                                                                                                                                 |
-| {{Event("pause")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-pause)                                                                                           | Playback has been paused.                                                                                                                                                                                                            |
-| {{Event("pause_(SpeechSynthesis)", "pause")}} {{Experimental_Inline}}               | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The utterance is paused part way through.                                                                                                                                                                                            |
-| {{Event("pointercancel")}}                                                          | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointercancel-event)                                                                                                                                 | The pointer is unlikely to produce any more events.                                                                                                                                                                                  |
-| {{Event("pointerdown")}}                                                            | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerdown-event)                                                                                                                                   | The pointer enters the active buttons state.                                                                                                                                                                                         |
-| {{Event("pointerenter")}}                                                           | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerenter-event)                                                                                                                                  | Pointing device is moved inside the hit-testing boundary.                                                                                                                                                                            |
-| {{Event("pointerleave")}}                                                           | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerleave-event)                                                                                                                                  | Pointing device is moved out of the hit-testing boundary.                                                                                                                                                                            |
-| {{Event("pointerlockchange")}}                                                      | {{DOMxRef("Event")}}                                                                                     | [Pointer Lock](http://www.w3.org/TR/pointerlock/#pointerlockchange-and-pointerlockerror-events)                                                                                                               | The pointer was locked or released.                                                                                                                                                                                                  |
-| {{Event("pointerlockerror")}}                                                       | {{DOMxRef("Event")}}                                                                                     | [Pointer Lock](http://www.w3.org/TR/pointerlock/#pointerlockchange-and-pointerlockerror-events)                                                                                                               | It was impossible to lock the pointer for technical reasons or because the permission was denied.                                                                                                                                    |
-| {{Event("pointermove")}}                                                            | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointermove-event)                                                                                                                                   | The pointer changed coordinates.                                                                                                                                                                                                     |
-| {{Event("pointerout")}}                                                             | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerout-event)                                                                                                                                    | The pointing device moved out of hit-testing boundary or leaves detectable hover range.                                                                                                                                              |
-| {{Event("pointerover")}}                                                            | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerover-event)                                                                                                                                   | The pointing device is moved into the hit-testing boundary.                                                                                                                                                                          |
-| {{Event("pointerup")}}                                                              | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerup-event)                                                                                                                                     | The pointer leaves the active buttons state.                                                                                                                                                                                         |
-| {{Event("play")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-play)                                                                                            | Playback has begun.                                                                                                                                                                                                                  |
-| {{Event("playing")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-playing)                                                                                         | Playback is ready to start after having been paused or delayed due to lack of data.                                                                                                                                                  |
-| {{Event("popstate")}}                                                               | {{DOMxRef("PopStateEvent")}}                                                                             | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-popstate)                                                                                                              | A session history entry is being navigated to (in certain cases).                                                                                                                                                                    |
-| {{Event("progress")}}                                                               | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-progress)                                                                               | In progress.                                                                                                                                                                                                                         |
-| {{Event("push")}}                                                                   | {{DOMxRef("PushEvent")}} {{Experimental_Inline}}                                                         | [Push API](https://w3c.github.io/push-api/)                                                                                                                                                                   | A [Service Worker](/ru/docs/Web/API/Service_Worker_API) has received a push message.                                                                                                                                                 |
-| {{Event("pushsubscriptionchange")}}                                                 | {{DOMxRef("PushEvent")}} {{Experimental_Inline}}                                                         | [Push API](https://w3c.github.io/push-api/)                                                                                                                                                                   | A [PushSubscription](/ru/docs/Web/API/PushSubscription) has expired.                                                                                                                                                                 |
-| {{Event("ratechange")}}                                                             | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-ratechange)                                                                                      | The playback rate has changed.                                                                                                                                                                                                       |
-| {{Event("readystatechange")}}                                                       | {{DOMxRef("Event")}}                                                                                     | HTML5 and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-readystatechange)                                                                                                                   | The readyState attribute of a document has changed.                                                                                                                                                                                  |
-| {{Event("repeatEvent")}}                                                            | {{DOMxRef("TimeEvent")}}                                                                                 | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | A [SMIL](/ru/docs/SVG/SVG_animation_with_SMIL) animation element is repeated.                                                                                                                                                        |
-| {{Event("reset")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [DOM L2](http://www.w3.org/TR/DOM-Level-2-Events/events.html), [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/association-of-controls-and-forms.html#form-submission-0#resetting-a-form) | A form is reset.                                                                                                                                                                                                                     |
-| {{Event("resize")}}                                                                 | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-resize)                                                                                                                                          | The document view has been resized.                                                                                                                                                                                                  |
-| {{Event("resourcetimingbufferfull")}}                                               | {{DOMxRef("Performance")}}                                                                               | [Resource Timing](https://w3c.github.io/resource-timing/#dom-performance-onresourcetimingbufferfull)                                                                                                          | The browser's resource timing buffer is full.                                                                                                                                                                                        |
-| {{Event("result")}} {{Experimental_Inline}}                                         | {{DOMxRef("SpeechRecognitionEvent")}} {{Experimental_Inline}}                                            | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service returns a result — a word or phrase has been positively recognized and this has been communicated back to the app.                                                                                    |
-| {{Event("resume")}} {{Experimental_Inline}}                                         | {{DOMxRef("SpeechSynthesisEvent")}} {{Experimental_Inline}}                                              | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | A paused utterance is resumed.                                                                                                                                                                                                       |
-| {{Event("scroll")}}                                                                 | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-scroll)                                                                                                                                          | The document view or an element has been scrolled.                                                                                                                                                                                   |
-| {{Event("seeked")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-seeked)                                                                                          | A _seek_ operation completed.                                                                                                                                                                                                        |
-| {{Event("seeking")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-seeking)                                                                                         | A _seek_ operation began.                                                                                                                                                                                                            |
-| {{Event("select")}}                                                                 | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-select)                                                                                                                                          | Some text is being selected.                                                                                                                                                                                                         |
-| {{Event("selectstart")}} {{Experimental_Inline}}                                    | {{DOMxRef("Event")}}                                                                                     | [Selection API](https://w3c.github.io/selection-api/)                                                                                                                                                         | A selection just started.                                                                                                                                                                                                            |
-| {{Event("selectionchange")}} {{Experimental_Inline}}                                | {{DOMxRef("Event")}}                                                                                     | [Selection API](https://w3c.github.io/selection-api/)                                                                                                                                                         | The selection in the document has been changed.                                                                                                                                                                                      |
-| {{Event("show")}}                                                                   | {{DOMxRef("MouseEvent")}}                                                                                | [HTML5](http://www.w3.org/TR/html5/interactive-elements.html#context-menus)                                                                                                                                   | A contextmenu event was fired on/bubbled to an element that has a [contextmenu](/ru/docs/DOM/element.contextmenu) attribute                                                                                                          |
-| {{Event("slotchange")}}                                                             | {{DOMxRef("Event")}}                                                                                     | [DOM](https://dom.spec.whatwg.org/)                                                                                                                                                                           | The node contents of a {{DOMxRef("HTMLSlotElement")}} ({{htmlelement("slot")}}) have changed.                                                                                                                                        |
-| {{Event("soundend")}} {{Experimental_Inline}}                                       | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Any sound — recognisable speech or not — has stopped being detected.                                                                                                                                                                 |
-| {{Event("soundstart")}} {{Experimental_Inline}}                                     | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Any sound — recognisable speech or not — has been detected.                                                                                                                                                                          |
-| {{Event("speechend")}} {{Experimental_Inline}}                                      | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Speech recognised by the speech recognition service has stopped being detected.                                                                                                                                                      |
-| {{Event("speechstart")}} {{Experimental_Inline}}                                    | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Sound that is recognised by the speech recognition service as speech has been detected.                                                                                                                                              |
-| {{Event("stalled")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-stalled)                                                                                         | The user agent is trying to fetch media data, but data is unexpectedly not forthcoming.                                                                                                                                              |
-| {{Event("start_(SpeechRecognition)","start")}} {{Experimental_Inline}}              | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service has begun listening to incoming audio with intent to recognize grammars associated with the current `SpeechRecognition`.                                                                              |
-| {{Event("start_(SpeechSynthesis)","start")}}                                        | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The utterance has begun to be spoken.                                                                                                                                                                                                |
-| {{Event("storage")}}                                                                | {{DOMxRef("StorageEvent")}}                                                                              | [Web Storage](http://www.w3.org/TR/webstorage/#the-storage-event)                                                                                                                                             | A storage area ([localStorage](/ru/docs/DOM/Storage#localStorage) or [sessionStorage](/ru/docs/DOM/Storage#sessionStorage)) has changed.                                                                                             |
-| {{Event("submit")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [DOM L2](http://www.w3.org/TR/DOM-Level-2-Events/events.html), [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/association-of-controls-and-forms.html#form-submission-algorithm)          | A form is submitted.                                                                                                                                                                                                                 |
-| [`success`](/ru/docs/Web/Reference/Events/success_indexedDB)                        | {{DOMxRef("Event")}}                                                                                     | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | A request successfully completed.                                                                                                                                                                                                    |
-| {{Event("suspend")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-suspend)                                                                                         | Media data loading has been suspended.                                                                                                                                                                                               |
-| {{Event("SVGAbort")}}                                                               | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | Page loading has been stopped before the [SVG](/ru/docs/SVG) was loaded.                                                                                                                                                             |
-| {{Event("SVGError")}}                                                               | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An error has occurred before the [SVG](/ru/docs/SVG) was loaded.                                                                                                                                                                     |
-| {{Event("SVGLoad")}}                                                                | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document has been loaded and parsed.                                                                                                                                                                          |
-| {{Event("SVGResize")}}                                                              | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document is being resized.                                                                                                                                                                                    |
-| {{Event("SVGScroll")}}                                                              | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document is being scrolled.                                                                                                                                                                                   |
-| {{Event("SVGUnload")}}                                                              | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document has been removed from a window or frame.                                                                                                                                                             |
-| {{Event("SVGZoom")}}                                                                | {{DOMxRef("SVGZoomEvent")}}                                                                              | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document is being zoomed.                                                                                                                                                                                     |
-| {{Event("timeout")}}                                                                | {{DOMxRef("ProgressEvent")}}                                                                             | [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-timeout)                                                                                                                                      |                                                                                                                                                                                                                                      |
-| {{Event("timeupdate")}}                                                             | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-timeupdate)                                                                                      | The time indicated by the `currentTime` attribute has been updated.                                                                                                                                                                  |
-| {{Event("touchcancel")}}                                                            | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/)                                                                                                                                                            | A touch point has been disrupted in an implementation-specific manners (too many touch points for example).                                                                                                                          |
-| {{Event("touchend")}}                                                               | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/#the-touchend-event)                                                                                                                                         | A touch point is removed from the touch surface.                                                                                                                                                                                     |
-| {{Event("touchmove")}}                                                              | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/#the-touchmove-event)                                                                                                                                        | A touch point is moved along the touch surface.                                                                                                                                                                                      |
-| {{Event("touchstart")}}                                                             | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/#the-touchstart---------event)                                                                                                                               | A touch point is placed on the touch surface.                                                                                                                                                                                        |
-| {{Event("transitionend")}}                                                          | {{DOMxRef("TransitionEvent")}} {{Experimental_Inline}}                                                   | [CSS Transitions](http://www.w3.org/TR/css3-transitions/#transition-events)                                                                                                                                   | A [CSS transition](/ru/docs/CSS/CSS_transitions) has completed.                                                                                                                                                                      |
-| {{Event("unload")}}                                                                 | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-unload)                                                                                                                                          | The document or a dependent resource is being unloaded.                                                                                                                                                                              |
-| [`upgradeneeded`](/ru/docs/Web/Reference/Events/upgradeneeded_indexedDB)            |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | An attempt was made to open a database with a version number higher than its current version. A `versionchange` transaction has been created.                                                                                        |
-| {{Event("userproximity")}}                                                          | {{DOMxRef("UserProximityEvent")}} {{Experimental_Inline}}                                                | [Proximity Sensor](https://w3c.github.io/proximity/)                                                                                                                                                          | Fresh data is available from a proximity sensor (indicates whether the nearby object is `near` the device or not).                                                                                                                   |
-| {{Event("voiceschanged")}} {{Experimental_Inline}}                                  | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The list of {{DOMxRef("SpeechSynthesisVoice")}} objects that would be returned by the {{DOMxRef("SpeechSynthesis.getVoices()")}} method has changed (when the {{Event("voiceschanged")}} event fires.)                               |
-| [`versionchange`](/ru/docs/Web/Reference/Events/versionchange_indexedDB)            |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#database-interface)                                                                                                                                               | A `versionchange` transaction completed.                                                                                                                                                                                             |
-| {{Event("visibilitychange")}}                                                       | {{DOMxRef("Event")}}                                                                                     | [Page visibility](http://www.w3.org/TR/page-visibility/#sec-visibilitychange-event)                                                                                                                           | The content of a tab has become visible or has been hidden.                                                                                                                                                                          |
-| {{Event("volumechange")}}                                                           | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-volumechange)                                                                                    | The volume has changed.                                                                                                                                                                                                              |
-| {{Event("waiting")}}                                                                | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-waiting)                                                                                         | Playback has stopped because of a temporary lack of data.                                                                                                                                                                            |
-| {{Event("wheel")}}                                                                  | {{DOMxRef("WheelEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-wheel)                                                                                                                                           | A wheel button of a pointing device is rotated in any direction.                                                                                                                                                                     |
+| Имя события                                                                          | Тип события                                                                                              | Спецификация                                                                                                                                                                                                  | Происходит когда...                                                                                                                                                                                                                  |
+| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| {{Event("abort")}}                                                                   | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-abort)                                                                                                                                           | The loading of a resource has been aborted.                                                                                                                                                                                          |
+| [`abort`](</ru/docs/Web/Reference/Events/abort_(ProgressEvent)>)                     | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-abort)                                                                                  | Progression has been terminated (not due to an error).                                                                                                                                                                               |
+| [`abort`](/ru/docs/Web/Reference/Events/abort_indexedDB)                             | {{DOMxRef("Event")}}                                                                                     | [IndexedDB](http://www.w3.org/TR/IndexedDB/#database-interface)                                                                                                                                               | A transaction has been aborted.                                                                                                                                                                                                      |
+| {{Event("afterprint")}}                                                              | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.w3.org/TR/html5/webappapis.html#printing)                                                                                                                                                  | The associated document has started printing or the print preview has been closed.                                                                                                                                                   |
+| {{Event("animationcancel")}}                                                         | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) has aborted.                                                                                                                                                                          |
+| {{Event("animationend")}}                                                            | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) has completed.                                                                                                                                                                        |
+| {{Event("animationiteration")}}                                                      | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) is repeated.                                                                                                                                                                          |
+| {{Event("animationstart")}}                                                          | {{DOMxRef("AnimationEvent")}} {{Experimental_Inline}}                                                    | [CSS Animations](http://www.w3.org/TR/css3-animations/#animation-events)                                                                                                                                      | A [CSS animation](/ru/docs/CSS/CSS_animations) has started.                                                                                                                                                                          |
+| {{Event("appinstalled")}}                                                            | {{DOMxRef("Event")}}                                                                                     | [Web App Manifest](/ru/docs/Web/Manifest)                                                                                                                                                                     | A web application is successfully installed as a [progressive web app](/en-US/Apps/Progressive).                                                                                                                                     |
+| {{Event("audioprocess")}}                                                            | {{DOMxRef("AudioProcessingEvent")}} {{Deprecated_Inline}}                                                | [Web Audio API](https://www.w3.org/TR/webaudio/#AudioProcessingEvent)                                                                                                                                         | The input buffer of a {{DOMxRef("ScriptProcessorNode")}} is ready to be processed.                                                                                                                                                   |
+| {{Event("audioend")}} {{Experimental_Inline}}                                        | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The user agent has finished capturing audio for speech recognition.                                                                                                                                                                  |
+| {{Event("audiostart")}} {{Experimental_Inline}}                                      | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The user agent has started to capture audio for speech recognition.                                                                                                                                                                  |
+| {{Event("beforeprint")}}                                                             | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.w3.org/TR/html5/webappapis.html#printing)                                                                                                                                                  | The associated document is about to be printed or previewed for printing.                                                                                                                                                            |
+| {{Event("beforeunload")}}                                                            | {{DOMxRef("BeforeUnloadEvent")}}                                                                         | [HTML5](http://www.w3.org/TR/html5/browsers.html#unloading-documents)                                                                                                                                         | The window, the document and its resources are about to be unloaded.                                                                                                                                                                 |
+| {{Event("beginEvent")}}                                                              | {{DOMxRef("TimeEvent")}}                                                                                 | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | A [SMIL](/ru/docs/SVG/SVG_animation_with_SMIL) animation element begins.                                                                                                                                                             |
+| [`blocked`](/ru/docs/Web/Reference/Events/blocked_indexedDB)                         |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | An open connection to a database is blocking a `versionchange` transaction on the same database.                                                                                                                                     |
+| {{Event("blur")}}                                                                    | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-blur)                                                                                                                                            | An element has lost focus (does not bubble).                                                                                                                                                                                         |
+| {{Event("boundary")}} {{Experimental_Inline}}                                        | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The spoken utterance reaches a word or sentence boundary                                                                                                                                                                             |
+| {{Event("canplay")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-canplay)                                                                                         | The user agent can play the media, but estimates that not enough data has been loaded to play the media up to its end without having to stop for further buffering of content.                                                       |
+| {{Event("canplaythrough")}}                                                          | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-canplaythrough)                                                                                  | The user agent can play the media up to its end without having to stop for further buffering of content.                                                                                                                             |
+| {{Event("change")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [DOM L2](http://www.w3.org/TR/DOM-Level-2-Events/events.html), [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/common-input-element-attributes.html#event-input-change)                   | The `change` event is fired for {{HTMLElement("input")}}, {{HTMLElement("select")}}, and {{HTMLElement("textarea")}} elements when a change to the element's value is committed by the user.                                         |
+| {{Event("chargingchange")}}                                                          | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The battery begins or stops charging.                                                                                                                                                                                                |
+| {{Event("chargingtimechange")}}                                                      | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The `chargingTime` attribute has been updated.                                                                                                                                                                                       |
+| {{Event("click")}}                                                                   | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-click)                                                                                                                                           | A pointing device button has been pressed and released on an element.                                                                                                                                                                |
+| [`close`](/ru/docs/Web/Reference/Events/close_websocket)                             | {{DOMxRef("Event")}}                                                                                     | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A WebSocket connection has been closed.                                                                                                                                                                                              |
+| [`complete`](/ru/docs/Web/Reference/Events/complete_indexedDB)                       |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#transaction)                                                                                                                                                      | A transaction successfully completed.                                                                                                                                                                                                |
+| {{Event("complete")}}                                                                | {{DOMxRef("OfflineAudioCompletionEvent")}} {{Deprecated_Inline}}                                         | [Web Audio API](https://www.w3.org/TR/webaudio/#OfflineAudioCompletionEvent-section)                                                                                                                          | The rendering of an {{DOMxRef("OfflineAudioContext")}} is terminated.                                                                                                                                                                |
+| {{Event("compositionend")}}                                                          | {{DOMxRef("CompositionEvent")}}                                                                          | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-compositionend)                                                                                                                                  | The composition of a passage of text has been completed or canceled.                                                                                                                                                                 |
+| {{Event("compositionstart")}}                                                        | {{DOMxRef("CompositionEvent")}}                                                                          | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-compositionstart)                                                                                                                                | The composition of a passage of text is prepared (similar to keydown for a keyboard input, but works with other inputs such as speech recognition).                                                                                  |
+| {{Event("compositionupdate")}}                                                       | {{DOMxRef("CompositionEvent")}}                                                                          | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-compositionupdate)                                                                                                                               | A character is added to a passage of text being composed.                                                                                                                                                                            |
+| {{Event("contextmenu")}}                                                             | {{DOMxRef("MouseEvent")}}                                                                                | [HTML5](https://html.spec.whatwg.org/multipage/forms.html#context-menus)                                                                                                                                      | The right button of the mouse is clicked (before the context menu is displayed).                                                                                                                                                     |
+| {{Event("copy")}}                                                                    | {{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}}                                                    | [Clipboard](http://www.w3.org/TR/clipboard-apis/#copy-event)                                                                                                                                                  | The text selection has been added to the clipboard.                                                                                                                                                                                  |
+| {{Event("cut")}}                                                                     | {{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}}                                                    | [Clipboard](http://www.w3.org/TR/clipboard-apis/#cut-event)                                                                                                                                                   | The text selection has been removed from the document and added to the clipboard.                                                                                                                                                    |
+| {{Event("dblclick")}}                                                                | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-dblclick)                                                                                                                                        | A pointing device button is clicked twice on an element.                                                                                                                                                                             |
+| {{Event("devicechange")}}                                                            | {{DOMxRef("Event")}}                                                                                     | [Media Capture and Streams](https://w3c.github.io/mediacapture-main/)                                                                                                                                         | A media device such as a camera, microphone, or speaker is connected or removed from the system.                                                                                                                                     |
+| {{Event("devicemotion")}}                                                            | {{DOMxRef("DeviceMotionEvent")}} {{Experimental_Inline}}                                                 | [Device Orientation Events](http://dev.w3.org/geo/api/spec-source-orientation.html)                                                                                                                           | Fresh data is available from a motion sensor.                                                                                                                                                                                        |
+| {{Event("deviceorientation")}}                                                       | {{DOMxRef("DeviceOrientationEvent")}} {{Experimental_Inline}}                                            | [Device Orientation Events](http://dev.w3.org/geo/api/spec-source-orientation.html)                                                                                                                           | Fresh data is available from an orientation sensor.                                                                                                                                                                                  |
+| {{Event("dischargingtimechange")}}                                                   | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The `dischargingTime` attribute has been updated.                                                                                                                                                                                    |
+| `DOMActivate` {{Deprecated_Inline}}                                                  | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMActivate)                                                                                                                                     | A button, link or state changing element is activated (use {{Event("click")}} instead).                                                                                                                                              |
+| [`DOMAttributeNameChanged`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}      | {{DOMxRef("MutationNameEvent")}}                                                                         | [DOM L3](http://www.w3.org/TR/2011/WD-DOM-Level-3-Events-20110531/#event-type-DOMAttributeNameChanged) Removed                                                                                                | The name of an attribute changed (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                                  |
+| [`DOMAttrModified`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}              | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMAttrModified)                                                                                                                                 | The value of an attribute has been modified (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                       |
+| [`DOMCharacterDataModified`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}     | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMCharacterDataModified)                                                                                                                        | A text or another [CharacterData](/ru/docs/DOM/CharacterData) has changed (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                         |
+| {{Event("DOMContentLoaded")}}                                                        | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-end.html#the-end)                                                                                                                     | The document has finished loading (but not its dependent resources).                                                                                                                                                                 |
+| [`DOMElementNameChanged`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}        | {{DOMxRef("MutationNameEvent")}}                                                                         | [DOM L3](http://www.w3.org/TR/2011/WD-DOM-Level-3-Events-20110531/#event-type-DOMElementNameChanged) Removed                                                                                                  | The name of an element changed (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                                    |
+| `DOMFocusIn` {{Deprecated_Inline}}                                                   | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMFocusIn)                                                                                                                                      | An element has received focus (use {{Event("focus")}} or {{Event("focusin")}} instead).                                                                                                                                              |
+| `DOMFocusOut` {{Deprecated_Inline}}                                                  | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMFocusOut)                                                                                                                                     | An element has lost focus (use {{Event("blur")}} or {{Event("focusout")}} instead).                                                                                                                                                  |
+| [`DOMNodeInserted`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}              | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeInserted)                                                                                                                                 | A node has been added as a child of another node (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                  |
+| [`DOMNodeInsertedIntoDocument`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}  | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeInsertedIntoDocument)                                                                                                                     | A node has been inserted into the document (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                        |
+| [`DOMNodeRemoved`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}               | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeRemoved)                                                                                                                                  | A node has been removed from its parent node (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                      |
+| [`DOMNodeRemovedFromDocument`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}   | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeRemovedFromDocument)                                                                                                                      | A node has been removed from the document (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                         |
+| [`DOMSubtreeModified`](/ru/docs/DOM/Mutation_events) {{Deprecated_Inline}}           | {{DOMxRef("MutationEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMSubtreeModified)                                                                                                                              | A change happened in the document (use [mutation observers](/ru/docs/DOM/MutationObserver) instead).                                                                                                                                 |
+| {{Event("drag")}}                                                                    | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-drag)                                                                                                                      | An element or text selection is being dragged (every 350ms).                                                                                                                                                                         |
+| {{Event("dragend")}}                                                                 | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragend)                                                                                                                   | A drag operation is being ended (by releasing a mouse button or hitting the escape key).                                                                                                                                             |
+| {{Event("dragenter")}}                                                               | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragenter)                                                                                                                 | A dragged element or text selection enters a valid drop target.                                                                                                                                                                      |
+| {{Event("dragleave")}}                                                               | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragleave)                                                                                                                 | A dragged element or text selection leaves a valid drop target.                                                                                                                                                                      |
+| {{Event("dragover")}}                                                                | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragover)                                                                                                                  | An element or text selection is being dragged over a valid drop target (every 350ms).                                                                                                                                                |
+| {{Event("dragstart")}}                                                               | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-dragstart)                                                                                                                 | The user starts dragging an element or text selection.                                                                                                                                                                               |
+| {{Event("drop")}}                                                                    | {{DOMxRef("DragEvent")}}                                                                                 | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/dnd.html#event-drop)                                                                                                                      | An element is dropped on a valid drop target.                                                                                                                                                                                        |
+| {{Event("durationchange")}}                                                          | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-durationchange)                                                                                  | The `duration` attribute has been updated.                                                                                                                                                                                           |
+| {{Event("emptied")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-emptied)                                                                                         | The media has become empty; for example, this event is sent if the media has already been loaded (or partially loaded), and the [`load()`](/ru/docs/XPCOM_Interface_Reference/NsIDOMHTMLMediaElement) method is called to reload it. |
+| {{Event("end_(SpeechRecognition)","end")}} {{Experimental_Inline}}                   | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service has disconnected.                                                                                                                                                                                     |
+| {{Event("end_(SpeechSynthesis)","end")}} {{Experimental_Inline}}                     | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The utterance has finished being spoken.                                                                                                                                                                                             |
+| {{Event("ended")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-ended)                                                                                           | Playback has stopped because the end of the media was reached.                                                                                                                                                                       |
+| {{Event("ended_(Web_Audio)", "ended")}}                                              | {{DOMxRef("Event")}}                                                                                     | [Web Audio API](https://www.w3.org/TR/webaudio/)                                                                                                                                                              | Playback has stopped because the end of the media was reached.                                                                                                                                                                       |
+| {{Event("endEvent")}}                                                                | {{DOMxRef("TimeEvent")}}                                                                                 | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | A [SMIL](/ru/docs/SVG/SVG_animation_with_SMIL) animation element ends.                                                                                                                                                               |
+| {{Event("error")}}                                                                   | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-error)                                                                                                                                           | A resource failed to load.                                                                                                                                                                                                           |
+| {{Event("error")}}                                                                   | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-error)                                                                                  | Progression has failed.                                                                                                                                                                                                              |
+| {{Event("error")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A WebSocket connection has been closed with prejudice (some data couldn't be sent for example).                                                                                                                                      |
+| {{Event("error")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [Server Sent Events](http://dev.w3.org/html5/eventsource/)                                                                                                                                                    | An event source connection has been failed.                                                                                                                                                                                          |
+| {{Event("error")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | A request caused an error and failed.                                                                                                                                                                                                |
+| {{Event("error_(SpeechRecognitionError)","error")}} {{Experimental_Inline}}          | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | A speech recognition error occurs.                                                                                                                                                                                                   |
+| {{Event("error_(SpeechSynthesisError)","error")}}                                    | {{DOMxRef("SpeechSynthesisErrorEvent")}}                                                                 | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | An error occurs that prevents the utterance from being successfully spoken.                                                                                                                                                          |
+| {{Event("focus")}}                                                                   | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-focus)                                                                                                                                           | An element has received focus (does not bubble).                                                                                                                                                                                     |
+| {{Event("focusin")}}                                                                 | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-focusIn)                                                                                                                                         | An element is about to receive focus (bubbles).                                                                                                                                                                                      |
+| {{Event("focusout")}}                                                                | {{DOMxRef("FocusEvent")}} {{Experimental_Inline}}                                                        | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-focusout)                                                                                                                                        | An element is about to lose focus (bubbles).                                                                                                                                                                                         |
+| {{Event("fullscreenchange")}}                                                        | {{DOMxRef("Event")}}                                                                                     | [Full Screen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api)                                                                                                                               | An element was turned to fullscreen mode or back to normal mode.                                                                                                                                                                     |
+| {{Event("fullscreenerror")}}                                                         | {{DOMxRef("Event")}}                                                                                     | [Full Screen](https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html#api)                                                                                                                               | It was impossible to switch to fullscreen mode for technical reasons or because the permission was denied.                                                                                                                           |
+| {{Event("gamepadconnected")}}                                                        | {{DOMxRef("GamepadEvent")}} {{Experimental_Inline}}                                                      | [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepadconnected-event)                                                                                                                                           | A gamepad has been connected.                                                                                                                                                                                                        |
+| {{domxref("Window.gamepaddisconnected_event", "gamepaddisconnected")}}               | {{DOMxRef("GamepadEvent")}} {{Experimental_Inline}}                                                      | [Gamepad](http://www.w3.org/TR/gamepad/#the-gamepaddisconnected-event)                                                                                                                                        | A gamepad has been disconnected.                                                                                                                                                                                                     |
+| {{Event("gotpointercapture")}}                                                       | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-gotpointercapture-event)                                                                                                                             | Element receives pointer capture.                                                                                                                                                                                                    |
+| {{Event("hashchange")}}                                                              | {{DOMxRef("HashChangeEvent")}}                                                                           | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-hashchange)                                                                                                            | The fragment identifier of the URL has changed (the part of the URL after the #).                                                                                                                                                    |
+| {{Event("lostpointercapture")}}                                                      | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-lostpointercapture-event)                                                                                                                            | Element lost pointer capture.                                                                                                                                                                                                        |
+| {{Event("input")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.w3.org/TR/html5/forms.html#common-event-behaviors)                                                                                                                                         | The value of an element changes or the content of an element with the attribute [contenteditable](/ru/docs/DOM/Element.contentEditable) is modified.                                                                                 |
+| {{Event("invalid")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/association-of-controls-and-forms.html#constraint-validation)                                                                             | A submittable element has been checked and doesn't satisfy its constraints.                                                                                                                                                          |
+| {{Event("keydown")}}                                                                 | {{DOMxRef("KeyboardEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-keydown)                                                                                                                                         | A key is pressed down.                                                                                                                                                                                                               |
+| {{Event("keypress")}} {{Deprecated_Inline}}                                          | {{DOMxRef("KeyboardEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-keypress)                                                                                                                                        | A key is pressed down and that key normally produces a character value (use input instead).                                                                                                                                          |
+| {{Event("keyup")}}                                                                   | {{DOMxRef("KeyboardEvent")}}                                                                             | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-keyup)                                                                                                                                           | A key is released.                                                                                                                                                                                                                   |
+| {{domxref("Window.languagechange_event", "languagechange")}} {{Experimental_Inline}} | {{DOMxRef("Event")}}                                                                                     | [HTML 5.1](https://www.w3.org/TR/html51/#dom-navigator-languages)                                                                                                                                             | The user's preferred languages have changed.                                                                                                                                                                                         |
+| {{Event("levelchange")}}                                                             | {{DOMxRef("Event")}}                                                                                     | [Battery status](https://dvcs.w3.org/hg/dap/raw-file/tip/battery/Overview.html)                                                                                                                               | The `level` attribute has been updated.                                                                                                                                                                                              |
+| {{Event("load")}}                                                                    | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-load)                                                                                                                                            | A resource and its dependent resources have finished loading.                                                                                                                                                                        |
+| [`load`](</ru/docs/Web/Reference/Events/load_(ProgressEvent)>)                       | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-load)                                                                                   | Progression has been successful.                                                                                                                                                                                                     |
+| {{Event("loadeddata")}}                                                              | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-loadeddata)                                                                                      | The first frame of the media has finished loading.                                                                                                                                                                                   |
+| {{Event("loadedmetadata")}}                                                          | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-loadedmetadata)                                                                                  | The metadata has been loaded.                                                                                                                                                                                                        |
+| {{Event("loadend")}}                                                                 | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-loadend)                                                                                | Progress has stopped (after "error", "abort" or "load" have been dispatched).                                                                                                                                                        |
+| {{Event("loadstart")}}                                                               | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-loadstart)                                                                              | Progress has begun.                                                                                                                                                                                                                  |
+| {{Event("mark")}} {{Experimental_Inline}}                                            | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The spoken utterance reaches a named SSML "mark" tag.                                                                                                                                                                                |
+| [`message`](/ru/docs/Web/Reference/Events/message_websocket)                         | {{DOMxRef("MessageEvent")}}                                                                              | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A message is received through a WebSocket.                                                                                                                                                                                           |
+| [`message`](/ru/docs/Web/Reference/Events/message_webworker)                         | {{DOMxRef("MessageEvent")}}                                                                              | [Web Workers](http://www.w3.org/TR/workers/#communicating-with-a-dedicated-worker)                                                                                                                            | A message is received from a Web Worker.                                                                                                                                                                                             |
+| [`message`](/ru/docs/Web/Reference/Events/message_webmessaging)                      | {{DOMxRef("MessageEvent")}}                                                                              | [Web Messaging](http://www.w3.org/TR/webmessaging/)                                                                                                                                                           | A message is received from a child (i)frame or a parent window.                                                                                                                                                                      |
+| [`message`](/ru/docs/Web/Reference/Events/message_serversentevents)                  | {{DOMxRef("MessageEvent")}}                                                                              | [Server Sent Events](http://dev.w3.org/html5/eventsource/)                                                                                                                                                    | A message is received through an event source.                                                                                                                                                                                       |
+| {{Event("messageerror")}}                                                            | {{DOMxRef("MessageEvent")}}                                                                              | {{DOMxRef("MessagePort")}}, [Web Workers](/ru/docs/Web/API/Web_Workers_API), [Broadcast Channel](/ru/docs/Web/API/Broadcast_Channel_API), {{DOMxRef("Window")}}                                               | A message error is raised when a message is received by an object.                                                                                                                                                                   |
+| {{Event("message_(ServiceWorker)","message")}} {{Experimental_Inline}}               | {{DOMxRef("ServiceWorkerMessageEvent")}} or {{DOMxRef("ExtendableMessageEvent")}}, depending on context. | [Service Workers](/ru/docs/Web/API/Service_Worker_API)                                                                                                                                                        | A message is received from a service worker, or a message is received in a service worker from another context.                                                                                                                      |
+| {{Event("mousedown")}}                                                               | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mousedown)                                                                                                                                       | A pointing device button (usually a mouse) is pressed on an element.                                                                                                                                                                 |
+| {{Event("mouseenter")}}                                                              | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseenter)                                                                                                                                      | A pointing device is moved onto the element that has the listener attached.                                                                                                                                                          |
+| {{Event("mouseleave")}}                                                              | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseleave)                                                                                                                                      | A pointing device is moved off the element that has the listener attached.                                                                                                                                                           |
+| {{Event("mousemove")}}                                                               | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mousemove)                                                                                                                                       | A pointing device is moved over an element.                                                                                                                                                                                          |
+| {{Event("mouseout")}}                                                                | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseout)                                                                                                                                        | A pointing device is moved off the element that has the listener attached or off one of its children.                                                                                                                                |
+| {{Event("mouseover")}}                                                               | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseover)                                                                                                                                       | A pointing device is moved onto the element that has the listener attached or onto one of its children.                                                                                                                              |
+| {{Event("mouseup")}}                                                                 | {{DOMxRef("MouseEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-mouseup)                                                                                                                                         | A pointing device button is released over an element.                                                                                                                                                                                |
+| {{Event("nomatch")}} {{Experimental_Inline}}                                         | {{DOMxRef("SpeechRecognitionEvent")}}                                                                    | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service returns a final result with no significant recognition.                                                                                                                                               |
+| {{Event("notificationclick")}}                                                       | {{DOMxRef("NotificationEvent")}} {{Experimental_Inline}}                                                 | [Notifications API](https://notifications.spec.whatwg.org/#dom-serviceworkerglobalscope-onnotificationclick)                                                                                                  | A system notification spawned by {{DOMxRef("ServiceWorkerRegistration.showNotification()")}} has been clicked.                                                                                                                       |
+| {{Event("offline")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 offline](http://www.whatwg.org/specs/web-apps/current-work/multipage/offline.html#event-offline)                                                                                                       | The browser has lost access to the network.                                                                                                                                                                                          |
+| {{Event("online")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [HTML5 offline](http://www.whatwg.org/specs/web-apps/current-work/multipage/offline.html#event-online)                                                                                                        | The browser has gained access to the network (but particular websites might be unreachable).                                                                                                                                         |
+| [`open`](/ru/docs/Web/Reference/Events/open_websocket)                               | {{DOMxRef("Event")}}                                                                                     | [WebSocket](http://www.w3.org/TR/websockets/)                                                                                                                                                                 | A WebSocket connection has been established.                                                                                                                                                                                         |
+| [`open`](/ru/docs/Web/Reference/Events/open_serversentevents)                        | {{DOMxRef("Event")}}                                                                                     | [Server Sent Events](http://dev.w3.org/html5/eventsource/)                                                                                                                                                    | An event source connection has been established.                                                                                                                                                                                     |
+| {{Event("orientationchange")}}                                                       | {{DOMxRef("Event")}}                                                                                     | [Screen Orientation](http://www.w3.org/TR/screen-orientation/)                                                                                                                                                | The orientation of the device (portrait/landscape) has changed                                                                                                                                                                       |
+| {{Event("pagehide")}}                                                                | {{DOMxRef("PageTransitionEvent")}}                                                                       | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-pagehide)                                                                                                              | A session history entry is being traversed from.                                                                                                                                                                                     |
+| {{Event("pageshow")}}                                                                | {{DOMxRef("PageTransitionEvent")}}                                                                       | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-pageshow)                                                                                                              | A session history entry is being traversed to.                                                                                                                                                                                       |
+| {{Event("paste")}}                                                                   | {{DOMxRef("ClipboardEvent")}} {{Experimental_Inline}}                                                    | [Clipboard](http://www.w3.org/TR/clipboard-apis/#paste-event)                                                                                                                                                 | Data has been transferred from the system clipboard to the document.                                                                                                                                                                 |
+| {{Event("pause")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-pause)                                                                                           | Playback has been paused.                                                                                                                                                                                                            |
+| {{Event("pause_(SpeechSynthesis)", "pause")}} {{Experimental_Inline}}                | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The utterance is paused part way through.                                                                                                                                                                                            |
+| {{Event("pointercancel")}}                                                           | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointercancel-event)                                                                                                                                 | The pointer is unlikely to produce any more events.                                                                                                                                                                                  |
+| {{Event("pointerdown")}}                                                             | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerdown-event)                                                                                                                                   | The pointer enters the active buttons state.                                                                                                                                                                                         |
+| {{Event("pointerenter")}}                                                            | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerenter-event)                                                                                                                                  | Pointing device is moved inside the hit-testing boundary.                                                                                                                                                                            |
+| {{Event("pointerleave")}}                                                            | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerleave-event)                                                                                                                                  | Pointing device is moved out of the hit-testing boundary.                                                                                                                                                                            |
+| {{Event("pointerlockchange")}}                                                       | {{DOMxRef("Event")}}                                                                                     | [Pointer Lock](http://www.w3.org/TR/pointerlock/#pointerlockchange-and-pointerlockerror-events)                                                                                                               | The pointer was locked or released.                                                                                                                                                                                                  |
+| {{Event("pointerlockerror")}}                                                        | {{DOMxRef("Event")}}                                                                                     | [Pointer Lock](http://www.w3.org/TR/pointerlock/#pointerlockchange-and-pointerlockerror-events)                                                                                                               | It was impossible to lock the pointer for technical reasons or because the permission was denied.                                                                                                                                    |
+| {{Event("pointermove")}}                                                             | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointermove-event)                                                                                                                                   | The pointer changed coordinates.                                                                                                                                                                                                     |
+| {{Event("pointerout")}}                                                              | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerout-event)                                                                                                                                    | The pointing device moved out of hit-testing boundary or leaves detectable hover range.                                                                                                                                              |
+| {{Event("pointerover")}}                                                             | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerover-event)                                                                                                                                   | The pointing device is moved into the hit-testing boundary.                                                                                                                                                                          |
+| {{Event("pointerup")}}                                                               | {{DOMxRef("PointerEvent")}}                                                                              | [Pointer Events](http://www.w3.org/TR/pointerevents/#the-pointerup-event)                                                                                                                                     | The pointer leaves the active buttons state.                                                                                                                                                                                         |
+| {{Event("play")}}                                                                    | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-play)                                                                                            | Playback has begun.                                                                                                                                                                                                                  |
+| {{Event("playing")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-playing)                                                                                         | Playback is ready to start after having been paused or delayed due to lack of data.                                                                                                                                                  |
+| {{Event("popstate")}}                                                                | {{DOMxRef("PopStateEvent")}}                                                                             | [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/history.html#event-popstate)                                                                                                              | A session history entry is being navigated to (in certain cases).                                                                                                                                                                    |
+| {{Event("progress")}}                                                                | {{DOMxRef("ProgressEvent")}}                                                                             | [Progress](http://www.w3.org/TR/progress-events/) and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-progress)                                                                               | In progress.                                                                                                                                                                                                                         |
+| {{Event("push")}}                                                                    | {{DOMxRef("PushEvent")}} {{Experimental_Inline}}                                                         | [Push API](https://w3c.github.io/push-api/)                                                                                                                                                                   | A [Service Worker](/ru/docs/Web/API/Service_Worker_API) has received a push message.                                                                                                                                                 |
+| {{Event("pushsubscriptionchange")}}                                                  | {{DOMxRef("PushEvent")}} {{Experimental_Inline}}                                                         | [Push API](https://w3c.github.io/push-api/)                                                                                                                                                                   | A [PushSubscription](/ru/docs/Web/API/PushSubscription) has expired.                                                                                                                                                                 |
+| {{Event("ratechange")}}                                                              | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-ratechange)                                                                                      | The playback rate has changed.                                                                                                                                                                                                       |
+| {{Event("readystatechange")}}                                                        | {{DOMxRef("Event")}}                                                                                     | HTML5 and [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-readystatechange)                                                                                                                   | The readyState attribute of a document has changed.                                                                                                                                                                                  |
+| {{Event("repeatEvent")}}                                                             | {{DOMxRef("TimeEvent")}}                                                                                 | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | A [SMIL](/ru/docs/SVG/SVG_animation_with_SMIL) animation element is repeated.                                                                                                                                                        |
+| {{Event("reset")}}                                                                   | {{DOMxRef("Event")}}                                                                                     | [DOM L2](http://www.w3.org/TR/DOM-Level-2-Events/events.html), [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/association-of-controls-and-forms.html#form-submission-0#resetting-a-form) | A form is reset.                                                                                                                                                                                                                     |
+| {{Event("resize")}}                                                                  | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-resize)                                                                                                                                          | The document view has been resized.                                                                                                                                                                                                  |
+| {{Event("resourcetimingbufferfull")}}                                                | {{DOMxRef("Performance")}}                                                                               | [Resource Timing](https://w3c.github.io/resource-timing/#dom-performance-onresourcetimingbufferfull)                                                                                                          | The browser's resource timing buffer is full.                                                                                                                                                                                        |
+| {{Event("result")}} {{Experimental_Inline}}                                          | {{DOMxRef("SpeechRecognitionEvent")}} {{Experimental_Inline}}                                            | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service returns a result — a word or phrase has been positively recognized and this has been communicated back to the app.                                                                                    |
+| {{Event("resume")}} {{Experimental_Inline}}                                          | {{DOMxRef("SpeechSynthesisEvent")}} {{Experimental_Inline}}                                              | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | A paused utterance is resumed.                                                                                                                                                                                                       |
+| {{Event("scroll")}}                                                                  | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-scroll)                                                                                                                                          | The document view or an element has been scrolled.                                                                                                                                                                                   |
+| {{Event("seeked")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-seeked)                                                                                          | A _seek_ operation completed.                                                                                                                                                                                                        |
+| {{Event("seeking")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-seeking)                                                                                         | A _seek_ operation began.                                                                                                                                                                                                            |
+| {{Event("select")}}                                                                  | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-select)                                                                                                                                          | Some text is being selected.                                                                                                                                                                                                         |
+| {{Event("selectstart")}} {{Experimental_Inline}}                                     | {{DOMxRef("Event")}}                                                                                     | [Selection API](https://w3c.github.io/selection-api/)                                                                                                                                                         | A selection just started.                                                                                                                                                                                                            |
+| {{Event("selectionchange")}} {{Experimental_Inline}}                                 | {{DOMxRef("Event")}}                                                                                     | [Selection API](https://w3c.github.io/selection-api/)                                                                                                                                                         | The selection in the document has been changed.                                                                                                                                                                                      |
+| {{Event("show")}}                                                                    | {{DOMxRef("MouseEvent")}}                                                                                | [HTML5](http://www.w3.org/TR/html5/interactive-elements.html#context-menus)                                                                                                                                   | A contextmenu event was fired on/bubbled to an element that has a [contextmenu](/ru/docs/DOM/element.contextmenu) attribute                                                                                                          |
+| {{Event("slotchange")}}                                                              | {{DOMxRef("Event")}}                                                                                     | [DOM](https://dom.spec.whatwg.org/)                                                                                                                                                                           | The node contents of a {{DOMxRef("HTMLSlotElement")}} ({{htmlelement("slot")}}) have changed.                                                                                                                                        |
+| {{Event("soundend")}} {{Experimental_Inline}}                                        | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Any sound — recognisable speech or not — has stopped being detected.                                                                                                                                                                 |
+| {{Event("soundstart")}} {{Experimental_Inline}}                                      | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Any sound — recognisable speech or not — has been detected.                                                                                                                                                                          |
+| {{Event("speechend")}} {{Experimental_Inline}}                                       | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Speech recognised by the speech recognition service has stopped being detected.                                                                                                                                                      |
+| {{Event("speechstart")}} {{Experimental_Inline}}                                     | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | Sound that is recognised by the speech recognition service as speech has been detected.                                                                                                                                              |
+| {{Event("stalled")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-stalled)                                                                                         | The user agent is trying to fetch media data, but data is unexpectedly not forthcoming.                                                                                                                                              |
+| {{Event("start_(SpeechRecognition)","start")}} {{Experimental_Inline}}               | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The speech recognition service has begun listening to incoming audio with intent to recognize grammars associated with the current `SpeechRecognition`.                                                                              |
+| {{Event("start_(SpeechSynthesis)","start")}}                                         | {{DOMxRef("SpeechSynthesisEvent")}}                                                                      | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The utterance has begun to be spoken.                                                                                                                                                                                                |
+| {{Event("storage")}}                                                                 | {{DOMxRef("StorageEvent")}}                                                                              | [Web Storage](http://www.w3.org/TR/webstorage/#the-storage-event)                                                                                                                                             | A storage area ([localStorage](/ru/docs/DOM/Storage#localStorage) or [sessionStorage](/ru/docs/DOM/Storage#sessionStorage)) has changed.                                                                                             |
+| {{Event("submit")}}                                                                  | {{DOMxRef("Event")}}                                                                                     | [DOM L2](http://www.w3.org/TR/DOM-Level-2-Events/events.html), [HTML5](http://www.whatwg.org/specs/web-apps/current-work/multipage/association-of-controls-and-forms.html#form-submission-algorithm)          | A form is submitted.                                                                                                                                                                                                                 |
+| [`success`](/ru/docs/Web/Reference/Events/success_indexedDB)                         | {{DOMxRef("Event")}}                                                                                     | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | A request successfully completed.                                                                                                                                                                                                    |
+| {{Event("suspend")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-suspend)                                                                                         | Media data loading has been suspended.                                                                                                                                                                                               |
+| {{Event("SVGAbort")}}                                                                | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | Page loading has been stopped before the [SVG](/ru/docs/SVG) was loaded.                                                                                                                                                             |
+| {{Event("SVGError")}}                                                                | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An error has occurred before the [SVG](/ru/docs/SVG) was loaded.                                                                                                                                                                     |
+| {{Event("SVGLoad")}}                                                                 | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document has been loaded and parsed.                                                                                                                                                                          |
+| {{Event("SVGResize")}}                                                               | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document is being resized.                                                                                                                                                                                    |
+| {{Event("SVGScroll")}}                                                               | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document is being scrolled.                                                                                                                                                                                   |
+| {{Event("SVGUnload")}}                                                               | {{DOMxRef("SVGEvent")}}                                                                                  | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document has been removed from a window or frame.                                                                                                                                                             |
+| {{Event("SVGZoom")}}                                                                 | {{DOMxRef("SVGZoomEvent")}}                                                                              | [SVG](http://www.w3.org/TR/SVG/interact.html#SVGEvents)                                                                                                                                                       | An [SVG](/ru/docs/SVG) document is being zoomed.                                                                                                                                                                                     |
+| {{Event("timeout")}}                                                                 | {{DOMxRef("ProgressEvent")}}                                                                             | [XMLHttpRequest](http://www.w3.org/TR/XMLHttpRequest/#event-xhr-timeout)                                                                                                                                      |                                                                                                                                                                                                                                      |
+| {{Event("timeupdate")}}                                                              | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-timeupdate)                                                                                      | The time indicated by the `currentTime` attribute has been updated.                                                                                                                                                                  |
+| {{Event("touchcancel")}}                                                             | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/)                                                                                                                                                            | A touch point has been disrupted in an implementation-specific manners (too many touch points for example).                                                                                                                          |
+| {{Event("touchend")}}                                                                | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/#the-touchend-event)                                                                                                                                         | A touch point is removed from the touch surface.                                                                                                                                                                                     |
+| {{Event("touchmove")}}                                                               | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/#the-touchmove-event)                                                                                                                                        | A touch point is moved along the touch surface.                                                                                                                                                                                      |
+| {{Event("touchstart")}}                                                              | {{DOMxRef("TouchEvent")}}                                                                                | [Touch Events](http://www.w3.org/TR/touch-events/#the-touchstart---------event)                                                                                                                               | A touch point is placed on the touch surface.                                                                                                                                                                                        |
+| {{Event("transitionend")}}                                                           | {{DOMxRef("TransitionEvent")}} {{Experimental_Inline}}                                                   | [CSS Transitions](http://www.w3.org/TR/css3-transitions/#transition-events)                                                                                                                                   | A [CSS transition](/ru/docs/CSS/CSS_transitions) has completed.                                                                                                                                                                      |
+| {{Event("unload")}}                                                                  | {{DOMxRef("UIEvent")}}                                                                                   | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-unload)                                                                                                                                          | The document or a dependent resource is being unloaded.                                                                                                                                                                              |
+| [`upgradeneeded`](/ru/docs/Web/Reference/Events/upgradeneeded_indexedDB)             |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#request-api)                                                                                                                                                      | An attempt was made to open a database with a version number higher than its current version. A `versionchange` transaction has been created.                                                                                        |
+| {{Event("userproximity")}}                                                           | {{DOMxRef("UserProximityEvent")}} {{Experimental_Inline}}                                                | [Proximity Sensor](https://w3c.github.io/proximity/)                                                                                                                                                          | Fresh data is available from a proximity sensor (indicates whether the nearby object is `near` the device or not).                                                                                                                   |
+| {{Event("voiceschanged")}} {{Experimental_Inline}}                                   | {{DOMxRef("Event")}}                                                                                     | [Web Speech API](https://wicg.github.io/speech-api/)                                                                                                                                                          | The list of {{DOMxRef("SpeechSynthesisVoice")}} objects that would be returned by the {{DOMxRef("SpeechSynthesis.getVoices()")}} method has changed (when the {{Event("voiceschanged")}} event fires.)                               |
+| [`versionchange`](/ru/docs/Web/Reference/Events/versionchange_indexedDB)             |                                                                                                          | [IndexedDB](http://www.w3.org/TR/IndexedDB/#database-interface)                                                                                                                                               | A `versionchange` transaction completed.                                                                                                                                                                                             |
+| {{Event("visibilitychange")}}                                                        | {{DOMxRef("Event")}}                                                                                     | [Page visibility](http://www.w3.org/TR/page-visibility/#sec-visibilitychange-event)                                                                                                                           | The content of a tab has become visible or has been hidden.                                                                                                                                                                          |
+| {{Event("volumechange")}}                                                            | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-volumechange)                                                                                    | The volume has changed.                                                                                                                                                                                                              |
+| {{Event("waiting")}}                                                                 | {{DOMxRef("Event")}}                                                                                     | [HTML5 media](http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#event-media-waiting)                                                                                         | Playback has stopped because of a temporary lack of data.                                                                                                                                                                            |
+| {{Event("wheel")}}                                                                   | {{DOMxRef("WheelEvent")}}                                                                                | [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-wheel)                                                                                                                                           | A wheel button of a pointing device is rotated in any direction.                                                                                                                                                                     |
 
 ## Нестандартные события
 

From fadbbaca840332b37768193c194f534fb133a529 Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Tue, 10 Sep 2024 09:09:48 +0800
Subject: [PATCH 020/115] zh-CN: remove some note (#23498)

---
 files/zh-cn/web/css/box-sizing/index.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/files/zh-cn/web/css/box-sizing/index.md b/files/zh-cn/web/css/box-sizing/index.md
index 145a26a41f90ce..48c8354b578145 100644
--- a/files/zh-cn/web/css/box-sizing/index.md
+++ b/files/zh-cn/web/css/box-sizing/index.md
@@ -16,8 +16,6 @@ box-sizing 属性可以被用来调整这些表现：
 - `content-box` 是默认值。如果你设置一个元素的宽为 100px，那么这个元素的内容区会有 100px 宽，并且任何边框和内边距的宽度都会被增加到最后绘制出来的元素宽度中。
 - `border-box` 告诉浏览器：你想要设置的边框和内边距的值是包含在 width 内的。也就是说，如果你将一个元素的 width 设为 100px，那么这 100px 会包含它的 border 和 padding，内容区的实际宽度是 width 减去 (border + padding) 的值。大多数情况下，这使得我们更容易地设定一个元素的宽高。
 
-**译者注：** `border-box`不包含`margin`
-
 > [!NOTE]
 > 对于新的 web 站点，你可能希望首先将 box-sizing 设置为 border-box，如下所示：
 >

From 33dac47edf742c613339a23ba81e23b8932ede9a Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Tue, 10 Sep 2024 09:12:01 +0800
Subject: [PATCH 021/115] zh-cn: update the translation of "Getting started
 with the web" (#23485)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../getting_started_with_the_web/index.md     | 44 +++++++++++--------
 1 file changed, 26 insertions(+), 18 deletions(-)

diff --git a/files/zh-cn/learn/getting_started_with_the_web/index.md b/files/zh-cn/learn/getting_started_with_the_web/index.md
index a64ee0026cced5..d2cf76b4a11f13 100644
--- a/files/zh-cn/learn/getting_started_with_the_web/index.md
+++ b/files/zh-cn/learn/getting_started_with_the_web/index.md
@@ -1,51 +1,59 @@
 ---
-title: web 入门
+title: Web 入门
 slug: Learn/Getting_started_with_the_web
+l10n:
+  sourceCommit: 33d92d501901ca505f1d33f914531753ca289f2e
 ---
 
 {{LearnSidebar}}
 
-*web 入门*是一个简要的系列，向你介绍 web 开发的实用性。你将配置你需要的工具来构建一个简单的网页，并发布一份属于你自己的代码。
+*Web 入门*是一套简明的，介绍 Web 开发实践的系列文章。你会安装构建简单网页和发布简单代码所需的工具。
 
 ## 你的第一个网站
 
-创建一个专业的网站需要大量的工作，所以如果你是 web 开发的新手，我们鼓励你从小事做起。你不可能立马再建一个 Facebook，但做一个自己的简单网站并不难，我们将由此开始。
+创建一个专业的网站需要大量的工作，因此如果你是 Web 开发的新手，我们会鼓励你从小事做起。虽然你无法立刻再建一个 Facebook，但是做一个简单的网站并不难，我们将由此开始。
 
-通过阅读下面列出的文章，你将从零开始获得你的第一个在线网页。让我们开始吧！
+## 指南
 
-- [安装基本软件](/zh-CN/docs/Learn/Getting_started_with_the_web/Installing_basic_software)
+通过学习下列的文章，你将从零开始获得第一个在线网页。让我们开始旅程吧！
 
-  - : 说到建设网站的工具，有很多可供选择的。如果你初入门径，你可能会被外面的一系列代码编辑器、框架和测试工具所迷惑。在这篇文章中，我们将逐步向你展示如何安装你需要的软件，以开始基本的 web 开发。
+- [安装基础软件](/zh-CN/docs/Learn/Getting_started_with_the_web/Installing_basic_software)
+
+  - : 说到建设网站的工具，有很多可供选择的。如果你初入门径，你可能会被外面一系列的代码编辑器、框架和测试工具所迷惑。在这篇文章中，我们将一步一步地教你如何安装开始基础的 Web 开发所需的软件。
 
 - [你的网站会是什么样子？](/zh-CN/docs/Learn/Getting_started_with_the_web/What_will_your_website_look_like)
 
   - : 在你开始为你的网站写代码之前，你应该先计划一下。需要展示什么信息？使用什么字体和颜色？我们概述了一个简单的方法，你可以按照这个方法来规划网站的内容和设计。
 
-- [文件处理](/zh-CN/docs/Learn/Getting_started_with_the_web/Dealing_with_files)
+- [处理文件](/zh-CN/docs/Learn/Getting_started_with_the_web/Dealing_with_files)
 
-  - : 一个网站由许多文件组成：文本内容、代码、样式表、媒体内容，等等。当你建立一个网站时，你需要将这些文件组合成一个合理的结构，并确保它们能够相互交流。这篇文章解释了如何为你的网站建立一个合理的文件结构以及你应该注意的问题。
+  - : 一个网站由很多文件组成：文本内容、代码、样式表、媒体内容，等等。在建立网站时，你需要将这些文件以合理的结构组合起来，并确保它们能够相互交流。本文将讲解如何为网站建立合理的结构以及相关注意事项。
 
-- [HTML 基础知识](/zh-CN/docs/Learn/Getting_started_with_the_web/HTML_basics)
+- [HTML 基础](/zh-CN/docs/Learn/Getting_started_with_the_web/HTML_basics)
 
-  - : 超文本标记语言（HTML）是你用来组织你的网络内容，并赋予它意义和目的的代码。例如，我的内容是一组段落还是一个要点列表？我的页面上是否插入了图片？我有一个数据表吗？在你的接受能力之内，这篇文章提供了足够的信息，使你熟悉 HTML。
+  - : 超文本标记语言（HTML）是用于构建 Web 内容并赋予内容含义和目的的代码。例如，这个内容是段落还是列表？页面中是否插入图像？是否要有数据表格？在你的接受能力之内，这篇文章将提供足够的信息让你熟悉 HTML。
 
-- [CSS 基础知识](/zh-CN/docs/Learn/Getting_started_with_the_web/CSS_basics)
+- [CSS 基础](/zh-CN/docs/Learn/Getting_started_with_the_web/CSS_basics)
 
-  - : 层叠样式表（CSS）是你用来为你的网站设置样式的代码。例如，你希望文本是黑色还是红色？内容应该画在屏幕的什么地方？应该用什么背景图片和颜色来装饰你的网站？在这篇文章中，我们将带你了解你所需要的东西，以便开始使用。
+  - : 层叠样式表（CSS）是用于为网站添加样式的代码。例如，你希望文本是黑色还是红色？内容应该绘制在屏幕的什么地方？应该用什么背景图像和颜色装饰你的网站？在这篇文章中，我们将带你学习入门所需的知识。
 
-- [JavaScript 基础知识](/zh-CN/docs/Learn/Getting_started_with_the_web/JavaScript_basics)
+- [JavaScript 基础](/zh-CN/docs/Learn/Getting_started_with_the_web/JavaScript_basics)
 
-  - : JavaScript 是一种编程语言，你用它来给你的网站添加交互功能。例如游戏、当按钮被按下或数据被输入表格时发生的事情、动态造型效果、动画等。这篇文章将让你了解这种令人兴奋的语言的潜力，以及如何开始使用。
+  - : JavaScript 是用于为网站添加交互特性的编程语言。例如，游戏、按钮按下或在表单中输入数据时会发生的事情、动态的样式效果、动画，等等。在这篇文章中，我们将让你了解这门令人兴奋的语言的潜力，以及如何入门。
 
 - [发布你的网站](/zh-CN/docs/Learn/Getting_started_with_the_web/Publishing_your_website)
 
-  - : 一旦你完成了编写代码并组织构成你的网站的文件时，你需要把它们全部放在网上，以便人们能够找到它。这篇文章描述了如何以最简便的方式将你的简单示例上线至网络。
+  - : 一旦完成了代码编写和构成网站的文件的组织工作，你就需要把它们全部放在网上，这样人们才能找到它。这篇文章描述如何以最简便的方式将你的简单示例上线至网络。
 
 - [万维网是如何工作的](/zh-CN/docs/Learn/Getting_started_with_the_web/How_the_Web_works)
 
-  - : 当你访问你最喜欢的网站时，你可能不知道正有很多复杂的事情在后台发生。这篇文章概述了当你在电脑上浏览网页时发生的事情。
+  - : 当你访问最喜欢的网站时，有很多你可能不知道的复杂的事情正在后台发生。本文将概述在电脑上浏览网页时正在发生的事情。
 
 ## 参见
 
-- [web 解密](https://www.youtube.com/playlist?list=PLo3w8EB99pqLEopnunz-dOOBJ8t-Wgt2g): 一系列解释 web 基础原理的精彩视频，针对 web 开发的完全初学者。由 [Jérémie Patonnier](https://twitter.com/JeremiePat) 创建。
-- [web 及 web 标准](/zh-CN/docs/Learn/Getting_started_with_the_web/The_web_and_web_standards): 这篇文章提供了一些关于 web 的背景故事——它是如何诞生的，什么是 web 标准，它们是如何一起工作的，为什么“web 开发者”是一个很好的职业选择，以及你将通过该课程了解什么样的最佳实践。
+- [前端开发者职业道路](https://v2.scrimba.com/the-frontend-developer-career-path-c0j?via=mdn) <sup>_MDN 课程合作伙伴_</sup>
+  - : [Scrimba](https://scrimba.com?via=mdn) 的*前端开发者职业道路*教授成为合格的前端 Web 开发者所需的知识，这里有有趣的交互式课程和挑战、有学识的老师以及提供帮助的社区。让你从零到获得第一份前端工作！许多课程有单独的免费版本。
+- [Web 解密](https://www.youtube.com/playlist?list=PLo3w8EB99pqLEopnunz-dOOBJ8t-Wgt2g)
+  - : 由 [Jérémie Patonnier](https://github.com/JeremiePat) 创建的一系列很棒的解释 Web 基础知识的视频，面向的是 Web 开发的纯新手。
+- [Web 和 Web 标准](/zh-CN/docs/Learn/Getting_started_with_the_web/The_web_and_web_standards)
+  - : 这篇文章提供一些实用的和 Web 相关的背景故事——Web 是如何诞生的、什么是 Web 标准技术、Web 和 Web 标准技术是如何一起工作的、为什么“Web 开发者”是一个很好的职业选择，以及在课程中你将学习什么样的最佳实践。

From e4c198849e0ddc596f67ae362a293b700dc038b6 Mon Sep 17 00:00:00 2001
From: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
Date: Tue, 10 Sep 2024 09:55:59 +0800
Subject: [PATCH 022/115] chore(zh-cn): update developer.chrome.com redirects
 (#23490)

Co-authored-by: Allo <yin199909@aliyun.com>
---
 .../webextensions/api/action/colorarray/index.md       |  2 +-
 .../add-ons/webextensions/api/action/disable/index.md  |  2 +-
 .../add-ons/webextensions/api/action/enable/index.md   |  2 +-
 .../api/action/getbadgebackgroundcolor/index.md        |  2 +-
 .../webextensions/api/action/getbadgetext/index.md     |  2 +-
 .../api/action/getbadgetextcolor/index.md              |  2 +-
 .../add-ons/webextensions/api/action/getpopup/index.md |  2 +-
 .../add-ons/webextensions/api/action/gettitle/index.md |  2 +-
 .../webextensions/api/action/getusersettings/index.md  |  2 +-
 .../webextensions/api/action/imagedatatype/index.md    |  2 +-
 .../mozilla/add-ons/webextensions/api/action/index.md  |  2 +-
 .../webextensions/api/action/onclicked/index.md        |  2 +-
 .../api/action/setbadgebackgroundcolor/index.md        |  2 +-
 .../webextensions/api/action/setbadgetext/index.md     |  2 +-
 .../api/action/setbadgetextcolor/index.md              |  2 +-
 .../add-ons/webextensions/api/action/seticon/index.md  |  2 +-
 .../add-ons/webextensions/api/action/setpopup/index.md |  2 +-
 .../add-ons/webextensions/api/action/settitle/index.md |  2 +-
 .../api/bookmarks/bookmarktreenode/index.md            |  2 +-
 .../bookmarks/bookmarktreenodeunmodifiable/index.md    |  2 +-
 .../webextensions/api/bookmarks/create/index.md        |  2 +-
 .../webextensions/api/bookmarks/createdetails/index.md |  2 +-
 .../add-ons/webextensions/api/bookmarks/get/index.md   |  2 +-
 .../webextensions/api/bookmarks/getchildren/index.md   |  2 +-
 .../webextensions/api/bookmarks/getrecent/index.md     |  2 +-
 .../webextensions/api/bookmarks/getsubtree/index.md    |  2 +-
 .../webextensions/api/bookmarks/gettree/index.md       |  2 +-
 .../add-ons/webextensions/api/bookmarks/index.md       |  2 +-
 .../add-ons/webextensions/api/bookmarks/move/index.md  |  2 +-
 .../webextensions/api/bookmarks/onchanged/index.md     |  2 +-
 .../api/bookmarks/onchildrenreordered/index.md         |  2 +-
 .../webextensions/api/bookmarks/oncreated/index.md     |  2 +-
 .../webextensions/api/bookmarks/onimportbegan/index.md |  2 +-
 .../webextensions/api/bookmarks/onimportended/index.md |  2 +-
 .../webextensions/api/bookmarks/onremoved/index.md     |  2 +-
 .../webextensions/api/bookmarks/remove/index.md        |  2 +-
 .../webextensions/api/bookmarks/removetree/index.md    |  2 +-
 .../webextensions/api/bookmarks/search/index.md        |  2 +-
 .../webextensions/api/bookmarks/update/index.md        |  2 +-
 .../api/browseraction/colorarray/index.md              |  2 +-
 .../webextensions/api/browseraction/disable/index.md   |  2 +-
 .../webextensions/api/browseraction/enable/index.md    |  2 +-
 .../api/browseraction/getbadgebackgroundcolor/index.md |  2 +-
 .../api/browseraction/getbadgetext/index.md            |  2 +-
 .../api/browseraction/getbadgetextcolor/index.md       |  2 +-
 .../webextensions/api/browseraction/getpopup/index.md  |  2 +-
 .../webextensions/api/browseraction/gettitle/index.md  |  2 +-
 .../api/browseraction/imagedatatype/index.md           |  2 +-
 .../add-ons/webextensions/api/browseraction/index.md   |  2 +-
 .../webextensions/api/browseraction/onclicked/index.md |  2 +-
 .../api/browseraction/setbadgebackgroundcolor/index.md |  2 +-
 .../api/browseraction/setbadgetext/index.md            |  2 +-
 .../api/browseraction/setbadgetextcolor/index.md       |  2 +-
 .../webextensions/api/browseraction/seticon/index.md   |  2 +-
 .../webextensions/api/browseraction/setpopup/index.md  |  2 +-
 .../webextensions/api/browseraction/settitle/index.md  |  2 +-
 .../api/browsingdata/datatypeset/index.md              |  2 +-
 .../add-ons/webextensions/api/browsingdata/index.md    |  2 +-
 .../api/browsingdata/removaloptions/index.md           |  2 +-
 .../webextensions/api/browsingdata/remove/index.md     |  2 +-
 .../api/browsingdata/removecache/index.md              |  2 +-
 .../api/browsingdata/removecookies/index.md            |  2 +-
 .../api/browsingdata/removedownloads/index.md          |  2 +-
 .../api/browsingdata/removeformdata/index.md           |  2 +-
 .../api/browsingdata/removehistory/index.md            |  2 +-
 .../api/browsingdata/removelocalstorage/index.md       |  2 +-
 .../api/browsingdata/removepasswords/index.md          |  2 +-
 .../api/browsingdata/removeplugindata/index.md         |  2 +-
 .../webextensions/api/browsingdata/settings/index.md   |  2 +-
 .../api/captiveportal/canonicalurl/index.md            |  2 +-
 .../add-ons/webextensions/api/clipboard/index.md       |  2 +-
 .../webextensions/api/clipboard/setimagedata/index.md  |  4 ++--
 .../webextensions/api/commands/command/index.md        |  2 +-
 .../add-ons/webextensions/api/commands/getall/index.md |  4 +++-
 .../add-ons/webextensions/api/commands/index.md        |  2 +-
 .../webextensions/api/commands/oncommand/index.md      |  2 +-
 .../add-ons/webextensions/api/cookies/cookie/index.md  |  2 +-
 .../webextensions/api/cookies/cookiestore/index.md     |  2 +-
 .../add-ons/webextensions/api/cookies/get/index.md     |  2 +-
 .../add-ons/webextensions/api/cookies/getall/index.md  |  2 +-
 .../api/cookies/getallcookiestores/index.md            |  2 +-
 .../mozilla/add-ons/webextensions/api/cookies/index.md |  2 +-
 .../webextensions/api/cookies/onchanged/index.md       |  2 +-
 .../webextensions/api/cookies/onchangedcause/index.md  |  2 +-
 .../add-ons/webextensions/api/cookies/remove/index.md  |  2 +-
 .../add-ons/webextensions/api/cookies/set/index.md     |  2 +-
 .../api/devtools/inspectedwindow/index.md              |  4 ++--
 .../webextensions/api/devtools/network/index.md        |  2 +-
 .../add-ons/webextensions/api/devtools/panels/index.md |  4 ++--
 .../api/dom/openorclosedshadowroot/index.md            |  2 +-
 .../webextensions/api/downloads/acceptdanger/index.md  |  2 +-
 .../webextensions/api/downloads/cancel/index.md        |  2 +-
 .../add-ons/webextensions/api/downloads/index.md       |  2 +-
 .../add-ons/webextensions/api/events/event/index.md    |  2 +-
 .../mozilla/add-ons/webextensions/api/events/index.md  |  2 +-
 .../add-ons/webextensions/api/events/rule/index.md     |  2 +-
 .../webextensions/api/events/urlfilter/index.md        |  2 +-
 .../webextensions/api/runtime/sendmessage/index.md     |  2 +-
 .../add-ons/webextensions/api/tabs/capturetab/index.md |  2 +-
 .../webextensions/api/tabs/capturevisibletab/index.md  |  2 +-
 .../add-ons/webextensions/api/tabs/connect/index.md    |  2 +-
 .../add-ons/webextensions/api/tabs/create/index.md     |  2 +-
 .../webextensions/api/tabs/detectlanguage/index.md     |  2 +-
 .../add-ons/webextensions/api/tabs/discard/index.md    |  2 +-
 .../add-ons/webextensions/api/tabs/duplicate/index.md  |  2 +-
 .../webextensions/api/tabs/executescript/index.md      |  2 +-
 .../add-ons/webextensions/api/tabs/get/index.md        |  2 +-
 .../webextensions/api/tabs/getallinwindow/index.md     |  2 +-
 .../add-ons/webextensions/api/tabs/getcurrent/index.md |  2 +-
 .../webextensions/api/tabs/getselected/index.md        |  2 +-
 .../add-ons/webextensions/api/tabs/getzoom/index.md    |  2 +-
 .../webextensions/api/tabs/getzoomsettings/index.md    |  2 +-
 .../add-ons/webextensions/api/tabs/goback/index.md     |  2 +-
 .../add-ons/webextensions/api/tabs/goforward/index.md  |  2 +-
 .../add-ons/webextensions/api/tabs/highlight/index.md  |  2 +-
 .../mozilla/add-ons/webextensions/api/tabs/index.md    |  2 +-
 .../add-ons/webextensions/api/tabs/insertcss/index.md  |  2 +-
 .../add-ons/webextensions/api/tabs/move/index.md       |  2 +-
 .../add-ons/webextensions/api/tabs/mutedinfo/index.md  |  2 +-
 .../webextensions/api/tabs/mutedinforeason/index.md    |  2 +-
 .../webextensions/api/tabs/onactivated/index.md        |  2 +-
 .../webextensions/api/tabs/onactivechanged/index.md    |  2 +-
 .../add-ons/webextensions/api/tabs/onattached/index.md |  2 +-
 .../add-ons/webextensions/api/tabs/oncreated/index.md  |  2 +-
 .../add-ons/webextensions/api/tabs/ondetached/index.md |  2 +-
 .../webextensions/api/tabs/onhighlightchanged/index.md |  2 +-
 .../webextensions/api/tabs/onhighlighted/index.md      |  2 +-
 .../add-ons/webextensions/api/tabs/onmoved/index.md    |  2 +-
 .../add-ons/webextensions/api/tabs/onremoved/index.md  |  2 +-
 .../add-ons/webextensions/api/tabs/onreplaced/index.md |  2 +-
 .../webextensions/api/tabs/onselectionchanged/index.md |  2 +-
 .../add-ons/webextensions/api/tabs/onupdated/index.md  |  2 +-
 .../webextensions/api/tabs/onzoomchange/index.md       |  2 +-
 .../add-ons/webextensions/api/tabs/query/index.md      |  2 +-
 .../add-ons/webextensions/api/tabs/reload/index.md     |  2 +-
 .../add-ons/webextensions/api/tabs/remove/index.md     |  2 +-
 .../add-ons/webextensions/api/tabs/removecss/index.md  |  2 +-
 .../webextensions/api/tabs/sendmessage/index.md        |  2 +-
 .../webextensions/api/tabs/sendrequest/index.md        |  2 +-
 .../add-ons/webextensions/api/tabs/setzoom/index.md    |  2 +-
 .../webextensions/api/tabs/setzoomsettings/index.md    |  2 +-
 .../webextensions/api/tabs/tab_id_none/index.md        |  2 +-
 .../add-ons/webextensions/api/tabs/tabstatus/index.md  |  2 +-
 .../add-ons/webextensions/api/tabs/update/index.md     |  2 +-
 .../add-ons/webextensions/api/tabs/windowtype/index.md |  2 +-
 .../webextensions/api/tabs/zoomsettings/index.md       |  2 +-
 .../webextensions/api/tabs/zoomsettingsmode/index.md   |  2 +-
 .../webextensions/api/tabs/zoomsettingsscope/index.md  |  2 +-
 .../webextensions/api/types/browsersetting/index.md    |  4 ++--
 .../mozilla/add-ons/webextensions/api/types/index.md   |  2 +-
 .../api/webnavigation/ondomcontentloaded/index.md      |  2 +-
 .../webextensions/chrome_incompatibilities/index.md    | 10 +++++-----
 152 files changed, 162 insertions(+), 160 deletions(-)

diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/colorarray/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/colorarray/index.md
index f1921e43173349..25cefb07b9d56d 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/colorarray/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/colorarray/index.md
@@ -25,7 +25,7 @@ l10n:
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#type-ColorArray) API。本文衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#type-ColorArray) API。本文衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/disable/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/disable/index.md
index 6aabd9635e8503..90940f9dbe49c3 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/disable/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/disable/index.md
@@ -54,7 +54,7 @@ browser.action.onClicked.addListener((tab) => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-disable) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-disable) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/enable/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/enable/index.md
index eb8affff1f8cf7..21cfc13dfa1703 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/enable/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/enable/index.md
@@ -46,7 +46,7 @@ browser.action.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-enable) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-enable) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgebackgroundcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgebackgroundcolor/index.md
index 4fa1932eca9856..2ebf4033166f89 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgebackgroundcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgebackgroundcolor/index.md
@@ -65,7 +65,7 @@ browser.action.getBadgeBackgroundColor({}).then(onGot, onFailure);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeBackgroundColor) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-getBadgeBackgroundColor) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md
index b206d59d427d7f..4ec17deae42272 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md
@@ -62,7 +62,7 @@ gettingBadgeText.then(gotBadgeText);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeText) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-getBadgeText) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md
index c097f4352b7866..7e69893da00220 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetextcolor/index.md
@@ -69,7 +69,7 @@ browser.action.getBadgeTextColor({}).then(onGot, onFailure);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeTextColor) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-getBadgeTextColor) API。该文档衍生于 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md
index fe022ccb8bccd8..02be9cc42a46f6 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getpopup/index.md
@@ -62,7 +62,7 @@ gettingPopup.then(gotPopup);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getPopup) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-getPopup) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md
index 867ffec50c1356..126f944ac70151 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/gettitle/index.md
@@ -70,7 +70,7 @@ browser.action.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-getTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getusersettings/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getusersettings/index.md
index c1bcbc8e583733..c9be5a10526f17 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getusersettings/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getusersettings/index.md
@@ -59,7 +59,7 @@ gettingUserSettings.then(gotSettings);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getUserSettings) API。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-getUserSettings) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/imagedatatype/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/imagedatatype/index.md
index 165e8223342f55..a360e713943d76 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/imagedatatype/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/imagedatatype/index.md
@@ -20,7 +20,7 @@ l10n:
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#type-ImageDataType) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#type-ImageDataType) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md
index 94ed7b484acfae..ee150dd674cdfa 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/index.md
@@ -79,7 +79,7 @@ l10n:
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/) API。该文档衍生自 Chromium 代码中的 [`action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action/) API。该文档衍生自 Chromium 代码中的 [`action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/onclicked/index.md
index 49cd8cba32824e..836b6f5d11fc9d 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/onclicked/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/onclicked/index.md
@@ -70,7 +70,7 @@ browser.action.onClicked.addListener((tab) => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#event-onClicked) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#event-onClicked) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgebackgroundcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgebackgroundcolor/index.md
index 061fcdcef562b8..9bad31d40184a8 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgebackgroundcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgebackgroundcolor/index.md
@@ -84,7 +84,7 @@ browser.action.onClicked.addListener((tab) => {
 Firefox 的默认颜色是 `[217, 0, 0, 255]`。
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-setBadgeBackgroundColor) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-setBadgeBackgroundColor) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetext/index.md
index ca22039476f464..1c85cc924f38a4 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetext/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetext/index.md
@@ -71,7 +71,7 @@ browser.action.onClicked.addListener(increment);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-setBadgeText) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-setBadgeText) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetextcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetextcolor/index.md
index 323b379376e331..5f6023d2ddfc8c 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetextcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setbadgetextcolor/index.md
@@ -78,7 +78,7 @@ browser.action.onClicked.addListener((tab) => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-setBadgeBackgroundColor) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-setBadgeBackgroundColor) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/seticon/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/seticon/index.md
index 0fb6a033a5eb41..e74119bf16fc8d 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/seticon/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/seticon/index.md
@@ -158,7 +158,7 @@ browser.action.onClicked.addListener((tab) => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-setIcon) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-setIcon) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setpopup/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setpopup/index.md
index 208d601302cc74..f64034fee2ab01 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/setpopup/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/setpopup/index.md
@@ -100,7 +100,7 @@ browser.contextMenus.onClicked.addListener((info, tab) => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-setPopup) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-setPopup) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/settitle/index.md
index ee91a21490e5da..4ccbb2aa340351 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/action/settitle/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/settitle/index.md
@@ -74,7 +74,7 @@ browser.action.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-setTitle) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/api/action#method-setTitle) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md
index e723ac23cf993f..97e20d6bf4a525 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md
@@ -43,7 +43,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-BookmarkTreeNode) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#type-BookmarkTreeNode) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md
index 78730d7a38b7d5..2139a19864a983 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md
@@ -20,7 +20,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-BookmarkTreeNodeUnmodifiable) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#type-BookmarkTreeNodeUnmodifiable) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/create/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/create/index.md
index b2ac53a002c394..7d627d85134198 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/create/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/create/index.md
@@ -58,7 +58,7 @@ createBookmark.then(onCreated);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/createdetails/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/createdetails/index.md
index 40f942545c9d8a..377aae508fc5d4 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/createdetails/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/createdetails/index.md
@@ -31,7 +31,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#type-CreateDetails) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#type-CreateDetails) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/get/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/get/index.md
index de3dec4345b411..8b9fa334715781 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/get/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/get/index.md
@@ -52,7 +52,7 @@ gettingBookmarks.then(onFulfilled, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getchildren/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getchildren/index.md
index c54aa01a833464..060ac7de15d960 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getchildren/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getchildren/index.md
@@ -56,7 +56,7 @@ gettingChildren.then(onFulfilled, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getChildren) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-getChildren) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getrecent/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getrecent/index.md
index 41c61e7039db85..bb0612dcf6aa54 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getrecent/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getrecent/index.md
@@ -53,7 +53,7 @@ browser.bookmarks.getRecent(1).then(onFulfilled, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getRecent) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-getRecent) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getsubtree/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getsubtree/index.md
index 1dda979ccd93a0..5593d9d19805c9 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getsubtree/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/getsubtree/index.md
@@ -75,7 +75,7 @@ browser.bookmarks.getSubTree(subTreeID).then(logSubTree, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getSubTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-getSubTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/gettree/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/gettree/index.md
index 850139052473f8..6551d558b787ac 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/gettree/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/gettree/index.md
@@ -70,7 +70,7 @@ gettingTree.then(logTree, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-getTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-getTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/index.md
index 6641ec52a935c4..5aa8fa74d40efb 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/index.md
@@ -73,7 +73,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/move/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/move/index.md
index a48a20967a905f..1beebdb07eb327 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/move/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/move/index.md
@@ -71,7 +71,7 @@ movingBookmark.then(onMoved, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-move) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-move) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchanged/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchanged/index.md
index 3ef304f8146534..3758a88c5fa423 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchanged/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchanged/index.md
@@ -68,7 +68,7 @@ browser.browserAction.onClicked.addListener(handleClick);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#event-onChanged) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#event-onChanged) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchildrenreordered/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchildrenreordered/index.md
index 963b6f925459fe..fb76e75e4c3121 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchildrenreordered/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onchildrenreordered/index.md
@@ -68,7 +68,7 @@ browser.browserAction.onClicked.addListener(handleClick);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#event-onChildrenReordered) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#event-onChildrenReordered) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/oncreated/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/oncreated/index.md
index 2d06dc8575cc57..7dcf52a12f9fcb 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/oncreated/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/oncreated/index.md
@@ -57,7 +57,7 @@ browser.bookmarks.onCreated.addListener(handleCreated);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#event-onCreated) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#event-onCreated) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportbegan/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportbegan/index.md
index d00c28e99d2304..81c09dedd7f4ad 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportbegan/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportbegan/index.md
@@ -61,7 +61,7 @@ browser.browserAction.onClicked.addListener(handleClick);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#event-onImportBegan) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#event-onImportBegan) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportended/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportended/index.md
index 75c1f04b6c5727..1d19f4d86eab4b 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportended/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onimportended/index.md
@@ -61,7 +61,7 @@ browser.browserAction.onClicked.addListener(handleClick);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#event-onImportEnded) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#event-onImportEnded) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onremoved/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onremoved/index.md
index c1face1199075e..480fb2f4b8cb32 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onremoved/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/onremoved/index.md
@@ -75,7 +75,7 @@ browser.browserAction.onClicked.addListener(handleClick);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#event-onRemoved) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#event-onRemoved) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/remove/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/remove/index.md
index fe2568703f44a2..e1dcff119da6f4 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/remove/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/remove/index.md
@@ -57,7 +57,7 @@ removingBookmark.then(onRemoved, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-remove) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-remove) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/removetree/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/removetree/index.md
index d3b5ec9e2d6153..3cdc4ccd30b5a5 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/removetree/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/removetree/index.md
@@ -64,7 +64,7 @@ searchingBookmarks.then(removeMDN, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-removeTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-removeTree) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/search/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/search/index.md
index 475709ae052846..f51a5dc96ce79a 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/search/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/search/index.md
@@ -98,7 +98,7 @@ browser.browserAction.onClicked.addListener(checkActiveTab);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-search) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-search) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/update/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/update/index.md
index 9d9633119b5d5d..fc0fe41737aa8b 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/update/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/bookmarks/update/index.md
@@ -78,7 +78,7 @@ browser.bookmarks.search({ title: "MDN" }).then(updateFolders, onRejected);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/bookmarks/#method-update) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
+> 此 API 基于 Chromium 的 [`chrome.bookmarks`](https://developer.chrome.com/docs/extensions/reference/api/bookmarks#method-update) API。该文档衍生自 Chromium 代码中的 [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/colorarray/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/colorarray/index.md
index 857a850e381a20..1c50c841788d19 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/colorarray/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/colorarray/index.md
@@ -25,7 +25,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-setTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#type-ColorArray) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/disable/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/disable/index.md
index d8bc7a10b81dc1..673ed4ca8691d6 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/disable/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/disable/index.md
@@ -51,7 +51,7 @@ browser.browserAction.onClicked.addListener((tab) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-disable) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-disable) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/enable/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/enable/index.md
index 6926b33b47fff3..a1c069c03ef3f9 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/enable/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/enable/index.md
@@ -43,7 +43,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-enable) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-enable) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgebackgroundcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgebackgroundcolor/index.md
index 6723d4c5eb7c29..d78739d6b8c5c4 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgebackgroundcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgebackgroundcolor/index.md
@@ -62,7 +62,7 @@ browser.browserAction.getBadgeBackgroundColor({}).then(onGot, onFailure);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-getBadgeBackgroundColor) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-getBadgeBackgroundColor) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetext/index.md
index a952196dbb76f1..dcec08ad316c8d 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetext/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetext/index.md
@@ -59,7 +59,7 @@ gettingBadgeText.then(gotBadgeText);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-getBadgeText) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-getBadgeText) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetextcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetextcolor/index.md
index e5e98ea8935db2..cb8cf0fffe5cc3 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetextcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getbadgetextcolor/index.md
@@ -66,7 +66,7 @@ browser.browserAction.getBadgeTextColor({}).then(onGot, onFailure);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-getBadgeBackgroundColor) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-getBadgeBackgroundColor) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getpopup/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getpopup/index.md
index 373d3b727d3bce..024a40ebff0b0f 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getpopup/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/getpopup/index.md
@@ -59,7 +59,7 @@ gettingPopup.then(gotPopup);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-getPopup) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-getPopup) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/gettitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/gettitle/index.md
index cf10d51d8a7890..46fc191aa177fc 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/gettitle/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/gettitle/index.md
@@ -67,7 +67,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-getTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-getTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/imagedatatype/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/imagedatatype/index.md
index c51d4e602d0290..c0d168fd1e6546 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/imagedatatype/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/imagedatatype/index.md
@@ -20,7 +20,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#type-ImageDataType) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#type-ImageDataType) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.md
index 4b96ddeb42752e..8c6afe42a94d30 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/index.md
@@ -78,7 +78,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md
index 8038fe8e3367b8..539839ea06711a 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md
@@ -69,7 +69,7 @@ browser.browserAction.onClicked.addListener((tab) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#event-onClicked) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#event-onClicked) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md
index 2e61eb705b6443..072acdf429dcff 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md
@@ -84,7 +84,7 @@ browser.browserAction.onClicked.addListener((tab) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-setBadgeBackgroundColors) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-setBadgeBackgroundColors) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetext/index.md
index bb4398278d94d2..794bd06a5b9290 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetext/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetext/index.md
@@ -71,7 +71,7 @@ browser.browserAction.onClicked.addListener(increment);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-setBadgeText) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-setBadgeText) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetextcolor/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetextcolor/index.md
index 8b1295c7a5b61b..539a54035646d2 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetextcolor/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setbadgetextcolor/index.md
@@ -78,7 +78,7 @@ browser.browserAction.onClicked.addListener((tab) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-setBadgeBackgroundColor) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-setBadgeBackgroundColor) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/seticon/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/seticon/index.md
index f7571b2fba2145..ac5fbbfc701272 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/seticon/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/seticon/index.md
@@ -158,7 +158,7 @@ browser.browserAction.onClicked.addListener((tab) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-setIcon) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-setIcon) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setpopup/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setpopup/index.md
index 44daaef1a16414..91aa56941b834c 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setpopup/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/setpopup/index.md
@@ -101,7 +101,7 @@ browser.contextMenus.onClicked.addListener((info, tab) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-setPopup) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-setPopup) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/settitle/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/settitle/index.md
index 911888245b8466..be4319925bd66c 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/settitle/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browseraction/settitle/index.md
@@ -74,7 +74,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/reference/browserAction/#method-setTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.browserAction`](https://developer.chrome.com/docs/extensions/mv2/reference/browserAction#method-setTitle) API。该文档衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md
index 8feb36edfb3156..1d56c0d8697219 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md
@@ -50,7 +50,7 @@ l10n:
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/index.md
index b9b4b090ca2a2b..52102650c91dfe 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/index.md
@@ -68,7 +68,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removaloptions/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removaloptions/index.md
index c6a8beadc5475d..5a1b81040d88d6 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removaloptions/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removaloptions/index.md
@@ -48,7 +48,7 @@ l10n:
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/remove/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/remove/index.md
index 4a6b4b4383d036..cd19dad5e1b3fb 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/remove/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/remove/index.md
@@ -82,7 +82,7 @@ browser.browsingData
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.md
index f187fb1a38ead9..83d5c5ebf22998 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.md
@@ -53,7 +53,7 @@ browser.browsingData.removeCache({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecookies/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecookies/index.md
index acb6a350e39855..7fd60318b1f456 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecookies/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removecookies/index.md
@@ -83,7 +83,7 @@ browser.browsingData.removeCookies({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removedownloads/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removedownloads/index.md
index b79a71ff94cf5e..3f15d05b1da844 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removedownloads/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removedownloads/index.md
@@ -76,7 +76,7 @@ browser.browsingData.removeDownloads({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md
index ce289c0be00feb..a5e681e42d652e 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md
@@ -78,7 +78,7 @@ browser.browsingData.removeFormData({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removehistory/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removehistory/index.md
index 60462a9ed5a19b..3744007db3c0f1 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removehistory/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removehistory/index.md
@@ -78,7 +78,7 @@ browser.browsingData.removeHistory({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removelocalstorage/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removelocalstorage/index.md
index 54acc3cb36293a..83cf12d493bc98 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removelocalstorage/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removelocalstorage/index.md
@@ -56,7 +56,7 @@ browser.browsingData.removeLocalStorage({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removepasswords/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removepasswords/index.md
index 68c5e56e85fdf3..9c5c6d5551a6da 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removepasswords/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removepasswords/index.md
@@ -78,7 +78,7 @@ browser.browsingData.removePasswords({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md
index 11eee2df858b3f..f1c8f0cc0b567b 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md
@@ -78,7 +78,7 @@ browser.browsingData.removePluginData({}).then(onRemoved, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/settings/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/settings/index.md
index 587c55b60b7987..e502950f6b9208 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/settings/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/browsingdata/settings/index.md
@@ -63,7 +63,7 @@ browser.browsingData.settings().then(onGotSettings, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/browsingData/) API。
+> 此 API 基于 Chromium 的 [`chrome.browsingData`](https://developer.chrome.com/docs/extensions/reference/api/browsingData) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/captiveportal/canonicalurl/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/captiveportal/canonicalurl/index.md
index 6aec2b5c644ed4..bbb51d770c9b57 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/captiveportal/canonicalurl/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/captiveportal/canonicalurl/index.md
@@ -16,7 +16,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#property-TAB_ID_NONE) API。该文档衍生自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#property-TAB_ID_NONE) API。该文档衍生自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/index.md
index 70f0a0fbb8e318..d85df7c0f8c6a7 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/index.md
@@ -13,7 +13,7 @@ WebExtension `clipboard` API 之所以存在，主要是因为标准剪贴板 AP
 
 此 API 不支持从剪贴板读取，因为剪贴板已经可以使用标准的 web 平台 API 进行读取。请参阅[与剪贴板交互](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Interact_with_the_clipboard#读取系统粘贴板)。
 
-此 API 基于 Chrome 的 [`clipboard`](https://developer.chrome.com/docs/extensions/reference/clipboard/) API，但该 API 仅适用于 Chrome 应用，不适用于扩展。
+此 API 基于 Chrome 的 [`clipboard`](https://developer.chrome.com/docs/apps/reference/clipboard) API，但该 API 仅适用于 Chrome 应用，不适用于扩展。
 
 要使用此 API，你需要有 `"clipboardWrite"` 扩展[权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)。
 
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md
index cf88c989812600..5bff1eb30f349a 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md
@@ -11,7 +11,7 @@ l10n:
 
 图像被作为包含经过编码的图像的 [`ArrayBuffer`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) 提供。支持 JPEG 和 PNG 格式。
 
-虽然此 API 基于 Chrome 浏览器的 [`clipboard.setImageData()`](https://developer.chrome.com/docs/extensions/reference/clipboard/) API，但两者还是有一些区别：
+虽然此 API 基于 Chrome 浏览器的 [`clipboard.setImageData()`](https://developer.chrome.com/docs/apps/reference/clipboard) API，但两者还是有一些区别：
 
 - Chrome API 仅适用于应用，不适用于扩展程序。
 - 此 API 仅需要 `"clipboardWrite"` 权限，Chrome 版本还需要 `"clipboard"` 权限。
@@ -68,4 +68,4 @@ fetch(browser.runtime.getURL("image.png"))
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.clipboard`](https://developer.chrome.com/docs/extensions/reference/clipboard/) API。
+> 此 API 基于 Chromium 的 [`chrome.clipboard`](https://developer.chrome.com/docs/apps/reference/clipboard) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/command/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/command/index.md
index 6d70dab0d1dbb0..ac823cb154c34a 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/command/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/command/index.md
@@ -29,4 +29,4 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/commands/) API。
+> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/api/commands) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/getall/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/getall/index.md
index 0e73ec67e636da..e143ef9c781c89 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/getall/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/getall/index.md
@@ -43,6 +43,8 @@ getCommands.then(logCommands);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/commands/) API。
+> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/api/commands) API。
+
+## 浏览器兼容性
 
 {{Compat}}
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/index.md
index fae8cc6d31d76b..8f91ec629a608e 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/index.md
@@ -37,7 +37,7 @@ l10n:
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/commands/) API。
+> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/api/commands) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/oncommand/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/oncommand/index.md
index bd434adbf0219b..741260387ff9db 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/commands/oncommand/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/commands/oncommand/index.md
@@ -73,4 +73,4 @@ browser.commands.onCommand.addListener((command) => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/commands/) API。
+> 此 API 基于 Chromium 的 [`chrome.commands`](https://developer.chrome.com/docs/extensions/reference/api/commands) API。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookie/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookie/index.md
index 1591fed6b507d2..b5558fb8511f62 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookie/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookie/index.md
@@ -69,7 +69,7 @@ gettingAll.then(logCookies);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md
index 22b99450b47599..19c780138b6c6b 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md
@@ -56,7 +56,7 @@ browser.cookies.getAllCookieStores().then((stores) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#type-CookieStore) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/get/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/get/index.md
index 666323dc36e60c..416b6554db3f32 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/get/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/get/index.md
@@ -87,7 +87,7 @@ getActive.then(getCookie);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#method-get) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getall/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getall/index.md
index aced3a4bb7ec75..30b631db0ffca3 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getall/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getall/index.md
@@ -101,7 +101,7 @@ browser.cookies
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#method-getAll) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md
index 3ab1ecedaa8ee6..66dfbf4ee2f4ac 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md
@@ -48,7 +48,7 @@ browser.cookies.getAllCookieStores().then(logStores);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#method-getAllCookieStores) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/index.md
index 3dce69bb698e6e..69aee7eb52afba 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/index.md
@@ -116,7 +116,7 @@ Firefox 包含拦截跟踪的特性。这些特性会分隔 cookie，以使跟
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/)。此文档衍生自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies)。此文档衍生自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchanged/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchanged/index.md
index 1422a24e103bdb..f83d3003346767 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchanged/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchanged/index.md
@@ -77,7 +77,7 @@ browser.cookies.onChanged.addListener((changeInfo) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#event-onChanged) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#event-onChanged) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchangedcause/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchangedcause/index.md
index 93ca03e5a85e0a..ca16bc140fa806 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchangedcause/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/onchangedcause/index.md
@@ -46,7 +46,7 @@ browser.cookies.onChanged.addListener((changeInfo) => {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#type-OnChangedCause) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/remove/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/remove/index.md
index 0b5a94302582d6..c38207e7698c6e 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/remove/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/remove/index.md
@@ -86,7 +86,7 @@ getActive.then(removeCookie);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#method-remove) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/set/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/set/index.md
index 5c4bc8270efee9..10b12a3a830e5f 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/set/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/set/index.md
@@ -82,7 +82,7 @@ function setCookie(tabs) {
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
+> 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/api/cookies#method-set) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.md
index ab729cc11e6326..2a6fa6757c2ac9 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.md
@@ -8,7 +8,7 @@ l10n:
 {{AddonSidebar}}
 
 > [!NOTE]
-> 本页面描述的是在 Firefox 54 中存在的 WebExtensions devtools API。尽管这些 API 基于 [Chrome devtools API](https://developer.chrome.com/docs/extensions/mv3/devtools/)，但 Firefox 中仍有许多特性尚未实现，因此在这里未被记录。要查看目前缺失哪些特性，请参见 [devtools API 的局限性](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Extending_the_developer_tools#devtools_api_的局限性)。
+> 本页面描述的是在 Firefox 54 中存在的 WebExtensions devtools API。尽管这些 API 基于 [Chrome devtools API](https://developer.chrome.com/docs/extensions/how-to/devtools/extend-devtools)，但 Firefox 中仍有许多特性尚未实现，因此在这里未被记录。要查看目前缺失哪些特性，请参见 [devtools API 的局限性](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Extending_the_developer_tools#devtools_api_的局限性)。
 
 `devtools.inspectedWindow` API 允许开发者工具扩展与附加到开发者工具的窗口进行交互。
 
@@ -33,7 +33,7 @@ l10n:
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的[`chrome.devtools.inspectedWindow`](https://developer.chrome.com/docs/extensions/reference/devtools_inspectedWindow/) API。
+> 此 API 基于 Chromium 的[`chrome.devtools.inspectedWindow`](https://developer.chrome.com/docs/extensions/reference/api/devtools/inspectedWindow) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/network/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/network/index.md
index 00d87b09d5d805..c3aa28dc0a2368 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/network/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/network/index.md
@@ -30,7 +30,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.devtools.network`](https://developer.chrome.com/docs/extensions/reference/devtools_network/) API。
+> 此 API 基于 Chromium 的 [`chrome.devtools.network`](https://developer.chrome.com/docs/extensions/reference/api/devtools/network) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/panels/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/panels/index.md
index 1ec327346b2fc3..85a925d61de6b4 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/panels/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/devtools/panels/index.md
@@ -8,7 +8,7 @@ l10n:
 {{AddonSidebar}}
 
 > [!NOTE]
-> 尽管这些 API 基于 [Chrome devtools API](https://developer.chrome.com/docs/extensions/mv3/devtools/)，但 Firefox 中仍有许多特性尚未实现，因此这里未记录。要查看当前缺少哪些特性，请参阅 [devtools API 的局限性](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Extending_the_developer_tools#devtools_api_的局限性)。
+> 尽管这些 API 基于 [Chrome devtools API](https://developer.chrome.com/docs/extensions/how-to/devtools/extend-devtools)，但 Firefox 中仍有许多特性尚未实现，因此这里未记录。要查看当前缺少哪些特性，请参阅 [devtools API 的局限性](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Extending_the_developer_tools#devtools_api_的局限性)。
 
 `devtools.panels` API 允许 devtools 扩展在 devtools 窗口内定义其用户界面。
 
@@ -51,7 +51,7 @@ devtools 窗口托管了多个独立的工具——JavaScript 调试器、网络
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.devtools.panels`](https://developer.chrome.com/docs/extensions/reference/devtools_panels/) API。
+> 此 API 基于 Chromium 的 [`chrome.devtools.panels`](https://developer.chrome.com/docs/extensions/reference/api/devtools/panels) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/dom/openorclosedshadowroot/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/dom/openorclosedshadowroot/index.md
index 4810b03da4ff2d..0dd95473c12750 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/dom/openorclosedshadowroot/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/dom/openorclosedshadowroot/index.md
@@ -38,4 +38,4 @@ let shadowRoot = browser.dom.openOrClosedShadowRoot(
 ## 参见
 
 - {{DOMxRef("Element.shadowRoot")}}
-- [`chrome.dom.openOrClosedShadowRoot`](https://developer.chrome.com/docs/extensions/reference/dom/#method-openOrClosedShadowRoot)
+- [`chrome.dom.openOrClosedShadowRoot`](https://developer.chrome.com/docs/extensions/reference/api/dom#method-openOrClosedShadowRoot)
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md
index 2c2b7e2f7aeaca..16b46a7cb340b3 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md
@@ -37,7 +37,7 @@ let prompting = browser.downloads.acceptDanger(
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.downloads`](https://developer.chrome.com/docs/extensions/reference/downloads/#method-acceptDanger) API。
+> 此 API 基于 Chromium 的 [`chrome.downloads`](https://developer.chrome.com/docs/extensions/reference/api/downloads#method-acceptDanger) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/cancel/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/cancel/index.md
index aaef1337f52bdc..18c81e833ffdd1 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/cancel/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/cancel/index.md
@@ -52,7 +52,7 @@ canceling.then(onCanceled, onError);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.downloads`](https://developer.chrome.com/docs/extensions/reference/downloads/#method-cancel) API。
+> 此 API 基于 Chromium 的 [`chrome.downloads`](https://developer.chrome.com/docs/extensions/reference/api/downloads#method-cancel) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/index.md
index 53e415696478b1..573f2eeb38b7e7 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/downloads/index.md
@@ -79,7 +79,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.downloads`](https://developer.chrome.com/docs/extensions/reference/downloads/) API。
+> 此 API 基于 Chromium 的 [`chrome.downloads`](https://developer.chrome.com/docs/extensions/reference/api/downloads) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/events/event/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/events/event/index.md
index 00ecb19f264a57..7613d799773e42 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/events/event/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/events/event/index.md
@@ -37,7 +37,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.events`](https://developer.chrome.com/docs/extensions/reference/events/#type-Event) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
+> 该 API 基于 Chromium 的 [`chrome.events`](https://developer.chrome.com/docs/extensions/reference/api/events#type-Event) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/events/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/events/index.md
index d1d0268f0310d5..955766d1bc5dff 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/events/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/events/index.md
@@ -25,7 +25,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.events](https://developer.chrome.com/docs/extensions/reference/events/) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
+> 该 API 基于 Chromium 的 [`chrome.events](https://developer.chrome.com/docs/extensions/reference/api/events) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/events/rule/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/events/rule/index.md
index 6253f1b33864ed..03359aa30edfad 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/events/rule/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/events/rule/index.md
@@ -31,7 +31,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.events`](https://developer.chrome.com/docs/extensions/reference/events/#type-Rule) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
+> 该 API 基于 Chromium 的 [`chrome.events`](https://developer.chrome.com/docs/extensions/reference/api/events#type-Rule) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/events/urlfilter/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/events/urlfilter/index.md
index 62ec2ea156560d..aedfac88a972a6 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/events/urlfilter/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/events/urlfilter/index.md
@@ -95,7 +95,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.events`](https://developer.chrome.com/docs/extensions/reference/events/#type-UrlFilter) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
+> 该 API 基于 Chromium 的 [`chrome.events`](https://developer.chrome.com/docs/extensions/reference/api/events#type-UrlFilter) API。本文衍生自 Chromium 代码中的 [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md
index adc44d8fda1561..f49e136a4c0e0b 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md
@@ -118,7 +118,7 @@ browser.runtime.onMessage.addListener(handleMessage);
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.runtime`](https://developer.chrome.com/docs/extensions/reference/runtime/#method-sendMessage) API。本文档源自 Chromium 代码中的 [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json)。
+> 此 API 基于 Chromium 的 [`chrome.runtime`](https://developer.chrome.com/docs/extensions/reference/api/runtime#method-sendMessage) API。本文档源自 Chromium 代码中的 [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md
index ece00e079e6077..47d5a95eea9063 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md
@@ -55,7 +55,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-captureVisibleTab) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-captureVisibleTab) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md
index 94e7ae601f6e30..b60fb5dfe921a7 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md
@@ -60,7 +60,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-captureVisibleTab) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-captureVisibleTab) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/connect/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/connect/index.md
index 79e3b32a20bdd3..3f9cdd6b65d489 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/connect/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/connect/index.md
@@ -71,7 +71,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-connect) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-connect) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/create/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/create/index.md
index d4be23a947f804..0a148f27d0cea1 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/create/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/create/index.md
@@ -103,7 +103,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-create) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-create) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md
index f5ed9cd4833535..a87a47823f6a8f 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md
@@ -80,7 +80,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-detectLanguage) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-detectLanguage) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/discard/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/discard/index.md
index e27dc1375fc087..da019f797d1f3c 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/discard/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/discard/index.md
@@ -75,7 +75,7 @@ discarding.then(onDiscarded, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-discard) API。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-discard) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md
index 389653f2b4a2cd..bac9c22f00920b 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md
@@ -74,7 +74,7 @@ querying.then(duplicateFirstTab, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-duplicate) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-duplicate) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/executescript/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/executescript/index.md
index 608e0277b1caf6..31edaf12b2f7f4 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/executescript/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/executescript/index.md
@@ -184,7 +184,7 @@ executing.then(onExecuted, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-executeScript) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-executeScript) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/get/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/get/index.md
index 0f772be9338807..2712d43bd9d506 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/get/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/get/index.md
@@ -52,7 +52,7 @@ browser.tabs.onActivated.addListener(logListener);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-get) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-get) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md
index 86d1378a6494f7..018978e98bc195 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md
@@ -38,7 +38,7 @@ let getting = browser.tabs.getAllInWindow(
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-getAllInWindow) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-getAllInWindow) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md
index 883cbfd76217ba..95d7ace3ce6a48 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md
@@ -54,7 +54,7 @@ gettingCurrent.then(onGot, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-getCurrent) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-getCurrent) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getselected/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getselected/index.md
index ec41ec336f8c02..21403ecc67b179 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getselected/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getselected/index.md
@@ -38,7 +38,7 @@ let gettingSelected = browser.tabs.getSelected(
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-getSelected) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-getSelected) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md
index 5d6058f5b26a73..503cf0b70fbf86 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md
@@ -67,7 +67,7 @@ gettingZoom.then(onGot, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-getZoom) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-getZoom) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md
index f74016dc4a5db8..694c6e616274b9 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md
@@ -52,7 +52,7 @@ gettingZoomSettings.then(onGot, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-getZoomSettings) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-getZoomSettings) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goback/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goback/index.md
index a3f348c92ddcbd..f559a7e294cdae 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goback/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goback/index.md
@@ -55,7 +55,7 @@ goingBack.then(onGoBack, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-getZoomSettings) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-getZoomSettings) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goforward/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goforward/index.md
index d98a5e98f2f70a..071aa361ee26dc 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goforward/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/goforward/index.md
@@ -54,7 +54,7 @@ goingForward.then(onGoForward, onError);
 
 {{Compat}}
 
-> **注意：** 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-getZoomSettings) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> **注意：** 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-getZoomSettings) API。本文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/highlight/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/highlight/index.md
index e2914e52a0d655..8ddc1f2686e3d1 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/highlight/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/highlight/index.md
@@ -48,7 +48,7 @@ let highlighting = browser.tabs.highlight(
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-highlight) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-highlight) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/index.md
index cea3b85c6253f6..0802ff8846bce8 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/index.md
@@ -163,7 +163,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md
index a847c225266c66..3b3ba51de7dc8f 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md
@@ -100,7 +100,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-insertCSS) API。此文档来源于 Chromium 代码库中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-insertCSS) API。此文档来源于 Chromium 代码库中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/move/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/move/index.md
index 73bc2d213a6083..b06facad9c4c2d 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/move/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/move/index.md
@@ -128,7 +128,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-move) API。此文档来源于 Chromium 代码库中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-move) API。此文档来源于 Chromium 代码库中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md
index 494efa4625999d..d53f85a3532315 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md
@@ -27,7 +27,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#type-MutedInfo) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#type-MutedInfo) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md
index e6e45cf04fa17b..f6bf1147df6a21 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md
@@ -27,7 +27,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#type-MutedInfoReason) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#type-MutedInfoReason) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md
index 13c26e6f2ead7a..46dfd5ea090165 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md
@@ -67,7 +67,7 @@ browser.tabs.onActivated.addListener(handleActivated);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onActivated) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onActivated) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md
index e832392cd5bf46..ab7d63c6666caf 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md
@@ -54,7 +54,7 @@ browser.tabs.onActiveChanged.hasListener(listener)
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onActiveChanged) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onActiveChanged) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onattached/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onattached/index.md
index 03b9f0b2b37183..e86ca94da04ee9 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onattached/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onattached/index.md
@@ -69,7 +69,7 @@ browser.tabs.onAttached.addListener(handleAttached);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onAttached) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onAttached) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md
index 8cfc7a5117e4b3..9e5d406d9c7363 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md
@@ -58,7 +58,7 @@ browser.tabs.onCreated.addListener(handleCreated);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onCreated) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onCreated) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md
index 66f2a5e9eede0d..f756407deb2e4d 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md
@@ -69,7 +69,7 @@ browser.tabs.onDetached.addListener(handleDetached);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onDetached) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onDetached) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md
index a065e2cc169abf..8842844c75bab1 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md
@@ -54,7 +54,7 @@ browser.tabs.onHighlightChanged.hasListener(listener)
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onHighlightChanged) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onHighlightChanged) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md
index 2c84ee67759d60..3d4cbfd8e34e1a 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md
@@ -67,7 +67,7 @@ browser.tabs.onHighlighted.addListener(handleHighlighted);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onHighlighted) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onHighlighted) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md
index ba485d33fcd0cf..0e96a156610c56 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md
@@ -73,7 +73,7 @@ browser.tabs.onMoved.addListener(handleMoved);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onMoved) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onMoved) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md
index be87d562615c97..587ae3cde49494 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md
@@ -69,7 +69,7 @@ browser.tabs.onRemoved.addListener(handleRemoved);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onRemoved) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onRemoved) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md
index 930d921da6a55d..33d422c7d66f20 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md
@@ -61,7 +61,7 @@ browser.tabs.onReplaced.addListener(handleReplaced);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onReplaced) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onReplaced) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md
index 0bcd3a8e0f76f4..69b3693bfe8c06 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md
@@ -56,7 +56,7 @@ browser.tabs.onSelectionChanged.hasListener(listener)
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onSelectionChanged) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onSelectionChanged) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md
index 6c71411afec42b..4449df3d949d5f 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md
@@ -222,7 +222,7 @@ browser.tabs.onUpdated.addListener(handleUpdated, filter);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onUpdated) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onUpdated) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md
index b477f2faf9bd61..fce0a455c9c98b 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md
@@ -71,7 +71,7 @@ browser.tabs.onZoomChange.addListener(handleZoomed);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#event-onZoomChange) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#event-onZoomChange) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/query/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/query/index.md
index e8cde12dc9f9bb..67841814c03075 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/query/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/query/index.md
@@ -145,7 +145,7 @@ browser.tabs.query({ url: "*://*.mozilla.org/*" }).then(logTabs, onError);
 {{Compat}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-query) API。本文档衍生自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-query) API。本文档衍生自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/reload/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/reload/index.md
index e40fb5147c4525..10550d05b664ce 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/reload/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/reload/index.md
@@ -70,7 +70,7 @@ reloading.then(onReloaded, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-reload) API。本文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-reload) API。本文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/remove/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/remove/index.md
index 2f810d4746291e..300ee27498f153 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/remove/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/remove/index.md
@@ -67,7 +67,7 @@ removing.then(onRemoved, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-remove) API。本文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-remove) API。本文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/removecss/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/removecss/index.md
index 3bcedc1a4f5983..5e3c4950da6cf6 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/removecss/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/removecss/index.md
@@ -75,7 +75,7 @@ browser.browserAction.onClicked.addListener(() => {
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-insertCSS) API。本文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-insertCSS) API。本文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md
index 80234eb5e9c44b..4cf5a2bb2ceda5 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md
@@ -102,7 +102,7 @@ browser.runtime.onMessage.addListener((request) => {
 {{Compat}}
 
 > [!NOTE]
-> 这个 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-sendMessage) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 这个 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-sendMessage) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md
index 45d3e997c675a0..15871802ca76f1 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md
@@ -39,7 +39,7 @@ let sending = browser.tabs.sendRequest(
 {{Compat}}
 
 > [!NOTE]
-> 这个 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-sendRequest) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 这个 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-sendRequest) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md
index f66511ccf9aa36..2f4ea3a86e8e4d 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md
@@ -62,7 +62,7 @@ setting.then(null, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-setZoom) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-setZoom) API。此文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md
index de8cd452135232..0c93eff71810b8 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md
@@ -55,7 +55,7 @@ setting.then(onSet, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-setZoomSettings) API。此文档来源于 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-setZoomSettings) API。此文档来源于 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md
index b760f4f5319761..e87b458bd44d7a 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md
@@ -16,4 +16,4 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#property-TAB_ID_NONE) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#property-TAB_ID_NONE) API。本文档内容源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md
index 0191a93ac6dacc..5fee733a6843f7 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md
@@ -20,7 +20,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#type-TabStatus) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#type-TabStatus) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/update/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/update/index.md
index f4706542909b92..b9dbcb1176a41c 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/update/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/update/index.md
@@ -123,7 +123,7 @@ querying.then(updateFirstTab, onError);
 {{Compat}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#method-update) API。该文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 此 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#method-update) API。该文档源自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md
index 7ed48a3c010387..343a31db215040 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md
@@ -25,7 +25,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#type-WindowType) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#type-WindowType) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md
index 92dbe63911e389..5c3362e14ee5d6 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md
@@ -27,7 +27,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#type-ZoomSettings) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#type-ZoomSettings) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md
index 2dfdf5b1e02e02..ee7d2d73af4ea7 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md
@@ -27,7 +27,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#type-ZoomSettingsMode) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#type-ZoomSettingsMode) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md
index a24e4d495ce1a6..6448f68acdcceb 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md
@@ -27,7 +27,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/tabs/#type-ZoomSettingsScope) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
+> 该 API 基于 Chromium 的 [`chrome.tabs`](https://developer.chrome.com/docs/extensions/reference/api/tabs#type-ZoomSettingsScope) API。此文档来自 Chromium 代码中的 [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/types/browsersetting/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/types/browsersetting/index.md
index 3f12ba1cc9bf59..032e60286f7172 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/types/browsersetting/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/types/browsersetting/index.md
@@ -11,7 +11,7 @@ l10n:
 
 它提供了方法来设置和获取设置的基础值，清除扩展程序对其进行的任何更改，和监听其值的变化。
 
-请注意，虽然此对象基于 [ChromeSetting](https://developer.chrome.com/docs/extensions/reference/types/#type-ChromeSetting) 类型，但它不区分在普通浏览窗口和私密浏览窗口中设置值。这意味着所有与无痕浏览相关的 API 部分（例如 `ChromeSetting.set()` 的 `scope` 选项）未实现。
+请注意，虽然此对象基于 [ChromeSetting](https://developer.chrome.com/docs/extensions/reference/api/types#type-ChromeSetting) 类型，但它不区分在普通浏览窗口和私密浏览窗口中设置值。这意味着所有与无痕浏览相关的 API 部分（例如 `ChromeSetting.set()` 的 `scope` 选项）未实现。
 
 ## 方法
 
@@ -34,7 +34,7 @@ l10n:
 {{WebExtExamples}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.types`](https://developer.chrome.com/docs/extensions/reference/types/) API。
+> 此 API 基于 Chromium 的 [`chrome.types`](https://developer.chrome.com/docs/extensions/reference/api/types) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/types/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/types/index.md
index 8124c5d7d7fbf5..92f1a7dbe2da51 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/types/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/types/index.md
@@ -19,7 +19,7 @@ l10n:
 {{WebExtExamples("h2")}}
 
 > [!NOTE]
-> 此 API 基于 Chromium 的 [`chrome.types`](https://developer.chrome.com/docs/extensions/reference/types/) API。
+> 此 API 基于 Chromium 的 [`chrome.types`](https://developer.chrome.com/docs/extensions/reference/api/types) API。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md
index 29246cc895877c..826f0b7a0adbf8 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md
@@ -84,7 +84,7 @@ browser.webNavigation.onDOMContentLoaded.addListener(
 {{WebExtExamples}}
 
 > [!NOTE]
-> 本 API 基于 Chromium 的 [`chrome.webNavigation`](https://developer.chrome.com/docs/extensions/reference/webNavigation/#event-onBeforeNavigate) API。本文档源自 Chromium 代码中的 [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json)。
+> 本 API 基于 Chromium 的 [`chrome.webNavigation`](https://developer.chrome.com/docs/extensions/reference/api/webNavigation#event-onBeforeNavigate) API。本文档源自 Chromium 代码中的 [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json)。
 
 <!--
 // Copyright 2015 The Chromium Authors. All rights reserved.
diff --git a/files/zh-cn/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md b/files/zh-cn/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md
index 0c2a861cf36e0e..8df44b116e4f1e 100644
--- a/files/zh-cn/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md
+++ b/files/zh-cn/mozilla/add-ons/webextensions/chrome_incompatibilities/index.md
@@ -21,7 +21,7 @@ WebExtension API 的目标是提供对所有主要浏览器的兼容性，因此
 - 异步 API：
 
   - **在 Firefox 和 Safari 中**：异步 API 使用 Promise 实现。
-  - **在 Chrome 浏览器中**：在 Manifest V2 中，异步 API 使用回调实现。在 Manifest V3 中，大多数适当的方法都支持 [promise](https://developer.chrome.com/docs/extensions/mv3/intro/mv3-overview/#promises)。（参见 [Chrome bug 328932](https://crbug.com/328932)）Manifest V3 支持回调，以实现向后兼容。
+  - **在 Chrome 浏览器中**：在 Manifest V2 中，异步 API 使用回调实现。在 Manifest V3 中，大多数适当的方法都支持 [promise](https://developer.chrome.com/docs/extensions/develop/migrate#promises)。（参见 [Chrome bug 328932](https://crbug.com/328932)）Manifest V3 支持回调，以实现向后兼容。
 
 本页其余部分将详细介绍这些不兼容性和其他不兼容性。
 
@@ -60,7 +60,7 @@ WebExtension API 的目标是提供对所有主要浏览器的兼容性，因此
   setCookie.then(logCookie, logError);
   ```
 
-- **在 Chrome 中**：在 Manifest V2 中，异步 API 使用回调来返回值，并使用 {{WebExtAPIRef("runtime.lastError")}} 来返回错误。在 Manifest V3 中，为实现向后兼容，支持回调，并在大多数适当的方法中支持 [promise](https://developer.chrome.com/docs/extensions/mv3/intro/mv3-overview/#promises)。
+- **在 Chrome 中**：在 Manifest V2 中，异步 API 使用回调来返回值，并使用 {{WebExtAPIRef("runtime.lastError")}} 来返回错误。在 Manifest V3 中，为实现向后兼容，支持回调，并在大多数适当的方法中支持 [promise](https://developer.chrome.com/docs/extensions/develop/migrate#promises)。
 
   ```js
   function logCookie(c) {
@@ -112,8 +112,8 @@ Firefox 和 Chrome 浏览器都包含代理 API。不过，这两个 API 的设
 
 - **在 Firefox 中**：使用 [proxy.settings](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/API/proxy/settings) 属性或 [proxy.onRequest](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/API/proxy/onRequest) 属性设置代理，以动态提供 [ProxyInfo](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/API/proxy/ProxyInfo)。
   有关 API 的更多信息，请参阅 [proxy](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/API/proxy)。
-- **在 Chrome 中**：代理设置在 [`proxy.ProxyConfig`](https://developer.chrome.com/docs/extensions/reference/proxy/#type-ProxyConfig) 对象中定义。根据 Chrome 浏览器的代理设置，该设置可能包含 [`proxy.ProxyRules`](https://developer.chrome.com/docs/extensions/reference/proxy/#type-ProxyRules) 或 [`proxy.PacScript`](https://developer.chrome.com/docs/extensions/reference/proxy/#type-PacScript)。代理设置使用 [proxy.settings](https://developer.chrome.com/docs/extensions/reference/proxy/#property-settings) 属性。
-  有关 API 的更多信息，请参阅 [chrome.proxy](https://developer.chrome.com/docs/extensions/reference/proxy/)。
+- **在 Chrome 中**：代理设置在 [`proxy.ProxyConfig`](https://developer.chrome.com/docs/extensions/reference/api/proxy#type-ProxyConfig) 对象中定义。根据 Chrome 浏览器的代理设置，该设置可能包含 [`proxy.ProxyRules`](https://developer.chrome.com/docs/extensions/reference/api/proxy#type-ProxyRules) 或 [`proxy.PacScript`](https://developer.chrome.com/docs/extensions/reference/api/proxy#type-PacScript)。代理设置使用 [proxy.settings](https://developer.chrome.com/docs/extensions/reference/api/proxy#property-settings) 属性。
+  有关 API 的更多信息，请参阅 [chrome.proxy](https://developer.chrome.com/docs/extensions/reference/api/proxy)。
 
 #### Tabs API
 
@@ -160,7 +160,7 @@ Firefox 和 Chrome 浏览器都包含代理 API。不过，这两个 API 的设
 
 #### DeclarativeContent API
 
-- **在 Firefox 中**：Chrome 浏览器的 [declarativeContent](https://developer.chrome.com/docs/extensions/reference/declarativeContent/) API [未被实现](https://bugzil.la/1435864)。此外，Firefox [将不支持](https://bugzil.la/1323433#c16) `declarativeContent.RequestContentScript` API（该 API 很少使用，在 Chrome 浏览器的稳定版本中也不可用）。
+- **在 Firefox 中**：Chrome 浏览器的 [declarativeContent](https://developer.chrome.com/docs/extensions/reference/api/declarativeContent) API [未被实现](https://bugzil.la/1435864)。此外，Firefox [将不支持](https://bugzil.la/1323433#c16) `declarativeContent.RequestContentScript` API（该 API 很少使用，在 Chrome 浏览器的稳定版本中也不可用）。
 
 ### 其他不兼容情况
 

From 4f9202e45cb4e8ba83eeda16526a5a85f019d343 Mon Sep 17 00:00:00 2001
From: Tianyi Tao <tianyi.tao@proton.me>
Date: Tue, 10 Sep 2024 10:46:22 +0800
Subject: [PATCH 023/115] [zh-cn]: update the translation of
 `Event.returnValue` (#23465)

Co-authored-by: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../zh-cn/web/api/event/returnvalue/index.md  | 26 ++++++++++---------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/files/zh-cn/web/api/event/returnvalue/index.md b/files/zh-cn/web/api/event/returnvalue/index.md
index 802528062c4f28..5b118a654cca21 100644
--- a/files/zh-cn/web/api/event/returnvalue/index.md
+++ b/files/zh-cn/web/api/event/returnvalue/index.md
@@ -1,26 +1,24 @@
 ---
-title: Event.returnValue
+title: Event：returnValue 属性
 slug: Web/API/Event/returnValue
+l10n:
+  sourceCommit: d8f04d843dd81ab8cea1cfc0577ae3c5c9b77d5c
 ---
 
-{{APIRef("DOM")}}{{Deprecated_Header}}
+{{APIRef("DOM")}}{{Deprecated_Header}}{{AvailableInWorkers}}
 
-**`Event.returnValue`** 属性表示该事件的默认操作是否已被阻止。默认情况下，它被设置为 `true`，即允许进行默认操作。将该属性设置为 `false` 即可阻止默认操作。
+{{domxref("Event")}} 接口的 **`returnValue`** 属性表示该事件的默认操作是否已被阻止。
+
+默认情况下，它被设置为 `true`，即允许进行默认操作。将该属性设置为 `false` 即可阻止默认操作。
 
 > [!NOTE]
-> While `returnValue` has been adopted into the DOM standard, it is present primarily to support existing code. You should use {{DOMxRef("Event.preventDefault", "preventDefault()")}}, and {{domxref("Event.defaultPrevented", "defaultPrevented")}} instead of this historical property.
+> 虽然 `returnValue` 已被纳入 DOM 标准，但它主要是为了支持现有代码。你应该使用 {{DOMxRef("Event.preventDefault", "preventDefault()")}} 和 {{domxref("Event.defaultPrevented", "defaultPrevented")}} 来代替这个历史遗留属性。
 
 ## 值
 
-A {{domxref("Boolean")}} value which is `true` if the event has not been canceled; otherwise, if the event has been canceled or the default has been prevented, the value is `false`.
-
-The value returned by `returnValue` is the opposite of the value returned by {{domxref("Event.defaultPrevented", "defaultPrevented")}}.
-
-## 使用说明
+布尔值，如果事件没有被取消，则为 `true`；否则，如果事件已被取消或默认操作已被阻止，则为 `false`。
 
-`returnValue` was introduced into the DOM by Internet Explorer 6, and due to that browser's ubiquity became so commonly used that other browsers eventually implemented it as well. It has been adopted into the DOM specification, primarily to ensure that existing web content continues to function going forward.
-
-New projects should generally avoid using `returnValue`, although they may if they choose to do so.
+`returnValue` 的值与 {{domxref("Event.defaultPrevented", "defaultPrevented")}} 返回的值相反。
 
 ## 规范
 
@@ -29,3 +27,7 @@ New projects should generally avoid using `returnValue`, although they may if th
 ## 浏览器兼容性
 
 {{Compat}}
+
+## 参见
+
+- {{domxref("HTMLDialogElement.returnValue")}}：{{HTMLElement("dialog")}} 的返回值。

From 51770fd30fefeb81b86fc5bd3134ddc72a793c87 Mon Sep 17 00:00:00 2001
From: A1lo <yin199909@aliyun.com>
Date: Tue, 10 Sep 2024 13:50:11 +0800
Subject: [PATCH 024/115] zh-cn: update the translation of the `UIEvent`
 constructor (#23301)

---
 files/zh-cn/web/api/uievent/uievent/index.md | 42 ++++++++++++--------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/files/zh-cn/web/api/uievent/uievent/index.md b/files/zh-cn/web/api/uievent/uievent/index.md
index 88fb4462f4fce8..fdc6e43a42905d 100644
--- a/files/zh-cn/web/api/uievent/uievent/index.md
+++ b/files/zh-cn/web/api/uievent/uievent/index.md
@@ -1,33 +1,43 @@
 ---
-title: UIEvent()
+title: UIEvent：UIEvent() 构造函数
 slug: Web/API/UIEvent/UIEvent
+l10n:
+  sourceCommit: 22080a7cc403f7f45c8e85065b182c9f0d4d383c
 ---
 
 {{APIRef("UI Events")}}
 
-**`UIEvent()`** 作为构造函数，可用于构造一个新的 {{domxref("UIEvent")}} 对象。
+**`UIEvent()`** 构造函数创建一个新的 {{domxref("UIEvent")}} 对象。
+
+> [!NOTE]
+> 如果你使用该构造函数构造合成事件，那么出于安全原因，该事件不会被*信任*。只有浏览器生成的 `UIEvent` 对象是受信任的，只有受信任的事件才会触发默认动作。
 
 ## 语法
 
-```
-event = new UIEvent(typeArg [, UIEventInit])
+```js-nolint
+new UIEvent(type)
+new UIEvent(type, options)
 ```
 
-### Values
+### 参数
 
-- `typeArg`
-  - : 传递的是一个 {{domxref("DOMString")}}类型的字符串，用来命名且重新发布的事件。
-- `UIEventInit` {{optional_inline}}
+- `type`
+  - : 表示事件名称的字符串。大小写敏感，浏览器会将其设置为 `load`、`unload`、`abort`、`error` 或 `select`。
+- `options` {{optional_inline}}
 
-  - : 是 `UIEventInit` 集合，它拥有以下属性：
+  - : 一个对象，_除了 {{domxref("Event/Event", "Event()")}} 中定义的属性外_，还可以具有以下属性：
+    - `detail` {{optional_inline}}
+      - : 一个表示与事件关联的事件相关值的数字。默认值为 `0`，{{domxref("UIEvent.detail")}} 列出了用于标准事件的语义。
+    - `view` {{optional_inline}}
+      - : 与事件关联的 {{domxref("Window")}}。默认值为 `null`。
+    - `sourceCapabilities` {{optional_inline}} {{non-standard_inline}}
+      - : 提供有关负责生成触摸事件的物理设备的信息的 {{domxref("InputDeviceCapabilities")}} 对象。
 
-    - **`detail`**: 可选，默认为 long 类型的 0 数值，用来标记事件的关联值。{{domxref("UIEvent.detail")}} 列出了标准事件的语义。
-    - **`view`**: 可选，默认为 null，类型为 {{domxref("WindowProxy")}}, 用来关联{{domxref("Window")}} 与 event 本身。
-    - **`sourceCapabilities`**: {{non-standard_inline}} 一个 {{domxref("InputDeviceCapabilities")}} 类型的接口实例 (对象)，用来提供物理设备的触摸信息。
+### 返回值
 
-    > **备注：** `UIEventInit` 合集依然接受从{{domxref("Event.Event", "EventInit")}} 定义来的合集。
+一个新的 {{domxref("UIEvent")}} 对象。
 
-## Specifications
+## 规范
 
 {{Specifications}}
 
@@ -35,6 +45,6 @@ event = new UIEvent(typeArg [, UIEventInit])
 
 {{Compat}}
 
-## See also
+## 参见
 
-- {{domxref("UIEvent")}}, the interface of the objects it constructs.
+- 其构造的对象的接口：{{domxref("UIEvent")}}。

From cacfc6188968124ba481f9847d5310648de75af3 Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Tue, 10 Sep 2024 20:11:47 +0800
Subject: [PATCH 025/115] zh-CN: create Glossary/Inset_properties (#23327)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../zh-cn/glossary/inset_properties/index.md  | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 files/zh-cn/glossary/inset_properties/index.md

diff --git a/files/zh-cn/glossary/inset_properties/index.md b/files/zh-cn/glossary/inset_properties/index.md
new file mode 100644
index 00000000000000..0f134e738e72aa
--- /dev/null
+++ b/files/zh-cn/glossary/inset_properties/index.md
@@ -0,0 +1,23 @@
+---
+title: Inset 属性
+slug: Glossary/Inset_properties
+l10n:
+  sourceCommit: c5f403bb08c91ae77ddfe47f937438fb5e6fcae5
+---
+
+{{GlossarySidebar}}
+
+CSS **inset 属性**通过指定元素相对于默认位置的偏移量控制定位元素的位置。inset 属性包括物理、逻辑和简写的 inset 属性。
+
+inset 属性包括物理属性（{{cssxref("top")}}、{{cssxref("left")}}、{{cssxref("bottom")}} 和 {{cssxref("right")}}）、与流式布局相关的等价{{glossary("logical properties", "逻辑属性")}}（{{cssxref("inset-block-start")}}、{{cssxref("inset-block-end")}}、{{cssxref("inset-inline-start")}} 和 {{cssxref("inset-inline-end")}}），以及 {{cssxref("inset-block")}}、{{cssxref("inset-inline")}} 和 {{cssxref("inset")}} 简写。
+
+**物理属性**引用元素的特定物理边界。逻辑属性使用相对于块轴和行轴的方向关键字。**块轴**是指定义块布局中元素堆叠顺序的轴。**行轴**与块轴垂直，代表文本等行级内容在区块内流动的方向。这些映射取决于元素的 {{cssxref("writing-mode")}}、{{cssxref("direction")}} 和 {{cssxref("text-orientation")}}。
+
+inset 属性的解释取决于 {{cssxref("position")}} 属性的值。当设置 `position: absolute` 时，它们代表从[包含块](/zh-CN/docs/Web/CSS/Containing_block)或[锚点元素](/zh-CN/docs/Web/CSS/CSS_anchor_positioning/Using)插入。如果使用 `position: relative`，它们表示从盒子的默认外边距边缘位置插入。如果使用 `sticky`，则表示从{{glossary("scroll container", "滚动容器")}}的边缘嵌入。`fixed` 值与 `absolute` 类似，只是元素的位置和大小是相对于其固定定位的包含块（通常是视口）而言的。
+
+## 参见
+
+- [布局与包含快](/zh-CN/docs/Web/CSS/Containing_block)
+- [CSS 定位布局](/zh-CN/docs/Web/CSS/CSS_positioned_layout)模块
+- [CSS 逻辑属性和值](/zh-CN/docs/Web/CSS/CSS_logical_properties_and_values)模块
+- [CSS 锚点定位](/zh-CN/docs/Web/CSS/CSS_anchor_positioning)模块

From 5fc0364e75bf73b0e40f8db32dbda885a436bc5b Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Tue, 10 Sep 2024 20:12:48 +0800
Subject: [PATCH 026/115] zh-CN: create Glossary/Shim (#23323)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 files/zh-cn/glossary/shim/index.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 files/zh-cn/glossary/shim/index.md

diff --git a/files/zh-cn/glossary/shim/index.md b/files/zh-cn/glossary/shim/index.md
new file mode 100644
index 00000000000000..5b27df18db7dbc
--- /dev/null
+++ b/files/zh-cn/glossary/shim/index.md
@@ -0,0 +1,14 @@
+---
+title: 垫片
+slug: Glossary/Shim
+l10n:
+  sourceCommit: ada5fa5ef15eadd44b549ecf906423b4a2092f34
+---
+
+{{GlossarySidebar}}
+
+**垫片**（shim）是用于修正已经存在的代码行为的一段代码，通常通过添加新的 API 来实现解决问题。它与 {{Glossary("polyfill")}} 不同：后者通过实现一个新的不受浏览器原生支持的 API 来解决问题。
+
+## 参见
+
+- 维基百科上的[垫片](<https://zh.wikipedia.org/wiki/垫片_(程序设计)>)

From 824a2f8b7dd8ff44a7ac474236304f21175828e7 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 6 Sep 2024 22:14:22 +0900
Subject: [PATCH 027/115] =?UTF-8?q?2024/08/30=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pointerevent/persistentdeviceid/index.md  | 72 +++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 files/ja/web/api/pointerevent/persistentdeviceid/index.md

diff --git a/files/ja/web/api/pointerevent/persistentdeviceid/index.md b/files/ja/web/api/pointerevent/persistentdeviceid/index.md
new file mode 100644
index 00000000000000..b638d094c23bcb
--- /dev/null
+++ b/files/ja/web/api/pointerevent/persistentdeviceid/index.md
@@ -0,0 +1,72 @@
+---
+title: "PointerEvent: persistentDeviceId プロパティ"
+short-title: persistentDeviceId
+slug: Web/API/PointerEvent/persistentDeviceId
+l10n:
+  sourceCommit: ba77b09c606b1b5fdea532e84b980cd0e79f226d
+---
+
+{{ APIRef("Pointer Events") }}{{SeeCompatTable}}
+
+**`persistentDeviceId`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用のプロパティで、この `PointerEvent` を生成したポインティングデバイスの固有の識別子です。これは、同時に画面の操作を行う複数のポインティングデバイス（ペンなど）を特定するための安全で信頼性の高い方法を提供します。
+
+`persistentDeviceId` は、閲覧セッションが継続する間維持されます。フィンガープリンティングやトラッキングのリスクを避けるため、それぞれのセッションの開始時に、このポインティングデバイスに新しい `persistentDeviceId` を割り当てます。
+
+発生源が特定できないポインターイベントには、`persistentDeviceId` 値として `0` が割り当てられます。
+
+## 値
+
+整数、またはこの `PointerEvent` を生成した端末が特定できなかった場合は `0`。
+
+> [!NOTE]
+> デジタイザーとポインティングデバイスのハードウェアの制約により、`persistentDeviceId` がすべてのポインターイベントで利用できるとは限りません。特に古いハードウェアでは利用できない可能性があります。例えば、ポインティングデバイスが、`pointerdown` が `persistentDeviceId` を受け取る時点までに、そのハードウェア ID をデジタイザーに報告しない可能性があります。最初は `0` であり、ストロークの後のイベントで有効な値に変更される可能性があります。
+
+## 例
+
+次の HTML があったとします。
+
+```html
+<canvas id="inking-surface" width="1280" height="720"></canvas>
+```
+
+次の JavaScript は、キャンバスを操作するそれぞれのポインターにそれぞれ異なるインキング色を割り当てます。
+
+```js
+const colorBlue = 0;
+const colorGreen = 1;
+const colorYellow = 2;
+const colors = [colorBlue, colorGreen, colorYellow];
+
+const pointerToColorMap = new Map();
+const colorAssignmentIndex = 0;
+
+const canvas = document.querySelector("#inking-surface");
+
+// ポインターダウンイベントを待ち受けし、persistentDeviceId が存在し、
+// まだ割り当てられていない場合は、それを色に割り当てます。
+canvas.addEventListener("pointerdown", (e) => {
+  if (e.persistentDeviceId && !pointerToColorMap.has(e.persistentDeviceId)) {
+    pointerToColorMap.set(e.persistentDeviceId, colors[colorAssignmentIndex]);
+
+    // 色割り当てインデックスを変更し、必要に応じてループバックします。
+    colorAssignmentIndex = (colorAssignmentIndex + 1) % colors.length;
+  }
+});
+
+// `pointermove` を待ち受けし、persistentDeviceId が存在し、ポインターに
+// 色が割り当てられている場合、その色を取得します。
+canvas.addEventListener("pointermove", (e) => {
+  if (e.persistentDeviceId && pointerToColorMap.has(e.persistentDeviceId)) {
+    const pointerColor = pointerToColorMap.get(e.persistentDeviceId);
+    // 何か <canvas> で描画する
+  }
+});
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}

From c61f32c1170beed7d7db6408b0aad661aa49d36d Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 6 Sep 2024 22:19:33 +0900
Subject: [PATCH 028/115] =?UTF-8?q?2024/08/30=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pointerevent/pointerid/index.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/files/ja/web/api/pointerevent/pointerid/index.md b/files/ja/web/api/pointerevent/pointerid/index.md
index ababf01dbd83a8..7169278b2d06cd 100644
--- a/files/ja/web/api/pointerevent/pointerid/index.md
+++ b/files/ja/web/api/pointerevent/pointerid/index.md
@@ -1,13 +1,16 @@
 ---
-title: PointerEvent.pointerId
+title: "PointerEvent: pointerId プロパティ"
+short-title: pointerId
 slug: Web/API/PointerEvent/pointerId
 l10n:
-  sourceCommit: c244d3b2cb6c17e6ba8692e3faec393afd9988ca
+  sourceCommit: ba77b09c606b1b5fdea532e84b980cd0e79f226d
 ---
 
 {{ APIRef("Pointer Events") }}
 
-**`pointerId`** {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、特定のポインターのイベントに割り当てられた識別子です。 識別子は一意であり、他のすべてのアクティブポインターのイベントの識別子と異なります。 値はランダムに生成される可能性があるため、特定の意味を伝えることは保証されません。
+**`pointerId`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、特定のポインターのイベントに割り当てられた識別子です。 識別子は一意であり、他のすべてのアクティブポインターのイベントの識別子と異なります。 値はランダムに生成される可能性があるため、特定の意味を伝えることは保証されません。
+
+> **メモ:** `pointerId` プロパティの実装は、ブラウザー間でばらつきがあり、常に各インクストロークや、画面の操作に対して維持されるわけではありません。画面に同時に存在する複数のポインティングデバイスを確実に識別する方法については、{{domxref("PointerEvent.persistentDeviceId")}} を参照してください。
 
 ## 値
 

From 34deda6a20fe2fce344105ed097d1ae92da0de4c Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 6 Sep 2024 22:21:23 +0900
Subject: [PATCH 029/115] =?UTF-8?q?2023/07/07=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pointerevent/pointertype/index.md        | 7 ++++---
 files/ja/web/api/pointerevent/pressure/index.md           | 5 +++--
 files/ja/web/api/pointerevent/tangentialpressure/index.md | 5 +++--
 files/ja/web/api/pointerevent/tiltx/index.md              | 7 ++++---
 files/ja/web/api/pointerevent/tilty/index.md              | 7 ++++---
 files/ja/web/api/pointerevent/twist/index.md              | 5 +++--
 6 files changed, 21 insertions(+), 15 deletions(-)

diff --git a/files/ja/web/api/pointerevent/pointertype/index.md b/files/ja/web/api/pointerevent/pointertype/index.md
index cc09ec9b4b7846..ea6d4b61231e0e 100644
--- a/files/ja/web/api/pointerevent/pointertype/index.md
+++ b/files/ja/web/api/pointerevent/pointertype/index.md
@@ -1,13 +1,14 @@
 ---
-title: PointerEvent.pointerType
+title: "PointerEvent: pointerType プロパティ"
+short-title: pointerType
 slug: Web/API/PointerEvent/pointerType
 l10n:
-  sourceCommit: c244d3b2cb6c17e6ba8692e3faec393afd9988ca
+  sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc
 ---
 
 {{ APIRef("Pointer Events") }}
 
-**`pointerType`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、特定のポインターイベントを引き起こした機器の種類（マウス、ペン、またはタッチ）を示します。
+**`pointerType`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、特定のポインターイベントを引き起こした機器の種類（マウス、ペン、タッチのいずれか）を示します。
 
 ## 値
 
diff --git a/files/ja/web/api/pointerevent/pressure/index.md b/files/ja/web/api/pointerevent/pressure/index.md
index 38b81d7ee72eb3..2b3e07e2bf0e9c 100644
--- a/files/ja/web/api/pointerevent/pressure/index.md
+++ b/files/ja/web/api/pointerevent/pressure/index.md
@@ -1,8 +1,9 @@
 ---
-title: PointerEvent.pressure
+title: "PointerEvent: pressure プロパティ"
+short-title: pressure
 slug: Web/API/PointerEvent/pressure
 l10n:
-  sourceCommit: c244d3b2cb6c17e6ba8692e3faec393afd9988ca
+  sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc
 ---
 
 {{ APIRef("Pointer Events") }}
diff --git a/files/ja/web/api/pointerevent/tangentialpressure/index.md b/files/ja/web/api/pointerevent/tangentialpressure/index.md
index e8b816bfa30232..2c49d778ce6e86 100644
--- a/files/ja/web/api/pointerevent/tangentialpressure/index.md
+++ b/files/ja/web/api/pointerevent/tangentialpressure/index.md
@@ -1,8 +1,9 @@
 ---
-title: PointerEvent.tangentialPressure
+title: "PointerEvent: tangentialPressure プロパティ"
+short-title: tangentialPressure
 slug: Web/API/PointerEvent/tangentialPressure
 l10n:
-  sourceCommit: c244d3b2cb6c17e6ba8692e3faec393afd9988ca
+  sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc
 ---
 
 {{ APIRef("Pointer Events") }}
diff --git a/files/ja/web/api/pointerevent/tiltx/index.md b/files/ja/web/api/pointerevent/tiltx/index.md
index a920761afe7a87..78bbe48cb5e84d 100644
--- a/files/ja/web/api/pointerevent/tiltx/index.md
+++ b/files/ja/web/api/pointerevent/tiltx/index.md
@@ -1,15 +1,16 @@
 ---
-title: PointerEvent.tiltX
+title: "PointerEvent: tiltX プロパティ"
+short-title: tiltX
 slug: Web/API/PointerEvent/tiltX
 l10n:
-  sourceCommit: 4b4638246aad5d39b9a2e5c572b179b4c39c0a84
+  sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc
 ---
 
 {{ APIRef("Pointer Events") }}
 
 **`tiltX`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、ポインターの *Y-Z 平面*と画面との間の角度（度単位）です。 このプロパティは通常、ペン/スタイラス型のポインターにのみ役立ちます。
 
-このプロパティの説明については、[仕様の図 2](https://w3c.github.io/pointerevents/#dom-pointerevent-tiltx) を参照してください。
+このプロパティの説明については、[仕様書の図 2](https://w3c.github.io/pointerevents/#dom-pointerevent-tiltx) を参照してください。
 
 ## 値
 
diff --git a/files/ja/web/api/pointerevent/tilty/index.md b/files/ja/web/api/pointerevent/tilty/index.md
index 604b70292921a1..bad66c491dea80 100644
--- a/files/ja/web/api/pointerevent/tilty/index.md
+++ b/files/ja/web/api/pointerevent/tilty/index.md
@@ -1,15 +1,16 @@
 ---
-title: PointerEvent.tiltY
+title: "PointerEvent: tiltY プロパティ"
+short-title: tiltY
 slug: Web/API/PointerEvent/tiltY
 l10n:
-  sourceCommit: 4b4638246aad5d39b9a2e5c572b179b4c39c0a84
+  sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc
 ---
 
 {{ APIRef("Pointer Events") }}
 
 **`tiltY`** は {{domxref("PointerEvent")}} インターフェイスの読み取り専用プロパティで、ポインターの *X-Z 平面*と画面の間の角度（度単位）です。 このプロパティは通常、ペン/スタイラス型のポインターのみ役立ちます。
 
-このプロパティの説明については、[仕様の図 3](https://w3c.github.io/pointerevents/#dom-pointerevent-tilty) を参照してください。
+このプロパティの説明については、[仕様書の図 3](https://w3c.github.io/pointerevents/#dom-pointerevent-tilty) を参照してください。
 
 ## 値
 
diff --git a/files/ja/web/api/pointerevent/twist/index.md b/files/ja/web/api/pointerevent/twist/index.md
index 17024c683f5d92..2895b56b56a5e9 100644
--- a/files/ja/web/api/pointerevent/twist/index.md
+++ b/files/ja/web/api/pointerevent/twist/index.md
@@ -1,8 +1,9 @@
 ---
-title: PointerEvent.twist
+title: "PointerEvent: twist プロパティ"
+short-title: twist
 slug: Web/API/PointerEvent/twist
 l10n:
-  sourceCommit: c244d3b2cb6c17e6ba8692e3faec393afd9988ca
+  sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc
 ---
 
 {{ APIRef("Pointer Events") }}

From 1acb4213fb8bae64a9de3567844db00b3e97ab66 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 6 Sep 2024 22:35:08 +0900
Subject: [PATCH 030/115] =?UTF-8?q?2024/07/25=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pointerevent/width/index.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/files/ja/web/api/pointerevent/width/index.md b/files/ja/web/api/pointerevent/width/index.md
index c2c8f4010c7a5e..5b1f9a790852be 100644
--- a/files/ja/web/api/pointerevent/width/index.md
+++ b/files/ja/web/api/pointerevent/width/index.md
@@ -1,8 +1,9 @@
 ---
-title: PointerEvent.width
+title: "PointerEvent: width プロパティ"
+short-title: width
 slug: Web/API/PointerEvent/width
 l10n:
-  sourceCommit: 4b4638246aad5d39b9a2e5c572b179b4c39c0a84
+  sourceCommit: b71d118ffc6d72b77efad9661110fcc9ede464eb
 ---
 
 {{ APIRef("Pointer Events") }}
@@ -17,7 +18,7 @@ l10n:
 
 ## 例
 
-この例では、{{domxref("PointerEvent")}} インターフェイスの {{domxref("PointerEvent.width","width")}} プロパティと {{domxref("PointerEvent.height","height")}} プロパティを使用して接触面積を計算する方法を示します。
+この例では、{{domxref("PointerEvent")}} インターフェイスの `width` プロパティと {{domxref("PointerEvent.height","height")}} プロパティを使用して接触面積を計算する方法を示します。
 
 ```js
 target.addEventListener(

From f8d14fec45a8164cf0b05f165a27061da546fdf9 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 00:29:31 +0900
Subject: [PATCH 031/115] =?UTF-8?q?2023/12/14=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pointerevent/getcoalescedevents/index.md  | 64 +++++++++++++++++--
 1 file changed, 60 insertions(+), 4 deletions(-)

diff --git a/files/ja/web/api/pointerevent/getcoalescedevents/index.md b/files/ja/web/api/pointerevent/getcoalescedevents/index.md
index f9f8a774ba7c19..9b500f9b12a27b 100644
--- a/files/ja/web/api/pointerevent/getcoalescedevents/index.md
+++ b/files/ja/web/api/pointerevent/getcoalescedevents/index.md
@@ -1,13 +1,20 @@
 ---
-title: PointerEvent.getCoalescedEvents()
+title: "PointerEvent: getCoalescedEvents() メソッド"
+short-title: getCoalescedEvents()
 slug: Web/API/PointerEvent/getCoalescedEvents
 l10n:
   sourceCommit: 95dff5ec1195f072b8e48a2273294933670b1e99
 ---
 
-{{APIRef("Pointer Events")}}
+{{APIRef("Pointer Events")}} {{secureContext_header}}
 
-**`getCoalescedEvents()`** は {{domxref("PointerEvent")}} インターフェイスのメソッドで、送出された {{domxref('Element/pointermove_event', 'pointermove')}} イベントに合成されるすべての `PointerEvent` インスタンスの列を返します。
+**`getCoalescedEvents()`** は {{domxref("PointerEvent")}} インターフェイスのメソッドで、単一の {{domxref('Element/pointermove_event', 'pointermove')}} または {{domxref('Element/pointerrawupdate_event', 'pointerrawupdate')}} イベントに統合（マージ）された `PointerEvent` インスタンスの配列を返します。
+ユーザーエージェントは、複数の更新を多数の {{domxref('Element/pointermove_event', 'pointermove')}} イベントの並びを単一のイベントに統合します。
+これにより、ユーザーエージェントが処理するイベント数が減るため、処理速度の向上に役立ちますが、特に高速かつ大規模な動きの場合、追跡の粒度と精度が低下する可能性があります。
+
+**`getCoalescedEvents()`** メソッドを使用すると、アプリケーションは必要に応じて、ポインターの移動データを正確に処理するために、統合前のすべての位置の変更にアクセスすることができます。統合前の位置の変更は、描画アプリケーションで望ましいものです。すべてのイベントにアクセスすることで、たとえば、ポインターの動きにより近い滑らかな曲線を作成するのに役立ちます。
+
+イベントの統合についての説明は、[仕様書の Figure 7](https://w3c.github.io/pointerevents/#figure_coalesced) を参照してください。
 
 ## 構文
 
@@ -21,7 +28,56 @@ getCoalescedEvents()
 
 ### 返値
 
-{{domxref('PointerEvent')}} インスタンスの列。
+{{domxref('PointerEvent')}} インスタンスの配列。
+
+## 例
+
+### HTML
+
+```html
+<canvas id="target" width="600" height="300"></canvas>
+```
+
+### JavaScript
+
+```js
+const canvas = document.getElementById("target");
+const ctx = canvas.getContext("2d");
+
+const pointerEvents = [];
+
+function drawCircle(x, y, color) {
+  ctx.clearRect(0, 0, canvas.width, canvas.height);
+
+  // 最後の 20 件のイベントを描画
+  if (pointerEvents.length > 20) {
+    pointerEvents.shift();
+  }
+  pointerEvents.push({ x, y, color });
+
+  for (const pointerEvent of pointerEvents) {
+    ctx.beginPath();
+    ctx.arc(pointerEvent.x, pointerEvent.y, 10, 0, 2 * Math.PI);
+    ctx.strokeStyle = pointerEvent.color;
+    ctx.stroke();
+  }
+}
+
+canvas.addEventListener("pointermove", (e) => {
+  // 現在のイベントに円を描画
+  drawCircle(e.clientX, e.clientY, "black");
+
+  const coalescedEvents = e.getCoalescedEvents();
+  for (let coalescedEvent of coalescedEvents) {
+    // 違いが分かるようにオフセットを適用し、赤に色付けする
+    drawCircle(coalescedEvent.clientX + 20, coalescedEvent.clientY + 20, "red");
+  }
+});
+```
+
+### 結果
+
+{{EmbedLiveSample("Example", "", "320")}}
 
 ## 仕様書
 

From c134726d775140ab4a6b71e3ff70f028e4c0d0cf Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 00:37:01 +0900
Subject: [PATCH 032/115] =?UTF-8?q?2023/06/23=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pointerevent/getpredictedevents/index.md  | 87 +++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 files/ja/web/api/pointerevent/getpredictedevents/index.md

diff --git a/files/ja/web/api/pointerevent/getpredictedevents/index.md b/files/ja/web/api/pointerevent/getpredictedevents/index.md
new file mode 100644
index 00000000000000..fa44b9b899fd1f
--- /dev/null
+++ b/files/ja/web/api/pointerevent/getpredictedevents/index.md
@@ -0,0 +1,87 @@
+---
+title: "PointerEvent: getPredictedEvents() メソッド"
+short-title: getPredictedEvents()
+slug: Web/API/PointerEvent/getPredictedEvents
+l10n:
+  sourceCommit: 84c430110b84fae0335959184ce73f03124220fd
+---
+
+{{APIRef("Pointer Events")}}
+
+**`getPredictedEvents()`** は {{domxref("PointerEvent")}} インターフェイスのメソッドで、将来のポインター位置を予測した一連の `PointerEvent` インスタンスを返します。
+予測位置の計算方法はユーザーエージェントによって異なりますが、過去の位置、現在の速度、軌道に基づいて計算されます。
+
+アプリケーションは予測イベントを使用して、予測された位置に「描画」することができます。予測イベントのアプリケーションによる解釈と用途によって、知覚される応答時間が縮小する可能性があります。
+
+予測されるイベントの例については、[仕様書の Figure 8](https://w3c.github.io/pointerevents/#figure_predicted) を参照してください。
+
+## 構文
+
+```js-nolint
+getPredictedEvents()
+```
+
+### 引数
+
+なし。
+
+### 返値
+
+{{domxref('PointerEvent')}} インスタンスの配列です。
+
+## 例
+
+### HTML
+
+```html
+<canvas id="target" width="600" height="300"></canvas>
+```
+
+### JavaScript
+
+```js
+const canvas = document.getElementById("target");
+const ctx = canvas.getContext("2d");
+
+const pointerEvents = [];
+
+function drawCircle(x, y, color) {
+  ctx.clearRect(0, 0, canvas.width, canvas.height);
+
+  // 最後の 20 件のイベントを描画
+  if (pointerEvents.length > 20) {
+    pointerEvents.shift();
+  }
+  pointerEvents.push({ x, y, color });
+
+  for (const pointerEvent of pointerEvents) {
+    ctx.beginPath();
+    ctx.arc(pointerEvent.x, pointerEvent.y, 10, 0, 2 * Math.PI);
+    ctx.strokeStyle = pointerEvent.color;
+    ctx.stroke();
+  }
+}
+
+canvas.addEventListener("pointermove", (e) => {
+  // 現在のイベントに円を描画
+  drawCircle(e.clientX, e.clientY, "black");
+
+  const predictedEvents = e.getPredictedEvents();
+  for (let predictedEvent of predictedEvents) {
+    // 違いが分かるようにオフセットを適用し、赤に色付けする
+    drawCircle(predictedEvent.clientX + 20, predictedEvent.clientY + 20, "red");
+  }
+});
+```
+
+### 結果
+
+{{EmbedLiveSample("Example", "", "320")}}
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}

From 830b825aa2ea2dd64c1f355aef8ccd409363933f Mon Sep 17 00:00:00 2001
From: jz4o <26317360+jz4o@users.noreply.github.com>
Date: Tue, 10 Sep 2024 21:50:35 +0900
Subject: [PATCH 033/115] [ja]: fix typo

---
 files/ja/glossary/kebab_case/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/ja/glossary/kebab_case/index.md b/files/ja/glossary/kebab_case/index.md
index 86a44e6cd4082e..3dd05f70841961 100644
--- a/files/ja/glossary/kebab_case/index.md
+++ b/files/ja/glossary/kebab_case/index.md
@@ -9,7 +9,7 @@ l10n:
 
 **ケバブケース**とは、スペースを入れずにフレーズを書く方法で、スペースはハイフン `-` で置き換えられ、単語はすべて小文字になるのが一般的です。ケバブの串に刺さった肉に似ていることから名付けられました。その姿を読者に連想させるため、よく "kebab-case" と表記されます。
 
-ケバブケースは変数の名前付き規約として多く使用されています。しかし、多くの言語ではハイフンは引き算を表しますので、ケーバブケースは選択されていません。 {{cssxref("background-color")}} や {{cssxref("font-family")}} のような CSS プロパティ、また [`aria-label`](/ja/docs/Web/Accessibility/ARIA/Attributes/aria-label) や [`data-*`](/ja/docs/Web/HTML/Global_attributes/data-*) のような HTML 属性はケバブケースです。
+ケバブケースは変数の名前付き規約として多く使用されています。しかし、多くの言語ではハイフンは引き算を表しますので、ケバブケースは選択されていません。 {{cssxref("background-color")}} や {{cssxref("font-family")}} のような CSS プロパティ、また [`aria-label`](/ja/docs/Web/Accessibility/ARIA/Attributes/aria-label) や [`data-*`](/ja/docs/Web/HTML/Global_attributes/data-*) のような HTML 属性はケバブケースです。
 
 ケバブケースの語は、よく「ハイフン区切り」と呼ばれます。
 

From fe37baf75ce15d68c55e98c30a203d6768601c67 Mon Sep 17 00:00:00 2001
From: hochan Lee <hochan049@gmail.com>
Date: Wed, 11 Sep 2024 08:24:50 +0900
Subject: [PATCH 034/115] fix: remove DOMAttributeMethods deprecated macro
 (#23462)

---
 docs/ko/guides/macro-guide.md                         | 2 --
 files/es/web/api/element/getattributenodens/index.md  | 2 --
 files/es/web/api/element/removeattribute/index.md     | 2 --
 files/es/web/api/element/setattributens/index.md      | 4 ----
 files/ja/web/api/element/getattributenode/index.md    | 2 --
 files/ja/web/api/element/getattributenodens/index.md  | 2 --
 files/ja/web/api/element/getattributens/index.md      | 2 --
 files/ja/web/api/element/hasattribute/index.md        | 4 ----
 files/ja/web/api/element/hasattributens/index.md      | 4 ----
 files/ja/web/api/element/removeattribute/index.md     | 2 --
 files/ja/web/api/element/removeattributenode/index.md | 2 --
 files/ja/web/api/element/removeattributens/index.md   | 4 ----
 files/ja/web/api/element/setattribute/index.md        | 2 --
 files/ja/web/api/element/setattributenode/index.md    | 2 --
 files/ja/web/api/element/setattributenodens/index.md  | 2 --
 files/ja/web/api/element/setattributens/index.md      | 2 --
 files/ja/web/api/element/toggleattribute/index.md     | 2 --
 files/ko/web/api/element/setattribute/index.md        | 2 --
 18 files changed, 44 deletions(-)

diff --git a/docs/ko/guides/macro-guide.md b/docs/ko/guides/macro-guide.md
index 2ccd4d0ac066c1..a874074acb4f31 100644
--- a/docs/ko/guides/macro-guide.md
+++ b/docs/ko/guides/macro-guide.md
@@ -29,5 +29,3 @@ EmbedLiveSample/MacroLiveSampleError 오류 찾는 [스크립트 링크 참고](
 ## 매크로 수정 및 번역
 
 MDN은 초창기에 [kuma](https://github.com/mdn/kuma) 플랫폼으로 MDN 웹 문서를 구동해왔습니다. 그 당시 사용한 많은 매크로들이 레거시로 남아 있습니다. 레거시로 남은 매크로를 [Kumascript](https://github.com/mdn/kumascript)라고 부릅니다. 현재는 [yari 저장소 내의 kumascript 폴더](https://github.com/mdn/yari/tree/main/kumascript)로 대체되어 사용되고 있습니다([참고](https://egas.tistory.com/168#%EB%AF%B8%EC%82%AC%EC%9A%A9-macro-%EC%A0%9C%EA%B1%B0)).
-
-만약 `{{DOMAttributeMethods}}` 매크로를 수정하자고 한다면 `kumascript/macros/DOMAttributeMethods.ejs`를 확인하면 됩니다([관련 PR](https://github.com/mdn/yari/pull/10502)).
diff --git a/files/es/web/api/element/getattributenodens/index.md b/files/es/web/api/element/getattributenodens/index.md
index ea6653878a277b..2f12790b2a514d 100644
--- a/files/es/web/api/element/getattributenodens/index.md
+++ b/files/es/web/api/element/getattributenodens/index.md
@@ -23,8 +23,6 @@ attributeNode = element.getAttributeNodeNS(namespace, nodeName);
 
 `getAttributeNodeNS` es más específica [getAttributeNode](en/DOM/element.getAttributeNode) en el sentido de que puedes especificar atributos de un namespace en particular. Su método setter es [setAttributeNodeNS](en/DOM/element.setAttributeNodeNS).
 
-{{ DOMAttributeMethods() }}
-
 ## Especificaciones
 
 {{Specifications}}
diff --git a/files/es/web/api/element/removeattribute/index.md b/files/es/web/api/element/removeattribute/index.md
index 35b5206a3ec661..204d6c28653595 100644
--- a/files/es/web/api/element/removeattribute/index.md
+++ b/files/es/web/api/element/removeattribute/index.md
@@ -29,8 +29,6 @@ Debe usarse preferiblemente `removeAttribute` en lugar de establecer el valor de
 
 Intentar eliminar un atributo que no existe en el elemento no disparará una excepción.
 
-{{ DOMAttributeMethods() }}
-
 ## Especificaciones
 
 {{Specifications}}
diff --git a/files/es/web/api/element/setattributens/index.md b/files/es/web/api/element/setattributens/index.md
index 68e7031566b862..999c6d866dbbc8 100644
--- a/files/es/web/api/element/setattributens/index.md
+++ b/files/es/web/api/element/setattributens/index.md
@@ -24,10 +24,6 @@ var d = document.getElementById("d1");
 d.setAttributeNS("http://www.mozilla.org/ns/specialspace", "align", "center");
 ```
 
-## Notas
-
-{{ DOMAttributeMethods() }}
-
 ## Especificaciones
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/getattributenode/index.md b/files/ja/web/api/element/getattributenode/index.md
index 369deeb84a11b8..d73e43d8316fbd 100644
--- a/files/ja/web/api/element/getattributenode/index.md
+++ b/files/ja/web/api/element/getattributenode/index.md
@@ -41,8 +41,6 @@ HTML 文書としてフラグが立てられた DOM 内の HTML 要素に対し
 
 要素の属性の値を取得するためには、通常 `getAttributeNode` の代わりに [getAttribute](/ja/docs/Web/API/Element/getAttribute) が使用されます。
 
-{{ DOMAttributeMethods() }}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/getattributenodens/index.md b/files/ja/web/api/element/getattributenodens/index.md
index fad9af6a1227bb..34fdceaabd1ed5 100644
--- a/files/ja/web/api/element/getattributenodens/index.md
+++ b/files/ja/web/api/element/getattributenodens/index.md
@@ -29,8 +29,6 @@ getAttributeNodeNS(namespace, nodeName)
 
 `getAttributeNodeNS` は [getAttributeNode](getAttributeNode) よりも、特定の名前空間に含まれる属性を特定することができる点でより具体的です。対応するセッターメソッドは [setAttributeNodeNS](/ja/docs/Web/API/Element/setAttributeNodeNS) です。
 
-{{ DOMAttributeMethods() }}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/getattributens/index.md b/files/ja/web/api/element/getattributens/index.md
index dda4882304726b..743bdd566fab2d 100644
--- a/files/ja/web/api/element/getattributens/index.md
+++ b/files/ja/web/api/element/getattributens/index.md
@@ -94,8 +94,6 @@ HTML 文書では名前空間に対応していないため、この属性は `t
 
 DOM4 より前の仕様では、このメソッドは属性が存在しない場合に null ではなく空文字列を返すように指定されていました。しかし、ほとんどのウェブブラウザーは null を返していました。 DOM4 以降は、仕様でも null を返すように指定されました。しかし、一部の古いウェブブラウザーは空文字列を返します。そのため、指定の要素に指定の属性が存在しない可能性があるなら、 `getAttributeNS` を呼ぶ前に {{domxref("element.hasAttributeNS()", "hasAttributeNS()")}} を使用して属性の存在を確かめる必要があります。
 
-{{DOMAttributeMethods}}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/hasattribute/index.md b/files/ja/web/api/element/hasattribute/index.md
index e34a234db70324..a995d545e2f329 100644
--- a/files/ja/web/api/element/hasattribute/index.md
+++ b/files/ja/web/api/element/hasattribute/index.md
@@ -34,10 +34,6 @@ if (foo.hasAttribute("bar")) {
 }
 ```
 
-## メモ
-
-{{DOMAttributeMethods}}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/hasattributens/index.md b/files/ja/web/api/element/hasattributens/index.md
index 7ec2b8fd76d410..d5264f88daa8d8 100644
--- a/files/ja/web/api/element/hasattributens/index.md
+++ b/files/ja/web/api/element/hasattributens/index.md
@@ -37,10 +37,6 @@ if (
 }
 ```
 
-## メモ
-
-{{ DOMAttributeMethods() }}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/removeattribute/index.md b/files/ja/web/api/element/removeattribute/index.md
index 1e2aa08adf14be..189ad4376b2057 100644
--- a/files/ja/web/api/element/removeattribute/index.md
+++ b/files/ja/web/api/element/removeattribute/index.md
@@ -29,8 +29,6 @@ removeAttribute(attrName)
 
 属性の値を直接、または {{domxref("Element.setAttribute", "setAttribute()")}} を使用して `null` に設定するのではなく、 `removeAttribute()` を使用してください。多くの属性は `null` に設定しても、期待通りの動作をしません。
 
-{{ DOMAttributeMethods() }}
-
 ## 例
 
 ```js
diff --git a/files/ja/web/api/element/removeattributenode/index.md b/files/ja/web/api/element/removeattributenode/index.md
index 9efe1dded2992f..1562e85040642b 100644
--- a/files/ja/web/api/element/removeattributenode/index.md
+++ b/files/ja/web/api/element/removeattributenode/index.md
@@ -46,8 +46,6 @@ d.removeAttributeNode(d_align);
 
 `removeAttributeNodeNS` メソッドはありません。`removeAttributeNode` メソッドは、名前空間付き属性と名前空間付きでない属性の両方を削除することができます。
 
-{{ DOMAttributeMethods() }}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/removeattributens/index.md b/files/ja/web/api/element/removeattributens/index.md
index 4353c86d1b9484..89567ede7273a3 100644
--- a/files/ja/web/api/element/removeattributens/index.md
+++ b/files/ja/web/api/element/removeattributens/index.md
@@ -36,10 +36,6 @@ d.removeAttributeNS("http://www.mozilla.org/ns/specialspace", "specialAlign");
 // Now: <div id="div1" width="200px" />
 ```
 
-## メモ
-
-{{ DOMAttributeMethods() }}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/setattribute/index.md b/files/ja/web/api/element/setattribute/index.md
index e0de90490465ae..56859542a0d976 100644
--- a/files/ja/web/api/element/setattribute/index.md
+++ b/files/ja/web/api/element/setattribute/index.md
@@ -79,8 +79,6 @@ button.setAttribute("disabled", "");
   重要なことは、属性が存在する場合、実際の値に関係なく、その値は `true` とみなされるということです。
   属性が存在しない場合、その値は `false` となります。`disabled` 属性の値を空文字列 (`""`) に設定することで、`disabled` を `true` に設定することになり、その結果ボタンは無効になります。
 
-{{DOMAttributeMethods}}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/setattributenode/index.md b/files/ja/web/api/element/setattributenode/index.md
index 0f04489717c29c..333d6c033de561 100644
--- a/files/ja/web/api/element/setattributenode/index.md
+++ b/files/ja/web/api/element/setattributenode/index.md
@@ -54,8 +54,6 @@ alert(d2.attributes[1].value);
 
 このメソッドが使われることはあまりなく、通常は {{domxref("Element.setAttribute()")}} が要素の属性を変更するために使われます。
 
-{{ DOMAttributeMethods() }}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/setattributenodens/index.md b/files/ja/web/api/element/setattributenodens/index.md
index f0333170f9b0d3..b3befa292a6b8c 100644
--- a/files/ja/web/api/element/setattributenodens/index.md
+++ b/files/ja/web/api/element/setattributenodens/index.md
@@ -45,8 +45,6 @@ alert(d2.attributes[1].value); // 返値: `utterleft'
 
 なお、ノードを複製せずに設定しようとすると、Mozilla は NS_ERROR_DOM_INUSE_ATTRIBUTE_ERR "Attribute already in use" エラーを出します。DOM は Attr を再利用するにあたって複製することを要求しているからです（他のノードが移動できるのとは異なります）。
 
-{{ DOMAttributeMethods() }}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ja/web/api/element/setattributens/index.md b/files/ja/web/api/element/setattributens/index.md
index 0ac2f113223633..571265fa34e82c 100644
--- a/files/ja/web/api/element/setattributens/index.md
+++ b/files/ja/web/api/element/setattributens/index.md
@@ -39,8 +39,6 @@ d.setAttributeNS(
 
 ## メモ
 
-{{ DOMAttributeMethods() }}
-
 `setAttributeNS` は名前空間属性のための唯一のメソッドで、完全修飾名、つまり `"namespace:localname"` を期待します。
 
 ## 仕様書
diff --git a/files/ja/web/api/element/toggleattribute/index.md b/files/ja/web/api/element/toggleattribute/index.md
index 61a664b5173cc2..f0c5050ff821bf 100644
--- a/files/ja/web/api/element/toggleattribute/index.md
+++ b/files/ja/web/api/element/toggleattribute/index.md
@@ -61,8 +61,6 @@ button.addEventListener("click", () => {
 
 {{ EmbedLiveSample('Examples', '300', '50') }}
 
-{{DOMAttributeMethods}}
-
 ## 仕様書
 
 {{Specifications}}
diff --git a/files/ko/web/api/element/setattribute/index.md b/files/ko/web/api/element/setattribute/index.md
index 5099f518f8edf0..48a90ba33013b1 100644
--- a/files/ko/web/api/element/setattribute/index.md
+++ b/files/ko/web/api/element/setattribute/index.md
@@ -72,8 +72,6 @@ button.setAttribute("disabled", "");
 - `disabled`와 같은 불리언 속성의 값을 설정하려면 아무 값으로든 설정할 수 있습니다.
   빈 문자열 또는 속성의 이름이 권장되는 값입니다. 중요한 것은 속성이 존재하는 경우 **실제 값에 관계없이** 해당 값이 참으로 간주된다는 것입니다. 속성이 없다는 것은 해당 값이 `false`임을 의미합니다. `disabled` 속성의 값을 빈 문자열(`""`)로 설정하면 `disabled`를 `true`로 설정하여 버튼이 비활성화됩니다.
 
-{{DOMAttributeMethods}}
-
 ## 명세서
 
 {{Specifications}}

From 414becf66fab76623809086804f3c73450f6fe21 Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Wed, 11 Sep 2024 16:22:09 +0800
Subject: [PATCH 035/115] zh-CN: create Glossary/Federated_identity (#23338)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../glossary/federated_identity/index.md      | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 files/zh-cn/glossary/federated_identity/index.md

diff --git a/files/zh-cn/glossary/federated_identity/index.md b/files/zh-cn/glossary/federated_identity/index.md
new file mode 100644
index 00000000000000..1cca2d8688b968
--- /dev/null
+++ b/files/zh-cn/glossary/federated_identity/index.md
@@ -0,0 +1,32 @@
+---
+title: 联合身份
+slug: Glossary/Federated_identity
+l10n:
+  sourceCommit: 50e5e8a9b8a6b7d0dd9877610c9639d8b90f329f
+---
+
+{{GlossarySidebar}}
+
+**联合身份**系统是一个{{glossary("identity provider", "身份提供商")}}（IdP）在用户和{{glossary("relying party", "依赖方")}}之间充当中介的系统，让用户可以使用一组{{glossary("credential", "凭据")}}与多个不同的依赖方进行身份验证。
+
+传统上，在 Web 中用户将使用用户名和密码登录网站，网站将根据存储在后端的（经过适当{{glossary("hash", "哈希")}}和{{glossary("salt", "加盐")}}处理的）副本来验证密码。
+
+在这种模型中，如果用户在不同的网站上有多个帐户，他们必须记住许多密码。这会促进不良的密码实践，比如为多个帐户使用相同的密码。
+
+在联合身份系统中，身份提供商：
+
+- 管理用户的凭据并可以对用户进行身份验证
+- 受到多个网站的信任，可以对用户的身份进行断言。
+
+用户可以使用身份提供商进行身份验证，如果验证成功，身份提供商将向用户的浏览器返回一个令牌。用户的浏览器将令牌发送给网站，网站可以验证它是否由 IdP 发行。如果验证成功，网站就可以同意用户的登录操作。
+
+联合身份通常由公司以服务的形式提供：例如，拥有 Google、Microsoft 或 Facebook 帐户的用户可以使用这些帐户登录许多网站。网站通常必须实现一个特定于身份提供商的令牌验证过程。然而，开放标准，如 [OpenID](https://zh.wikipedia.org/wiki/OpenID)、[OAuth](https://zh.wikipedia.org/wiki/开放授权) 和 [SAML](https://zh.wikipedia.org/wiki/安全断言标记语言) 在联合身份系统的实现中被广泛使用。
+
+尽管联合身份使用户登录多个不同帐户变得更加容易，同时也可以极大地提高安全性，但它可能对用户的隐私产生严重影响。如果设计不当，联合身份系统可能允许身份提供商跟踪用户在网上的活动：用户会登录多个不同的站点。Web 上早期的联合身份系统是建立在诸如第三方 cookie 之类的技术上的，这些技术本质上侵犯了隐私。随着这些技术被浏览器弃用，需要新的方法。[联合凭证管理（FedCM）API](/zh-CN/docs/Web/API/FedCM_API) 提供了一个标准化的保护隐私的机制，用于实现 Web 上的联合身份。
+
+## 参见
+
+- 相关术语：
+  - {{glossary("Relying party", "依赖方")}}
+  - {{glossary("Identity provider", "身份提供商")}}
+- [联合凭证管理（FedCM）API](/zh-CN/docs/Web/API/FedCM_API)

From 2eaee6a0868eab4b0d84aebbb5eeb36185869cfd Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 18:01:03 +0900
Subject: [PATCH 036/115] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../http1_x_connections.png                   | Bin 0 -> 26677 bytes
 .../httpsharding.png                          | Bin 0 -> 15019 bytes
 .../index.md                                  |  20 ++++++++++--------
 3 files changed, 11 insertions(+), 9 deletions(-)
 create mode 100644 files/ja/web/http/connection_management_in_http_1.x/http1_x_connections.png
 create mode 100644 files/ja/web/http/connection_management_in_http_1.x/httpsharding.png

diff --git a/files/ja/web/http/connection_management_in_http_1.x/http1_x_connections.png b/files/ja/web/http/connection_management_in_http_1.x/http1_x_connections.png
new file mode 100644
index 0000000000000000000000000000000000000000..e677173dbad3adb5fca96c6b899bd45439c8d036
GIT binary patch
literal 26677
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

literal 0
HcmV?d00001

diff --git a/files/ja/web/http/connection_management_in_http_1.x/httpsharding.png b/files/ja/web/http/connection_management_in_http_1.x/httpsharding.png
new file mode 100644
index 0000000000000000000000000000000000000000..9e63e45a9af263097cacfa3ef69099a396c27117
GIT binary patch
literal 15019
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
G|NjDhW0bG}

literal 0
HcmV?d00001

diff --git a/files/ja/web/http/connection_management_in_http_1.x/index.md b/files/ja/web/http/connection_management_in_http_1.x/index.md
index f65c4ee67d688c..e8cb480832e2cd 100644
--- a/files/ja/web/http/connection_management_in_http_1.x/index.md
+++ b/files/ja/web/http/connection_management_in_http_1.x/index.md
@@ -1,24 +1,26 @@
 ---
 title: HTTP/1.x のコネクション管理
 slug: Web/HTTP/Connection_management_in_HTTP_1.x
+l10n:
+  sourceCommit: ef46a4ac6bfec3e33c9209244e7cb1a9206165d6
 ---
 
 {{HTTPSidebar}}
 
 コネクション管理は、 HTTP の重要なトピックです。コネクションを開いたり管理したりすることは、ウェブサイトやウェブアプリケーションのパフォーマンスに大きな影響を与えます。HTTP/1.x では*短命な (short-lived) コネクション*、_持続的な (persistent) コネクション_、*HTTP パイプライン*といったモデルがあります。
 
-HTTP は、クライアントとサーバーの間のコネクションを提供するトランスポートプロトコルを、たいてい TCP に依存しています。初期のころ、 HTTP が使用するコネクションの制御モデルは 1 種類でした。それらのコネクションは短命です。リクエストの送信が必要になるたびに新たなコネクションを作成して、回答を受け取るとコネクションを閉じていました。
+HTTP は、クライアントとサーバーの間のコネクションを提供するトランスポートプロトコルを、たいてい TCP に依存しています。初期のころ、HTTP が使用するコネクションの制御モデルは 1 種類でした。それらのコネクションは短命です。リクエストの送信が必要になるたびに新たなコネクションを作成して、回答を受け取るとコネクションを閉じていました。
 
 このシンプルなモデルは、先天的なパフォーマンスの制約を抱えていました。それぞれの TCP コネクションを開く処理は、リソースを消費します。いくつかのメッセージを、クライアントとサーバーの間で交換しなければなりません。リクエストの送信が必要になると、ネットワークの遅延や帯域がパフォーマンスに影響を与えます。現代のウェブページは、必要な情報を提供するために多くのリクエスト (1 ダース以上) を必要としており、初期のモデルが非効率であることを実証しています。
 
 HTTP/1.1 で、新たなモデルを 2 種類導入しました。持続的なコネクションモデルは、連続したリクエストの間はコネクションを開き続けておくことで、新たなコネクションを開始するために必要な時間を削減します。 HTTP パイプラインモデルはさらに 1 歩進んで、回答を待っている間も複数の連続したリクエストを送信して、ネットワークの遅延の大部分を削減します。
 
-![HTTP/1.x の3つのコネクションモデルにおけるパフォーマンスの比較: 短命なコネクション、持続的なコネクション、 HTTP パイプライン](http1_x_connections.png)
+![HTTP/1.x の 3 つのコネクションモデルにおけるパフォーマンスの比較: 短命なコネクション、持続的なコネクション、 HTTP パイプライン](http1_x_connections.png)
 
 > [!NOTE]
 > HTTP/2 では、コネクションの管理モデルをさらに追加しました。
 
-特筆すべき重要なポイントとして、 HTTP のコネクション管理は隣接したノードの間のコネクション、すなわち[エンドツーエンド](/ja/docs/Web/HTTP/Headers#e2e)ではなく[ホップバイホップ](/ja/docs/Web/HTTP/Headers#hbh)に適用されることがあります。クライアントと最初のプロキシの間で使用するモデルと、プロキシと宛先サーバー (または任意の中間プロキシ) の間で使用するモデルが異なることもあります。{{HTTPHeader("Connection")}} や {{HTTPHeader("Keep-Alive")}} といったコネクションモデルの定義にかかわる HTTP ヘッダーは、中間のノードが値を変更できる [ホップバイホップ](/ja/docs/Web/HTTP/Headers#hbh) ヘッダーです。
+特筆すべき重要なポイントとして、 HTTP のコネクション管理は隣接したノードの間のコネクション、すなわち[エンドツーエンド](/ja/docs/Web/HTTP/Headers#エンドツーエンドヘッダー)ではなく[ホップバイホップ](/ja/docs/Web/HTTP/Headers#ホップバイホップヘッダー)に適用されることがあります。クライアントと最初のプロキシーの間で使用するモデルと、プロキシーと宛先サーバー (または任意の中間プロキシー) の間で使用するモデルが異なることもあります。{{HTTPHeader("Connection")}} や {{HTTPHeader("Keep-Alive")}} といったコネクションモデルの定義にかかわる HTTP ヘッダーは、中間のノードが値を変更できる [ホップバイホップ](/ja/docs/Web/HTTP/Headers#ホップバイホップヘッダー)ヘッダーです。
 
 関連するトピックとしては、 HTTP コネクションのアップグレードの概念、つまり HTTP/1.1 コネクションが TLS/1.0、 WebSocket、 又は平文の HTTP/2 のような異なるプロトコルにアップグレードされたことが挙げられます。この[プロトコルのアップグレードメカニズム](/ja/docs/Web/HTTP/Protocol_upgrade_mechanism)は他の場所でもっと詳しく文書化されています。
 
@@ -50,7 +52,7 @@ HTTP/1.1 では既定で持続的であり、ヘッダーは不要になりま
 > [!NOTE]
 > HTTP パイプラインは、現代のブラウザーでは既定で有効化されていません。
 >
-> - 不具合がある[プロキシ](https://ja.wikipedia.org/wiki/%E3%83%97%E3%83%AD%E3%82%AD%E3%82%B7)がまだ一般的であり、これらは開発者が容易には予見あるいは診断できない、奇妙かつ一定しない挙動の原因になります。
+> - 不具合がある[プロキシー](https://ja.wikipedia.org/wiki/%E3%83%97%E3%83%AD%E3%82%AD%E3%82%B7)がまだ一般的であり、これらは開発者が容易には予見あるいは診断できない、奇妙かつ一定しない挙動の原因になります。
 > - パイプラインの正しい実装は複雑です。転送するリソースのサイズ、効果的な [RTT](https://ja.wikipedia.org/wiki/%E3%83%A9%E3%82%A6%E3%83%B3%E3%83%89%E3%83%88%E3%83%AA%E3%83%83%E3%83%97%E3%82%BF%E3%82%A4%E3%83%A0) および帯域が、パイプラインによる改善に対して直接的な影響力を持ちます。これらがわからなければ、重要なメッセージがそうでないメッセージより遅れる場合があります。重要さの概念は、ページのレイアウト中に高まります!よって、 HTTP パイプラインはほとんどの場合でわずかな改善にしかなりません。
 > - パイプラインは、 [HOL](https://en.wikipedia.org/wiki/Head-of-line_blocking) の問題に左右されます。
 >
@@ -58,11 +60,11 @@ HTTP/1.1 では既定で持続的であり、ヘッダーは不要になりま
 
 既定で、[HTTP](/ja/docs/Web/HTTP) リクエストは順次発行されます。次のリクエストは、現在のリクエストのレスポンスが到着してから発行されます。これはネットワークの遅延や帯域の制約を受けるため、次のリクエストがサーバーで*見える*ようになるまでにかなりの遅延が発生する可能性があります。
 
-パイプラインは連続したリクエストを同一の持続的なコネクションで、回答を待たずに処理します。これは、コネクションの遅延を回避します。理論上は、2 つのリクエストを同じ TCP メッセージに収めた場合でもパフォーマンスが向上するでしょう。典型的な [MSS](https://ja.wikipedia.org/wiki/%E6%9C%80%E5%A4%A7%E3%82%BB%E3%82%B0%E3%83%A1%E3%83%B3%E3%83%88%E3%82%B5%E3%82%A4%E3%82%BA) (最大セグメントサイズ) は複数のシンプルをリクエストを収めるには十分な大きさですが、 HTTP リクエストのサイズの需要は増え続けています。
+パイプラインは連続したリクエストを同一の持続的なコネクションで、回答を待たずに処理します。これは、コネクションの遅延を回避します。理論上は、2 つのリクエストを同じ TCP メッセージに収めた場合でもパフォーマンスが向上するでしょう。HTTP リクエストのサイズ面での需要は増え続けていますが、典型的な [MSS](https://ja.wikipedia.org/wiki/%E6%9C%80%E5%A4%A7%E3%82%BB%E3%82%B0%E3%83%A1%E3%83%B3%E3%83%88%E3%82%B5%E3%82%A4%E3%82%BA) （最大セグメントサイズ）の大きさならば、いくつかのシンプルなリクエストが十分に収まります。
 
 パイプライン化できない HTTP リクエストもあります。 {{glossary("idempotent","べき等")}} なメソッドである {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}}, {{HTTPMethod("DELETE")}} だけが安全に再実行できます。これらは失敗しても、パイプラインの内容を再実行できます。
 
-現在、すべての HTTP/1.1 に準拠するプロキシやサーバーはパイプラインをサポートしているはずですが、実際は多くの制限があります。さまざまな理由で、現行のブラウザーはパイプラインを既定で有効化していません。
+現在、すべての HTTP/1.1 に準拠するプロキシーやサーバーはパイプラインをサポートしているはずですが、実際は多くの制限があります。さまざまな理由で、現行のブラウザーはパイプラインを既定で有効化していません。
 
 ## ドメインシャーディング
 
@@ -71,10 +73,10 @@ HTTP/1.1 では既定で持続的であり、ヘッダーは不要になりま
 
 HTTP/1.x のコネクションはリクエストが整理されることもなく連続するため、十分な帯域を使用できない状況では最適化できません。その解決策として、ブラウザーはそれぞれのドメインに対して複数のコネクションを開いて、リクエストを並行して送信します。既定では一度に 2 から 3 つのコネクションですが、現在は主に 6 つの並列したコネクションへ増えています。この数をさらに増やそうとすると、サーバー側で [DoS](/ja/docs/Glossary/DOS_attack) 防御が発動する危険性があります。
 
-サーバーがウェブサイトやウェブアプリケーションのレスポンスを早くしたい場合、より多くのコネクションを開かせることが考えられます。例えば、すべてのリソースを同じドメイン `www.example.com` で持つのではなく、`www1.example.com`、`www2.example.com`、`www3.example.com` といった複数のドメインに分散させることができます。それぞれのドメインは*同じ*サーバーに名前解決されて、ウェブブラウザーはドメインごとに 6 つのコネクションを開きます (この例では、コネクション数が 18 に増加します)。この技術は*ドメインシャーディング*と呼ばれます。
+サーバーがウェブサイトやウェブアプリケーションのレスポンスを早くしたい場合、より多くのコネクションを開かせることが考えられます。例えば、すべてのリソースを同じドメイン `www.example.com` で持つのではなく、`www1.example.com`、`www2.example.com`、`www3.example.com` といった複数のドメインに分散させることができます。それぞれのドメインは*同じ*サーバーに名前解決されて、ウェブブラウザーはドメインごとに 6 つのコネクションを開きます（この例では、コネクション数が 18 に増加します）。この技術は*ドメインシャーディング*と呼ばれます。
 
-![](httpsharding.png)
+![ドメインシャーディングを使用しない場合、クライアントは最大 2 つのリクエストが並列で実行されるドメインから 6 つの画像をリクエストします。ドメインシャーディングを使用すると、画像は 2 つのドメインから利用でき、クライアントは 4 つのリクエストを並列で実行し、画像をより短い時間でダウンロードすることができます。](httpsharding.png)
 
 ## まとめ
 
-改良されたコネクション管理により、 HTTP のパフォーマンスを大きく向上できます。 HTTP/1.1 や HTTP/1.0 では、持続的なコネクションを使用します。少なくともコネクションがアイドル状態になるまで、最良のパフォーマンスになります。一方、パイプラインの失敗は優れたコネクション管理モデルの設計を促し、それは HTTP/2 に導入されました。
+接続の管理が改善されたことで、HTTP のパフォーマンスが大幅に向上しました。HTTP/1.1 または HTTP/1.0 では、少なくともアイドル状態になるまでは持続的な接続を使用することが最高のパフォーマンスにつながります。しかし、パイプライン処理の失敗により、より優れた接続管理モデルが設計され、HTTP/2 に組み込まれました。

From fc59bfed9d037f3ca14feb66fae686cccba728e8 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 11 Sep 2024 22:22:50 +0900
Subject: [PATCH 037/115] =?UTF-8?q?=E8=A1=A8=E8=A8=98=E3=82=86=E3=82=8C?=
 =?UTF-8?q?=E3=82=92=E4=BF=AE=E6=AD=A3=20(#23450)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 表記ゆれを修正

* 表記ゆれを修正
---
 .../ja/learn/forms/html_forms_in_legacy_browsers/index.md | 2 +-
 .../javascript/first_steps/what_is_javascript/index.md    | 2 +-
 .../ja/learn/server-side/express_nodejs/mongoose/index.md | 2 +-
 .../mozilla/add-ons/webextensions/api/bookmarks/index.md  | 2 +-
 files/ja/mozilla/firefox/experimental_features/index.md   | 8 ++++----
 files/ja/web/api/popstateevent/popstateevent/index.md     | 2 +-
 files/ja/web/api/presentation_api/index.md                | 8 ++++----
 files/ja/web/api/presentationavailability/index.md        | 2 +-
 files/ja/web/api/pushmanager/subscribe/index.md           | 4 ++--
 files/ja/web/api/pushmessagedata/index.md                 | 2 +-
 .../api/readablebytestreamcontroller/desiredsize/index.md | 2 +-
 files/ja/web/api/readablestream/getreader/index.md        | 2 +-
 files/ja/web/api/readablestreambyobreader/read/index.md   | 2 +-
 .../ja/web/api/readablestreambyobrequest/respond/index.md | 4 ++--
 .../readablestreambyobrequest/respondwithnewview/index.md | 2 +-
 files/ja/web/api/relativeorientationsensor/index.md       | 2 +-
 .../relativeorientationsensor/index.md                    | 2 +-
 files/ja/web/api/reporterror/index.md                     | 4 ++--
 files/ja/web/api/requestinit/index.md                     | 4 ++--
 19 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/files/ja/learn/forms/html_forms_in_legacy_browsers/index.md b/files/ja/learn/forms/html_forms_in_legacy_browsers/index.md
index 4083b324d2169c..656a30a0d03dac 100644
--- a/files/ja/learn/forms/html_forms_in_legacy_browsers/index.md
+++ b/files/ja/learn/forms/html_forms_in_legacy_browsers/index.md
@@ -13,7 +13,7 @@ l10n:
 
 ## 問題について知る
 
-一般的なパターンを理解するには、ブラウザーのドキュメントを読むことが役立ちます。 [MDN](/) でこの記事を読んでいるのであれば、始めるのにふさわしい場所にいます。使用したい要素（または DOM インタフェース）の対応状況を確認するだけです。 MDN には、ウェブページで使用できるほとんどの要素、プロパティ、API の互換性一覧表が用意されています。他にも驚くほど役に立つリソースがあります。
+一般的なパターンを理解するには、ブラウザーのドキュメントを読むことが役立ちます。 [MDN](/) でこの記事を読んでいるのであれば、始めるのにふさわしい場所にいます。使用したい要素（または DOM インターフェイス）の対応状況を確認するだけです。 MDN には、ウェブページで使用できるほとんどの要素、プロパティ、API の互換性一覧表が用意されています。他にも驚くほど役に立つリソースがあります。
 
 [HTML フォーム](/ja/docs/Learn/Forms)では複雑なやり取りが行われるため、シンプルに保つという経験則があり、「[KISS の原則](https://ja.wikipedia.org/wiki/KISS%E3%81%AE%E5%8E%9F%E5%89%87)」とも呼ばれています。フォームを「よりかっこよく」あるいは「高機能に」したい場合はたくさんありますが、効率的なフォームの作成はデザインや技術の問題ではありません。むしろ、シンプルさ、直感性、そしてユーザーとの対話のしやすさが重要なのです。 [forms usability on UX For The Masses](https://www.uxforthemasses.com/forms-usability/) のチュートリアルがこれをよく説明しています。
 
diff --git a/files/ja/learn/javascript/first_steps/what_is_javascript/index.md b/files/ja/learn/javascript/first_steps/what_is_javascript/index.md
index 6643147ac91f29..2ed78efac56737 100644
--- a/files/ja/learn/javascript/first_steps/what_is_javascript/index.md
+++ b/files/ja/learn/javascript/first_steps/what_is_javascript/index.md
@@ -90,7 +90,7 @@ JavaScript は次のことを実現する一般的なプログラミング機能
 - ウェブページで起きるイベントに対処します。先ほどの例では {{domxref("Element/click_event", "click")}} イベントを使用して、ボタンがクリックされたことを検出し、ラベルを更新するコードを実行しました。
 - 他にもたくさんのことができます。
 
-しかしさらに期待が大きいのは、クライアントサイド JavaScript 言語の上に構築された機能です。いわゆる**アプリケーションプログラミングインタフェース** (**API**) は、JavaScript コードで使用するための特別なスーパーパワーを提供します。
+しかしさらに期待が大きいのは、クライアントサイド JavaScript 言語の上に構築された機能です。いわゆる**アプリケーションプログラミングインターフェイス** (**API**) は、JavaScript コードで使用するための特別なスーパーパワーを提供します。
 
 API がなければ難しかったり、不可能であるようなコードを、すぐに使えるブロックのように、開発者がプログラムを作ることができるようになります。
 家を作るときの既製の家具と同じことを、プログラミングでしてくれるのです。自分で設計し、使用する木材を選定し、正しい形で板を切り出して、正しいサイズのネジを見つけて、自分で組み立てるよりも、既に切り出されたボードとネジを使って本棚を組み立てるだけの方がずっと簡単ですよね。
diff --git a/files/ja/learn/server-side/express_nodejs/mongoose/index.md b/files/ja/learn/server-side/express_nodejs/mongoose/index.md
index 5237791ef277c5..80b1d22be041eb 100644
--- a/files/ja/learn/server-side/express_nodejs/mongoose/index.md
+++ b/files/ja/learn/server-side/express_nodejs/mongoose/index.md
@@ -143,7 +143,7 @@ db.on("error", console.error.bind(console, "MongoDB connection error:"));
 
 #### スキーマの定義
 
-以下のコードは、単純なスキーマを定義する方法を示しています。最初に mongoose を `require()` し、次に Schema コンストラクタを使用して新しいスキーマインスタンスを作成し、コンストラクタの object 引数で内部のさまざまなフィールドを定義します。
+以下のコードは、単純なスキーマを定義する方法を示しています。最初に mongoose を `require()` し、次に Schema コンストラクターを使用して新しいスキーマインスタンスを作成し、コンストラクターの object 引数で内部のさまざまなフィールドを定義します。
 
 ```js
 //Require Mongoose
diff --git a/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.md b/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.md
index e5de664172b0fe..f744cefe9774c6 100644
--- a/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.md
+++ b/files/ja/mozilla/add-ons/webextensions/api/bookmarks/index.md
@@ -60,7 +60,7 @@ slug: Mozilla/Add-ons/WebExtensions/API/bookmarks
 - {{WebExtAPIRef("bookmarks.onChildrenReordered")}}
   - : UI で表示されている順序に伴って子フォルダーの順序も変更された際に発火します。{{WebExtAPIRef("bookmarks.move", "move()")}} の実行後には発火しません。
 - {{WebExtAPIRef("bookmarks.onImportBegan")}}
-  - : ブックマークのインポートが開始した際に発火します。パフォーマンスが重要である場合、イベントのオブザーバは {{WebExtAPIRef("bookmarks.onImportEnded")}} が発火するまで {{WebExtAPIRef("bookmarks.onCreated")}} を無視すべきでしょう。その場合であっても、オブザーバは他のイベントについては即座に処理すべきでしょう。
+  - : ブックマークのインポートが開始した際に発火します。パフォーマンスが重要である場合、イベントのオブザーバーは {{WebExtAPIRef("bookmarks.onImportEnded")}} が発火するまで {{WebExtAPIRef("bookmarks.onCreated")}} を無視すべきでしょう。その場合であっても、オブザーバーは他のイベントについては即座に処理すべきでしょう。
 - {{WebExtAPIRef("bookmarks.onImportEnded")}}
   - : ブックマークのインポートが終了した際に発火します。
 
diff --git a/files/ja/mozilla/firefox/experimental_features/index.md b/files/ja/mozilla/firefox/experimental_features/index.md
index 364479825d6287..412a365b6da969 100644
--- a/files/ja/mozilla/firefox/experimental_features/index.md
+++ b/files/ja/mozilla/firefox/experimental_features/index.md
@@ -728,7 +728,7 @@ jsxref("Array.prototype.groupBy()")}} と {{jsxref("Array.prototype.groupByToMap
 
 ### WebRTC とメディア
 
-[WebRTC API](/ja/docs/Web/API/WebRTC_API)、[Web Audio API](/ja/docs/Web/API/Web_Audio_API)、[Media Source Extensions API](/ja/docs/Web/API/Media_Source_Extensions_API)、[Encrypted Media Extensions API](/ja/docs/Web/API/Encrypted_Media_Extensions_API)、[Media Capture and Streams API](/ja/docs/Web/API/Media_Streams_API) にある以下の機能は実験的なものです。
+[WebRTC API](/ja/docs/Web/API/WebRTC_API)、[Web Audio API](/ja/docs/Web/API/Web_Audio_API)、[Media Source Extensions API](/ja/docs/Web/API/Media_Source_Extensions_API)、[Encrypted Media Extensions API](/ja/docs/Web/API/Encrypted_Media_Extensions_API)、[Media Capture and Streams API](/ja/docs/Web/API/Media_Capture_and_Streams_API) にある以下の機能は実験的なものです。
 
 非同期の SourceBuffer の追加と削除
 
@@ -1392,11 +1392,11 @@ Android 版 Firefox で、 [AV1 形式のメディア](/ja/docs/Web/Media/Format
   </tbody>
 </table>
 
-### 支払いリクエスト API
+### 決済リクエスト API
 
-#### 主要な支払いの扱い
+#### 主要な決済の扱い
 
-[支払いリクエスト API](/ja/docs/Web/API/Payment_Request_API) は、ウェブコンテンツやアプリ内でウェブベースの支払いを処理するためのサポートを提供します。ユーザーインターフェイスのテスト中にバグが発生したため、 API の変更を検討している間、この API の出荷を延期することにしました。作業は継続中です。(詳細は [Firefox バグ 1318984](https://bugzil.la/1318984) をご参照ください。)
+[決済リクエスト API](/ja/docs/Web/API/Payment_Request_API) は、ウェブコンテンツやアプリ内でウェブベースの決済を処理するためのサポートを提供します。ユーザーインターフェイスのテスト中にバグが発生したため、 API の変更を検討している間、この API の出荷を延期することにしました。作業は継続中です。(詳細は [Firefox バグ 1318984](https://bugzil.la/1318984) をご参照ください。)
 
 <table>
   <thead>
diff --git a/files/ja/web/api/popstateevent/popstateevent/index.md b/files/ja/web/api/popstateevent/popstateevent/index.md
index 812a8bca902466..a922bacc872405 100644
--- a/files/ja/web/api/popstateevent/popstateevent/index.md
+++ b/files/ja/web/api/popstateevent/popstateevent/index.md
@@ -11,7 +11,7 @@ l10n:
 **`PopStateEvent()`** コンストラクターは、新しい {{domxref("PopStateEvent")}} オブジェクトを生成します。
 
 > [!NOTE]
-> ウェブ開発者は通常このコンストラクタを呼び出す必要はありません。ブラウザーは {{domxref("Window/popstate_event", "popstate")}} イベントを発行するときにこれらのオブジェクトを生成するからです。
+> ウェブ開発者は通常このコンストラクターを呼び出す必要はありません。ブラウザーは {{domxref("Window/popstate_event", "popstate")}} イベントを発行するときにこれらのオブジェクトを生成するからです。
 
 ## 構文
 
diff --git a/files/ja/web/api/presentation_api/index.md b/files/ja/web/api/presentation_api/index.md
index de9ec2b3f62605..e0039c1a0559b3 100644
--- a/files/ja/web/api/presentation_api/index.md
+++ b/files/ja/web/api/presentation_api/index.md
@@ -1,5 +1,5 @@
 ---
-title: Presentation API
+title: プレゼンテーション API
 slug: Web/API/Presentation_API
 l10n:
   sourceCommit: 88c098f5bd651a5c587d7b32dba055766c1789ca
@@ -21,9 +21,9 @@ Presentation API は、(ウェブブラウザーなどの) {{Glossary("user agen
 ## インターフェイス
 
 - {{domxref("Presentation")}}
-  - : 操作を行うブラウジングコンテキストでは、`Presentation` インターフェイスが外部の画面へのプレゼンテーションを開始する際のブラウザーのデフォルトの挙動を上書きする方法を提供します。受信を行うブラウジングコンテキストでは、`Presentation` インターフェイスは利用可能なプレゼンテーションの接続へのアクセスを提供します。
+  - : 操作を行う閲覧コンテキストでは、`Presentation` インターフェイスが外部の画面へのプレゼンテーションを開始する際のブラウザーのデフォルトの挙動を上書きする方法を提供します。受信を行う閲覧コンテキストでは、`Presentation` インターフェイスは利用可能なプレゼンテーションの接続へのアクセスを提供します。
 - {{domxref("PresentationRequest")}}
-  - : 操作を行うブラウジングコンテキストで生成されたプレゼンテーションを開始または再接続します。
+  - : 操作を行う閲覧コンテキストで生成されたプレゼンテーションを開始または再接続します。
 - {{domxref("PresentationAvailability")}}
   - : [PresentationAvailability](/ja/docs/Web/API/PresentationAvailability) オブジェクトは、利用可能なプレゼンテーション用の画面に紐付けられ、プレゼンテーションの要求に対する _プレゼンテーション用の画面の利用可能性_ を表します。
 - {{domxref("PresentationConnectionAvailableEvent")}}
@@ -33,7 +33,7 @@ Presentation API は、(ウェブブラウザーなどの) {{Glossary("user agen
 - {{domxref("PresentationConnectionCloseEvent")}}
   - : `PresentationConnectionCloseEvent` は、プレゼンテーションの接続が `closed` 状態になった時発火します。
 - {{domxref("PresentationReceiver")}}
-  - : [PresentationReceiver](/ja/docs/Web/API/PresentationReceiver) は、受信を行うブラウジングコンテキストが操作を行うブラウジングコンテキストへのアクセスとやり取りをできるようにします。
+  - : [PresentationReceiver](/ja/docs/Web/API/PresentationReceiver) は、受信を行う閲覧コンテキストが操作を行う閲覧コンテキストへのアクセスとやり取りをできるようにします。
 - {{domxref("PresentationConnectionList")}}
   - : `PresentationConnectionList` は、終了していないプレゼンテーションの接続のコレクションを表します。これは、新しいプレゼンテーションの接続が利用可能になったイベントのモニターでもあります。
 
diff --git a/files/ja/web/api/presentationavailability/index.md b/files/ja/web/api/presentationavailability/index.md
index 1d7f8e3edb0707..423aa7b0a349c5 100644
--- a/files/ja/web/api/presentationavailability/index.md
+++ b/files/ja/web/api/presentationavailability/index.md
@@ -7,7 +7,7 @@ l10n:
 
 {{SeeCompatTable}}{{securecontext_header}}{{APIRef("Presentation API")}}
 
-**`PresentationAvailability`** オブジェクトは利用可能な[プレゼンテーション用の画面](https://www.w3.org/TR/presentation-api/#dfn-presentation-display)に紐付けられ、プレゼンテーションの要求に対する _プレゼンテーション用の画面の利用可能性_ を表します。[操作を行うユーザーエージェント](https://www.w3.org/TR/presentation-api/#dfn-controlling-user-agent)が (`start()` の保留中の要求が無くても) バックグラウンドで[利用可能なプレゼンテーション用の画面のリストを監視](https://www.w3.org/TR/presentation-api/#dfn-monitor-the-list-of-available-presentation-displays)できる場合、`PresentationAvailability` オブジェクトは[操作を行うブラウジングコンテキスト](https://www.w3.org/TR/presentation-api/#dfn-controlling-browsing-context)で実装され _**なければなりません**_。
+**`PresentationAvailability`** オブジェクトは利用可能な[プレゼンテーション用の画面](https://www.w3.org/TR/presentation-api/#dfn-presentation-display)に紐付けられ、プレゼンテーションの要求に対する _プレゼンテーション用の画面の利用可能性_ を表します。[操作を行うユーザーエージェント](https://www.w3.org/TR/presentation-api/#dfn-controlling-user-agent)が (`start()` の保留中の要求が無くても) バックグラウンドで[利用可能なプレゼンテーション用の画面のリストを監視](https://www.w3.org/TR/presentation-api/#dfn-monitor-the-list-of-available-presentation-displays)できる場合、`PresentationAvailability` オブジェクトは[操作を行う閲覧コンテキスト](https://www.w3.org/TR/presentation-api/#dfn-controlling-browsing-context)で実装され _**なければなりません**_。
 
 `value` 属性は設定された最新の値を返さ _**なければなりません**_。この値は[利用可能なプレゼンテーション用画面のリストを監視する](https://www.w3.org/TR/presentation-api/#dfn-monitor-the-list-of-available-presentation-displays)アルゴリズムにより更新されます。
 
diff --git a/files/ja/web/api/pushmanager/subscribe/index.md b/files/ja/web/api/pushmanager/subscribe/index.md
index 21637ce5d30e13..8417ebccb86ac0 100644
--- a/files/ja/web/api/pushmanager/subscribe/index.md
+++ b/files/ja/web/api/pushmanager/subscribe/index.md
@@ -56,13 +56,13 @@ navigator.serviceWorker.ready.then((serviceWorkerRegistration) => {
   serviceWorkerRegistration.pushManager.subscribe(options).then(
     (pushSubscription) => {
       console.log(pushSubscription.endpoint);
-      // アプリケーションサーバが必要としているプッシュサブスクリプションの
+      // アプリケーションサーバーが必要としているプッシュサブスクリプションの
       // 詳細はここから使用できます。たとえば、XMLHttpRequest を使用して
       // これを送信できます。
     },
     (error) => {
       // 開発中は、コンソールにエラーを表示するのに役立ちます。
-      // 本番環境では、アプリケーションサーバにエラー情報を送信
+      // 本番環境では、アプリケーションサーバーにエラー情報を送信
       // するためにも 役立ちます。
       console.error(error);
     },
diff --git a/files/ja/web/api/pushmessagedata/index.md b/files/ja/web/api/pushmessagedata/index.md
index a983b6a0fe9097..a64c0e8695e9c9 100644
--- a/files/ja/web/api/pushmessagedata/index.md
+++ b/files/ja/web/api/pushmessagedata/index.md
@@ -11,7 +11,7 @@ l10n:
 
 [フェッチ API](/ja/docs/Web/API/Fetch_API) の同様のメソッドが 1 回しか呼び出せないのと異なり、これらは複数回呼び出せます。
 
-プッシュ API を通して受け取ったメッセージはプッシュサービスによって暗号化されて送信され、`PushMessageData` インターフェースのメソッドで利用可能になる前にブラウザーによって自動的に復号されます。
+プッシュ API を通して受け取ったメッセージはプッシュサービスによって暗号化されて送信され、`PushMessageData` インターフェイスのメソッドで利用可能になる前にブラウザーによって自動的に復号されます。
 
 ## インスタンスプロパティ
 
diff --git a/files/ja/web/api/readablebytestreamcontroller/desiredsize/index.md b/files/ja/web/api/readablebytestreamcontroller/desiredsize/index.md
index b0b213df85e841..146b0941547dc3 100644
--- a/files/ja/web/api/readablebytestreamcontroller/desiredsize/index.md
+++ b/files/ja/web/api/readablebytestreamcontroller/desiredsize/index.md
@@ -11,7 +11,7 @@ l10n:
 **`desiredSize`** は {{domxref("ReadableByteStreamController")}} インターフェイスの読み取り専用プロパティで、ストリームの内部キューを満たすために必要な「希望サイズ」を返します。
 
 この値は、ストリームが、基盤となるソースへの推奨する流量を示すために使用します。
-データ流入のスロットリングや一時停止に対応しているソース（すべてではありません）は、ストリームバッファの `desiredSize` が正の値で、使用可能な限りゼロに近づくように流入を制御する必要があります。
+データ流入のスロットリングや一時停止に対応しているソース（すべてではありません）は、ストリームバッファーの `desiredSize` が正の値で、使用可能な限りゼロに近づくように流入を制御する必要があります。
 
 `desiredSize` は下流コンシューマーの[背圧](/ja/docs/Web/API/Streams_API/Concepts#背圧)を適用するために使用します。
 
diff --git a/files/ja/web/api/readablestream/getreader/index.md b/files/ja/web/api/readablestream/getreader/index.md
index 11e2b2103fe1d9..ec3f2eeb82bbe9 100644
--- a/files/ja/web/api/readablestream/getreader/index.md
+++ b/files/ja/web/api/readablestream/getreader/index.md
@@ -29,7 +29,7 @@ getReader(options)
       - : 作成するリーダーの種類を指定するプロパティです。
         値は以下の通り。
 
-        - `"byob"`: 読み取り可能なバイトストリーム（内部ストリームバッファが空のときに、基礎となるバイトソースからリーダーへのゼロコピー転送に対応しているストリーム）を読み取ることができる {{domxref("ReadableStreamBYOBReader")}} を作成します。
+        - `"byob"`: 読み取り可能なバイトストリーム（内部ストリームバッファーが空のときに、基礎となるバイトソースからリーダーへのゼロコピー転送に対応しているストリーム）を読み取ることができる {{domxref("ReadableStreamBYOBReader")}} を作成します。
         - `undefined` （または指定しない場合、既定値）。 これにより、ストリームから個々のチャンクを読み取ることができる {{domxref("ReadableStreamDefaultReader")}} が作成されます。
 
 ### 返値
diff --git a/files/ja/web/api/readablestreambyobreader/read/index.md b/files/ja/web/api/readablestreambyobreader/read/index.md
index d80ef07c69e26d..297ce347541101 100644
--- a/files/ja/web/api/readablestreambyobreader/read/index.md
+++ b/files/ja/web/api/readablestreambyobreader/read/index.md
@@ -17,7 +17,7 @@ l10n:
 ストリームがエラーになった場合、プロミスは関連するエラーオブジェクトと共に拒否されます。
 
 データのチャンクが渡された場合、 `value` プロパティには新しいビューが格納されます。
-これは `read()` メソッドに渡された元の `view` と同じバッファー/バッキングメモリ（および同じ型）上のビューになります。
+これは `read()` メソッドに渡された元の `view` と同じバッファー/バッキングメモリー（および同じ型）上のビューになります。
 プロミスが履行されると、メソッドに渡された元の `view` は切り離され、使えなくなることに注意してください。
 ストリームが取り消された可能性がある場合、プロミスは `value: undefined` で履行されます。
 この場合、 `view` のバッキングメモリー領域は破棄され、呼び出し側には返されません（ビューのバッファー内の前回読み込んだデータはすべて失われます）。
diff --git a/files/ja/web/api/readablestreambyobrequest/respond/index.md b/files/ja/web/api/readablestreambyobrequest/respond/index.md
index 6f71cbd244193f..b06508dd52f422 100644
--- a/files/ja/web/api/readablestreambyobrequest/respond/index.md
+++ b/files/ja/web/api/readablestreambyobrequest/respond/index.md
@@ -30,14 +30,14 @@ respond(bytesWritten)
 ### 例外
 
 - {{jsxref("TypeError")}}
-  - : リクエストが関連付けられた{{domxref("ReadableByteStreamController")}}を持っていないか、ビューバッファが切り離されていないか、移譲できません。
+  - : リクエストが関連付けられた {{domxref("ReadableByteStreamController")}} を持っていないか、ビューバッファーが切り離されていないか、移譲できません。
 
 ## 例
 
 下記のコードは[読み取り可能なバイトストリームの使用](/ja/docs/Web/API/Streams_API/Using_readable_byte_streams)のライブ例から引用しています。
 
 このメソッドは、コンシューマーからの待機中の読み取りリクエストを履行するために、データのゼロコピー移譲を行う一環として、基盤となるバイトソースによって呼び出されます。
-基盤となるバイトソースは最初に {{domxref("ReadableStreamBYOBRequest.view")}} にデータを書き込み、次にこの `respond()` メソッドを呼び出して、バッファにコピーされたデータの量を示し、データをリーダーに移譲させます。
+基盤となるバイトソースは最初に {{domxref("ReadableStreamBYOBRequest.view")}} にデータを書き込み、次にこの `respond()` メソッドを呼び出して、バッファーにコピーされたデータの量を示し、データをリーダーに移譲させます。
 
 下記のコードはこの用途を示すもので、データをビューにコピーするために `readInto()` メソッドを使用しています。
 
diff --git a/files/ja/web/api/readablestreambyobrequest/respondwithnewview/index.md b/files/ja/web/api/readablestreambyobrequest/respondwithnewview/index.md
index ab77eea55292eb..8786bcdddf9fdc 100644
--- a/files/ja/web/api/readablestreambyobrequest/respondwithnewview/index.md
+++ b/files/ja/web/api/readablestreambyobrequest/respondwithnewview/index.md
@@ -39,7 +39,7 @@ respondWithNewView(view)
 
 - {{jsxref("TypeError")}}
 
-  - : 元のオブジェクトが `ReadableStreamBYOBRequest` でないか、関連するコントローラがないか、関連する内部配列バッファが存在しないか切り離されている場合に発生します。
+  - : 元のオブジェクトが `ReadableStreamBYOBRequest` でないか、関連するコントローラがないか、関連する内部配列バッファーが存在しないか切り離されている場合に発生します。
     また、アクティブな読者がいるときに `view` の長さがゼロである場合や、閉じられたストリームで呼び出されたときにゼロでない場合にも発生する可能性があります。
 
 - {{jsxref("RangeError")}}
diff --git a/files/ja/web/api/relativeorientationsensor/index.md b/files/ja/web/api/relativeorientationsensor/index.md
index 08f246bf51a92b..57769af5b4cb9a 100644
--- a/files/ja/web/api/relativeorientationsensor/index.md
+++ b/files/ja/web/api/relativeorientationsensor/index.md
@@ -9,7 +9,7 @@ l10n:
 
 [Sensor APIs](/ja/docs/Web/API/Sensor_APIs) の **`RelativeOrientationSensor`** インターフェイスは、地球の参照用座標系は考慮せず、デバイスの物理的な向きを表します。
 
-このセンサーを使用するには、ユーザーが [Permissions API](/ja/docs/Web/API/Permissions_API) により `'accelerometer'` および `'gyroscope'` デバイスセンサーを使用する許可を与える必要があります。さらに、この機能はサーバーで設定された [Permissions Policy](/ja/docs/Web/HTTP/Permissions_Policy) でブロックされる可能性があります。
+このセンサーを使用するには、ユーザーが [権限 API](/ja/docs/Web/API/Permissions_API) により `'accelerometer'` および `'gyroscope'` デバイスセンサーを使用する許可を与える必要があります。さらに、この機能はサーバーで設定された [権限ポリシー](/ja/docs/Web/HTTP/Permissions_Policy) でブロックされる可能性があります。
 
 {{InheritanceDiagram}}
 
diff --git a/files/ja/web/api/relativeorientationsensor/relativeorientationsensor/index.md b/files/ja/web/api/relativeorientationsensor/relativeorientationsensor/index.md
index 31e88bc6166a1d..8ba39e6f2e0555 100644
--- a/files/ja/web/api/relativeorientationsensor/relativeorientationsensor/index.md
+++ b/files/ja/web/api/relativeorientationsensor/relativeorientationsensor/index.md
@@ -30,7 +30,7 @@ new RelativeOrientationSensor(options)
 ### 例外
 
 - `SecurityError` {{domxref("DOMException")}}
-  - : この機能の使用が [Permissions Policy](/ja/docs/Web/HTTP/Permissions_Policy) によりブロックされました。
+  - : この機能の使用が [権限ポリシー](/ja/docs/Web/HTTP/Permissions_Policy) によりブロックされました。
 
 ## 仕様書
 
diff --git a/files/ja/web/api/reporterror/index.md b/files/ja/web/api/reporterror/index.md
index 5ff7db34f3b9dc..aa212c6fa89854 100644
--- a/files/ja/web/api/reporterror/index.md
+++ b/files/ja/web/api/reporterror/index.md
@@ -8,10 +8,10 @@ l10n:
 
 {{APIRef}} {{AvailableInWorkers}}
 
-**`reportError()`** グローバルメソッドは、 JavaScript の捕捉されない例外をエミュレートして、コンソールやグローバルイベントハンドラにエラーを報告するために使用することができます。
+**`reportError()`** グローバルメソッドは、 JavaScript の捕捉されない例外をエミュレートして、コンソールやグローバルイベントハンドラーにエラーを報告するために使用することができます。
 
 この機能は、主にカスタムイベント配信ライブラリーや コールバック操作ライブラリーを対象としています。
-ライブラリはこの機能を使用して、コールバックコードのエラーを捕捉し、最上位のハンドラーに投げ直すことができます。
+ライブラリーはこの機能を使用して、コールバックコードのエラーを捕捉し、最上位のハンドラーに投げ直すことができます。
 これにより、 1 つのコールバックで例外が発生しても、他のコールバックが処理されなくなることがなくなると同時に、スタックトレース情報が最上位レベルのデバッグに利用できるようになります。
 
 <!-- {{EmbedInteractiveExample("pages/js/self-reporterror.html")}} -->
diff --git a/files/ja/web/api/requestinit/index.md b/files/ja/web/api/requestinit/index.md
index d68caf67e28058..192838469c840d 100644
--- a/files/ja/web/api/requestinit/index.md
+++ b/files/ja/web/api/requestinit/index.md
@@ -225,7 +225,7 @@ async function post() {
 
 ### `Request()` コンストラクターにオプションを渡す
 
-この例では {{domxref("Request")}} を作成し、そのコンストラクタに同じオプション設定をして `fetch()` にリクエストを渡します。
+この例では {{domxref("Request")}} を作成し、そのコンストラクターに同じオプション設定をして `fetch()` にリクエストを渡します。
 
 ```js
 async function post() {
@@ -245,7 +245,7 @@ async function post() {
 
 ### `Request()` と `fetch()` の両方にオプションを渡す
 
-この例では {{domxref("Request")}} を作成し、 `method`、`headers`、`body` オプションをコンストラクタに渡します。そして、`body` と `referrer` オプションとともに `fetch()` にリクエストを渡します。
+この例では {{domxref("Request")}} を作成し、 `method`、`headers`、`body` オプションをコンストラクターに渡します。そして、`body` と `referrer` オプションとともに `fetch()` にリクエストを渡します。
 
 ```js
 async function post() {

From 08f8fd74f872fc4a714ab9c111b6f12376dd112b Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 18:22:32 +0900
Subject: [PATCH 038/115] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/index.md | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/files/ja/web/api/request/index.md b/files/ja/web/api/request/index.md
index ed75710c6ec029..15ef8a1c929497 100644
--- a/files/ja/web/api/request/index.md
+++ b/files/ja/web/api/request/index.md
@@ -2,7 +2,7 @@
 title: Request
 slug: Web/API/Request
 l10n:
-  sourceCommit: 06105598d11001e9f12d80ad05087f1df3c0634b
+  sourceCommit: 802b6063046dffb7634d2138aadcd92cb22ed40c
 ---
 
 {{APIRef("Fetch API")}}
@@ -27,7 +27,7 @@ l10n:
 - {{domxref("Request.credentials")}} {{ReadOnlyInline}}
   - : リクエストの認証情報 (`omit`, `same-origin`, `include` など) が入ります。既定値は `same-origin` です。
 - {{domxref("Request.destination")}} {{ReadOnlyInline}}
-  - : 文字列で、リクエストの宛先を示します。これはその種類のコンテンツがリクエストされることを示す文字列です。
+  - : 文字列で、リクエストされたコンテンツの型を表します。
 - {{domxref("Request.headers")}} {{ReadOnlyInline}}
   - : リクエストに関連付けられた {{domxref("Headers")}} オブジェクトが入ります。
 - {{domxref("Request.integrity")}} {{ReadOnlyInline}}
@@ -36,14 +36,14 @@ l10n:
   - : リクエストメソッド (`GET`, `POST` など) を保持します。
 - {{domxref("Request.mode")}} {{ReadOnlyInline}}
   - : リクエストのモード ( `cors`, `no-cors`, `same-origin`, `navigate` など) を保持します。
-- {{domxref("Request.priority")}} {{ReadOnlyInline}} {{Experimental_Inline}}
-  - : このリクエストの優先度のヒント（`high`, `low`, `auto` など）を保持します。
 - {{domxref("Request.redirect")}} {{ReadOnlyInline}}
   - : リダイレクトをどう扱うかのモードが入ります。 `follow`, `error`, `manual` のいずれかです。
 - {{domxref("Request.referrer")}} {{ReadOnlyInline}}
-  - : リクエストのリファラー (`client` など) が入ります。
+  - : このリクエストのリファラー (`client` など) が入ります。
 - {{domxref("Request.referrerPolicy")}} {{ReadOnlyInline}}
   - : リファラに関するポリシー (`no-referrer` など) が入ります。
+- {{domxref("Request.signal")}} {{ReadOnlyInline}}
+  - : リクエストに関連付けられた {{domxref("AbortSignal")}} を返します。
 - {{domxref("Request.url")}} {{ReadOnlyInline}}
   - : リクエストの URL が入ります。
 
@@ -53,6 +53,8 @@ l10n:
   - : リクエストの本体の {{jsxref("ArrayBuffer")}} 表現で解決するプロミスを返します。
 - {{domxref("Request.blob()")}}
   - : リクエストの本体の {{domxref("Blob")}} 表現で解決するプロミスを返します。
+- {{domxref("Request.bytes()")}}
+  - : リクエスト本体の {{jsxref("Uint8Array")}} 表現で解決するプロミスを返します。
 - {{domxref("Request.clone()")}}
   - : 現在の `Request` オブジェクトのコピーを生成します。
 - {{domxref("Request.formData()")}}
@@ -63,7 +65,7 @@ l10n:
   - : リクエストの本体のテキスト表現で解決するプロミスを返します。
 
 > [!NOTE]
-> リクエストの本体の関数は 1 度しか呼び出せません。 2 回目以降は空の文字列または ArrayBuffer で解決します。
+> リクエスト本体の機能は一度しか実行することができません。それ以降の呼び出しは、TypeError で拒否され、本体ストリームがすでに使用されていることを示すエラーが表示されます。
 
 ## 例
 
@@ -77,7 +79,7 @@ const method = request.method;
 const credentials = request.credentials;
 ```
 
-このリクエストは、下記のように `Request` オブジェクトを引数として {{domxref("fetch()")}} に渡すことで読み取ることができます。
+このリクエストは、下記のように `Request` オブジェクトを引数として {{domxref("Window/fetch", "fetch()")}} に渡すことで読み取ることができます。
 
 ```js
 fetch(request)
@@ -104,7 +106,7 @@ const bodyUsed = request.bodyUsed;
 > [!NOTE]
 > body の型は {{domxref("Blob")}}, {{jsxref("ArrayBuffer")}}, {{jsxref("TypedArray")}}, {{jsxref("DataView")}}, {{domxref("FormData")}}, {{domxref("URLSearchParams")}}, {{domxref("ReadableStream")}}, {{jsxref("String")}} オブジェクトのいずれか、および文字列リテラルのみですので、 JSON オブジェクトを本体に追加するには、そのオブジェクトの文字列化をする必要があります。
 
-すると `Request` オブジェクトを、例えば {{domxref("fetch()")}} 呼び出しの引数として渡すことで API リクエストを取得できて、レスポンスを取得できます。
+すると `Request` オブジェクトを、例えば {{domxref("Window/fetch", "fetch()")}} 呼び出しの引数として渡すことで API リクエストを取得できて、レスポンスを取得できます。
 
 ```js
 fetch(request)

From 50d64aa28b5510fe597d502ca72e71388450c30a Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 21:23:00 +0900
Subject: [PATCH 039/115] =?UTF-8?q?2024/01/31=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/cache/index.md | 60 ++++++++++++-------------
 1 file changed, 30 insertions(+), 30 deletions(-)

diff --git a/files/ja/web/api/request/cache/index.md b/files/ja/web/api/request/cache/index.md
index c59e8e3b683ba7..3423a74b196992 100644
--- a/files/ja/web/api/request/cache/index.md
+++ b/files/ja/web/api/request/cache/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.cache
+title: "Request: cache プロパティ"
+short-title: cache
 slug: Web/API/Request/cache
 l10n:
-  sourceCommit: f5054555f990996051ea47e4282b905dffb95206
+  sourceCommit: 74206b3f81736bac558470f36222544cc67ba9e2
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`cache`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、リクエストのキャッシュモードを保持します。リクエストがブラウザーの [HTTP キャッシュ](/ja/docs/Web/HTTP/Caching) とどのように作用するかを制御します。
 
@@ -31,7 +32,7 @@ l10n:
   - 一致するものが*新しいか古いかに関わらず*、キャッシュから返されます。
   - 一致するものがない場合、ブラウザーは通常のリクエストを行い、ダウンロードしたリソースでキャッシュを更新します。
 
-- `only-if-cached` — ブラウザーは、 HTTP キャッシュで一致するリクエストを探します。
+- `only-if-cached` — ブラウザーは、 HTTP キャッシュで一致するリクエストを探します。 {{experimental_inline}}
 
   - 一致するものが*新しいか古いかに関わらず*、キャッシュから返されます。
   - 一致するものがない場合、ブラウザーは [504 Gateway timeout](/ja/docs/Web/HTTP/Status/504) ステータスで応答します。
@@ -41,38 +42,37 @@ l10n:
 ## 例
 
 ```js
-// Download a resource with cache busting, to bypass the cache
-// completely.
+// キャッシュを完全にバイパスするために、キャッシュ無効で
+// リソースをダウンロードします。
 fetch("some.json", { cache: "no-store" }).then((response) => {
-  /* consume the response */
+  /* レスポンスを消費 */
 });
 
-// Download a resource with cache busting, but update the HTTP
-// cache with the downloaded resource.
+// キャッシュ無効でリソースをダウンロードしますが、
+// ダウンロードしたリソースで HTTP キャッシュを更新します。
 fetch("some.json", { cache: "reload" }).then((response) => {
-  /* consume the response */
+  /* レスポンスを消費 */
 });
 
-// Download a resource with cache busting when dealing with a
-// properly configured server that will send the correct ETag
-// and Date headers and properly handle If-Modified-Since and
-// If-None-Match request headers, therefore we can rely on the
-// validation to guarantee a fresh response.
+// 正しい ETag および Date ヘッダーを送信し、If-Modified-Since と
+// If-None-Match リクエストヘッダーを適切に処理するよう適切に
+// 構成されたサーバーを扱う際には、キャッシュ無効でリソースを
+// ダウンロードします。これにより、新鮮なレスポンスを保証する
+// 検証をシンラインすることができます。
 fetch("some.json", { cache: "no-cache" }).then((response) => {
-  /* consume the response */
+  /* レスポンスを消費 */
 });
 
-// Download a resource with economics in mind! Prefer a cached
-// albeit stale response to conserve as much bandwidth as possible.
+// 経済性を考慮してリソースをダウンロードします。できるだけ多くの
+// 帯域幅を確保するために、キャッシュされた古いレスポンスを優先します。
 fetch("some.json", { cache: "force-cache" }).then((response) => {
-  /* consume the response */
+  /* レスポンスを消費 */
 });
 
-// Naive stale-while-revalidate client-level implementation.
-// Prefer a cached albeit stale response; but update if it's too old.
-// AbortController and signal to allow better memory cleaning.
-// In reality; this would be a function that takes a path and a
-// reference to the controller since it would need to change the value
+// 単純な期限切れを再検証するクライアントレベルの実装。
+// キャッシュされた古いレスポンスを優先しますが、あまりにも古い場合は更新します。
+// AbortController および signal により、よりよくメモリーの掃除ができます。
+// 実際には、値を変更する必要があるため、パスとコントローラーの参照を取る関数となります。
 let controller = new AbortController();
 fetch("some.json", {
   cache: "only-if-cached",
@@ -81,7 +81,7 @@ fetch("some.json", {
 })
   .catch((e) =>
     e instanceof TypeError && e.message === "Failed to fetch"
-      ? { status: 504 } // Workaround for chrome; which fails with a TypeError
+      ? { status: 504 } // Chrome の回避策。TypeError で失敗する
       : Promise.reject(e),
   )
   .then((res) => {
@@ -97,7 +97,7 @@ fetch("some.json", {
     const date = res.headers.get("date"),
       dt = date ? new Date(date).getTime() : 0;
     if (dt < Date.now() - 86_400_000) {
-      // if older than 24 hours
+      // 24 時間以上古ければ
       controller.abort();
       controller = new AbortController();
       return fetch("some.json", {
@@ -107,17 +107,17 @@ fetch("some.json", {
       });
     }
 
-    // Other possible conditions
+    // その他の条件
     if (dt < Date.now() - 300_000)
-      // If it's older than 5 minutes
+      // 5 分以上古ければ
       fetch("some.json", { cache: "no-cache", mode: "same-origin" }); // no cancellation or return value.
     return res;
   })
   .then((response) => {
-    /* consume the (possibly stale) response */
+    /* （おそらく古い）レスポンスを消費する */
   })
   .catch((error) => {
-    /* Can be an AbortError/DOMError or a TypeError */
+    /* AbortError/DOMException または TypeError となる */
   });
 ```
 

From 04b0c911fc2eef10b5a81d6c721972dec91604d0 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 21:42:18 +0900
Subject: [PATCH 040/115] =?UTF-8?q?2024/07/12=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/credentials/index.md | 29 ++++++++++---------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/files/ja/web/api/request/credentials/index.md b/files/ja/web/api/request/credentials/index.md
index d5715e394b4595..34186feba3a30a 100644
--- a/files/ja/web/api/request/credentials/index.md
+++ b/files/ja/web/api/request/credentials/index.md
@@ -1,34 +1,37 @@
 ---
-title: Request.credentials
+title: "Request: credentials プロパティ"
+short-title: credentials
 slug: Web/API/Request/credentials
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 09937df677a7c057656d7a2f5fcab7699b1e4bb9
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
-**`credentials`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、オリジン間リクエストの場合に、ユーザーエージェントが他のドメインからクッキーを送信または受信するべきかどうかを示すものです。
+**`credentials`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、[`credentials`](/ja/docs/Web/API/RequestInit#credentials) オプションで指定された {{domxref("Request.Request()", "Request()")}} コンストラクターの値を反映します。このプロパティは、ブラウザーがリクエストに資格情報を送信するかどうか、また、**`Set-Cookie`** レスポンスヘッダーが尊重されるかどうかを決定します。
+
+資格情報とは、クッキー、TLS クライアント証明書、ユーザー名とパスワードを格納する認証ヘッダーなどです。
+
+詳しくは[資格情報を含める](/ja/docs/Web/API/Fetch_API/Using_Fetch#資格情報を含める)を参照してください。
 
 ### 値
 
-`RequestCredentials` 辞書の値で、オリジン間リクエストの場合、ユーザーエージェントが他のドメインからクッキーを送信するか受信するかを示します。使用可能な値は以下の通りです。
+文字列で、以下の値のうちのいずれかです。
 
 - `omit`
-  - : クッキーを送受信しません。
+  - : リクエストに資格情報を記載したり、レスポンスに資格情報を含めたりしません。
 - `same-origin`
-  - : URL が呼び出し元のスクリプトと同一オリジンだった場合のみ、ユーザーの資格情報 (HTTP Basic 認証、など) を送信します。 **これが既定値です。**
+  - : 同一オリジンリクエストにのみ、資格情報を送信したり含めたりします。
 - `include`
-  - : オリジン間の呼び出しであっても、常にユーザーの資格情報 (クッキー、HTTP Basic 認証、など) を送信します。
-
-これは XHR の [`withCredentials`](/ja/docs/Web/API/XMLHttpRequest/withCredentials) フラグと似ていますが、有効な値が 2 つではなく 3 つあります。
+  - : オリジン間のリクエストであっても、常に資格情報を含めます。
 
 ## 例
 
-次のスニペットは、{{domxref("Request.Request()")}} コンストラクターを使って（スクリプトと同じディレクトリーにある画像ファイルのために）新しいリクエストを生成してから、リクエストの資格情報を変数に保存しています。
+次のスニペットは、{{domxref("Request.Request", "Request()")}} コンストラクターを使って（スクリプトと同じディレクトリーにある画像ファイルのために）新しいリクエストを生成してから、リクエストの資格情報を変数に保存しています。
 
 ```js
-const myRequest = new Request("flowers.jpg");
-const myCred = myRequest.credentials; // 既定で "same-origin" を返す
+const request = new Request("flowers.jpg");
+const request = request.request; // 既定で "same-origin" を返す
 ```
 
 ## 仕様書

From 610a3af35d83001717d417bc19d1364c8d3f146f Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 21:56:08 +0900
Subject: [PATCH 041/115] =?UTF-8?q?2024/07/24=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/destination/index.md | 29 ++++++++++++++-----
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/files/ja/web/api/request/destination/index.md b/files/ja/web/api/request/destination/index.md
index cfa37b47c064fa..ebd392bcc0755a 100644
--- a/files/ja/web/api/request/destination/index.md
+++ b/files/ja/web/api/request/destination/index.md
@@ -1,24 +1,25 @@
 ---
-title: Request.destination
+title: "Request: destination プロパティ"
+short-title: destination
 slug: Web/API/Request/destination
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 58ad1df59f2ffb9ecab4e27fe1bdf1eb5a55f89b
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`destination`** は **{{domxref("Request")}}** インターフェイスの読み取り専用プロパティで、リクエストされたコンテンツの種類を記述した文字列を返します。
 
 この文字列は、 `audio`, `audioworklet`,
-`document`, `embed`, `font`, `frame`,
-`iframe`, `image`, `manifest`, `object`,
+`document`, `embed`, `fencedframe`, `font`, `frame`,
+`iframe`, `image`, `json`, `manifest`, `object`,
 `paintworklet`, `report`, `script`, `sharedworker`,
 `style`, `track`, `video`, `worker`,
 `xslt`、または空文字列（既定値）の何れかでなければなりません。
 
 この `destination` は{{Glossary("user agent", "ユーザーエージェント")}}によって使用され、例えば、 CORS のためにどのルールに従うべきか、あるいは特定の型の入力がどのように処理されるかに影響する複雑なコードパスをどのようにナビゲートするかを決定するのに役に立ちます。
 
-これらの出力先によって、その処理方法は大きく異なります。あるものはデータを受け取るもので、受け取ったデータは後で処理するために格納さ れます。他にもスクリプトベースのものがあり、その場合は受け取ったデータはスクリプトを呼び出してデータを渡すことで配信されます。スクリプトベースの出力先には {{HTMLElement("script")}} 要素、 {{domxref("Worklet")}} ベースの出力先（{{domxref("AudioWorklet")}} や {{domxref("PaintWorklet")}} など）、 {{domxref("Worker")}} ベースの出力先（{{domxref("ServiceWorker")}} や {{domxref("SharedWorker")}} など）が含まれます。
+これらの出力先によって、その処理方法は大きく異なります。あるものはデータを受け取るもので、受け取ったデータは後で処理するために格納さ れます。他にもスクリプトベースのものがあり、その場合は受け取ったデータはスクリプトを呼び出してデータを渡すことで配信されます。スクリプトベースの出力先には {{HTMLElement("script")}} 要素、 {{domxref("Worklet")}} ベースの出力先（{{domxref("AudioWorklet")}} などのサブクラスも含む）、 {{domxref("Worker")}} ベースの出力先（{{domxref("ServiceWorker")}} や {{domxref("SharedWorker")}} など）が含まれます。
 
 ## 値
 
@@ -27,7 +28,17 @@ l10n:
 使用可能な値は以下の通りです。
 
 - `""`
-  - : 自分自身で値を持たない出力先には、既定で `destination` が使用されます。 [navigator.sendBeacon()](/ja/docs/Web/API/Navigator/sendBeacon), [EventSource](/ja/docs/Web/API/EventSource), [\<a ping>](/ja/docs/Web/HTML/Element/a#attr-ping), [\<area ping>](/ja/docs/Web/HTML/Element/area#attr-ping), [fetch()](/ja/docs/Web/API/fetch), [XMLHttpRequest](/ja/docs/Web/API/XMLHttpRequest), [WebSocket](/ja/docs/Web/API/WebSocket), [Cache](/ja/docs/Web/API/Cache) などです。
+
+  - : 空文字列は既定値であり、独自の値を持たない出力先に対して使用されます。これは、以下の API（その他多数）を使用してリクエストが行われた場合の値です。
+    - [`<a ping>`](/ja/docs/Web/HTML/Element/a#ping)
+    - [`<area ping>`](/ja/docs/Web/HTML/Element/area#ping)
+    - {{domxref("Cache")}}
+    - {{domxref("EventSource")}}
+    - {{domxref("Window/fetch", "fetch()")}}
+    - {{domxref("navigator.sendBeacon()")}}
+    - {{domxref("WebSocket")}}
+    - {{domxref("XMLHttpRequest")}}
+
 - `"audio"`
   - : 対象は音声データです。
 - `"audioworklet"`
@@ -36,10 +47,14 @@ l10n:
   - : 対象は文書（HTML または XML）です。
 - `"embed"`
   - : 対象は埋め込みコンテンツです。
+- `"fencedframe"`
+  - : 対象は[フェンスフレーム](/ja/docs/Web/API/Fenced_frame_API)です。
 - `"font"`
   - : 対象はフォントです。
 - `"image"`
   - : 対象は画像です。
+- `"json"`
+  - : 対象は JSON ファイルです。
 - `"manifest"`
   - : 対象はマニフェストです。
 - `"object"`

From f5021119dcbd5951e3d382b0ff3637621f1694fd Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 22:03:23 +0900
Subject: [PATCH 042/115] =?UTF-8?q?2023/07/03=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/integrity/index.md | 22 +++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/files/ja/web/api/request/integrity/index.md b/files/ja/web/api/request/integrity/index.md
index a65bd70f65a09b..659a0aead66b1d 100644
--- a/files/ja/web/api/request/integrity/index.md
+++ b/files/ja/web/api/request/integrity/index.md
@@ -1,27 +1,37 @@
 ---
-title: Request.integrity
+title: "Request: integrity プロパティ"
+short-title: integrity
 slug: Web/API/Request/integrity
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 1259740828bbbe9f19f9697df5847c957abb64e3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`integrity`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、このリクエストの[サブリソース完全性](/ja/docs/Web/Security/Subresource_Integrity)の値を保持します。
 
 ## 値
 
-リクエストの[サブリソース完全性](/ja/docs/Web/Security/Subresource_Integrity)の値（`sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=` など）。
+`Request` を構築する際に `options.integrity` 引数として渡された値。
 
 完全性が指定されていない場合、 `''` を返します。
 
 ## 例
 
-次のスニペットでは {{domxref("Request.Request()")}} コンストラクターを使用して新しいリクエストを作成し（スクリプトと同じディレクトリーにある画像ファイルに対して）、そのリクエストの `integrity` 値を変数に保存します。
+次のスニペットでは {{domxref("Request.Request()")}} コンストラクターを使用して新しいリクエストを作成し（スクリプトと同じディレクトリーにある画像ファイルに対して）、次に、そのリクエストの完全性を読み取ります。リクエストは特定の完全性なしに作成されたため、プロパティは空文字列を返します。
 
 ```js
 const myRequest = new Request("flowers.jpg");
-const myIntegrity = myRequest.integrity;
+console.log(myRequest.integrity); // ""
+```
+
+例えば、下記の場合、リクエストは特定の完全性の値で作成されたため、プロパティはその値を返します。なお、完全性の値の検証は行われません。このプロパティは渡された値をそのまま返します。
+
+```js
+const myRequest = new Request("flowers.jpg", {
+  integrity: "sha256-abc123",
+});
+console.log(myRequest.integrity); // "sha256-abc123"
 ```
 
 ## 仕様書

From 659bcf4e20e5dee705f373e332c61fb0684065fc Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 22:28:16 +0900
Subject: [PATCH 043/115] =?UTF-8?q?2023/10/02=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/mode/index.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/files/ja/web/api/request/mode/index.md b/files/ja/web/api/request/mode/index.md
index 3fc61713369721..4fb217c411e898 100644
--- a/files/ja/web/api/request/mode/index.md
+++ b/files/ja/web/api/request/mode/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.mode
+title: "Request: mode プロパティ"
+short-title: mode
 slug: Web/API/Request/mode
 l10n:
   sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`mode`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、リクエストのモード（たとえば、`cors`、`no-cors`、`same-origin`、`navigate`、`websocket`）を保持します。これは、オリジン間リクエストに対して有効なレスポンスができるか、またレスポンスのプロパティが読み取り可能かどうかを判定するために使用されます。
 
@@ -18,7 +19,10 @@ l10n:
     - `same-origin`
       - : このモードを設定してほかのオリジンにリクエストをした場合、結果はエラーになります。リクエストが常に同一オリジンに行われることを保証するために使用できます。
     - `no-cors`
-      - : メソッドが `HEAD`、`GET`、`POST` 以外にならないようにし、ヘッダーが[単純ヘッダー](https://fetch.spec.whatwg.org/#simple-header)以外のものにならないようにします。サービスワーカーがこれらのリクエストに介入した場合、[単純ヘッダー](https://fetch.spec.whatwg.org/#simple-header)以外のヘッダーを追加したり上書きしたりすることはできません。さらに、 JavaScript で結果の {{domxref("Response")}} のプロパティにアクセスすることはできません。これは、サービスワーカーがウェブの意味づけに影響を与えないようにし、ドメイン間でデータが漏れることによって生じるセキュリティとプライバシーの問題を防ぐためです。
+      - : メソッドが `HEAD`、`GET`、`POST` 以外にならないようにし、ヘッダーが {{Glossary("CORS-safelisted request header", "CORS セーフリストリクエストヘッダー")}}以外のものにならないようにします。
+        サービスワーカーがこれらのリクエストに介入した場合 {{Glossary("CORS-safelisted request header", "CORS セーフリストリクエストヘッダー")}}以外のヘッダーを追加したり上書きしたりすることはできません。
+        さらに、 JavaScript で結果の {{domxref("Response")}} のプロパティにアクセスすることはできません。
+        これは、サービスワーカーがウェブの意味づけに影響を与えないようにし、ドメイン間でデータが漏れることによって生じるセキュリティとプライバシーの問題を防ぐためです。
     - `cors`
       - : オリジン間リクエストを許可します。たとえば、サードパーティベンダーが提供する様々な API にアクセスできます。これらは、[CORS プロトコル](/ja/docs/Web/HTTP/CORS)に則ることが期待されています。[制限された](https://fetch.spec.whatwg.org/#concept-filtered-response-cors)ヘッダーしか {{domxref("Response")}} からは見えないようになりますが、本体は読み取り可能です。
     - `navigate`

From 2563fd863003012b31009f8322d2bfe0028f53e0 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 22:34:15 +0900
Subject: [PATCH 044/115] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/referrer/index.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/files/ja/web/api/request/referrer/index.md b/files/ja/web/api/request/referrer/index.md
index 5cda9b07121e7d..8bfa912a275271 100644
--- a/files/ja/web/api/request/referrer/index.md
+++ b/files/ja/web/api/request/referrer/index.md
@@ -1,15 +1,16 @@
 ---
-title: Request.referrer
+title: "Request: referrer プロパティ"
+short-title: referrer
 slug: Web/API/Request/referrer
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 802b6063046dffb7634d2138aadcd92cb22ed40c
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
-**`referrer`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、ユーザーエージェントによってリクエストのリファラーが設定されます（`about:client` や `no-referrer`、URL、など）。
+**`referrer`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、ユーザーエージェントによってリクエストのリファラーが設定されます（`client` や `no-referrer`、URL、など）。
 
-> **メモ:** `referrerPolicy` の値が `no-referrer` だった場合、空文字が返されます。
+> **メモ:** `referrer` の値が `no-referrer` だった場合、空文字が返されます。
 
 ## 値
 
@@ -21,7 +22,7 @@ l10n:
 
 ```js
 const myRequest = new Request("flowers.jpg");
-const myReferrer = myRequest.referrer; // returns "about:client" by default
+const myReferrer = myRequest.referrer; // 既定では "about:client" を返す
 ```
 
 ## 仕様書

From 61c72cd009982a3475c714b9b1f48d5700a407a5 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 00:40:02 +0900
Subject: [PATCH 045/115] =?UTF-8?q?2024/06/25=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/bytes/index.md | 52 +++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 files/ja/web/api/request/bytes/index.md

diff --git a/files/ja/web/api/request/bytes/index.md b/files/ja/web/api/request/bytes/index.md
new file mode 100644
index 00000000000000..d755a879000f20
--- /dev/null
+++ b/files/ja/web/api/request/bytes/index.md
@@ -0,0 +1,52 @@
+---
+title: "Request: bytes() メソッド"
+short-title: bytes()
+slug: Web/API/Request/bytes
+l10n:
+  sourceCommit: 9dfdc8522d5c53448643682bacaf33959487006a
+---
+
+{{APIRef("Fetch API")}}
+
+**`bytes()`** は {{domxref("Request")}} インターフェイスのメソッドで、リクエスト本体を読み込み、{{jsxref("Uint8Array")}} で解決するプロミスとしてそれを返します。
+
+## 構文
+
+```js-nolint
+bytes()
+```
+
+### 引数
+
+なし。
+
+### 返値
+
+{{jsxref("Uint8Array")}} で解決するプロミスです。
+
+## 例
+
+```js
+const myArray = new Uint8Array(10);
+
+const request = new Request("/myEndpoint", {
+  method: "POST",
+  body: myArray,
+});
+
+request.bytes().then((buffer) => {
+  // リクエストで送信されたバッファーを処理する
+});
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{domxref("Response.arrayBuffer()")}}

From c1642a983bd7d325ec25e785d3a87d14fd2b9d51 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 22:44:59 +0900
Subject: [PATCH 046/115] =?UTF-8?q?2023/07/25=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/signal/index.md | 54 ++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 files/ja/web/api/request/signal/index.md

diff --git a/files/ja/web/api/request/signal/index.md b/files/ja/web/api/request/signal/index.md
new file mode 100644
index 00000000000000..a0bd0bb2508a14
--- /dev/null
+++ b/files/ja/web/api/request/signal/index.md
@@ -0,0 +1,54 @@
+---
+title: "Request: signal プロパティ"
+short-title: signal
+slug: Web/API/Request/signal
+l10n:
+  sourceCommit: 989453176fd8756828b34b743a677a797d897156
+---
+
+{{APIRef("Fetch API")}}
+
+**`signal`** は {{DOMxRef("Request")}} インターフェイスの読み取り専用プロパティで、このリクエストに関連付けられた {{domxref("AbortSignal")}} を返します。
+
+## 値
+
+{{DOMxRef("AbortSignal")}} オブジェクトです。
+
+## 例
+
+```js
+// 新しい中止コントローラーを作成
+const controller = new AbortController();
+
+// このコントローラーの AbortSignal オブジェクトを使用してリクエストを作成
+const req = new Request("/", { signal: controller.signal });
+
+// 中止された場合にメッセージをログ出力するイベントハンドラーを追加
+req.signal.addEventListener("abort", () => {
+  console.log("abort");
+});
+
+// 中止された場合は、AbortSignalの理由をログ出力
+fetch(req).catch(() => {
+  if (signal.aborted) {
+    if (signal.reason) {
+      console.log(`リクエストは ${signal.reason} が原因で中止されました。`);
+    } else {
+      console.log("リクエストは中止されましたが、理由は示されませんでした。");
+    }
+  } else {
+    console.log("リクエストは中止されませんでしたが、異常終了しました。");
+  }
+});
+
+// 実際にリクエストを中止
+controller.abort();
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}

From 0444ad21ee1f75979f95947d16140125e02b12fe Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sat, 7 Sep 2024 20:24:16 +0900
Subject: [PATCH 047/115] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/request/arraybuffer/index.md    |  9 +++++----
 files/ja/web/api/request/blob/index.md           | 11 ++++++-----
 files/ja/web/api/request/body/index.md           |  7 ++++---
 files/ja/web/api/request/bodyused/index.md       |  7 ++++---
 files/ja/web/api/request/clone/index.md          |  9 +++++----
 files/ja/web/api/request/formdata/index.md       |  9 +++++----
 files/ja/web/api/request/headers/index.md        |  7 ++++---
 files/ja/web/api/request/json/index.md           |  7 ++++---
 files/ja/web/api/request/method/index.md         |  7 ++++---
 files/ja/web/api/request/redirect/index.md       |  9 +++++----
 files/ja/web/api/request/referrerpolicy/index.md |  7 ++++---
 files/ja/web/api/request/text/index.md           | 11 ++++++-----
 files/ja/web/api/request/url/index.md            |  7 ++++---
 13 files changed, 60 insertions(+), 47 deletions(-)

diff --git a/files/ja/web/api/request/arraybuffer/index.md b/files/ja/web/api/request/arraybuffer/index.md
index 45ff62e7f6057c..fa901a8fbfff46 100644
--- a/files/ja/web/api/request/arraybuffer/index.md
+++ b/files/ja/web/api/request/arraybuffer/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.arrayBuffer()
+title: "Request: arrayBuffer() メソッド"
+short-title: arrayBuffer()
 slug: Web/API/Request/arrayBuffer
 l10n:
-  sourceCommit: 2b8f5d9a29f00aea5d2edfa78d1fb90c51752858
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`arrayBuffer()`** は {{domxref("Request")}} インターフェイスのメソッドで、リクエスト本体を読み込み、それを {{jsxref("ArrayBuffer")}} で解決するプロミスとして返します。
 
@@ -34,7 +35,7 @@ const request = new Request("/myEndpoint", {
 });
 
 request.arrayBuffer().then((buffer) => {
-  // do something with the buffer sent in the request
+  // リクエストで送信されたバッファーに対して何らかの処理を行う
 });
 ```
 
diff --git a/files/ja/web/api/request/blob/index.md b/files/ja/web/api/request/blob/index.md
index fe6ffe23d20651..d57b022f825097 100644
--- a/files/ja/web/api/request/blob/index.md
+++ b/files/ja/web/api/request/blob/index.md
@@ -1,13 +1,14 @@
 ---
-title: Request.blob()
+title: "Request: blob() メソッド"
+short-title: blob()
 slug: Web/API/Request/blob
 l10n:
-  sourceCommit: 2b8f5d9a29f00aea5d2edfa78d1fb90c51752858
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
-**`arrayBuffer()`** は {{domxref("Request")}} インターフェイスのメソッドで、リクエスト本体を読み込み、それを {{domxref("Blob")}} で解決するプロミスとして返します。
+**`blob()`** は {{domxref("Request")}} インターフェイスのメソッドで、リクエスト本体を読み込み、それを {{domxref("Blob")}} で解決するプロミスとして返します。
 
 ## 構文
 
@@ -37,7 +38,7 @@ const request = new Request("/myEndpoint", {
 });
 
 request.blob().then((myBlob) => {
-  // do something with the blob sent in the request
+  // リクエストで送信された blob を処理する
 });
 ```
 
diff --git a/files/ja/web/api/request/body/index.md b/files/ja/web/api/request/body/index.md
index 31ef84fa26aa4f..7e11fae7cfa3a0 100644
--- a/files/ja/web/api/request/body/index.md
+++ b/files/ja/web/api/request/body/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.body
+title: "Request: body プロパティ"
+short-title: body
 slug: Web/API/Request/body
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`body`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、
 このインターフェイスは、リクエストに追加された本体のコンテンツを含む {{domxref("ReadableStream")}} を保持します。 `GET` や `HEAD` メソッドを使用したリクエストは本体を持つことができず、その場合は `null` が返されることに注意してください。
diff --git a/files/ja/web/api/request/bodyused/index.md b/files/ja/web/api/request/bodyused/index.md
index ef832e106ef58a..df1497e116f82f 100644
--- a/files/ja/web/api/request/bodyused/index.md
+++ b/files/ja/web/api/request/bodyused/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.bodyUsed
+title: "Request: bodyUsed プロパティ"
+short-title: bodyUsed
 slug: Web/API/Request/bodyUsed
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`bodyUsed`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、リクエスト本体がまだ読み込まれていないかどうかを示す論理値です。
 
diff --git a/files/ja/web/api/request/clone/index.md b/files/ja/web/api/request/clone/index.md
index b395c04bc2be39..b8870f0b3e18ee 100644
--- a/files/ja/web/api/request/clone/index.md
+++ b/files/ja/web/api/request/clone/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.clone()
+title: "Request: clone() メソッド"
+short-title: clone()
 slug: Web/API/Request/clone
 l10n:
-  sourceCommit: 2b8f5d9a29f00aea5d2edfa78d1fb90c51752858
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`clone()`** は {{domxref("Request")}} インターフェイスのメソッドで、現在の `Request` オブジェクトのコピーを生成します。
 
@@ -32,7 +33,7 @@ clone()
 
 ## 例
 
-次のスニペットは、{{domxref("Request.Request()")}} コンストラクタをー使って（スクリプトと同じディレクトリーにある画像ファイルのために）新しいリクエストを生成してから、リクエストをコピーしています。
+次のスニペットは、{{domxref("Request.Request()")}} コンストラクターをー使って（スクリプトと同じディレクトリーにある画像ファイルのために）新しいリクエストを生成してから、リクエストをコピーしています。
 
 ```js
 const myRequest = new Request("flowers.jpg");
diff --git a/files/ja/web/api/request/formdata/index.md b/files/ja/web/api/request/formdata/index.md
index 962befd2e45a75..e4d5d6fe1a548f 100644
--- a/files/ja/web/api/request/formdata/index.md
+++ b/files/ja/web/api/request/formdata/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.formData()
+title: "Request: formData() メソッド"
+short-title: formData()
 slug: Web/API/Request/formData
 l10n:
-  sourceCommit: 2b8f5d9a29f00aea5d2edfa78d1fb90c51752858
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`formData()`** は {{domxref("Request")}} インターフェイスのメソッドで、リクエスト本体を読み込み、 {{domxref("FormData")}} オブジェクトで解決するプロミスとして返します。
 
@@ -38,7 +39,7 @@ const request = new Request("/myEndpoint", {
 });
 
 request.formData().then((data) => {
-  // do something with the formdata sent in the request
+  // リクエストで送信されたフォームデータに対して何らかの処理を行う
 });
 ```
 
diff --git a/files/ja/web/api/request/headers/index.md b/files/ja/web/api/request/headers/index.md
index c48a3a33d9089a..81084270bcc9b4 100644
--- a/files/ja/web/api/request/headers/index.md
+++ b/files/ja/web/api/request/headers/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.headers
+title: "Request: headers プロパティ"
+short-title: headers
 slug: Web/API/Request/headers
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`headers`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、リクエストに関連する {{domxref("Headers")}} オブジェクトを保持します。
 
diff --git a/files/ja/web/api/request/json/index.md b/files/ja/web/api/request/json/index.md
index 86ed79700c2221..8d7fd80aa38291 100644
--- a/files/ja/web/api/request/json/index.md
+++ b/files/ja/web/api/request/json/index.md
@@ -1,8 +1,9 @@
 ---
-title: Request.json()
+title: "Request: json() メソッド"
+short-title: json()
 slug: Web/API/Request/json
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
 {{APIRef("Fetch API")}}
@@ -37,7 +38,7 @@ const request = new Request("/myEndpoint", {
 });
 
 request.json().then((data) => {
-  // do something with the data sent in the request
+  // リクエストで送信されたデータに対して何らかの処理をする
 });
 ```
 
diff --git a/files/ja/web/api/request/method/index.md b/files/ja/web/api/request/method/index.md
index ad7a94074f1910..2e08d71ccffc79 100644
--- a/files/ja/web/api/request/method/index.md
+++ b/files/ja/web/api/request/method/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.method
+title: "Request: method プロパティ"
+short-title: method
 slug: Web/API/Request/method
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`method`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、このリクエストのメソッド（`GET`、`POST` など）を保持します。
 
diff --git a/files/ja/web/api/request/redirect/index.md b/files/ja/web/api/request/redirect/index.md
index 1065bee9c3cb6a..39424a1399e4fb 100644
--- a/files/ja/web/api/request/redirect/index.md
+++ b/files/ja/web/api/request/redirect/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.redirect
+title: "Request: redirect プロパティ"
+short-title: redirect
 slug: Web/API/Request/redirect
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`redirect`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、リダイレクトを処理する方法のモードを保持します。
 
@@ -21,7 +22,7 @@ l10n:
 
 ## 例
 
-次のスニペットでは、 {{domxref("Request.Request()")}} コンストラクターを使用して（スクリプトと同じディレクトリにある画像ファイルのために）新しいリクエストを作成し、そのリクエストの `redirect` の値を変数に保存します。
+次のスニペットでは、 {{domxref("Request.Request()")}} コンストラクターを使用して（スクリプトと同じディレクトリーにある画像ファイルのために）新しいリクエストを作成し、そのリクエストの `redirect` の値を変数に保存します。
 
 ```js
 const myRequest = new Request("flowers.jpg");
diff --git a/files/ja/web/api/request/referrerpolicy/index.md b/files/ja/web/api/request/referrerpolicy/index.md
index 1ef000646366db..0849f733bbf90d 100644
--- a/files/ja/web/api/request/referrerpolicy/index.md
+++ b/files/ja/web/api/request/referrerpolicy/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.referrerPolicy
+title: "Request: referrerPolicy プロパティ"
+short-title: referrerPolicy
 slug: Web/API/Request/referrerPolicy
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`referrerPolicy`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、{{HTTPHeader("Referer")}} ヘッダーで送信されるどのリファラー情報がリクエストに記載されるべきかを管理する、リファラーポリシーを返します。
 
diff --git a/files/ja/web/api/request/text/index.md b/files/ja/web/api/request/text/index.md
index bb243708b90eac..2a3825f8394672 100644
--- a/files/ja/web/api/request/text/index.md
+++ b/files/ja/web/api/request/text/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.text()
+title: "Request: text() メソッド"
+short-title: text()
 slug: Web/API/Request/text
 l10n:
-  sourceCommit: 16e398809d62247dbadc89ff4024a0ffa4781f0e
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`text()`** は {{domxref("Request")}} インターフェイスのメソッドで、リクエスト本体を読み込み、文字列で解決されるプロミスとして返します。
 レスポンスは常に UTF-8 を使用してデコードされます。
@@ -22,7 +23,7 @@ text()
 
 ### 返値
 
-文字列で解決する {{jsxref("Promise")}}。
+文字列で解決するプロミスです。
 
 ## 例
 
@@ -35,7 +36,7 @@ const request = new Request("/myEndpoint", {
 });
 
 request.text().then((text) => {
-  // do something with the text sent in the request
+  // リクエストで送信されたテキストに対して何らかの処理を行う
 });
 ```
 
diff --git a/files/ja/web/api/request/url/index.md b/files/ja/web/api/request/url/index.md
index b4aeb57294a62a..fe5799d28ab56f 100644
--- a/files/ja/web/api/request/url/index.md
+++ b/files/ja/web/api/request/url/index.md
@@ -1,11 +1,12 @@
 ---
-title: Request.url
+title: "Request: url プロパティ"
+short-title: url
 slug: Web/API/Request/url
 l10n:
-  sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1
+  sourceCommit: 954612667bafd71241a93e8554e8f11afc474ff3
 ---
 
-{{APIRef("Fetch")}}
+{{APIRef("Fetch API")}}
 
 **`url`** は {{domxref("Request")}} インターフェイスの読み取り専用プロパティで、リクエストの URL を保持します。
 

From 35292f2a96c6c620477e85dac7397dbe6a5b5c8d Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 09:24:31 +0900
Subject: [PATCH 048/115] =?UTF-8?q?2024/07/08=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/glossary/static_method/index.md | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/files/ja/glossary/static_method/index.md b/files/ja/glossary/static_method/index.md
index f1bf52c7e7e1f8..9033482eb2a72f 100644
--- a/files/ja/glossary/static_method/index.md
+++ b/files/ja/glossary/static_method/index.md
@@ -1,6 +1,8 @@
 ---
 title: Static method (静的メソッド)
 slug: Glossary/Static_method
+l10n:
+  sourceCommit: 424582339e3d3de819667b2e5e2ea52a180fe84c
 ---
 
 {{GlossarySidebar}}
@@ -13,7 +15,7 @@ slug: Glossary/Static_method
 
 ## 例
 
-[Notifications API](/ja/docs/Web/API/Notifications_API) では、{{domxref("Notification.requestPermission()")}} メソッドは実際は {{domxref("Notification")}} コンストラクター自身に対して呼び出されます。— これが静的メソッドです。
+[通知 API](/ja/docs/Web/API/Notifications_API) では、{{domxref("Notification.requestPermission_static")}} メソッドは実際は {{domxref("Notification")}} コンストラクター自身に対して呼び出されます。— これが静的メソッドです。
 
 ```js
 let promise = Notification.requestPermission();
@@ -27,15 +29,10 @@ let myNotification = new Notification("This is my notification");
 myNotification.close();
 ```
 
-1. 一般知識
+## 関連情報
 
-   1. Techopedia の [Static Method](https://www.techopedia.com/definition/24034/static-method)
-
-2. JavaScript リファレンス
-
-   1. [static](/ja/docs/Web/JavaScript/Reference/Classes/static)
-
-3. 関連用語:
-
-   1. {{Glossary("Object", "オブジェクト")}}
-   2. {{Glossary("Method", "メソッド")}}
+- [Static Method](https://www.techopedia.com/definition/24034/static-method) (Techopedia)
+- [static](/ja/docs/Web/JavaScript/Reference/Classes/static)
+- 関連用語:
+  - {{Glossary("Object", "オブジェクト")}}
+  - {{Glossary("Method", "メソッド")}}

From 9aec80479c7dec3ced2443a0c7d8f952826feb89 Mon Sep 17 00:00:00 2001
From: zztkm <33755694+zztkm@users.noreply.github.com>
Date: Wed, 11 Sep 2024 11:58:02 +0900
Subject: [PATCH 049/115] =?UTF-8?q?=E3=82=B9=E3=83=86=E3=83=AC=E3=82=AA?=
 =?UTF-8?q?=E3=81=A8=E3=83=A2=E3=83=8E=E3=83=A9=E3=83=AB=E3=81=8C=E9=80=86?=
 =?UTF-8?q?=E3=81=AA=E3=81=AE=E3=81=A7=E4=BF=AE=E6=AD=A3=E3=81=99=E3=82=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

翻訳元の英文は `Down-mix from stereo to mono` だったので修正

元ソース:
https://github.com/mdn/content/blob/1bb0a2834d8e90495319ee9e52ecbc55e856e913/files/en-us/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md?plain=1#L192
---
 .../web_audio_api/basic_concepts_behind_web_audio_api/index.md  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/ja/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md b/files/ja/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md
index c4ff470469687a..ad4b952863f50d 100644
--- a/files/ja/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md
+++ b/files/ja/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.md
@@ -177,7 +177,7 @@ Web Audio API は、音声処理に適することを理由に、平面的なバ
       <td><code>2</code> <em>(Stereo)</em></td>
       <td><code>1</code> <em>(Mono)</em></td>
       <td>
-        <em>モノラルからステレオへのダウンミックス。</em><br />(<code>L</code>
+        <em>ステレオからモノラルへのダウンミックス。</em><br />(<code>L</code>
         と
         <code>R</code>
         の)両入力チャンネルは等しく結合され、単一出力チャンネル(<code>M</code>)になります。<br /><code

From 3dd899c16107935c2a07a89da245fbf9e39a081c Mon Sep 17 00:00:00 2001
From: seeker <seeker8@users.noreply.github.com>
Date: Wed, 11 Sep 2024 13:13:23 -0400
Subject: [PATCH 050/115] [es] Update
 learn/common_questions/design_and_accessibility/common_web_layouts (#23481)

* [es] update common web layouts

* Minnor fixes index.md

* Fix links index.md
---
 .../common_web_layouts/index.md               | 36 ++++++++++---------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/files/es/learn/common_questions/design_and_accessibility/common_web_layouts/index.md b/files/es/learn/common_questions/design_and_accessibility/common_web_layouts/index.md
index 99d13a1cb97e16..30191759ae307f 100644
--- a/files/es/learn/common_questions/design_and_accessibility/common_web_layouts/index.md
+++ b/files/es/learn/common_questions/design_and_accessibility/common_web_layouts/index.md
@@ -1,28 +1,30 @@
 ---
 title: ¿Qué contienen los diseños web comunes?
 slug: Learn/Common_questions/Design_and_accessibility/Common_web_layouts
+l10n:
+  sourceCommit: 530c1f54e63834411aa38789b1ac82e3831c4dfa
 ---
 
 {{QuicklinksWithSubPages("Learn/Common_questions")}}
 
-Cuando diseña páginas para su sitio web es bueno tener una idea de los diseños más comunes.
+Cuando diseñas páginas para tú sitio web es bueno tener una idea de los diseños más comunes.
 
-<table>
+<table class="standard-table">
   <tbody>
     <tr>
       <th scope="row">Prerrequisitos:</th>
       <td>
-        Asegúrese que usted ya ha pensado sobre
-        <a href="/es/docs/Learn/Common_questions/Thinking_before_coding"
-          >lo que quiere lograr</a
+        Asegúrate haber pensado
+        <a href="/es/docs/Learn/Common_questions/Design_and_accessibility/Thinking_before_coding"
+          >lo que quieres lograr</a
         >
-        con su proyecto web.
+        con tú proyecto web.
       </td>
     </tr>
     <tr>
       <th scope="row">Objetivo:</th>
       <td>
-        Aprender dónde colocar las cosas en sus páginas web, y cómo hacerlo.
+        Aprender dónde colocar las cosas en tus páginas web, y cómo hacerlo.
       </td>
     </tr>
   </tbody>
@@ -30,9 +32,9 @@ Cuando diseña páginas para su sitio web es bueno tener una idea de los diseño
 
 ## Resumen
 
-Existe una razón para que hablemos sobre diseño web. Se comienza con una página en blanco, y se pueden tomar muchas direcciones. Si no tienes mucha experiencia, comenzar con una página en blanco pudiera ser un poco temible. Nosotros tenemos alrededor de 25 años de experiencia y te daremos algunas reglas básicas para ayudarte a diseñar tu sitio.
+Existe una razón para que hablemos sobre diseño web. Comienzas con una página en blanco, y puedes tomar muchas direcciones. Y si no tienes mucha experiencia, comenzar con una página en blanco puede ser un poco intimidante. Nosotros tenemos alrededor de 25 años de experiencia y te daremos algunas reglas básicas para ayudarte a diseñar tu sitio.
 
-Aún ahora con el nuevo enfoque de la web para móviles, la mayoría de las páginas web principales son construídas a partir de las siguientes partes:
+Aún ahora con el nuevo enfoque de la web para móviles, la mayoría de las páginas web convencionales son construídas a partir de las siguientes partes:
 
 - Encabezado
   - : Visible en la parte superior de cada página de un sitio. Contiene información relevante para todas las páginas (como el nombre del sitio o el logo) y un sistema de navegación fácil de usar.
@@ -63,11 +65,11 @@ La verdadera diversión comienza cuando empiezas a mezclarlos todos juntos.
 
 Estos son solo ejemplos y eres bastante libre de diseñar las cosas como quieras. Puedes notar que mientras el contenido se puede mover alrededor de la pantalla, siempre se mantiene el encabezado (1) en la parte superior y el pie de página (2) en la parte inferior. Además, el contenido principal (A) es lo más importante, así que dale la mayor parte del espacio.
 
-Estas son reglas del juego que puedes aprovechar. Desde luego, existen diseños complejos y excepciones. En otros artículos discutiremos cómo diseñar sitios responsivos (sitios que cambian en dependencia del tamaño de la pantalla) y sitios cuyos diseños varían entre las páginas. Por ahora, es mejor mantener tu diseño consistente en todo tu sitio.
+Estas son reglas generales que puedes aprovechar. Desde luego, existen diseños complejos y excepciones. En otros artículos discutiremos cómo diseñar sitios responsivos (sitios que cambian dependiendo del tamaño de la pantalla) y sitios cuyos diseños varían entre las páginas. Por ahora, es mejor mantener tu diseño consistente en todo tu sitio.
 
 ## Aprendizaje activo
 
-_Aún no hay aprendizaje activo disponible. [Por favor, considere contribuir](/es/docs/MDN/Getting_started)._
+_Aún no hay aprendizaje activo disponible. [Por favor, considere contribuir](/es/docs/MDN/Community/Contributing/Getting_started)._
 
 ## Profundización
 
@@ -83,7 +85,7 @@ Bastante sencillo. Sólo recuerda que muchas personas navegarán por tu sitio de
 
 ### Diseño de dos columnas
 
-**[Abduzeedo](http://abduzeedo.com/typography-mania-261)**, un simple diseño de blog. Los blogs usualmente tienen dos columnas, una para el contenido principal que es más ancha y otra más estrecha para el contenido secundario (como widgets, niveles de navegación secundarios y anuncios).
+Los blogs usualmente tienen dos columnas, una para el contenido principal que es más ancha y otra más estrecha para el contenido secundario (como widgets, niveles de navegación secundarios y anuncios).
 
 ![Example of a 2 column layout for a blog](screenshot-blog.jpg) ![A 2 column layout with the main content on the left column](screenshot-blog-overlay.jpg)
 
@@ -91,11 +93,11 @@ En este ejemplo, mira la imagen (B1) justo debajo del encabezado. Está relacion
 
 ### Es una trampa
 
-**[MICA](http://www.mica.edu/About_MICA.html)**. Este es un poco más complicado. Parece un diseño de tres columnas...
+**[MICA](http://www.mica.edu/About_MICA.html)**. Este es un poco más complicado. Parece un diseño de tres columnas:
 
 ![Example of a false 3 columns layout](screenshot-education.jpg) ![It looks like a 3 columns layout but actually, the aside content is floating around.](screenshot-education-overlay.jpg)
 
-...pero no lo es. B1 y B2 flotan alrededor del contenido principal. Recuerda esa palabra "float"--te acordarás cuando empieces a aprender sobre {{Glossary("CSS")}}.
+Pero no lo es. B1 y B2 flotan alrededor del contenido principal. Recuerda esa palabra "float"--te acordarás cuando empieces a aprender sobre {{Glossary("CSS")}}.
 
 ¿Por qué pensarías que es un diseño de tres columnas? Porque la imagen en la parte superior derecha está en forma de L, porque B1 parece una columna sosteniendo el conenido principal desplazado, y porque la "M" y la "I" del logo MICA crean una línea de fuerza vertical.
 
@@ -103,10 +105,10 @@ Este es un buen ejemplo de diseño clásico que admite cierta creatividad. Los d
 
 ### Un diseño mucho más complicado
 
-**La [Opera de Paris](https://www.operadeparis.fr/en/saison-2014-2015/opera/la-boheme-puccini).**
+**La Opera de Paris**.
 
 ![An example of a tricky layout.](screenshot-opera.jpg) ![This is a 2 column layout but the header is overlaping the main content.](screenshot-opera-overlay.jpg)
 
-Básicamente un diseño de dos columnas, pero notarás muchos ajustes por aquí y por allá que rompen visualmente el diseño. Especialmente, el encabezado se superposiciona a la imagen del contenido principal. La manera en que la curva del menú del encabezado se une con la curva en el fondo de la imagen, hacen que el encabezado y el contenido principal parezcan un solo componente a pesar de que son técnicamente completamente distintos.
+Básicamente un diseño de dos columnas, pero notarás muchos ajustes por aquí y por allá que visualmente rompen el diseño. Especialmente, el encabezado se superposiciona a la imagen del contenido principal. La manera en que la curva del menú del encabezado se une con la curva en el fondo de la imagen, hacen que el encabezado y el contenido principal parezcan un solo componente a pesar de que son técnicamente completamente distintos. El ejemplo de la Opera parece más complejo que el de MICA, pero en realidad es más fácil de implementar (bueno, "fácil" es un concepto relativo).
 
-Como ves, puedes crear maravillosos sitios web incluso sólo con diseños básicos. Échale una mirada a tus propios sitos web favoritos y pregúntate a ti mismo, ¿dónde está el encabezado, el pie de página, el contenido principal y el contenido secundario? Esto te inspirará para tu propio diseño y te dará buenas pistas sobre para cuáles diseños funciona y para cuáles no.
+Como ves, puedes crear maravillosos sitios web incluso sólo con diseños básicos. Échale una mirada a tus sitos web favoritos y pregúntate a ti mismo, ¿dónde está el encabezado, el pie de página, el contenido principal y el contenido secundario? Esto te inspirará para tu propio diseño y te dará buenas pistas sobre para cuáles diseños funciona y para cuáles no.

From 7a9fd9c5790b743bee6dc69a351711bdafabe8dc Mon Sep 17 00:00:00 2001
From: seeker <seeker8@users.noreply.github.com>
Date: Wed, 11 Sep 2024 13:29:50 -0400
Subject: [PATCH 051/115] [es] Update
 learn/javascript/first_steps/silly_story_generator (#23428)

* [es] update silly story generator

* [es] update missing parts

* [es] fix typo
---
 .../silly_story_generator/index.md            | 79 +++++++++++--------
 1 file changed, 46 insertions(+), 33 deletions(-)

diff --git a/files/es/learn/javascript/first_steps/silly_story_generator/index.md b/files/es/learn/javascript/first_steps/silly_story_generator/index.md
index 92a0268ed8a11b..cc7785cc0ab89e 100644
--- a/files/es/learn/javascript/first_steps/silly_story_generator/index.md
+++ b/files/es/learn/javascript/first_steps/silly_story_generator/index.md
@@ -1,40 +1,57 @@
 ---
 title: Generador de historias absurdas
 slug: Learn/JavaScript/First_steps/Silly_story_generator
+l10n:
+  sourceCommit: bc0d0d1ef796435e969f6d65c7e5d3c08f4023aa
 ---
 
 {{LearnSidebar}}{{PreviousMenu("Learn/JavaScript/First_steps/Arrays", "Learn/JavaScript/First_steps")}}
 
 En esta evaluación, deberás tomar parte del conocimiento que has aprendido en los artículos de este módulo y aplicarlo a la creación de una aplicación divertida que genere historias aleatorias. ¡Que te diviertas!
 
-| Prerrequisitos: | Antes de intentar esta evaluación, deberías haber revisado todos los artículos de este módulo.                  |
-| --------------- | --------------------------------------------------------------------------------------------------------------- |
-| Objetivo:       | Probar la comprensión de los fundamentos de JavaScript, como variables, números, operadores, cadenas y matrices |
+<table>
+  <tbody>
+    <tr>
+      <th scope="row">Prerrequisitos:</th>
+      <td>
+        Antes de intentar esta evaluación, deberías haber revisado todos los artículos de este módulo.
+      </td>
+    </tr>
+    <tr>
+      <th scope="row">Objetivo:</th>
+      <td>
+        Probar la comprensión de los fundamentos de JavaScript, como variables, números, operadores, cadenas y arreglos.
+      </td>
+    </tr>
+  </tbody>
+</table>
 
 ## Punto de partida
 
-Para iniciar esta evaluación, debe:
+Para iniciar esta evaluación, debes:
 
-- Vaya y [tome el archivo HTML](https://github.com/mdn/learning-area/blob/master/javascript/introduction-to-js-1/assessment-start/index.html) para el ejemplo y guarde una copia local de este como `index.html` en un directorio nuevo en algún lugar de su computadora. Esto también tiene el CSS para estilizar el ejemplo que contiene.
-- Vaya a la [página que contiene el texto sin procesar](https://github.com/mdn/learning-area/blob/master/javascript/introduction-to-js-1/assessment-start/raw-text.txt) y manténgalo abierto en una pestaña separada del navegador en algún lugar. Lo necesitarás más tarde.
+- Ir y [tomar el archivo HTML](https://github.com/mdn/learning-area/blob/master/javascript/introduction-to-js-1/assessment-start/index.html) para el ejemplo y guarda una copia local de este, como `index.html` en un directorio nuevo en algún lugar de tú computadora. Esto también tiene el CSS para estilizar el ejemplo que contiene.
+- Ve a la [página que contiene el texto sin procesar](https://github.com/mdn/learning-area/blob/master/javascript/introduction-to-js-1/assessment-start/raw-text.txt) y mantenlo abierto en una pestaña separada del navegador en algún lugar. Lo necesitarás más tarde.
+
+Alternativamente, puede usar un sitio como [CodePen](https://codepen.io/), [JSFiddle](https://jsfiddle.net/), or [Glitch](https://glitch.com/). Puedes pegar el HTML, CSS y JavaScript en uno de estos editores en línea. Si el editor en línea que estas utilizando no tiene un panel de JavaScript separado, no dude en colocarlo en línea en un elemento `<script>` dentro de la página HTML.
 
 > [!NOTE]
-> Alternativamente, puede usar un sitio como [JSBin](https://jsbin.com/) o [Glitch](https://glitch.com/) para hacer su evaluación. Puede pegar el HTML, CSS y JavaScript en uno de estos editores en línea. Si el editor en línea que está utilizando no tiene un panel de JavaScript separado, no dude en colocarlo en línea en un elemento `<script>` dentro de la página HTML.
+> Si tienes algún problema, puedes contactarnos a través de nuestros [canales de comunicación](/es/docs/MDN/Community/Communication_channels).
 
 ## Resumen del proyecto
 
-Se le han proporcionado algunos HTML / CSS en bruto y algunas cadenas de texto y funciones de JavaScript; necesita escribir el JavaScript necesario para convertir esto en un programa de trabajo, que hace lo siguiente:
+Se te han proporcionado algunos HTML / CSS en bruto y algunas cadenas de texto y funciones de JavaScript; necesitas escribir el JavaScript necesario para convertir esto en un programa funcional, que hace lo siguiente:
 
-- Genera una historia tonta cuando se presiona el botón "Generar historia aleatoria".
-- Reemplaza el nombre predeterminado "Bob" en la historia con un nombre personalizado, solo si se ingresa un nombre personalizado en el campo de texto "Ingresar nombre personalizado" antes de presionar el botón Generar.
-- Convierte las cantidades y unidades de peso y temperatura predeterminadas de los EE. UU. En la historia en equivalentes del Reino Unido del botón de opción del Reino Unido, antes de presionar el botón de generar.
+- Genera una historia tonta cuando se presiona el botón "Generate random story".
+- Reemplaza el nombre predeterminado "Bob" en la historia con un nombre personalizado, solo si se ingresa un nombre personalizado en el campo de texto "Enter custom name" antes de presionar el botón de generar.
+- Convierte las cantidades y unidades de peso y temperatura predeterminadas de los EE. UU. (US) en la historia en equivalentes del Reino Unido (UK), si el botón de selección del Reino Unido es seleccionado, antes de presionar el botón de generar.
 - Generará otra historia tonta al azar si presionas el botón otra vez (y otra vez ...)
 
 La siguiente captura de pantalla muestra un ejemplo de lo que debería producir el programa terminado:
 
 ![](screen_shot_2018-09-19_at_10.01.38_am.png)
 
-Para darle más idea, eche un vistazo al ejemplo final (¡no mire el código fuente!)
+Para darte una mejor idea, [echa un vistazo al ejemplo final](https://mdn.github.io/learning-area/javascript/introduction-to-js-1/assessment-finished/) (¡no mires el código fuente!)
 
 ## Etapas para completar
 
@@ -43,55 +60,51 @@ En las siguientes secciones se describe lo que hay que hacer.
 Configuración básica:
 
 1. Crear un nuevo archivo llamado `main.js`, en el mismo directorio que tu archivo `index.html`.
-2. Aplicar el archivo JavaScript externo a tu HTML insertando un elemento {{htmlelement("script")}} en tu HTML haciendo referencia a `main.js`. Póngalo justo antes de la etiquette de cierra `</body>`.
+2. Aplicar el archivo JavaScript externo a tu HTML insertando un elemento {{htmlelement("script")}} en tu HTML haciendo referencia a `main.js`. Pónlo justo antes de la etiqueta de cierre `</body>`.
 
 Variables y funciones iniciales:
 
-1. en el archivo de texto sin procesar, copia todo el código bajo el encabezado "1. COMPLETE VARIABLE AND FUNCTION DEFINITIONS" y pégalo en la parte superior del archivo main.js. Esto te dará tres variables que almacenan las referencias al campo de texto "Enter custom name" (`customName`), el botón "Generate random story" (`randomize`), y el elemento {{htmlelement("p")}} al fondo del cuerpo HTML en el que la historia será copiada en (`story`), respectivamente. Además, obtendrás una funcion llamada `randomValueFromArray()` que toma un array, y devuelve uno de los items guardados dentro del array al azar.
+1. En el archivo de texto sin procesar, copia todo el código bajo el encabezado "1. COMPLETE VARIABLE AND FUNCTION DEFINITIONS" y pégalo en la parte superior del archivo main.js. Esto te dará tres variables que almacenan las referencias al campo de texto "Enter custom name" (`customName`), el botón "Generate random story" (`randomize`), y el elemento {{htmlelement("p")}} al fondo del cuerpo HTML en el que la historia será copiada en (`story`), respectivamente. Además, obtendrás una funcion llamada `randomValueFromArray()` que toma un arreglo, y devuelve uno de los elementos guardados dentro del arreglo al azar.
 2. Ahora observa la segunda sección del archivo de texto sin procesar — "2. RAW TEXT STRINGS". Esta contiene cadenas de texto que actuarán como entrada en nuestro programa. Nos gustaría que mantengas estas variables internas dentro del archivo `main.js`:
 
    1. Almacena la primera, la más larga, cadena de texto dentro de una variable llamada `storyText`.
-   2. Almacena el primer conjunto de tres cadenas dentro de un array llamado `insertX`.
-   3. Almacena el segundo conjunto de tres cadenas dentro de un array llamado `insertY`.
-   4. Almacena el tercer conjunto de tres cadenas dentro de un array llamado `insertZ`.
+   2. Almacena el primer conjunto de tres cadenas dentro de un arreglo llamado `insertX`.
+   3. Almacena el segundo conjunto de tres cadenas dentro de un arreglo llamado `insertY`.
+   4. Almacena el tercer conjunto de tres cadenas dentro de un arreglo llamado `insertZ`.
 
 Colocar el controlador de evento y la función incompleta:
 
 1. Ahora regresa al archivo de texto sin procesar.
 2. Copia el código encontrado bajo el encabezado "3. EVENT LISTENER AND PARTIAL FUNCTION DEFINITION" y pégalo al fondo de tu archivo `main.js` . Esto:
 
-   - Añade un detector de eventos a la variable `randomize`, de manera que cuando al botón que esta representa se le haya dado un click, la función `result()` funcione.
-   - Añade una definición de la función parcialmente completada `result()` a tu código. Por el resto de la evaluación, deberás llenar en líneas dentro de esta función para completarla y hacer que trabaje adecuadamente.
+   - Añade un detector de eventos a la variable `randomize`, de manera que cuando al botón que esta representa se le haya dado un clic, la función `result()` se ejecute.
+   - Añade una definición de la función parcialmente completada `result()` a tu código. Por el resto de la evaluación, vas a escribir tú código dentro de esta función para completarla y hacer que funcione adecuadamente.
 
 Completando la función `result()`:
 
 1. Crear una nueva variable llamada `newStory`, y establezca su valor igual a `storyText`. Esto es necesario para que podamos crear una nueva historia aleatoria cada vez que se presiona el botón y se ejecuta la función. Si hiciéramos cambios directamente en `storyText`, solo podríamos generar una nueva historia una vez.
-2. Crear tres nuevas variables llamadas `xItem`, `yItem`, y `zItem`, y tienes que igualar cada variable llamando a `randomValueFromArray()` en sus tres matrices (el resultado en cada caso será un elemento aleatorio de cada matriz en la que se llama). Por ejemplo, puede llamar a la función y hacer que devuelva una cadena aleatoria de `insertX` escribiendo `randomValueFromArray(insertX)`.
-3. A continuación, queremos reemplazar los tres marcadores de posición en la cadena `newStory` — `:insertx:`, `:inserty:`, y `:insertz:` — con las cadenas almacenadas en `xItem`, `yItem`, y `zItem`. Hay un método de string en particular que lo ayudará aquí: en cada caso, haga que la llamada al método sea igual a `newStory` de modo que cada vez que se llame, `newStory` se iguale a sí mismo, pero con sustituciones. Entonces, cada vez que se presiona el botón, estos marcadores de posición se reemplazan con una cadena absurda aleatoria. Como sugerencia adicional, el método en cuestión solo reemplaza la primera instancia de la subcadena que encuentra, por lo que es posible que deba realizar una de las llamadas dos veces.
+2. Crear tres nuevas variables llamadas `xItem`, `yItem`, y `zItem`, y tienes que igualar cada variable al resultado de la llamanda a `randomValueFromArray()` en tus tres matrices (el resultado en cada caso será un elemento aleatorio de cada matriz en la que se llama). Por ejemplo, puedes llamar a la función y hacer que devuelva una cadena aleatoria de `insertX` escribiendo `randomValueFromArray(insertX)`.
+3. A continuación, queremos reemplazar los tres marcadores de posición en la cadena `newStory` — `:insertx:`, `:inserty:`, y `:insertz:` — con las cadenas almacenadas en `xItem`, `yItem`, y `zItem`. Hay dos posibles métodos de cadena que te ayudarán aquí: en cada caso, haga que la llamada al método sea igual a `newStory` de modo que cada vez que se llame, `newStory` se iguale a sí mismo, pero con sustituciones. Entonces, cada vez que se presiona el botón, estos marcadores de posición se reemplazan con una cadena absurda aleatoria. Como sugerencia adicional, dependiendo de el método que elijas, es posible que debas realizar una de las llamadas dos veces.
 4. Dentro del primer bloque `if`, agregue otra llamada al método de reemplazo de cadena para reemplazar el nombre 'Bob' que se encuentra en la cadena `newStory` con la variable de `name`. En este bloque estamos diciendo "Si se ingresó un valor en la entrada de texto `customName` reemplace a Bob en la historia con ese nombre personalizado."
-5. Dentro del segundo bloque `if`, se esta verificando si se ha seleccionado el botón de opción `uk` Si es así, queremos convertir los valores de peso y temperatura en la historia de libras and Fahrenheit a stones and grados centígrados. Lo que debe hacer es lo siguiente:
+5. Dentro del segundo bloque `if`, verificamos si se ha seleccionado el botón de opción `uk`. Si es así, queremos convertir los valores de peso y temperatura en la historia de libras y Fahrenheit a piedras y grados centígrados. Lo que debe hacer es lo siguiente:
 
-   1. Busque las fórmulas para convertir libras a stone, and Fahrenheit en grados centígrados.
-   2. Dentro de la línea que define la variable de `weight`, reemplace 300 con un cálculo que convierta 300 libras en stones. Concatenar `'stone'` al final del resultado de la llamada `Math.round()`.
-   3. Al lado de la línea que define la variable de `temperature`, reemplace 94 con un cálculo que convierta 94 Fahrenheit en centígrados. Concatenar `'centigrade'` al final del resultado de la llamada `Math.round()`.
-   4. Justo debajo de las dos definiciones de variables, agregue dos líneas de reemplazo de cadena más que reemplacen '94 fahrenheit 'con el contenido de la variable de `temperature`, y '300 libras' con el contenido de la variable de `weight`.
+   1. Busque las fórmulas para convertir libras a piedras, y Fahrenheit en grados centígrados.
+   2. Dentro de la línea que define la variable `weight`, reemplace 300 con un cálculo que convierta 300 libras en piedras. Concatenar `'stone'` al final del resultado de la llamada `Math.round()`.
+   3. Al lado de la línea que define la variable `temperature`, reemplace 94 con un cálculo que convierta 94 Fahrenheit en centígrados. Concatenar `'centigrade'` al final del resultado de la llamada `Math.round()`.
+   4. Justo debajo de las dos definiciones de variables, agregue dos líneas de reemplazo de cadena más, que reemplacen '94 fahrenheit' con el contenido de la variable `temperature`, y '300 libras' con el contenido de la variable `weight`.
 
-6. Finalmente, en la penúltima línea de la función, haga que la propiedad `textContent` de la variable de la `story` (que hace referencia al párrafo) sea igual a `newStory`.
+6. Finalmente, en la penúltima línea de la función, haga que la propiedad `textContent` de la variable `story` (que hace referencia al párrafo) sea igual a `newStory`.
 
 ## Claves y pistas
 
 - No necesitas modificar el HTML, salvo para incrustar el JavaScript a tu HTML.
-- Si no estás seguro si el JavaScript está siendo aplicado adecuadamente a tu HTML, intenta remover temporalmente todo el codigo del archivo JavaScript, agregar una instruccion simple que sabes que tendrá un efecto obvio, luego guarda y actualiza. El siguiente ejemplo cambia el fondo de {{htmlelement("html")}} - así la ventana se verá completamente roja si el JavaScript está siendo aplicado adecuadamente.:
+- Si no estás seguro si el JavaScript está siendo aplicado adecuadamente a tu HTML, intenta remover temporalmente todo el codigo del archivo JavaScript, agrega una instruccion simple que sabes que tendrá un efecto obvio, luego guarda y actualiza. El siguiente ejemplo cambia el fondo de el elemento {{htmlelement("html")}} - así la ventana se verá completamente roja si el JavaScript está siendo aplicado adecuadamente:
 
   ```js
   document.querySelector("html").style.backgroundColor = "red";
   ```
 
 - [Math.round()](/es/docs/Web/JavaScript/Reference/Global_Objects/Math/round) es un método JavaScript integrado que simplemente redondea el resultado de un cálculo al número entero más cercano.
-- Hay tres casos de cadenas que deben reemplazarse. Puede repetir el método `replace()` varias veces o puede utilizar expresiones regulares. Por ejemplo, `let text = 'I am the biggest lover, I love my love'; text.replace(/love/g,'like');` Reemplazará todas las instancias de 'love' a 'like'. Recuerde, las cuerdas son inmutables.
-
-## Evaluación o ayuda adicional
-
-Si está siguiendo esta evaluación como parte de un curso organizado, debería poder entregar su trabajo a su profesor/mentor para que lo califique. Si está aprendiendo por ti mismo, puede obtener la guía de calificación con bastante facilidad preguntando en el hilo de [discussion thread for this exercise](https://discourse.mozilla.org/t/silly-story-generator-assessment/24686), o en el canal de IRC [#mdn](irc://irc.mozilla.org/mdn) en [Mozilla IRC](https://wiki.mozilla.org/IRC). Pruebe el ejercicio primero: ¡no se gana nada haciendo trampa!
+- Hay tres instancias de cadenas que deben reemplazarse. Puede repetir el método `replace()` varias veces o puedes utilizar `replaceAll(). Recuerda, los Strings son inmutables.
 
 {{PreviousMenu("Learn/JavaScript/First_steps/Arrays", "Learn/JavaScript/First_steps")}}

From fa6c1495cdd1ace2a2f0e3496dff84e39cefaf89 Mon Sep 17 00:00:00 2001
From: abing <abing22333@163.com>
Date: Thu, 12 Sep 2024 11:17:32 +0800
Subject: [PATCH 052/115] zh-CN: update 'Video and audio content' (#23516)

Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 .../video_and_audio_content/index.md                   | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md b/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md
index 8022a3069057e3..a683aeacc959e9 100644
--- a/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md
+++ b/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md
@@ -45,7 +45,7 @@ l10n:
 我们不会教你如何制作音频和视频，因为那需要完全不同的技术。如果你没有音频和视频的话，也没有关系，我们为你提供了[示例音频和视频文件以及示例代码](https://github.com/mdn/learning-area/tree/main/html/multimedia-and-embedding/video-and-audio-content)供你实验。
 
 > [!NOTE]
-> 在开始之前，你应当了解一些在线视频提供商，例如 [YouTube](https://www.youtube.com/) 、[Dailymotion](http://www.dailymotion.com) 、[Vimeo](https://vimeo.com/) 还有 [Bilibili](https://www.bilibili.com)，以及在线音频提供商，例如 [Soundcloud](https://soundcloud.com/)。这些公司可以让你以方便、简单的方式来托管和消费视频，所以你不必担心庞大的带宽消耗。在线视频提供商甚至提供现成的代码用于为你的 web 网页嵌入视频/音频。如果你使用这样的服务，你便可以避免在这篇文章中我们讨论的一些难题。在下一篇文章中，我们将会再讨论这样的服务。
+> 在开始之前，你应当了解一些在线视频提供商，例如 [YouTube](https://www.youtube.com/)、[Dailymotion](http://www.dailymotion.com/)、[Vimeo](https://vimeo.com/) 还有 [Bilibili](https://www.bilibili.com)，以及在线音频提供商，例如 [Soundcloud](https://soundcloud.com/)。这些公司可以让你以方便、简单的方式来托管和消费视频，所以你不必担心庞大的带宽消耗。在线视频提供商甚至提供现成的代码用于为你的 web 网页嵌入视频/音频。如果你使用这样的服务，你便可以避免在这篇文章中我们讨论的一些难题。在下一篇文章中，我们将会再讨论这样的服务。
 
 ### \<video> 元素
 
@@ -59,7 +59,7 @@ l10n:
 </video>
 ```
 
-当中值得注意的有：
+值得注意的特性有：
 
 - [`src`](/zh-CN/docs/Web/HTML/Element/video#src)
   - : 同 {{htmlelement("img")}} 元素的使用方式相同，`src`（来源）属性指向你想要嵌入到网页中的视频资源，它们的运作方式完全相同。
@@ -244,7 +244,7 @@ WEBVTT
 
 要让其与 HTML 媒体一起显示，你需要做如下工作：
 
-1. 将其保存为 `.vtt` 文件，放在合理的位置。
+1. 将其保存为 `.vtt` 文件，放在服务器可以提供服务的地方（见下文），例如和 HTML 文件放在同一文件夹。
 2. 用 {{htmlelement("track")}} 标签链接 `.vtt` 文件，`<track>` 标签需放在 `<audio>` 或 `<video>` 标签当中，同时需要放在所有 `<source>` 标签之后。使用 [`kind`](/zh-CN/docs/Web/HTML/Element/track#kind) 属性来指明是 `subtitles`、`captions` 还是 `descriptions`。然后，使用 [`srclang`](/zh-CN/docs/Web/HTML/Element/track#srclang) 来告诉浏览器你是用什么语言来编写的 subtitles。最后，添加 [`label`](/zh-CN/docs/Web/HTML/Element/track#label)，以帮助读者在查找时识别语言。
 
 如下是例子：
@@ -257,11 +257,11 @@ WEBVTT
 </video>
 ```
 
-上面这串代码会显示一段带有字幕的视频，如下：
+为了尝试这种方法，需要在[本地 HTTP 服务器](/zh-CN/docs/Learn/Common_questions/Tools_and_setup/set_up_a_local_testing_server)上托管文件。在浏览器的输出中，会看到一个显示字幕的视频，有点像这样：
 
 ![视频播放器带有标准的控制功能，如播放、停止、音量和字幕开关。播放的视频显示了一名男子手持长矛状武器的场景，标题为“Esta hoja tiene pasado oscuro”。](video-player-with-captions.png)
 
-如果你想了解更多细节，你可以阅读[为 HTML 视频添加标题和字幕](/zh-CN/Apps/Build/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video)。在 Github 上你可以找到[与本文相关的样例](https://iandevlin.github.io/mdn/video-player-with-captions/)，它们由 Ian Devlin 编写（或者[查看源代码](https://github.com/iandevlin/iandevlin.github.io/tree/master/mdn/video-player-with-captions)）。这个样例使用了 JavaScript 代码，用户借此可以选择不同的字幕。注意，若想要显示字幕，你需要点击“CC”按钮，并且选择某个选项（English、Deutsch 或 Español）。
+更多细节，包括如何添加标签，请阅读[为 HTML 视频添加标题和字幕](/zh-CN/docs/Web/Media/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video)。在 Github 上可以找到[与本文相关的样例](https://iandevlin.github.io/mdn/video-player-with-captions/)，它们由 Ian Devlin 编写（或者[查看源代码](https://github.com/iandevlin/iandevlin.github.io/tree/master/mdn/video-player-with-captions)）。这个样例使用了 JavaScript 代码，用户借此可以选择不同的字幕。注意，若想要显示字幕，你需要点击“CC”按钮，并且选择某个选项（English、Deutsch 或 Español）。
 
 > [!NOTE]
 > 文本轨道还可以帮助你进行 {{glossary("SEO")}}，因为搜索引擎对文字特别感兴趣。搜索引擎甚至可以借助文本轨道直接链接到视频中的某个位置。

From 960f21a26b0b671aeec6dd521d363907f2027a1d Mon Sep 17 00:00:00 2001
From: Chunhui Fu <fuchuhu7@gmail.com>
Date: Thu, 12 Sep 2024 16:28:26 +0800
Subject: [PATCH 053/115] [zh-cn]: create docs for HTMLTableSectionElement
 (#23377)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../htmltablesectionelement/align/index.md    |  41 ++++++
 .../api/htmltablesectionelement/ch/index.md   |  31 +++++
 .../htmltablesectionelement/choff/index.md    |  31 +++++
 .../deleterow/index.md                        | 124 +++++++++++++++++
 .../web/api/htmltablesectionelement/index.md  |  48 +++++++
 .../insertrow/index.md                        | 128 ++++++++++++++++++
 .../api/htmltablesectionelement/rows/index.md | 108 +++++++++++++++
 .../htmltablesectionelement/valign/index.md   |  45 ++++++
 8 files changed, 556 insertions(+)
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/align/index.md
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/ch/index.md
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/choff/index.md
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/deleterow/index.md
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/index.md
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/insertrow/index.md
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/rows/index.md
 create mode 100644 files/zh-cn/web/api/htmltablesectionelement/valign/index.md

diff --git a/files/zh-cn/web/api/htmltablesectionelement/align/index.md b/files/zh-cn/web/api/htmltablesectionelement/align/index.md
new file mode 100644
index 00000000000000..b711d0afb03b35
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/align/index.md
@@ -0,0 +1,41 @@
+---
+title: HTMLTableSectionElement：align 属性
+slug: Web/API/HTMLTableSectionElement/align
+l10n:
+  sourceCommit: d16706e4e930c57161d473287374a9286c663147
+---
+
+{{APIRef("HTML DOM")}}{{deprecated_header}}
+
+{{domxref("HTMLTableSectionElement")}} 接口的 **`align`** 属性是一个指示如何在 {{htmlelement("thead")}}、{{htmlelement("tbody")}} 或 {{htmlelement("tfoot")}} 表格部分水平对齐文本的字符串，单个行和单元格可以覆盖它。
+
+> [!NOTE]
+> 此属性已弃用，应使用 CSS 在单元格中水平对齐文本。使用 CSS {{cssxref("text-align")}} 属性，其用于水平对齐单元格中文本，且优先级更高。
+
+## 值
+
+可能的值：
+
+- `left`
+  - : 将文本向左对齐。使用 `text-align: left` 代替。
+- `right`
+  - : 将文本向右对齐。使用 `text-align: right` 代替。
+- `center`
+  - : 将文本居中对齐。使用 `text-align: center` 代替。
+
+## 示例
+
+使用 CSS `text-align` 替代，{{cssxref("text-align")}} 页面有一个[示例](/zh-CN/docs/Web/CSS/text-align#表格对齐)。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{cssxref("text-align")}}
+- [样式化表格](/zh-CN/docs/Learn/CSS/Building_blocks/Styling_tables)
diff --git a/files/zh-cn/web/api/htmltablesectionelement/ch/index.md b/files/zh-cn/web/api/htmltablesectionelement/ch/index.md
new file mode 100644
index 00000000000000..42871e94630e90
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/ch/index.md
@@ -0,0 +1,31 @@
+---
+title: HTMLTableSectionElement：ch 属性
+slug: Web/API/HTMLTableSectionElement/ch
+l10n:
+  sourceCommit: d16706e4e930c57161d473287374a9286c663147
+---
+
+{{APIRef("HTML DOM")}}{{deprecated_header}}
+
+{{domxref("HTMLTableSectionElement")}} 接口的 **`ch`** 属性什么都不做，它反映 section 元素的 `char` 属性。
+
+> [!NOTE]
+> 此属性旨在支持将表格单元格内容对齐到特定字符（通常是小数点），但浏览器从未实现过。
+>
+> 要实现这种对齐，请注意 {{cssxref("text-align")}} CSS 属性对字符串值的支持。
+
+## 值
+
+单个字符。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{cssxref("text-align")}}
diff --git a/files/zh-cn/web/api/htmltablesectionelement/choff/index.md b/files/zh-cn/web/api/htmltablesectionelement/choff/index.md
new file mode 100644
index 00000000000000..904ac628d2b597
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/choff/index.md
@@ -0,0 +1,31 @@
+---
+title: HTMLTableSectionElement：chOff 属性
+slug: Web/API/HTMLTableSectionElement/chOff
+l10n:
+  sourceCommit: d16706e4e930c57161d473287374a9286c663147
+---
+
+{{APIRef("HTML DOM")}}{{deprecated_header}}
+
+{{domxref("HTMLTableSectionElement")}} 接口的 **`chOff`** 属性什么都不做，它反映 section 元素的 `charoff` 属性。
+
+> [!NOTE]
+> 此属性旨在支持将表格单元格内容对齐到特定字符（通常是小数点），但浏览器从未实现过。
+>
+> 要实现这种对齐，请注意 {{cssxref("text-align")}} CSS 属性对字符串值的支持。
+
+## 值
+
+一个整数。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{cssxref("text-align")}}
diff --git a/files/zh-cn/web/api/htmltablesectionelement/deleterow/index.md b/files/zh-cn/web/api/htmltablesectionelement/deleterow/index.md
new file mode 100644
index 00000000000000..893797ec06d4e3
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/deleterow/index.md
@@ -0,0 +1,124 @@
+---
+title: HTMLTableSectionElement：deleteRow() 方法
+slug: Web/API/HTMLTableSectionElement/deleteRow
+l10n:
+  sourceCommit: 1197521ff42256b9d298144330cfd5b6e0d98c33
+---
+
+{{APIRef("HTML DOM")}}
+
+{{domxref("HTMLTableSectionElement")}} 接口的 **`deleteRow()`** 方法从给定的 {{HtmlElement("section")}} 中移除特定的行（{{HtmlElement("tr")}}）。
+
+## 语法
+
+```js-nolint
+deleteRow(index)
+```
+
+### 参数
+
+- `index`
+  - : `index` 是一个表示应该删除行的整数。然而，特殊索引 `-1` 可以用于删除当前分段的最后一行。
+
+### 返回值
+
+无（{{jsxref("undefined")}}）。
+
+### 异常
+
+- `IndexSizeError` {{domxref("DOMException")}}
+  - : 如果 `index` 大于等于行数或小于 `-1`，则抛出该异常。
+
+## 示例
+
+在这个示例中，有两个按钮允许你对表格主体添加和移除行，它还使用表中当前行数更新 {{HTMLElement("output")}} 元素。
+
+### HTML
+
+```html
+<table>
+  <thead>
+    <th>列 1</th>
+    <th>列 2</th>
+    <th>列 3</th>
+  </thead>
+  <tbody>
+    <tr>
+      <td>X</td>
+      <td>Y</td>
+      <td>Z</td>
+    </tr>
+  </tbody>
+</table>
+<button id="add">添加一行</button>
+<button id="remove">移除最后一行</button>
+<div>表格主体有 <output>1</output> 行。</div>
+```
+
+```css hidden
+table {
+  border-collapse: collapse;
+}
+
+th,
+td {
+  border: 1px solid black;
+}
+
+button {
+  margin: 1em 1em 1em 0;
+}
+```
+
+### JavaScript
+
+```js
+// 获取相关接口元素
+const bodySection = document.querySelectorAll("tbody")[0];
+const rows = bodySection.rows; // 集合是动态的，因此其总是最新的
+const rowNumberDisplay = document.querySelectorAll("output")[0];
+
+const addButton = document.getElementById("add");
+const removeButton = document.getElementById("remove");
+
+function updateRowNumber() {
+  rowNumberDisplay.textContent = rows.length;
+}
+
+addButton.addEventListener("click", () => {
+  // 在主体的末尾添加一个新行
+  const newRow = bodySection.insertRow();
+
+  // 在新行内添加单元格
+  ["A", "B", "C"].forEach(
+    (elt) => (newRow.insertCell().textContent = `${elt}${rows.length}`),
+  );
+
+  // 更新行计数
+  updateRowNumber();
+});
+
+removeButton.addEventListener("click", () => {
+  // 从主体删除行
+  bodySection.deleteRow(-1);
+
+  // 更新行计数
+  updateRowNumber();
+});
+```
+
+### 结果
+
+{{EmbedLiveSample("示例", "100%", 175)}}
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{domxref("HTMLTableElement.deleteRow()")}}
diff --git a/files/zh-cn/web/api/htmltablesectionelement/index.md b/files/zh-cn/web/api/htmltablesectionelement/index.md
new file mode 100644
index 00000000000000..90f5f396bd8158
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/index.md
@@ -0,0 +1,48 @@
+---
+title: HTMLTableSectionElement
+slug: Web/API/HTMLTableSectionElement
+l10n:
+  sourceCommit: 7e6e5f5d4c1c984af3d4ebf9399042d19eccea1e
+---
+
+{{ APIRef("HTML DOM") }}
+
+**`HTMLTableSectionElement`** 接口提供特定的属性和方法（除了常规 {{domxref("HTMLElement")}} 接口之外，它还可以通过继承来使用），用于操作当前分段——即 HTML 表格中的表头、表尾和主体部分（{{HTMLElement("thead")}}、{{HTMLElement("tfoot")}} 和 {{HTMLElement("tbody")}}）——的布局和呈现。
+
+{{InheritanceDiagram}}
+
+## 实例属性
+
+_从其父接口 {{domxref("HTMLElement")}} 继承属性。_
+
+- {{domxref("HTMLTableSectionElement.align")}} {{deprecated_inline}}
+  - : 一个反映 [`align`](/zh-CN/docs/Web/HTML/Element/tr#align) 属性的字符串枚举值。其指示元素内容相对于周围上下文的对齐方式，可能的值有：`"left"`、`"right"` 和 `"center"`。
+- {{domxref("HTMLTableSectionElement.rows")}} {{ReadOnlyInline}}
+  - : 返回包含 section 中行的动态 {{domxref("HTMLCollection")}}。`HTMLCollection` 是动态的，当添加或删除行时会自动更新。
+- {{domxref("HTMLTableSectionElement.ch")}} {{deprecated_inline}}
+  - : 一个包含单字符的字符串。这个字符是用来对齐某一列所有单元格内容的基准。它反映 [`char`](/zh-CN/docs/Web/HTML/Element/tr#char) 并默认为与语言相关的小数点，例如，英语的默认值为 `'.'`，法语的默认值为 `','`。此属性是可选的，而且没有得到很好的支持。
+- {{domxref("HTMLTableSectionElement.chOff")}} {{deprecated_inline}}
+  - : 一个包含整数的字符串，表示由 `HTMLTableRowElement.ch` 定义的字符的右侧（对于从左到右的文本；或者对于从右到左的文本的左侧）必须保留多少个字符。此属性是可选的，并没有得到很好的支持。
+- {{domxref("HTMLTableSectionElement.vAlign")}} {{deprecated_inline}}
+  - : 一个表示枚举值的字符串，指示单元格内容必须如何对齐。它反映 [`valign`](/zh-CN/docs/Web/HTML/Element/tr#valign) 属性，可以为以下值之一：`"top"`、`"middle"`、`"bottom"` 或 `"baseline"`。
+
+## 实例方法
+
+_从其父接口 {{domxref("HTMLElement")}} 继承方法。_
+
+- {{domxref("HTMLTableSectionElement.deleteRow()")}}
+  - : 删除 section 中与参数给出的 `index` 对应的行。如果 `index` 值是 `-1`，则删除最后一行；如果索引小于 `-1` 或大于集合中的行数，引发值为 `IndexSizeError` 的 {{DOMxRef("DOMException")}}。
+- {{domxref("HTMLTableSectionElement.insertRow()")}}
+  - : 返回一个表示 section 新行的 {{DOMxRef("HTMLTableRowElement")}}。它将其插入到行集合中给定索引（`index`）位置的 {{HTMLElement("tr")}} 元素之前。如果 `index` 是 `-1`，则新行添加到集合末尾，如果 `index` 小于 `-1` 或大于集合的行数，则引发值为 `IndexSizeError` 的 {{DOMxRef("DOMException")}}。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- 实现此接口的 HTML 元素：{{HTMLElement("tfoot")}}、{{HTMLElement("thead")}} 和 {{HTMLElement("tbody")}}。
diff --git a/files/zh-cn/web/api/htmltablesectionelement/insertrow/index.md b/files/zh-cn/web/api/htmltablesectionelement/insertrow/index.md
new file mode 100644
index 00000000000000..0b5ed111dd9d77
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/insertrow/index.md
@@ -0,0 +1,128 @@
+---
+title: HTMLTableSectionElement：insertRow() 方法
+slug: Web/API/HTMLTableSectionElement/insertRow
+l10n:
+  sourceCommit: 1197521ff42256b9d298144330cfd5b6e0d98c33
+---
+
+{{APIRef("HTML DOM")}}
+
+{{domxref("HTMLTableSectionElement")}} 接口的 **`insertRow()`** 方法在给定的表格分段元素（{{HTMLElement("thead")}}、{{HTMLElement("tfoot")}} 或 {{HTMLElement("tbody")}}）插入一个新行（{{HtmlElement("tr")}}），然后返回新行的引用。
+
+> **备注：** `insertRow()` 将行直接插入到分段（section）中，该行不需要像使用 {{domxref("Document.createElement()")}} 创建新的 `<tr>` 元素那样单独追加。
+
+## 语法
+
+```js-nolint
+insertRow()
+insertRow(index)
+```
+
+### 参数
+
+- `index` {{optional_inline}}
+  - : 新行的行索引，如果 `index` 是 `-1` 或者等于行数，新行作为最后一行附加。如果省略 `index`，则默认值是 `-1`。
+
+### 返回值
+
+一个引用新行的 {{domxref("HTMLTableRowElement")}}。
+
+### 异常
+
+- `IndexSizeError` {{domxref("DOMException")}}
+  - : 如果 `index` 大于行数或小于 `-1`，则抛出此异常。
+
+## 示例
+
+在这个示例中，有两个按钮允许你对表格主体添加和移除行，它还使用表中当前行数更新 {{HTMLElement("output")}} 元素。
+
+### HTML
+
+```html
+<table>
+  <thead>
+    <th>列 1</th>
+    <th>列 2</th>
+    <th>列 3</th>
+  </thead>
+  <tbody>
+    <tr>
+      <td>X</td>
+      <td>Y</td>
+      <td>Z</td>
+    </tr>
+  </tbody>
+</table>
+<button id="add">添加一行</button>
+<button id="remove">移除最后一行</button>
+<div>表格主体有 <output>1</output> 行。</div>
+```
+
+```css hidden
+table {
+  border-collapse: collapse;
+}
+
+th,
+td {
+  border: 1px solid black;
+}
+
+button {
+  margin: 1em 1em 1em 0;
+}
+```
+
+### JavaScript
+
+```js
+// 获取相关接口元素
+const bodySection = document.querySelectorAll("tbody")[0];
+const rows = bodySection.rows; // 集合是动态的，因此其总是最新的
+const rowNumberDisplay = document.querySelectorAll("output")[0];
+
+const addButton = document.getElementById("add");
+const removeButton = document.getElementById("remove");
+
+function updateRowNumber() {
+  rowNumberDisplay.textContent = rows.length;
+}
+
+addButton.addEventListener("click", () => {
+  // 在主体的末尾添加一个新行
+  const newRow = bodySection.insertRow();
+
+  // 在新行内添加单元格
+  ["A", "B", "C"].forEach(
+    (elt) => (newRow.insertCell().textContent = `${elt}${rows.length}`),
+  );
+
+  // 更新行计数
+  updateRowNumber();
+});
+
+removeButton.addEventListener("click", () => {
+  // 从主体删除行
+  bodySection.deleteRow(-1);
+
+  // 更新行计数
+  updateRowNumber();
+});
+```
+
+### 结果
+
+{{EmbedLiveSample("示例", "100%", 175)}}
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{domxref("HTMLTableRowElement.insertCell()")}}
+- {{domxref("HTMLTableElement.insertRow()")}}
diff --git a/files/zh-cn/web/api/htmltablesectionelement/rows/index.md b/files/zh-cn/web/api/htmltablesectionelement/rows/index.md
new file mode 100644
index 00000000000000..77d9304b95e0ca
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/rows/index.md
@@ -0,0 +1,108 @@
+---
+title: HTMLTableSectionElement：rows 属性
+slug: Web/API/HTMLTableSectionElement/rows
+l10n:
+  sourceCommit: 1197521ff42256b9d298144330cfd5b6e0d98c33
+---
+
+{{APIRef("HTML DOM")}}
+
+{{domxref("HTMLTableSectionElement")}} 接口的 **`rows`** 只读属性返回一个包含当前分段中行属性的动态 {{domxref("HTMLCollection")}}。此 `HTMLCollection` 是动态的，并在添加或移除行时自动更新。
+
+## 值
+
+一个动态 {{domxref("HTMLTableRowElement")}} 的 {{domxref("HTMLCollection")}} 对象。
+
+## 示例
+
+在这个示例中，有两个按钮允许你对表格主体添加和移除行，它还使用表中当前行数更新 {{HTMLElement("output")}} 元素。
+
+### HTML
+
+```html
+<table>
+  <thead>
+    <th>列 1</th>
+    <th>列 2</th>
+    <th>列 3</th>
+  </thead>
+  <tbody>
+    <tr>
+      <td>X</td>
+      <td>Y</td>
+      <td>Z</td>
+    </tr>
+  </tbody>
+</table>
+<button id="add">添加一行</button>
+<button id="remove">移除最后一行</button>
+<div>表格主体有 <output>1</output> 行。</div>
+```
+
+```css hidden
+table {
+  border-collapse: collapse;
+}
+
+th,
+td {
+  border: 1px solid black;
+}
+
+button {
+  margin: 1em 1em 1em 0;
+}
+```
+
+### JavaScript
+
+```js
+// 获取相关接口元素
+const bodySection = document.querySelectorAll("tbody")[0];
+const rows = bodySection.rows; // 集合是动态的，因此其总是最新的
+const rowNumberDisplay = document.querySelectorAll("output")[0];
+
+const addButton = document.getElementById("add");
+const removeButton = document.getElementById("remove");
+
+function updateRowNumber() {
+  rowNumberDisplay.textContent = rows.length;
+}
+
+addButton.addEventListener("click", () => {
+  // 在主体的末尾添加一个新行
+  const newRow = bodySection.insertRow();
+
+  // 在新行内添加单元格
+  ["A", "B", "C"].forEach(
+    (elt) => (newRow.insertCell().textContent = `${elt}${rows.length}`),
+  );
+
+  // 更新行计数
+  updateRowNumber();
+});
+
+removeButton.addEventListener("click", () => {
+  // 从主体删除行
+  bodySection.deleteRow(-1);
+
+  // 更新行计数
+  updateRowNumber();
+});
+```
+
+### 结果
+
+{{EmbedLiveSample("示例", "100%", 175)}}
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{cssxref("text-align")}}
diff --git a/files/zh-cn/web/api/htmltablesectionelement/valign/index.md b/files/zh-cn/web/api/htmltablesectionelement/valign/index.md
new file mode 100644
index 00000000000000..739f9882e3d6e4
--- /dev/null
+++ b/files/zh-cn/web/api/htmltablesectionelement/valign/index.md
@@ -0,0 +1,45 @@
+---
+title: HTMLTableSectionElement：vAlign 属性
+slug: Web/API/HTMLTableSectionElement/vAlign
+l10n:
+  sourceCommit: d16706e4e930c57161d473287374a9286c663147
+---
+
+{{APIRef("HTML DOM")}}{{deprecated_header}}
+
+{{domxref("HTMLTableSectionElement")}} 接口的 **`vAlign`** 属性是一个指示如何在 {{htmlelement("thead")}}、{{htmlelement("tbody")}} 或 {{htmlelement("tfoot")}} 表格部分垂直对齐文本的字符串，单个行和单元格可以覆盖它。
+
+> [!NOTE]
+> 此属性已弃用。请使用 CSS {{cssxref("vertical-align")}} 属性来垂直对齐分段单元格中的文本。
+
+## 值
+
+可能的值有：`"top"`、`"middle"`、`"bottom"` 或 `"baseline"`。
+
+- `top`
+  - : 将文本与单元格顶部对齐。使用 `vertical-align: top` 代替。
+- `center`
+  - : 将文本与单元格垂直居中对齐，`middle` 的同义词。使用 `vertical-align: middle` 代替。
+- `middle`
+  - : 将文本与单元格垂直居中对齐。使用 `vertical-align: middle` 代替。
+- `bottom`
+  - : 将文本与单元格底部对齐。使用 `vertical-align:  bottom` 代替。
+- `baseline`
+  - : 与 `top` 相似，但使文本的基线贴近顶部，这样字符的任何部分都不会超出单元格。
+
+## 示例
+
+使用 CSS {{cssxref("vertical-align")}} 替代，它的优先级更高，如[垂直对齐表格单元格](/zh-CN/docs/Web/CSS/vertical-align#vertical_alignment_in_a_table_cell)示例所示。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
+
+## 参见
+
+- {{cssxref("vertical-align")}}
+- [样式化表格](/zh-CN/docs/Learn/CSS/Building_blocks/Styling_tables)

From f40964abd8dc0c8e28a7eb67443a55ef06dfc754 Mon Sep 17 00:00:00 2001
From: Gahotx <53534938+Gahotx@users.noreply.github.com>
Date: Thu, 12 Sep 2024 16:38:07 +0800
Subject: [PATCH 054/115] [zh-cn]: update the translation of the SVG attribute
 `alignment-baseline` (#23426)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../svg/attribute/alignment-baseline/index.md | 171 +++++++++++++-----
 1 file changed, 123 insertions(+), 48 deletions(-)

diff --git a/files/zh-cn/web/svg/attribute/alignment-baseline/index.md b/files/zh-cn/web/svg/attribute/alignment-baseline/index.md
index 75e37a8829eb04..ab8dc6d223b6c0 100644
--- a/files/zh-cn/web/svg/attribute/alignment-baseline/index.md
+++ b/files/zh-cn/web/svg/attribute/alignment-baseline/index.md
@@ -1,73 +1,148 @@
 ---
 title: alignment-baseline
 slug: Web/SVG/Attribute/alignment-baseline
+l10n:
+  sourceCommit: 5c000c8621145c6915f3d545b505c216317bc64a
 ---
 
 {{SVGRef}}
 
-`alignment-baseline` 属性指定了一个对象如何相对于它的父元素对齐。这个属性指定了该元素的基线对齐到相应的父元素的基线。举个例子，允许罗马文字中的字母表基线在字体大小发生变化时保持一致。它的默认值是 baseline，与该 `alignment-baseline` 属性的计算值同名。
+**`alignment-baseline`** 属性指定了一个对象如何相对于它的父元素对齐。这个属性指定了该元素的基线对齐到相应的父元素的基线。举个例子，允许罗马文字中的字母表基线在字体大小发生变化时保持一致。它的默认值是 baseline，与 `alignment-baseline` 属性的计算值同名。
 
-作为一个外观属性，它还可以直接作为 CSS 样式表内部的属性使用。请阅读 {{ cssxref("alignment-baseline","CSS alignment-baseline") }} 以了解更多信息。
+> [!NOTE]
+> 作为一个表现属性，`alignment-baseline` 可以用作 CSS 属性。
+
+你可以将此属性与以下 SVG 元素一起使用：
+
+- {{SVGElement("tspan")}}
+- {{SVGElement("text")}}
+- {{SVGElement("textPath")}}
 
 ## 使用说明
 
-| 类别     | 外观属性                                                                                                                                                                         |
-| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 值       | **auto** \| baseline \| before-edge \| text-before-edge \| middle \| central \| after-edge \| text-after-edge \| ideographic \| alphabetic \| hanging \| mathematical \| inherit |
-| 可变性   | Yes                                                                                                                                                                              |
-| 规范文档 | [SVG 1.1 (2nd Edition)](http://www.w3.org/TR/SVG11/text.html#AlignmentBaselineProperty)                                                                                          |
+<table class="properties">
+  <tbody>
+    <tr>
+      <th scope="row">值</th>
+      <td>
+        <code>auto</code> | <code>baseline</code> | <code>before-edge</code> |
+        <code>text-before-edge</code> | <code>middle</code> |
+        <code>central</code> | <code>after-edge</code> |
+        <code>text-after-edge</code> | <code>ideographic</code> |
+        <code>alphabetic</code> | <code>hanging</code> |
+        <code>mathematical</code> | <code>top</code> | <code>center</code> |
+        <code>bottom</code>
+      </td>
+    </tr>
+    <tr>
+      <th scope="row">默认值</th>
+      <td><code>auto</code></td>
+    </tr>
+    <tr>
+      <th scope="row">动画性</th>
+      <td>有</td>
+    </tr>
+  </tbody>
+</table>
+
+- `auto` {{deprecated_inline}}
+  - : 该值是字符所属文稿的 dominant-baseline 值——即使用父元素的 dominant-baseline。
+- `baseline`
+  - : 使用父元素的{{Glossary("dominant baseline", "主导基线")}}选择。将盒子的相应{{Glossary("baseline/typography", "基线")}}与其父元素的基线匹配。
+- `before-edge` {{deprecated_inline}}
+  - : 正在对齐的对象的对齐点与父文本内容元素的“before-edge”基线对齐。
+- `text-bottom`
+  - : 将盒子的底部与父元素内容区域的顶部相匹配。
+- `text-before-edge`
+
+  - : 正在对齐的对象的对齐点与父文本内容元素的“text-before-edge”基线对齐。
+
+    > [!NOTE]
+    > 此关键字可能会映射到 `text-top`。
+
+- `middle`
+  - : 将盒子的垂直中点与父盒子的基线加上父盒子 x 轴高度的一半对齐。
+- `central`
+  - : 将盒子的中心基线与其父盒子的中心基线相匹配。
+- `after-edge` {{deprecated_inline}}
+  - : 正在对齐的对象的对齐点与父文本内容元素的“after-edge”基线对齐。
+- `text-top`
+  - : 将盒子的顶部与父级内容区域的顶部相匹配。
+- `text-after-edge`
+
+  - : 正在对齐的对象的对齐点与父文本内容元素的“text-after-edge”基线对齐。
+
+    > [!NOTE]
+    > 此关键字可能会映射到 `text-bottom`。
+
+- `ideographic`
+  - : 将盒子的表意字符面下侧基线与其父盒子的基线相匹配。
+- `alphabetic`
+  - : 将盒子的字母基线与其父盒子的“alphabetic”基线相匹配。
+- `hanging`
+  - : 正在对齐的对象的对齐点与父文本内容元素的“hanging”基线对齐。
+- `mathematical`
+  - : 将盒子的数学基线与其父盒子的“mathematical”基线相匹配。
+- `top`
+  - : 将对齐子树的顶部与盒子的顶部对齐。
+- `center`
+  - : 将对齐子树的中心与盒子的中心对齐。
+- `bottom`
+  - : 将对齐子树的底部与盒子的底部对齐。
+
+SVG 2 对此属性的定义进行了一些更改。特别是：`auto`、`before-edge` 和 `after-edge` 已经被移除。为了向后兼容，`text-before-edge` 可以映射到 `text-top`，`text-after-edge` 映射到 `text-bottom`。`text-before-edge` 和 `text-after-edge` 都不应该与 {{cssxref("vertical-align")}} 属性一起使用。
 
 ## 示例
 
-```plain
-<?xml version="1.0"?>
-<svg width="300" height="120" viewBox="0 0 300 120"
-     xmlns="http://www.w3.org/2000/svg" version="1.1">
-
-    <!-- Materialisation of anchors -->
-    <path d="M60,10 L60,110
-             M30,10 L300,10
-             M30,65 L300,65
-             M30,110 L300,110
-             " stroke="grey" />
-
-    <!-- Anchors in action -->
-    <text alignment-baseline="hanging"
-          x="60" y="10">A hanging</text>
-
-    <text alignment-baseline="middle"
-          x="60" y="65">A middle</text>
-
-    <text alignment-baseline="baseline"
-          x="60" y="110">A baseline</text>
-
-    <!-- Materialisation of anchors -->
-    <circle cx="60" cy="10" r="3" fill="red" />
-    <circle cx="60" cy="65" r="3" fill="red" />
-    <circle cx="60" cy="110" r="3" fill="red" />
-
-<style><![CDATA[
-text{
-    font: bold 36px Verdana, Helvetica, Arial, sans-serif;
-}
-]]></style>
+```html
+<svg
+  width="300"
+  height="120"
+  viewBox="0 0 300 120"
+  xmlns="http://www.w3.org/2000/svg">
+  <!-- 锚点的具体化 -->
+  <path
+    d="M60,10 L60,110
+              M30,10 L300,10
+              M30,65 L300,65
+              M30,110 L300,110
+              "
+    stroke="grey" />
+
+  <!-- 锚点的实际应用 -->
+  <text alignment-baseline="hanging" x="60" y="10">hanging</text>
+
+  <text alignment-baseline="middle" x="60" y="65">middle</text>
+
+  <text alignment-baseline="baseline" x="60" y="110">baseline</text>
+
+  <!-- 锚点的具体化 -->
+  <circle cx="60" cy="10" r="3" fill="red" />
+  <circle cx="60" cy="65" r="3" fill="red" />
+  <circle cx="60" cy="110" r="3" fill="red" />
+
+  <style>
+    <![CDATA[
+      text{
+        font: bold 36px Verdana, Helvetica, Arial, sans-serif;
+      }
+    ]]>
+  </style>
 </svg>
 ```
 
-## 元素
-
-下列元素使用 `alignment-baseline` 属性：
+{{EmbedLiveSample("示例")}}
 
-- {{ SVGElement("tspan") }}
-- {{ SVGElement("tref") }}
-- {{ SVGElement("textPath") }}
-
-如果对象要在别的元素中对齐（比如在{{ SVGElement("text") }}元素中），请阅读{{ SVGAttr("dominant-baseline") }}。
+对于其他元素（如 {{SVGElement("text")}}）的对齐，请参见 {{SVGAttr("dominant-baseline")}}。
 
 ## 规范
 
 {{Specifications}}
 
+## 浏览器兼容性
+
+{{Compat}}
+
 ## 参见
 
-- {{ cssxref("alignment-baseline","CSS alignment-baseline") }}
+- [CSS 基线对齐](/zh-CN/docs/Web/CSS/CSS_box_alignment#基线对齐)

From 567682d70422837e33628a4380405a581f1c942a Mon Sep 17 00:00:00 2001
From: MDN Web Docs GitHub Bot <108879845+mdn-bot@users.noreply.github.com>
Date: Thu, 12 Sep 2024 16:51:03 +0200
Subject: [PATCH 055/115] [ja] sync translated content (#23517)

* ja: sync translated content

* Update _redirects.txt

* Delete files/ja/conflicting/web/css/grid-auto-flow/index.md

---------

Co-authored-by: Masahiro FUJIMOTO <mfujimot@gmail.com>
---
 files/ja/_redirects.txt                     |   1 +
 files/ja/web/css/masonry-auto-flow/index.md | 139 --------------------
 2 files changed, 1 insertion(+), 139 deletions(-)
 delete mode 100644 files/ja/web/css/masonry-auto-flow/index.md

diff --git a/files/ja/_redirects.txt b/files/ja/_redirects.txt
index 0f8b46f52d6a90..e0e316c754739d 100644
--- a/files/ja/_redirects.txt
+++ b/files/ja/_redirects.txt
@@ -3783,6 +3783,7 @@
 /ja/docs/Web/CSS/linear-gradient()	/ja/docs/Web/CSS/gradient/linear-gradient
 /ja/docs/Web/CSS/margin-new	/ja/docs/Web/CSS/margin
 /ja/docs/Web/CSS/margin_collapsing	/ja/docs/Web/CSS/CSS_box_model/Mastering_margin_collapsing
+/ja/docs/Web/CSS/masonry-auto-flow	/ja/docs/Web/CSS/grid-auto-flow
 /ja/docs/Web/CSS/max()	/ja/docs/Web/CSS/max
 /ja/docs/Web/CSS/min()	/ja/docs/Web/CSS/min
 /ja/docs/Web/CSS/minmax()	/ja/docs/Web/CSS/minmax
diff --git a/files/ja/web/css/masonry-auto-flow/index.md b/files/ja/web/css/masonry-auto-flow/index.md
deleted file mode 100644
index 84e2e986e59def..00000000000000
--- a/files/ja/web/css/masonry-auto-flow/index.md
+++ /dev/null
@@ -1,139 +0,0 @@
----
-title: masonry-auto-flow
-slug: Web/CSS/masonry-auto-flow
----
-
-{{CSSRef}}
-
-{{SeeCompatTable}}
-
-**`masonry-auto-flow`** は CSS のプロパティで、[CSS グリッドレイアウト](/ja/docs/Web/CSS/CSS_grid_layout)において[組積](/ja/docs/Web/CSS/CSS_grid_layout/Masonry_layout)を使用する際のアイテムの配置方法を変更します。
-
-## 構文
-
-```css
-/* キーワード値 */
-masonry-auto-flow: pack;
-masonry-auto-flow: next;
-masonry-auto-flow: ordered;
-masonry-auto-flow: definite-first;
-masonry-auto-flow: next ordered;
-
-/* グローバル値 */
-masonry-auto-flow: inherit;
-masonry-auto-flow: initial;
-maosnry-auto-flow: revert;
-masonry-auto-flow: unset;
-```
-
-このプロパティは 2 つの形式のうちの 1 つから成ります。
-
-- 単一のキーワード: `pack`, `next`, `definite-first`, `ordered` のうちの何れか
-- 2 つのキーワード。例えば `next ordered`。
-
-### 値
-
-- `pack`
-  - : 既定の組積アルゴリズムで、アイテムは最も余裕のあるトラックに配置されます。
-- `next`
-  - : アイテムはグリッド軸に次々と配置されていきます。
-- `definite-first`
-  - : 既定の組積アルゴリズムのように、場所が確定しているアイテムを最初に配置してから、他の組積アイテムを配置するように表示します。
-- `ordered`
-  - : 配置が確定しているものは無視して、すべてを order で変更した文書順に従って配置します。
-
-## 公式定義
-
-{{cssinfo}}
-
-## 形式文法
-
-{{csssyntax}}
-
-## 例
-
-### next キーワードの使用
-
-#### HTML
-
-```html
-<div id="grid">
-  <div id="item1"></div>
-  <div id="item2"></div>
-  <div id="item3"></div>
-  <div id="item4"></div>
-  <div id="item5"></div>
-</div>
-<select id="flow">
-  <option value="pack">pack</option>
-  <option value="next">next</option>
-</select>
-```
-
-#### CSS
-
-```css
-#grid {
-  height: 200px;
-  width: 200px;
-  display: grid;
-  gap: 10px;
-  grid-template-columns: repeat(3, 1fr);
-  grid-template-rows: masonry;
-  masonry-auto-flow: pack;
-}
-
-#item1 {
-  background-color: lime;
-  height: 2em;
-}
-
-#item2 {
-  background-color: yellow;
-}
-
-#item3 {
-  background-color: blue;
-  height: 3em;
-}
-
-#item4 {
-  background-color: red;
-  height: 2.5em;
-}
-
-#item5 {
-  background-color: aqua;
-  height: 4em;
-}
-```
-
-```js
-const selectElem = document.querySelector("select");
-
-function changeMasonryFlow() {
-  var grid = document.getElementById("grid");
-  var direction = document.getElementById("flow");
-  var masonryAutoFlow = direction.value === "pack" ? "pack" : "next";
-
-  grid.style.masonryAutoFlow = masonryAutoFlow;
-}
-
-selectElem.addEventListener("change", changeMasonryFlow);
-```
-
-#### 結果
-
-{{EmbedLiveSample("next キーワードの使用", "200px", "230px")}}
-
-## 仕様書
-
-{{Specifications}}
-
-## ブラウザーの互換性
-
-{{Compat}}
-
-## 関連情報
-
-- 関連する CSS プロパティ: {{cssxref("align-tracks")}}, {{cssxref("justify-tracks")}}

From 50eb9521b9070a315f5e9d618e92c3c32596bef6 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 09:28:16 +0900
Subject: [PATCH 056/115] =?UTF-8?q?fetch()=20=E3=81=AE=E8=A8=98=E4=BA=8B?=
 =?UTF-8?q?=E3=81=B8=E3=81=AE=E3=83=AA=E3=83=B3=E3=82=AF=E3=82=92=E4=B8=80?=
 =?UTF-8?q?=E6=8B=AC=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../ja/web/api/baseaudiocontext/decodeaudiodata/index.md  | 8 ++++----
 files/ja/web/api/cache/index.md                           | 4 ++--
 files/ja/web/api/cache/put/index.md                       | 2 +-
 files/ja/web/api/document/lastmodified/index.md           | 2 +-
 files/ja/web/api/fetchevent/request/index.md              | 2 +-
 files/ja/web/api/fetchevent/respondwith/index.md          | 2 +-
 files/ja/web/api/formdata/index.md                        | 2 +-
 files/ja/web/api/html_dom_api/microtask_guide/index.md    | 4 ++--
 .../ja/web/api/htmlscriptelement/attributionsrc/index.md  | 2 +-
 files/ja/web/api/mediasource/endofstream/index.md         | 2 +-
 .../api/performanceresourcetiming/initiatortype/index.md  | 2 +-
 11 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md b/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md
index c3bde80949a1a4..1aa0f2508552d6 100644
--- a/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md
+++ b/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md
@@ -8,7 +8,7 @@ l10n:
 
 {{ APIRef("Web Audio API") }}
 
-`decodeAudioData()` は {{ domxref("BaseAudioContext") }} のメソッドで、 {{jsxref("ArrayBuffer")}} に書き込まれた音声ファイルデータを非同期にデコードするために使用されます。この場合、{{jsxref("ArrayBuffer")}} は {{domxref("fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} などから読み込まれます。デコードされた {{domxref("AudioBuffer")}} は {{domxref("AudioContext")}} のサンプリングレートにリサンプリングされ、コールバックやプロミスに渡されます。
+`decodeAudioData()` は {{ domxref("BaseAudioContext") }} のメソッドで、 {{jsxref("ArrayBuffer")}} に書き込まれた音声ファイルデータを非同期にデコードするために使用されます。この場合、{{jsxref("ArrayBuffer")}} は {{domxref("Window/fetch", "fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} などから読み込まれます。デコードされた {{domxref("AudioBuffer")}} は {{domxref("AudioContext")}} のサンプリングレートにリサンプリングされ、コールバックやプロミスに渡されます。
 
 この方法は、オーディオトラックからウェブオーディオ API 用のオーディオソースを作成する際に推奨される方法です。この方法は、音声ファイルの断片的なデータではなく、完全なファイルデータに対してのみ動作します。
 
@@ -28,7 +28,7 @@ decodeAudioData(arrayBuffer, successCallback, errorCallback)
 ### 引数
 
 - `arrayBuffer`
-  - : デコードする音声データが入った ArrayBuffer です。通常は {{domxref("fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} から取得します。
+  - : デコードする音声データが入った ArrayBuffer です。通常は {{domxref("Window/fetch", "fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} から取得します。
 - `successCallback` {{optional_inline}}
   - : デコードが完了すると呼び出されるコールバック関数です。このコールバックの引数は 1 つで、 {{domxref("AudioBuffer")}} であり _decodedData_ （デコードされた PCM 音声データ）を表します。通常は、デコードされたデータを {{domxref("AudioBufferSourceNode")}} に入れて、そこから再生したり、好きなように操作したりすることができます。
 - `errorCallback` {{optional_inline}}
@@ -44,7 +44,7 @@ _decodedData_ で履行される {{jsxref("Promise") }} オブジェクトです
 
 ### プロミスベースの構文
 
-この例では、 `loadAudio()` は {{domxref("fetch()")}} を使用して音声ファイルを取得し、それを {{domxref("AudioBuffer")}} にデコードします。そして、後で再生できるように `audioBuffer` をグローバル変数 `buffer` にキャッシュします。
+この例では、 `loadAudio()` は {{domxref("Window/fetch", "fetch()")}} を使用して音声ファイルを取得し、それを {{domxref("AudioBuffer")}} にデコードします。そして、後で再生できるように `audioBuffer` をグローバル変数 `buffer` にキャッシュします。
 
 > **メモ:** [完全な例をライブで実行](https://mdn.github.io/webaudio-examples/decode-audio-data/promise/)したり、[ソースを表示](https://github.com/mdn/webaudio-examples/blob/main/decode-audio-data/promise/)したりすることができます。
 
@@ -67,7 +67,7 @@ async function loadAudio() {
 
 ### コールバックの構文
 
-この例では `loadAudio()` は {{domxref("fetch()")}} を用いて音声ファイルを取得し、コールバックベースの `decodeAudioData()` を用いて {{domxref("AudioBuffer")}} にデコードします。コールバックでは、デコードしたバッファーが再生されます。
+この例では `loadAudio()` は {{domxref("Window/fetch", "fetch()")}} を用いて音声ファイルを取得し、コールバックベースの `decodeAudioData()` を用いて {{domxref("AudioBuffer")}} にデコードします。コールバックでは、デコードしたバッファーが再生されます。
 
 > **メモ:** [完全な例をライブで実行](https://mdn.github.io/webaudio-examples/decode-audio-data/callback/)したり、[ソースを表示](https://github.com/mdn/webaudio-examples/blob/main/decode-audio-data/callback/)したりすることができます。
 
diff --git a/files/ja/web/api/cache/index.md b/files/ja/web/api/cache/index.md
index af3f66a3a18863..ea05fc0d74660a 100644
--- a/files/ja/web/api/cache/index.md
+++ b/files/ja/web/api/cache/index.md
@@ -46,7 +46,7 @@ l10n:
 
 そしてこのコードは、 {{domxref("Cache.match()")}} を使用してすでにキャッシュ内に一致するフォントがあるかどうかを確認し、もしあれば、それを返します。一致するフォントがなかった場合は、コードはネットワークからフォントを取得して、 {{domxref("Cache.put()")}} を用いて取得したリソースをキャッシュします。
 
-このコードは {{domxref("fetch()")}} の操作で発生する例外を処理します。なお、 HTTP のエラーレスポンス（404 など）はこの例外を発生させません。適切なエラーコードを持つ通常のレスポンスオブジェクトを返します。
+このコードは {{domxref("Window/fetch", "fetch()")}} の操作で発生する例外を処理します。なお、 HTTP のエラーレスポンス（404 など）はこの例外を発生させません。適切なエラーコードを持つ通常のレスポンスオブジェクトを返します。
 
 このコードスニペットでは、サービスワーカーで使用されるバージョン付きキャッシュのベストプラクティスも示しています。この例ではキャッシュが 1 つしかありませんが、キャッシュが複数でも同じアプローチが利用できます。これはキャッシュの一括指定識別子を、具体的なバージョン付けされたキャッシュ名に対応させます。このコードはまた、 `CURRENT_CACHES` で名前が指定されていないキャッシュをすべて削除します。
 
@@ -172,7 +172,7 @@ self.addEventListener("fetch", (event) => {
 
 ### クッキーとキャッシュオブジェクト
 
-[フェッチ API](/ja/docs/Web/API/Fetch_API) では {{httpheader("Set-Cookie")}} ヘッダーを、 {{domxref("Response")}} オブジェクトを {{domxref("fetch()")}} から返す前に削除することを要求しています。したがって、 `Response` は `Cache` へ格納されるとき `Set=Cookie` ヘッダーを含まず、クッキーを格納する操作も行われません。
+[フェッチ API](/ja/docs/Web/API/Fetch_API) では {{httpheader("Set-Cookie")}} ヘッダーを、 {{domxref("Response")}} オブジェクトを {{domxref("Window/fetch", "fetch()")}} から返す前に削除することを要求しています。したがって、 `Response` は `Cache` へ格納されるとき `Set=Cookie` ヘッダーを含まず、クッキーを格納する操作も行われません。
 
 ## 仕様書
 
diff --git a/files/ja/web/api/cache/put/index.md b/files/ja/web/api/cache/put/index.md
index c362186ae1b394..759772fb234487 100644
--- a/files/ja/web/api/cache/put/index.md
+++ b/files/ja/web/api/cache/put/index.md
@@ -10,7 +10,7 @@ l10n:
 
 **`put()`** は {{domxref("Cache")}} インターフェイスのメソッドで、キーと値のペアを現在の {{domxref("Cache")}} オブジェクトに追加することができます。
 
-多くの場合、やりたいことは、ただ 1 つ以上のリクエストを {{domxref("fetch()")}} して、その結果を直接キャッシュに追加するだけです。そのような場合は、{{domxref("Cache.add","Cache.add()")}} や {{domxref("Cache.addAll","Cache.addAll()")}} を使用した方がよいでしょう。 これらはこうした操作を 1 つ以上行うための一括操作関数であるためです。
+多くの場合、やりたいことは、ただ 1 つ以上のリクエストを {{domxref("Window/fetch", "fetch()")}} して、その結果を直接キャッシュに追加するだけです。そのような場合は、{{domxref("Cache.add","Cache.add()")}} や {{domxref("Cache.addAll","Cache.addAll()")}} を使用した方がよいでしょう。 これらはこうした操作を 1 つ以上行うための一括操作関数であるためです。
 
 ```js
 fetch(url).then((response) => {
diff --git a/files/ja/web/api/document/lastmodified/index.md b/files/ja/web/api/document/lastmodified/index.md
index 143ad3a6e72e1b..146e64bba3bc64 100644
--- a/files/ja/web/api/document/lastmodified/index.md
+++ b/files/ja/web/api/document/lastmodified/index.md
@@ -80,7 +80,7 @@ if (Number.isNaN(lastVisit) || lastModif > lastVisit) {
 }
 ```
 
-外部ページが変更されたかどうかを知りたい場合、{{HTTPMethod("HEAD")}} リクエストを {{domxref("fetch()")}} API によって行い、{{HTTPHeader("Last-Modified")}} レスポンスヘッダーを調べます。
+外部ページが変更されたかどうかを知りたい場合、{{HTTPMethod("HEAD")}} リクエストを {{domxref("Window/fetch", "fetch()")}} API によって行い、{{HTTPHeader("Last-Modified")}} レスポンスヘッダーを調べます。
 
 ## 仕様書
 
diff --git a/files/ja/web/api/fetchevent/request/index.md b/files/ja/web/api/fetchevent/request/index.md
index 599b4e88fda0c2..1af56625ceb3bb 100644
--- a/files/ja/web/api/fetchevent/request/index.md
+++ b/files/ja/web/api/fetchevent/request/index.md
@@ -20,7 +20,7 @@ l10n:
 このコードスニペットは、[サービスワーカーのフェッチの例](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/prefetch/service-worker.js)からのものです（[フェッチの例をライブで実行](https://googlechrome.github.io/samples/service-worker/prefetch/)）。 {{domxref("ServiceWorkerGlobalScope.fetch_event", "onfetch")}} イベントハンドラーは、`fetch` イベントを待ち受けします。イベントが発生、{{domxref("FetchEvent.respondWith", "FetchEvent.respondWith()")}} に、制御されたページに戻すプロミスを渡します。
 このプロミスは、{{domxref("Cache")}} オブジェクトで最初に一致した URL リクエストに解決されます。 一致が見つからない場合、コードはネットワークからレスポンスをフェッチします。
 
-このコードは、{{domxref("fetch()")}} 操作で発生した例外も処理します。 HTTP のエラーレスポンス（404 など）でも例外は発生しないことに注意してください。然るべきエラーコードが設定された通常のレスポンスオブジェクトを返します。
+このコードは、{{domxref("Window/fetch", "fetch()")}} 操作で発生した例外も処理します。 HTTP のエラーレスポンス（404 など）でも例外は発生しないことに注意してください。然るべきエラーコードが設定された通常のレスポンスオブジェクトを返します。
 
 ```js
 self.addEventListener("fetch", (event) => {
diff --git a/files/ja/web/api/fetchevent/respondwith/index.md b/files/ja/web/api/fetchevent/respondwith/index.md
index 136ee6e9fd8fca..77aa873c835b25 100644
--- a/files/ja/web/api/fetchevent/respondwith/index.md
+++ b/files/ja/web/api/fetchevent/respondwith/index.md
@@ -25,7 +25,7 @@ Firefox 59 以降、サービスワーカーが {{domxref("FetchEvent.respondWit
 
 たいていのネットワークリクエストに対して、最終 URL を観測できないためこの変更は影響ありません。しかし、少しだけ関係する場合があります。
 
-- {{domxref("fetch()")}} が介入された場合、結果の {{domxref("Response.url")}} で最終 URL を観測できます。
+- {{domxref("Window/fetch", "fetch()")}} が介入された場合、結果の {{domxref("Response.url")}} で最終 URL を観測できます。
 - [ワーカー](/ja/docs/Web/API/Web_Workers_API)スクリプトが介入された場合、最終 URL は [`self.location`](/ja/docs/Web/API/WorkerGlobalScope/location) をセットするのに使われ、ワーカースクリプトの相対 URL の代わりのベース URL として使われます。
 - スタイルシートが介入された場合、最終 URL は相対的な {{cssxref("@import")}} 読み込みの代わりのベース URL として使われます。
 
diff --git a/files/ja/web/api/formdata/index.md b/files/ja/web/api/formdata/index.md
index 5362448e71989e..7e78febcba5a6b 100644
--- a/files/ja/web/api/formdata/index.md
+++ b/files/ja/web/api/formdata/index.md
@@ -7,7 +7,7 @@ l10n:
 
 {{APIRef("XMLHttpRequest API")}}
 
-**`FormData`** インターフェイスは、フォームフィールドおよびそれらの値から表現されるキーと値のペアのセットを簡単に構築する手段を提供します。これは {{domxref("fetch()")}}、{{domxref("XMLHttpRequest.send()")}}、{{domxref("navigator.sendBeacon()")}} の各メソッドを用いることで送信が可能です。エンコーディング型を `"multipart/form-data"` に設定した場合にフォームが使用するものと同じ形式を使用します。
+**`FormData`** インターフェイスは、フォームフィールドおよびそれらの値から表現されるキーと値のペアのセットを簡単に構築する手段を提供します。これは {{domxref("Window/fetch", "fetch()")}}、{{domxref("XMLHttpRequest.send()")}}、{{domxref("navigator.sendBeacon()")}} の各メソッドを用いることで送信が可能です。エンコーディング型を `"multipart/form-data"` に設定した場合にフォームが使用するものと同じ形式を使用します。
 
 単純な `GET` の送信を用いる {{HTMLElement("form")}} が行うようなクエリー引数を生成したい場合は、{{domxref("URLSearchParams")}} コンストラクターに直接渡すことも可能です。
 
diff --git a/files/ja/web/api/html_dom_api/microtask_guide/index.md b/files/ja/web/api/html_dom_api/microtask_guide/index.md
index 09d0f5cd3a9edf..c22b360bf158d0 100644
--- a/files/ja/web/api/html_dom_api/microtask_guide/index.md
+++ b/files/ja/web/api/html_dom_api/microtask_guide/index.md
@@ -141,7 +141,7 @@ customElement.prototype.getData = (url) => {
 };
 ```
 
-これは、マイクロタスク内で `data` の設定と `load` イベントの発行の両方を処理させることで、節のバランスを取っています（`if` 節では `queueMicrotask()` を使い、 `else` 節では {{domxref("fetch()")}} が使うプロミスを使用する）。
+これは、マイクロタスク内で `data` の設定と `load` イベントの発行の両方を処理させることで、節のバランスを取っています（`if` 節では `queueMicrotask()` を使い、 `else` 節では {{domxref("Window/fetch", "fetch()")}} が使うプロミスを使用する）。
 
 #### 操作のバッチ化
 
@@ -169,7 +169,7 @@ let sendMessage = (message) => {
 
 配列に追加したメッセージが最初のものであれば、バッチを送信するマイクロタスクをキューに入れます。マイクロタスクは、いつものように、 JavaScript の実行パスが最上位に達したとき、コールバックを実行する直前に実行されます。つまり、その間に行われる `sendMessage()` のさらなる呼び出しは、メッセージをメッセージキューにプッシュしますが、マイクロタスクを追加する前に配列の長さをチェックするため、新しいマイクロタスクはキューに入れません。
 
-マイクロタスクが実行されるとき、それは潜在的に多くのメッセージが待っている配列を持っています。それは、 {{jsxref("JSON.stringify()")}} メソッドを使用して JSON としてそれをエンコードすることから始まります。その後、配列の内容が不要になったので、 `messageQueue` 配列を空にします。最後に、{{domxref("fetch()")}} メソッドを用いて、 JSON 文字列をサーバーに送信します。
+マイクロタスクが実行されるとき、それは潜在的に多くのメッセージが待っている配列を持っています。それは、 {{jsxref("JSON.stringify()")}} メソッドを使用して JSON としてそれをエンコードすることから始まります。その後、配列の内容が不要になったので、 `messageQueue` 配列を空にします。最後に、{{domxref("Window/fetch", "fetch()")}} メソッドを用いて、 JSON 文字列をサーバーに送信します。
 
 これにより、イベントループの同じイテレーションの中で行われる `sendMessage()` のすべての呼び出しが、タイムアウトなどの他のタスクによって送信が遅れる可能性を排除して、同じ `fetch()` 操作にメッセージを追加することができます。
 
diff --git a/files/ja/web/api/htmlscriptelement/attributionsrc/index.md b/files/ja/web/api/htmlscriptelement/attributionsrc/index.md
index b6a2000beeadb2..0ecf693bab7e00 100644
--- a/files/ja/web/api/htmlscriptelement/attributionsrc/index.md
+++ b/files/ja/web/api/htmlscriptelement/attributionsrc/index.md
@@ -13,7 +13,7 @@ l10n:
 サーバー側では、これはレスポンスで {{httpheader("Attribution-Reporting-Register-Source")}} または {{httpheader("Attribution-Reporting-Register-Trigger")}} ヘッダーを送信するトリガーとして用いられ、それぞれ JavaScript ベースの[属性ソース](/ja/docs/Web/API/Attribution_Reporting_API/Registering_sources#javascript-based_event_sources)または[属性トリガー](/ja/docs/Web/API/Attribution_Reporting_API/Registering_triggers#javascript-based_attribution_triggers)を登録します。どのレスポンスヘッダーを送り返すべきかは、登録を行った `Attribution-Reporting-Eligible` ヘッダーの値に依存します。
 
 > [!NOTE]
-> 他にも、JavaScript の属性ソースまたはトリガーは、{{domxref("fetch()")}} リクエストに `attributionReporting` オプションをつけて送信するか（`fetch()` 呼び出しで直接設定するか、`fetch()` 呼び出しに渡された {{domxref("Request")}} オブジェクトで）、{{domxref("XMLHttpRequest")}} で {{domxref("XMLHttpRequest.setAttributionReporting", "setAttributionReporting()")}} をリクエストオブジェクトについて呼び出したりすることもできます。
+> 他にも、JavaScript の属性ソースまたはトリガーは、{{domxref("Window/fetch", "fetch()")}} リクエストに `attributionReporting` オプションをつけて送信するか（`fetch()` 呼び出しで直接設定するか、`fetch()` 呼び出しに渡された {{domxref("Request")}} オブジェクトで）、{{domxref("XMLHttpRequest")}} で {{domxref("XMLHttpRequest.setAttributionReporting", "setAttributionReporting()")}} をリクエストオブジェクトについて呼び出したりすることもできます。
 
 詳細は[属性レポート API](/ja/docs/Web/API/Attribution_Reporting_API) です。
 
diff --git a/files/ja/web/api/mediasource/endofstream/index.md b/files/ja/web/api/mediasource/endofstream/index.md
index fdb84e47d0d37d..8db29c071de007 100644
--- a/files/ja/web/api/mediasource/endofstream/index.md
+++ b/files/ja/web/api/mediasource/endofstream/index.md
@@ -24,7 +24,7 @@ endOfStream(endOfStreamError)
   - : 文字列で、ストリームの終わりに達したときに発生したエラーを表します。可能な値は次のとおりです。
 
     - `network`
-      - : 再生を終了し、ネットワークエラーが発生したことを通知します。 これを使用して、メディアストリームに関連するカスタムエラーハンドラーを作成できます。 例えば、他のネットワーク要求とは別に、メディアチャンク要求を処理する関数があるとします。メディアチャンクを {{domxref("fetch()")}} リクエストしてネットワークエラーが発生した場合、 `endOfStream('network')` を呼び出し、 UI に説明的なメッセージを表示し、ネットワークリクエストをすぐに再試行するか、ネットワークが（何らかのポーリングで）復旧するまで待ちます。
+      - : 再生を終了し、ネットワークエラーが発生したことを通知します。 これを使用して、メディアストリームに関連するカスタムエラーハンドラーを作成できます。 例えば、他のネットワーク要求とは別に、メディアチャンク要求を処理する関数があるとします。メディアチャンクを {{domxref("Window/fetch", "fetch()")}} リクエストしてネットワークエラーが発生した場合、 `endOfStream('network')` を呼び出し、 UI に説明的なメッセージを表示し、ネットワークリクエストをすぐに再試行するか、ネットワークが（何らかのポーリングで）復旧するまで待ちます。
     - `decode`
       - : 再生を終了し、デコードエラーが発生したことを通知します。 これは、メディアデータの取得中に解析エラーが発生したことを示すために使用できます。 データが破損しているか、ブラウザーがデコード方法を知らないコーデックを使用してエンコードされている可能性があります。
 
diff --git a/files/ja/web/api/performanceresourcetiming/initiatortype/index.md b/files/ja/web/api/performanceresourcetiming/initiatortype/index.md
index 63fca7e4bca5ac..9437b6d3e8fd51 100644
--- a/files/ja/web/api/performanceresourcetiming/initiatortype/index.md
+++ b/files/ja/web/api/performanceresourcetiming/initiatortype/index.md
@@ -29,7 +29,7 @@ l10n:
 - `embed`
   - : このリクエストが {{HTMLElement("embed")}} 要素の `src` 属性によって開始された場合。
 - `fetch`
-  - : このリクエストが {{domxref("fetch()")}} メソッドによって開始された場合。
+  - : このリクエストが {{domxref("Window/fetch", "fetch()")}} メソッドによって開始された場合。
 - `frame`
   - : このリクエストが {{HTMLElement("frame")}} 要素の読み込みによって開始された場合。
 - `iframe`

From e30bc16e2ce0154a3647f509e4076f075cb8f453 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 10:02:39 +0900
Subject: [PATCH 057/115] =?UTF-8?q?2023/09/25=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../reference/global_objects/string/trim/index.md      | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/files/ja/web/javascript/reference/global_objects/string/trim/index.md b/files/ja/web/javascript/reference/global_objects/string/trim/index.md
index 60e88ea0a8f3fa..7c7ba0867ac29e 100644
--- a/files/ja/web/javascript/reference/global_objects/string/trim/index.md
+++ b/files/ja/web/javascript/reference/global_objects/string/trim/index.md
@@ -2,14 +2,14 @@
 title: String.prototype.trim()
 slug: Web/JavaScript/Reference/Global_Objects/String/trim
 l10n:
-  sourceCommit: d91af249c51c398ee7c0f0280e6ae5b22f6478e5
+  sourceCommit: fb85334ffa4a2c88d209b1074909bee0e0abd57a
 ---
 
 {{JSRef}}
 
-**`trim()`** メソッドは、文字列の両端からホワイトスペースを取り除き、元の文字列を変更せずに新しい文字列を返す。
+**`trim()`** は {{jsxref("String")}} 値のメソッドで、この文字列の両端からホワイトスペースを取り除き、元の文字列を変更せずに新しい文字列を返します。
 
-一方の端からのみホワイトスペースを取り除いた新しい文字列を返したい場合は、{{jsxref("String.prototype.trimStart()", "trimStart()")}} または {{jsxref("String.prototype.trimEnd()", "trimEnd()")}} を使用してください。
+一方の端からのみホワイトスペースを取り除いた新しい文字列を返したい場合は、{{jsxref("String/trimStart", "trimStart()")}} または {{jsxref("String/trimEnd", "trimEnd()")}} を使用してください。
 
 {{EmbedInteractiveExample("pages/js/string-trim.html")}}
 
@@ -19,6 +19,10 @@ l10n:
 trim()
 ```
 
+### 引数
+
+なし。
+
 ### 返値
 
 `str` の先頭と末尾のホワイトスペースを取り除いた新しい文字列を表します。 ホワイトスペースは[ホワイトスペース](/ja/docs/Web/JavaScript/Reference/Lexical_grammar#ホワイトスペース)文字と[改行文字](/ja/docs/Web/JavaScript/Reference/Lexical_grammar#改行文字)で定義します。

From 4d628003d091d12e7a31d6220c9992a40876eefa Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 16:24:53 +0900
Subject: [PATCH 058/115] =?UTF-8?q?2024/06/23=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../ja/web/api/view_transitions_api/index.md  | 304 +++---------------
 1 file changed, 47 insertions(+), 257 deletions(-)

diff --git a/files/ja/web/api/view_transitions_api/index.md b/files/ja/web/api/view_transitions_api/index.md
index 7fe86926feba02..a9b88d57e797d8 100644
--- a/files/ja/web/api/view_transitions_api/index.md
+++ b/files/ja/web/api/view_transitions_api/index.md
@@ -1,298 +1,88 @@
 ---
-title: ビュートランジション API
+title: ビュー遷移 API
 slug: Web/API/View_Transitions_API
 l10n:
-  sourceCommit: 6d4b6a0f9df94de158c373d6b08c504caafcee5f
+  sourceCommit: 722311032dbf520bf6aeba3d1f432aca38779ffd
 ---
 
-{{SeeCompatTable}}{{DefaultAPISidebar("View Transitions API")}}
+{{DefaultAPISidebar("View Transitions API")}}
 
-**ビュートランジション API** は、異なる DOM 状態間のアニメーション遷移を簡単に作成する仕組みを提供し、同時に DOM コンテンツも単一の手順で更新します。
+**ビュー遷移 API** は、異なるウェブサイトのビュー間のアニメーション遷移を簡単に作成するための仕組みを提供します。これには、単一ページアプリケーション (SPA) における DOM 状態変化のアニメーション、および複数ページアプリケーション (MPA) における文書内の移動時のアニメーションを含みます。
 
 ## 概念と使い方
 
-ビュートランジションは、ユーザーがアプリケーションの状態またはビューの間を移動する際に、ユーザーの認知的負荷を縮小し、コンテキストにとどまることを支援し、読み込み待ちの知覚時間を短縮するための有力な設計の選択肢です。
+ビュー遷移は、ユーザーがアプリケーションの状態またはビューの間を移動する際に、ユーザーの認知的負荷を縮小し、コンテキストにとどまることを支援し、読み込み待ちの知覚時間を短縮するための有力な設計の選択肢です。
 
-しかし、ウェブ上でビュートランジションを作成するのは、過去には困難なことでした。単一のページアプリ (SPA) で状態間の遷移を行うには、かなりの CSS と JavaScript を書かなければならない傾向があります。
+しかし、ウェブ上でビュー遷移を作成するのは、従来は困難なことでした。
 
-- 古いコンテンツと新しいコンテンツの読み込みと位置決めを処理します。
-- 古い状態と新しい状態をアニメーション化して、トランジションを作成します。
-- 古いコンテンツを誤ってユーザーが操作して問題が発生しないようにします。
-- トランジションが完了したら、古いコンテンツを除去します。
+- 単一ページアプリ (SPA) で状態変化の遷移を行うには、かなりの CSS と JavaScript を書かなければならない傾向があります。
+  - 古いコンテンツと新しいコンテンツの読み込みと位置決めを処理します。
+  - 古い状態と新しい状態をアニメーション化して、遷移を作成します。
+  - 古いコンテンツをユーザーが操作して問題を起こすことを防止します。
+  - 遷移が完了したら、古いコンテンツを除去します。
+    アクセシビリティに関する問題、例えば、読み込み位置の喪失、フォーカスの混乱、ライブリージョンに関する正しくないアナウンスなどといった問題も、新しいコンテンツと古いコンテンツの両方を同時に DOM に存在させることによって引き起こされる可能性があります。
+- 文書間のビュー遷移（つまり、MPA の異なるページ間の移動）は不可能でした。
 
-また、新しいコンテンツと古いコンテンツが同時に DOM に存在することで、読み上げ位置の喪失、フォーカスの混乱、奇妙なライブ領域のアナウンス動作といったアクセシビリティの課題も生じます。さらに、文書間の（つまり、 SPA ではない通常のウェブサイトの異なるページ間の）ビュートランジションは不可能です。
+ビュー遷移 API は、要求される DOM の変更と遷移アニメーションをより簡単に処理する方法を提供します。
 
-ビュートランジション API は、要求される DOM の変更とトランジションアニメーションをより簡単に処理する方法を提供します。
+ブラウザーの既定では、ビュー遷移を作成するアニメーションはすばやく実行されます。また、SPA と MPA のビュー遷移の両方で、遷移アニメーションをカスタマイズしたり、ビュー遷移自体を操作したり（例えば、アニメーションをスキップする状況を指定したり）できる機能があります。
 
-> [!NOTE]
-> ビュートランジション API は、現在のところ文書間のビュートランジションを可能にするものではありませんが、これは将来の仕様レベルで計画されており、活発に作業されています。
-
-### 基本的なビュートランジションの作成
-
-例えば、ナビゲーションリンクがクリックされたり、サーバーから更新がプッシュされたりといった何らかのイベントに応答して、新しいコンテンツを取得して DOM を更新する機能を SPA に含めることができます。この[基本的なビュートランジションのデモ](https://mdn.github.io/dom-examples/view-transitions/)では、クリックされたサムネイルに基づいて新しいフルサイズの画像を表示する `displayNewImage()` 関数に単純化しました。これを `updateView()` 関数内にカプセル化し、ブラウザーの対応している場合にのみビュートランジション API を呼び出すようにしています。
-
-```js
-function updateView(event) {
-  // <a> と <img> のどちらにイベントが発生するかの違いを扱う
-  const targetIdentifier = event.target.firstChild || event.target;
-
-  const displayNewImage = () => {
-    const mainSrc = `${targetIdentifier.src.split("_th.jpg")[0]}.jpg`;
-    galleryImg.src = mainSrc;
-    galleryCaption.textContent = targetIdentifier.alt;
-  };
-
-  // ビュートランジションに対応していないブラウザー用のフォールバック
-  if (!document.startViewTransition) {
-    displayNewImage();
-    return;
-  }
-
-  // ビュートランジションで
-  const transition = document.startViewTransition(() => displayNewImage());
-}
-```
-
-このコードだけで表示画像の切り替えを処理することができます。対応しているブラウザーでは、古い画像から新しい画像とキャプションへの変更をスムーズなクロスフェード（ビュートランジションの既定値）として表示させます。対応していないブラウザーでも動作しますが、アニメーションは表示されません。
-
-`startViewTransition()` は {{domxref("ViewTransition")}} インスタンスを返しますが、このインスタンスにはいくつかのプロミスが含まれており、ビュートランジションプロセスの異なる部分に到達するためにコードを実行することができます。
-
-### ビュートランジションのプロセス
-
-これがどのように動作するのかを見ていきましょう。
-
-1. {{domxref("Document.startViewTransition()", "document.startViewTransition()")}} が呼び出されると、 API は現在のページのスクリーンショットを撮ります。
-2. 次に `startViewTransition()` に渡したコールバック（この場合は `displayNewImage`）を呼び出し、これが DOM を変更します。
-
-   コールバックが正常に実行されると、 {{domxref("ViewTransition.updateCallbackDone")}} のプロミスが履行され、 DOM の更新に応答できるようになります。
-
-3. API はページの新しい状態をライブ表現として取り込みます。
-4. API は以下のような構造の擬似要素ツリーを構築します。
-
-   ```plain
-   ::view-transition
-   └─ ::view-transition-group(root)
-      └─ ::view-transition-image-pair(root)
-         ├─ ::view-transition-old(root)
-         └─ ::view-transition-new(root)
-   ```
-
-   - {{cssxref("::view-transition")}} はビュートランジションオーバーレイのルートで、すべてのビュートランジションを収め、他のすべてのページコンテンツの上に配置されます。
-   - {{cssxref("::view-transition-old")}} は古いページ表示のスクリーンショットで、 {{cssxref("::view-transition-new")}} は新しいページ表示のライブ表示です。どちらも {{htmlelement("img")}} や {{htmlelement("video")}} と同じように置換コンテンツとしてレンダリングされ、 {{cssxref("object-fit")}} や {{cssxref("object-position")}} のような便利なプロパティでスタイル設定できることを意味しています。
-
-   トランジションアニメーションが実行されるとき、 {{domxref("ViewTransition.ready")}} プロミスが履行され、例えば既定のアニメーションではなく独自の JavaScript アニメーションを実行して対応することができます。
-
-5. 古いページ表示の {{cssxref("opacity")}} を 1 から 0 へアニメーションさせる一方、新しい表示の `opacity` を 0 から 1 までアニメーションします。これは既定のクロスフェードを作成するものです。
-6. トランジションアニメーションが終了状態に達すると、 {{domxref("ViewTransition.finished")}} プロミスが履行され、応答できるようになります。
-
-### 要素ごとに異なるトランジション
-
-現時点では、 DOM 更新時に変化する異なる要素はすべて同じアニメーションを使用してトランジションします。異なる要素を既定で「ルート」アニメーションとは異なる形でアニメーションさせたい場合は、 {{cssxref("view-transition-name")}} プロパティを使用してそれらを区切ることができます。例えば、以下のようにします。
-
-```css
-figcaption {
-  view-transition-name: figure-caption;
-}
-```
-
-{{htmlelement("figcaption")}} 要素に `figure-caption` という `view-transition-name` を指定したのは、ビュートランジションでページの他の部分と区別するためです。
-
-この CSS を適用すると、擬似要素ツリーは次のようになります。
-
-```plain
-::view-transition
-├─ ::view-transition-group(root)
-│ └─ ::view-transition-image-pair(root)
-│     ├─ ::view-transition-old(root)
-│     └─ ::view-transition-new(root)
-└─ ::view-transition-group(figure-caption)
-  └─ ::view-transition-image-pair(figure-caption)
-      ├─ ::view-transition-old(figure-caption)
-      └─ ::view-transition-new(figure-caption)
-```
-
-2 つ目の擬似要素が存在することで、 `<figcaption>` だけに別個のビュートランジションスタイル設定を適用することができます。異なる新旧のページビューのキャプチャは完全に別個のものとして処理されます。
-
-`view-transition-name` の値は `none` 以外であれば何らかの値を指定することができます。`none` はその要素がビュートランジションに参加しないことを意味します。
-
-> **メモ:** `view-transition-name` は一意でなければなりません。 2 つのレンダリング要素が同時に同じ `view-transition-name` がある場合、 {{domxref("ViewTransition.ready")}} は拒否され、トランジションはスキップされます。
-
-### アニメーションのカスタマイズ
-
-ビュートランジションの擬似要素には既定で [CSS アニメーション](/ja/docs/Web/CSS/CSS_animations)が適用されています（詳しくは[参照ページ](#css_の追加)を参照してください）。
-
-特に、 `height`、`width`、`position`、`transform` のトランジションはスムーズなクロスフェードアニメーションを使用しません。その代わりに、height と width のトランジションでは拡大縮小するアニメーションが適用されます。一方、position と transform のトランジションは要素に滑らかな移動アニメーションを適用します。
-
-既定のアニメーションは、通常の CSS を使用して自由に変更することができます。
-
-例えば、そのスピードを変えるには次のようにします。
-
-```css
-::view-transition-old(root),
-::view-transition-new(root) {
-  animation-duration: 0.5s;
-}
-```
-
-もっと面白いものを見ていきましょう。 `<figcaption>` のカスタムアニメーションです。
-
-```css
-@keyframes grow-x {
-  from {
-    transform: scaleX(0);
-  }
-  to {
-    transform: scaleX(1);
-  }
-}
-
-@keyframes shrink-x {
-  from {
-    transform: scaleX(1);
-  }
-  to {
-    transform: scaleX(0);
-  }
-}
-
-::view-transition-old(figure-caption),
-::view-transition-new(figure-caption) {
-  height: auto;
-  right: 0;
-  left: auto;
-  transform-origin: right center;
-}
-
-::view-transition-old(figure-caption) {
-  animation: 0.25s linear both shrink-x;
-}
-
-::view-transition-new(figure-caption) {
-  animation: 0.25s 0.25s linear both grow-x;
-}
-```
-
-ここでは、独自の CSS アニメーションを作成し、それを `::view-transition-old(figure-caption)` および `::view-transition-new(figure-caption)` 擬似要素に適用しています。他にも、同じ配置を維持し、既定値のスタイル設定がカスタムアニメーションの邪魔をしないようにするために、両方にスタイルを追加しています。
-
-なお、上記よりもシンプルで、より良い結果をもたらす別のトランジションオプションも見つけました。最終的な `<figcaption>` のビュートランジションはこのようになりました。
-
-```css
-figcaption {
-  view-transition-name: figure-caption;
-}
-
-::view-transition-old(figure-caption),
-::view-transition-new(figure-caption) {
-  height: 100%;
-}
-```
-
-これは既定では `::view-transition-group` が古いビューと新しいビューの間で幅と高さを遷移させるのでうまくいきます。これはうまくいくために、両方の状態で固定された `height` を設定する必要がありました。
-
-> **メモ:** [ビュートランジション API によるスムーズでシンプルなトランジション](https://developer.chrome.com/docs/web-platform/view-transitions/)には、いくつかの他のカスタマイズ例があります。
-
-### JavaScript によるアニメーションの制御
-
-{{domxref("Document.startViewTransition()", "document.startViewTransition()")}} メソッドは {{domxref("ViewTransition")}} オブジェクトインスタンスを返します。このオブジェクトインスタンスには、いくつかのプロミスメンバーが含まれており、トランジションの様々な状態に達したことに応答して JavaScript を実行することができます。例えば、 {{domxref("ViewTransition.ready")}} は擬似要素ツリーが作成され、アニメーションが始まろうとすると履行され、 {{domxref("ViewTransition.finished")}} はアニメーションが完了し、新しいページビューがユーザーに表示され操作できるようになると履行されます。
-
-例えば、次の例では、{{domxref("Web Animations API", "ウェブアニメーション API", "", "nocode")}} によって指定されたアニメーションで、クリック時のユーザーカーソルの位置から発せられる円形の明らかになるビュー遷移を作成するために、以下の JavaScript を使用することができます。
-
-```js
-// 最後のクリックイベントを格納
-let lastClick;
-addEventListener("click", (event) => (lastClick = event));
-
-function spaNavigate(data) {
-  // この API に対応していないブラウザーのためのフォールバック
-  if (!document.startViewTransition) {
-    updateTheDOMSomehow(data);
-    return;
-  }
-
-  // クリック位置を取得するか、画面の中央へフォールバックする
-  const x = lastClick?.clientX ?? innerWidth / 2;
-  const y = lastClick?.clientY ?? innerHeight / 2;
-  // 最も遠いコーナーまでの距離を取得
-  const endRadius = Math.hypot(
-    Math.max(x, innerWidth - x),
-    Math.max(y, innerHeight - y),
-  );
-
-  // トランジションを作成
-  const transition = document.startViewTransition(() => {
-    updateTheDOMSomehow(data);
-  });
-
-  // 擬似要素が作成されるのを待つ
-  transition.ready.then(() => {
-    // ルートの新しいビューをアニメーション
-    document.documentElement.animate(
-      {
-        clipPath: [
-          `circle(0 at ${x}px ${y}px)`,
-          `circle(${endRadius}px at ${x}px ${y}px)`,
-        ],
-      },
-      {
-        duration: 500,
-        easing: "ease-in",
-        // アニメーションさせる擬似要素を指定
-        pseudoElement: "::view-transition-new(root)",
-      },
-    );
-  });
-}
-```
-
-このアニメーションには以下の CSS も必要です。CSS の既定のアニメーションをオフにし、新しい状態と古い状態を混合しないようにします（新しい状態はトランジションするのではなく、古い状態のすぐ上に「ワイプ」されます）。
-
-```css
-::view-transition-image-pair(root) {
-  isolation: auto;
-}
-
-::view-transition-old(root),
-::view-transition-new(root) {
-  animation: none;
-  mix-blend-mode: normal;
-  display: block;
-}
-```
+詳しくは[ビュー遷移 API の使用](/ja/docs/Web/API/View_Transitions_API/Using)を参照してください。
 
 ## インターフェイス
 
 - {{domxref("ViewTransition")}}
-  - : ビュートランジションを表します。トランジションが異なる状態（アニメーションを実行する準備ができている、アニメーションが完了したなど）に達したり、トランジションを完全にスキップしたりする機能を提供します。
+  - : ビュー遷移を表します。遷移が異なる状態（アニメーションを実行する準備ができている、アニメーションが完了したなど）に達したり、遷移を完全にスキップしたりする機能を提供します。
 
 ## 他のインターフェイスの拡張
 
 - {{domxref("Document.startViewTransition()")}}
-  - : 新しいビュートランジションを開始し、それを表す {{domxref("ViewTransition")}} オブジェクトを返します。
+  - : 新しい同一文書内 (SPA) ビュー遷移を開始し、それを表す {{domxref("ViewTransition")}} オブジェクトを返します。
+- {{domxref("PageRevealEvent")}}
+  - : {{domxref("Window.pagereveal_event", "pagereveal")}} イベント用のイベントオブジェクト。文書間の移動中に、移動先の文書内のビュー遷移が起動された場合、関連のビュー遷移を操作することができます（関連する {{domxref("ViewTransition")}} オブジェクトにアクセスできます）。
+- {{domxref("PageSwapEvent")}}
+  - : {{domxref("Window.pageswap_event", "pageswap")}} イベントのイベントオブジェクト。文書間の移動中、移動によってビュー遷移が起動された場合、移動元の文書から関連するビュー遷移を操作することができます（関連する {{domxref("ViewTransition")}} オブジェクトにアクセスできます）。 また、移動の種類や、移動元と移動先の文書の履歴項目に関する情報へのアクセスも提供します。
+- {{domxref("Window")}} の {{domxref("Window.pagereveal_event", "pagereveal")}} イベント
+  - : 文書が最初にレンダリングされるとき、ネットワークから新しい文書を読み込んだ場合、または文書（[バック/フォワードキャッシュ](/ja/docs/Glossary/bfcache) (bfcache)または[事前レンダリング](/ja/docs/Glossary/Prerender)）をアクティブにした場合に発行されます。
+- {{domxref("Window")}} の {{domxref("Window.pageswap_event", "pageswap")}} イベント
+  - : ナビゲーションにより文書がアンロードされようとするときに発行されます。
+
+## HTML への追加
+
+- [`<link rel="expect">`](/ja/docs/Web/HTML/Attributes/rel#expect)
+  - : ユーザーがページを最初に表示した際に、関連文書内の最も重要なコンテンツを識別します。 重要なコンテンツが解釈されるまで文書のレンダリングがブロックされ、すべての対応ブラウザーで一貫したファーストペイント（最初の描画）が保証され、その結果、ビューの遷移が保証されます。
 
 ## CSS の追加
 
+### アットルール
+
+- {{cssxref("@view-transition")}}
+  - : 文書間の移動の場合、`@view-transition` を使用して、移動元と移動先の文書でビュー遷移を行うようにします。
+
 ### プロパティ
 
 - {{cssxref("view-transition-name")}}
-  - : 選択された要素に別な識別名を提供し、ルートのビュートランジションとは別のビュートランジションに参加させます。 `none` の値が指定された場合はビュートランジションに参加させません。
+  - : 選択された要素に別な識別名を提供し、ルートのビュー遷移とは別のビュー遷移に参加させます。 `none` の値が指定された場合はビュー遷移に参加させません。
 
 ### 擬似要素
 
 - {{cssxref("::view-transition")}}
-  - : ビュートランジションオーバーレイのルートで、すべてのビュートランジションを格納し、他のすべてのページコンテンツの上に配置されます。
+  - : ビュー遷移オーバーレイのルートで、すべてのビュー遷移を格納し、他のすべてのページコンテンツの上に配置されます。
 - {{cssxref("::view-transition-group", "::view-transition-group()")}}
-  - : 単一のビュートランジションのルートです。
+  - : 単一のビュー遷移のルートです。
 - {{cssxref("::view-transition-image-pair", "::view-transition-image-pair()")}}
-  - : ビュートランジションの新旧ビュー（トランジション前とトランジション後）のコンテナーです。
+  - : ビュー遷移の新旧ビュー（遷移前と遷移後）のコンテナーです。
 - {{cssxref("::view-transition-old", "::view-transition-old()")}}
-  - : ビュートランジション移行前の静止スクリーンショットです。
+  - : ビュー遷移移行前の静止スクリーンショットです。
 - {{cssxref("::view-transition-new", "::view-transition-new()")}}
-  - : ビュートランジション後の新しいビューのライブ表現です。
+  - : ビュー遷移後の新しいビューのライブ表現です。
 
 ## 例
 
-- [Basic View Transitions demo](https://mdn.github.io/dom-examples/view-transitions/): 基本的な画像ギャラリーのデモで、古い画像と新しい画像、古いキャプションと新しいキャプションの間に別個のトランジションがあります。
-- [HTTP 203 playlist](https://http203-playlist.netlify.app/): [ビュートランジション API によるスムーズでシンプルなトランジション](https://developer.chrome.com/docs/web-platform/view-transitions/)では、その多くが説明されています。異なる多くのビュートランジション機能を備えた、より洗練された動画プレーヤーのデモアプリです。
+- [Basic View Transitions SPA demo](https://mdn.github.io/dom-examples/view-transitions/): 基本的な画像ギャラリーのデモで、古い画像と新しい画像、古いキャプションと新しいキャプションの間に別個の遷移があります。
+- [Basic View Transitions MPA demo](https://mdn.github.io/dom-examples/view-transitions/mpa/): 2 ページのサイトの例で、2 つのページ間を移動する際に独自の「スワイプアップ」遷移が指定された、文書間 (MPA) のビュー遷移の使用例を示します。
+- [HTTP 203 playlist](https://http203-playlist.netlify.app/): [ビュー遷移 API によるスムーズでシンプルな遷移](https://developer.chrome.com/docs/web-platform/view-transitions/)では、その多くが説明されています。さまざまな多くのビュー遷移機能を備えた、より洗練された動画プレーヤーのデモアプリです。
+- [List of Chrome DevRel team members](https://view-transitions.netlify.app/profiles/mpa/): 基本的なチームプロフィールページのアプリで、{{domxref("Window.pagereveal_event", "pagereveal")}} および {{domxref("Window.pageswap_event", "pageswap")}} イベントを使用して、"from" と "to" の URL に基づいて、文書間ビュー遷移の流出・流入アニメーションをカスタマイズする方法を示しています。
 
 ## 仕様書
 
@@ -304,5 +94,5 @@ function spaNavigate(data) {
 
 ## 関連情報
 
-- [ビュートランジション API によるスムーズでシンプルなトランジション](https://developer.chrome.com/docs/web-platform/view-transitions/)
+- [ビュー遷移 API によるスムーズでシンプルな遷移](https://developer.chrome.com/docs/web-platform/view-transitions/)
 - [View Transitions API: Creating Smooth Page Transitions](https://stackdiary.com/view-transitions-api/)

From 2a1a8ffc51bbf79be71c515e77ed5e24ed6d78e5 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 15:49:16 +0900
Subject: [PATCH 059/115] =?UTF-8?q?2024/07/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../api/view_transitions_api/using/index.md   | 544 ++++++++++++++++++
 1 file changed, 544 insertions(+)
 create mode 100644 files/ja/web/api/view_transitions_api/using/index.md

diff --git a/files/ja/web/api/view_transitions_api/using/index.md b/files/ja/web/api/view_transitions_api/using/index.md
new file mode 100644
index 00000000000000..6c1dbb0df9989a
--- /dev/null
+++ b/files/ja/web/api/view_transitions_api/using/index.md
@@ -0,0 +1,544 @@
+---
+title: ビュー遷移 API の使用
+slug: Web/API/View_Transitions_API/Using
+l10n:
+  sourceCommit: 4dec42ed700040565e8af0e14ff104054ebc20f5
+---
+
+{{DefaultAPISidebar("View Transitions API")}}
+
+この記事では、[ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API) がどのように動作するのか、ビュー遷移を作成し、遷移アニメーションをカスタマイズする方法、アクティブなビュー遷移を操作する方法についての理論を説明します。単一ページアプリケーション (SPA) における DOM 状態の更新と、複数ページアプリケーション (MPA) における文書間の移動の両方におけるビュー遷移をカバーしています。
+
+### ビュー遷移のプロセス
+
+ビュー遷移が動作するプロセスを追ってみましょう。
+
+1. ビュー遷移が発生します。どのように行われるかは、ビュー遷移の種類によって異なります。
+   - 同一文書内 (SPA) の遷移の場合、ビュー遷移を発生させるには、ビューの変更と DOM の更新を実行する関数を、{{domxref("Document.startViewTransition()", "document.startViewTransition()")}} メソッドのコールバックとして渡します。
+   - 文書間 (MPA) の遷移の場合、新しい文書への移動を開始するとビュー遷移が開始されます。移動元と移動先の文書はどちらも同じオリジンに存在する必要があり、CSS に {{cssxref("@view-transition")}} アットルールを記述し、`navigation` 記述子を `auto` に設定することで、ビュー遷移に同意する必要があります。
+     > [!NOTE]
+     > アクティブなビュー遷移は、関連する {{domxref("ViewTransition")}} インスタンスを保有しています（例えば、同一文書内 (SPA) の遷移の場合、`startViewTransition()` によって返されます）。`ViewTransition` オブジェクトには、いくつかのプロミスが含まれており、ビュー遷移プロセスのさまざまな段階に到達した際に、それに対応するコードを実行することができます。 詳しくは、[JavaScript によるビュー遷移の制御](#javascript_によるビュー遷移の制御)を参照してください。
+2. 現在の（古いページ）ビューでは、API は {{cssxref("view-transition-name")}} が宣言された要素のスナップショットを取得します。
+3. ビューの変更が発生します。
+
+   - 同一文書内 (SPA) の遷移の場合、`startViewTransition()` に渡したコールバックが呼び出され、DOM の変更を行います。
+
+     コールバックが正常に実行された場合、{{domxref("ViewTransition.updateCallbackDone")}} プロミスが履行され、DOM の更新に対応できます。
+
+   - 文書間 (MPA) の遷移の場合、現在の文書と遷移先の文書間で移動します。
+
+4. API は、新しいビューのスナップショットをライブ表示としてキャプチャします。
+
+   この時点で、ビューの遷移が実行されようとしており、{{domxref("ViewTransition.ready")}} プロミスが履行されたため、例えば既定ではなく独自の JavaScript アニメーションを実行するなどして応答することができます。
+
+5. 古いページのスナップショットは "out" アニメーションで、新しいビューのスナップショットは "in" アニメーションで表示されます。既定では、古いビューのスナップショットは `opacity` が 1 から 0 に、新しいビューのスナップショットは `opacity` が 0 から 1 にアニメーションで変化して、クロスフェード効果になります。
+6. 遷移アニメーションが終わりに達すると、{{domxref("ViewTransition.finished")}} プロミスが履行され、応答することができます。
+
+> [!NOTE]
+> 文書内の[ページの可視状態](/ja/docs/Web/API/Page_Visibility_API)が `hidden` の場合（例えば、文書がウィンドウの下に覆われていたり、ブラウザーが最小化されていたり、他のブラウザータブがアクティブになっている場合など）、{{domxref("Document.startViewTransition()", "document.startViewTransition()")}} を呼び出した際に、ビュー遷移は完全にスキップされます。
+
+### ビュー遷移の擬似要素ツリー
+
+流出および流入の遷移アニメーションを作成する処理を行うために、API は以下の構造で擬似要素ツリーを構築します。
+
+```plain
+::view-transition
+└─ ::view-transition-group(root)
+  └─ ::view-transition-image-pair(root)
+      ├─ ::view-transition-old(root)
+      └─ ::view-transition-new(root)
+```
+
+> **メモ:** {{cssxref("::view-transition-group")}} のサブツリーは、キャプチャされたそれぞれの `view-transition-name` ごとに作成されます。
+
+同一文書内 (SPA) の遷移の場合、擬似要素ツリーは文書内で利用できます。異なる文書間 (MPA) の遷移の場合、擬似要素ツリーは出力先文書でのみ利用できます。
+
+ツリー構造の最も特徴的な部分は以下の通りです。
+
+- {{cssxref("::view-transition")}} はビュー遷移オーバーレイのルートであり、すべてのビュー遷移のスナップショットグループを格納し、他のすべてのページコンテンツの上に位置します。
+- {{cssxref("::view-transition-group")}} は、各ビュー遷移のスナップショットグループのコンテナーとして機能します。引数 `root` は既定のスナップショットグループを指定し、ビュー遷移アニメーションは `view-transition-name` が `root` であるスナップショットに適用されます。 既定では、これは {{cssxref(":root")}} 要素です。これは、既定のブラウザーのスタイル設定がこれを定義しているためです。
+
+  ```css
+  :root {
+    view-transition-name: root;
+  }
+  ```
+
+  ただし、ページの作成者は、上記の設定を解除し、別の要素に `view-transition-name: root` を設定することで、これを変更できることに注意してください。
+
+- {{cssxref("::view-transition-old")}} は古いページ要素の静的なスナップショットを対象とし、{{cssxref("::view-transition-new")}} は新しいページ要素の動的なスナップショットを対象とします。どちらも、{{htmlelement("img")}} や {{htmlelement("video")}} と同様に置換コンテンツとしてレンダリングされるため、{{cssxref("object-fit")}} や {{cssxref("object-position")}} などの便利なプロパティでスタイル設定できるということです。
+
+> [!NOTE]
+> 異なるカスタムビュー遷移アニメーションを異なる DOM 要素に適用することは可能です。各要素に異なる {{cssxref("view-transition-name")}} を設定することで、異なるアニメーションを適用できます。このような場合、各要素に対して `::view-transition-group` が作成されます。例えば、異なる要素に異なるアニメーションを適用する方法については、[さまざまな要素に対する様々なアニメーション](#さまざまな要素に対する様々なアニメーション)を参照してください。
+
+> [!NOTE]
+> 後ほど説明しますが、流出と流入のアニメーションをカスタマイズするには、それぞれ {{cssxref("::view-transition-old")}} および {{cssxref("::view-transition-new")}} 擬似要素をアニメーションの対象とする必要があります。
+
+## 基本的なビュー遷移の作成
+
+この章では、SPA と MPA のどちらの場合でも、基本的なビュー遷移を作成する方法を示します。
+
+### 基本的な SPA ビュー遷移
+
+例えば、SPA には、新しいコンテンツを取得し、ナビゲーションリンクがクリックされたり、サーバーから更新がプッシュされたりといった何らかのイベントに応答して DOM を更新する機能などを盛り込むことができます。[SPA のビュー遷移のデモ](https://mdn.github.io/dom-examples/view-transitions/spa/)では、この処理を、クリックされたサムネイルに基づいて新しいフルサイズの画像を表示させる `displayNewImage()` 関数に単純化しています。 また、この処理を `updateView()` 関数内にカプセル化し、ブラウザーが対応している場合にのみビュー遷移 API を呼び出すようにしています。
+
+```js
+function updateView(event) {
+  // イベントが発行されたのが <a> と <img> のどちらなのかの違いを処理
+  const targetIdentifier = event.target.firstChild || event.target;
+
+  const displayNewImage = () => {
+    const mainSrc = `${targetIdentifier.src.split("_th.jpg")[0]}.jpg`;
+    galleryImg.src = mainSrc;
+    galleryCaption.textContent = targetIdentifier.alt;
+  };
+
+  // ビュー遷移に未対応のブラウザー用の代替処理
+  if (!document.startViewTransition) {
+    displayNewImage();
+    return;
+  }
+
+  // ビュー遷移の場合
+  const transition = document.startViewTransition(() => displayNewImage());
+}
+```
+
+このコードで、表示されている画像間の遷移を十分に処理できます。対応しているブラウザーでは、古い画像から新しい画像、キャプションへの変更がスムーズなクロスフェード(既定の表示遷移)で表示されます。これは、対応していないブラウザーでも動作しますが、素敵なアニメーションは表示されません。
+
+### 基本的な MPA ビュー遷移
+
+文書間 (MPA) のビュー遷移を作成する際には、SPA の場合よりもさらに処理が簡単になります。JavaScript は必要ありません。ビューの更新は、JavaScript による DOM の変更ではなく、文書間、同一オリジン内の移動によって発生するためです。基本的な MPA ビュー遷移を有効にするには、現在の文書と出力先の文書のどちらもオプトインするように、CSS で {{cssxref("@view-transition")}} アットルールを指定する必要があります。
+
+```css
+@view-transition {
+  navigation: auto;
+}
+```
+
+当社の [MPA のビュー遷移のデモ](https://mdn.github.io/dom-examples/view-transitions/mpa/)では、このアットルールを実際に表示させ、さらに、ビュー遷移の[流出および流入のアニメーションをカスタマイズ](#アニメーションのカスタマイズ)する方法を示しています。
+
+> [!NOTE]
+> 現在、MPA のビュー遷移は同一オリジン文書間でしか作成できませんが、将来的な実装ではこの制限が緩和される可能性があります。
+
+## アニメーションのカスタマイズ
+
+ビュー遷移の擬似要素は、既定で [CSS アニメーション](/ja/docs/Web/CSS/CSS_animations)が設定されています。（詳細は[リファレンスページ](/ja/docs/Web/API/View_Transitions_API#擬似要素)を参照）。
+
+ほとんどの外観の遷移には、前述のとおり、既定でスムーズなクロスフェードのアニメーションが指定されています。ただし、例外もあります。
+
+- `height` と `width` の遷移には、スムーズな拡大縮小アニメーションが適用されます。
+- `position` と `transform` の遷移には、スムーズな動きのアニメーションが適用されます。
+
+既定のアニメーションは、通常の CSS を使用して好きなように変更することができます。"from" アニメーションを対象とするには {{cssxref("::view-transition-old")}} を、"to" アニメーションを対象とするには {{cssxref("::view-transition-new")}} を使用します。
+
+例えば、両方の速度を変更するには、次のようにします。
+
+```css
+::view-transition-old(root),
+::view-transition-new(root) {
+  animation-duration: 0.5s;
+}
+```
+
+`::view-transition-group()` を対象として `::view-transition-old()` と `::view-transition-new()` にスタイルを適用することをお勧めします。擬似要素の階層と既定のユーザーエージェントスタイル設定により、どちらもスタイルが継承されます。例えば次のようにします。
+
+```css
+::view-transition-group(root) {
+  animation-duration: 0.5s;
+}
+```
+
+> [!NOTE]
+> これは、コードを保護するのにも良いオプションです。`::view-transition-group()` もアニメーションするので、 `group`/`image-pair` 擬似要素と `old` および `new` 擬似要素で再生時間が異なるという結果になる可能性があります。
+
+文書間 (MPA) 遷移の場合、ビュー遷移が機能するには、擬似要素を出力先文書にも記載する必要があります。双方向でビュー遷移を使用したい場合は、もちろんどちらにも記載する必要があります。
+
+私たちの [MPA のビュー遷移のデモ](https://mdn.github.io/dom-examples/view-transitions/mpa/)では、上記の CSS を含んでいますが、カスタマイズをさらに一歩進め、カスタムアニメーションを定義し、それを `::view-transition-old(root)` および `::view-transition-new(root)` 擬似要素に適用しています。その結果、ナビゲーションが発生すると、既定のクロスフェード遷移が「スワイプアップ」遷移に置き換わります。
+
+```css
+/* 独自アニメーションの作成 */
+
+@keyframes move-out {
+  from {
+    transform: translateY(0%);
+  }
+
+  to {
+    transform: translateY(-100%);
+  }
+}
+
+@keyframes move-in {
+  from {
+    transform: translateY(100%);
+  }
+
+  to {
+    transform: translateY(0%);
+  }
+}
+
+/* 新旧のページの状態にカスタムアニメーションを適用 */
+
+::view-transition-old(root) {
+  animation: 0.4s ease-in both move-out;
+}
+
+::view-transition-new(root) {
+  animation: 0.4s ease-in both move-in;
+}
+```
+
+## さまざまな要素に対する様々なアニメーション
+
+既定では、ビューの更新中に変更されるそれぞれの要素はすべて、同じアニメーションを使用して遷移します。 既定の `root` アニメーションとは異なるアニメーションを適用したい要素がある場合は、{{cssxref("view-transition-name")}} プロパティを使用してそれらを分離することができます。 例えば、[SPA のビュー遷移のデモ](https://mdn.github.io/dom-examples/view-transitions/spa/)では、{{htmlelement("figcaption")}} 要素に `view-transition-name` として `figure-caption` が指定され、ビュー遷移の観点からページの他の部分と区別されています。
+
+```css
+figcaption {
+  view-transition-name: figure-caption;
+}
+```
+
+この CSS を適用すると、生成された擬似要素ツリーはこのようになります。
+
+```plain
+::view-transition
+├─ ::view-transition-group(root)
+│ └─ ::view-transition-image-pair(root)
+│     ├─ ::view-transition-old(root)
+│     └─ ::view-transition-new(root)
+└─ ::view-transition-group(figure-caption)
+  └─ ::view-transition-image-pair(figure-caption)
+      ├─ ::view-transition-old(figure-caption)
+      └─ ::view-transition-new(figure-caption)
+```
+
+2 つ目の疑似要素を設定することで、`<figcaption>` だけに別個のビュー遷移スタイル設定を適用することができます。 異なる古いビューと新しいビューは、それぞれ別個に処理されます。
+
+> **メモ:** `view-transition-name` の値は、`none` を除いて何らかの値にすることができます。`none` の値は、特定の要素がビュー遷移に参加しないということを意味しています。
+>
+> `view-transition-name` の値も固有のものでなければなりません。 レンダリングされた要素が同時に同じ `view-transition-name` を保有している場合、{{domxref("ViewTransition.ready")}} が拒否され、遷移がスキップされます。
+
+以下のコードは `<figcaption>` だけに独自のアニメーションを適用します。
+
+```css
+@keyframes grow-x {
+  from {
+    transform: scaleX(0);
+  }
+  to {
+    transform: scaleX(1);
+  }
+}
+
+@keyframes shrink-x {
+  from {
+    transform: scaleX(1);
+  }
+  to {
+    transform: scaleX(0);
+  }
+}
+
+::view-transition-group(figure-caption) {
+  height: auto;
+  right: 0;
+  left: auto;
+  transform-origin: right center;
+}
+
+::view-transition-old(figure-caption) {
+  animation: 0.25s linear both shrink-x;
+}
+
+::view-transition-new(figure-caption) {
+  animation: 0.25s 0.25s linear both grow-x;
+}
+```
+
+ここでは、独自の CSS アニメーションを作成し、それを `::view-transition-old(figure-caption)` および `::view-transition-new(figure-caption)` 擬似要素に適用しています。 また、どちらも同じ位置に維持し、既定のスタイルが独自のアニメーションに干渉しないように、他にもいくつかのスタイルを追加しています。
+
+> [!NOTE]
+> 擬似要素の識別子として `*` を使用すると、名前に関係なく、すべてのスナップショット擬似要素を対象とすることができます。例えば、次のようにします。
+>
+> ```css
+> ::view-transition-group(*) {
+>   animation-duration: 2s;
+> }
+> ```
+
+### 既定のアニメーションスタイルの利点
+
+なお、よりシンプルで、より良い結果をもたらす別の遷移オプションも発見しました。最終的な `<figcaption>`ビュー遷移は、以下のような形になりました。
+
+```css
+figcaption {
+  view-transition-name: figure-caption;
+}
+
+::view-transition-group(figure-caption) {
+  height: 100%;
+}
+```
+
+これはうまく動作します。既定では、`::view-transition-group` が、古いビューと新しいビューの間でスムーズに変倍しながら、`width` と `height` を移行させるからです。どちらの状態でも `height` を固定して設定するだけで、うまくいくようになりました。
+
+> **メモ:** [Smooth and simple transitions with the View Transitions API](https://developer.chrome.com/docs/web-platform/view-transitions/) には、他にもいくつかのカスタマイズ例があります。
+
+## JavaScript によるビュー遷移の制御
+
+ビュー遷移には、{{domxref("ViewTransition")}} オブジェクトのインスタンスが関連付けられており、このオブジェクトには、遷移のさまざまな状態に到達した際に JavaScript を実行できるようにするプロミスメンバーがいくつかあります。例えば、{{domxref("ViewTransition.ready")}} は、擬似要素ツリーが作成され、アニメーションが開始されると履行され、 {{domxref("ViewTransition.finished")}} は、アニメーションが終了し、新しいページビューがユーザーに対して表示され、操作可能になると履行されます。
+
+`ViewTransition` には次のようにアクセスできます。
+
+1. 同一文書内 (SPA) の遷移の場合、{{domxref("Document.startViewTransition()", "document.startViewTransition()")}} メソッドが遷移に関連付けられた `ViewTransition` を返します。
+2. 文書間 (MPA) の遷移の場合は、次のようになります。
+
+   - ナビゲーションにより文書がアンロードされようとするときに、{{domxref("Window.pageswap_event", "pageswap")}} イベントが発行されます。イベントオブジェクト ({{domxref("PageSwapEvent")}}) は、`ViewTransition` に{{domxref("PageSwapEvent.viewTransition")}} プロパティからアクセスできるほか、ナビゲーションの種類と現在の文書および移動先文書の履歴項目を含む {{domxref("NavigationActivation")}} にも {{domxref("PageSwapEvent.activation")}} からアクセスできます。
+     > [!NOTE]
+     > ナビゲーションのリダイレクトチェーンのどこかにオリジンをまたいだ URL がある場合、`activation` プロパティは `null` を返します。
+   - ページが最初にレンダリングされると、{{domxref("Window.pagereveal_event", "pagereveal")}} イベントが発生します。これは、ネットワークから新しい文書を読み込んだ場合、または（[バック/フォワードキャッシュ](/ja/docs/Glossary/bfcache) (bfcache) または[事前レンダリング](/ja/docs/Glossary/Prerender)）文書をアクティブにした場合です。イベントオブジェクト ({{domxref("PageRevealEvent")}}) は、`ViewTransition` に {{domxref("PageRevealEvent.viewTransition")}} プロパティを介してアクセスできます。
+
+これらの機能がどのように使用できるかを示すために、いくつかのコード例を見ていきましょう。
+
+### JavaScript を活用した独自の文書内 (SPA) 遷移
+
+以下の JavaScript を使用することで、クリック時にユーザーのカーソル位置から円形の「リベール」ビュー遷移を作成することができます。{{domxref("Web Animations API", "ウェブアニメーション API", "", "nocode")}} で指定されたアニメーションが提供されます。
+
+```js
+// 最後のクリックイベントを格納
+let lastClick;
+addEventListener("click", (event) => (lastClick = event));
+
+function spaNavigate(data) {
+  // この API に対応していないブラウザー用の代替処理
+  if (!document.startViewTransition) {
+    updateTheDOMSomehow(data);
+    return;
+  }
+
+  // クリック位置を取得し、失敗時は画面の中央にする
+  const x = lastClick?.clientX ?? innerWidth / 2;
+  const y = lastClick?.clientY ?? innerHeight / 2;
+  // 最も遠い角までの距離を取得
+  const endRadius = Math.hypot(
+    Math.max(x, innerWidth - x),
+    Math.max(y, innerHeight - y),
+  );
+
+  // 遷移を作成
+  const transition = document.startViewTransition(() => {
+    updateTheDOMSomehow(data);
+  });
+
+  // 擬似要素が作成されるまで待つ
+  transition.ready.then(() => {
+    // ルート要素の新しいビューをアニメーション
+    document.documentElement.animate(
+      {
+        clipPath: [
+          `circle(0 at ${x}px ${y}px)`,
+          `circle(${endRadius}px at ${x}px ${y}px)`,
+        ],
+      },
+      {
+        duration: 500,
+        easing: "ease-in",
+        // Specify which pseudo-element to animate
+        pseudoElement: "::view-transition-new(root)",
+      },
+    );
+  });
+}
+```
+
+このアニメーションでは、以下の CSS も必要となります。これは、既定の CSS アニメーションを無効にし、新旧のビューの状態が混ざり合うのを防ぐためです（遷移ではなく新しい状態が古い状態の上に「ワイプ」されるようになります）。
+
+```css
+::view-transition-image-pair(root) {
+  isolation: auto;
+}
+
+::view-transition-old(root),
+::view-transition-new(root) {
+  animation: none;
+  mix-blend-mode: normal;
+  display: block;
+}
+```
+
+### JavaScript を活用した独自の文書間 (MPA) 遷移
+
+[List of Chrome DevRel team members](https://view-transitions.netlify.app/profiles/mpa/) のデモでは、チームのプロフィールページの基本設定を提供し、{{domxref("Window.pageswap_event", "pageswap")}} および {{domxref("Window.pagereveal_event", "pagereveal")}} イベントを使用して、"from" と "to" の URL に基づいて、文書間ビュー遷移における流出・流入アニメーションをカスタマイズする方法を説明しています。
+
+{{domxref("Window.pageswap_event", "pageswap")}} イベントのリスナーは次のようになります。これにより、プロフィールページにリンクする、流出ページ上の要素にビュー遷移の名前が設定されます。ホームページからプロフィールページに移動する際、クリックされたリンク要素に対してのみ、独自のアニメーションが指定されます。
+
+```js
+window.addEventListener("pageswap", async (e) => {
+  // アクティブなビュー遷移が存在する場合のみ実行
+  if (e.viewTransition) {
+    const currentUrl = e.activation.from?.url
+      ? new URL(e.activation.from.url)
+      : null;
+    const targetUrl = new URL(e.activation.entry.url);
+
+    // プロフィールページからホームページへ移動
+    // ~> 大きな画像とタイトルが一時一度に表示される
+    if (isProfilePage(currentUrl) && isHomePage(targetUrl)) {
+      // アニメーションさせる要素に view-transition-name の値を設定
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが撮影された後、ビュー遷移名を除去する
+      // BFCache にページの状態が維持されることによる名前の競合を防止する
+      await e.viewTransition.finished;
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "none";
+    }
+
+    // Going to profile page
+    // ~> The clicked items are the ones!
+    if (isProfilePage(targetUrl)) {
+      const profile = extractProfileNameFromUrl(targetUrl);
+
+      // アニメーションさせる要素に view-transition-name の値を設定
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが撮影された後、ビュー遷移名を除去する
+      // BFCache にページの状態が維持されることによる名前の競合を防止する
+      await e.viewTransition.finished;
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "none";
+    }
+  }
+});
+```
+
+> **メモ:** `view-transition-name` の値は、それぞれの場合でスナップショットが取得された後に除去します。 設定したままにしておくと、ナビゲーションの際に [bfcache](/ja/docs/Glossary/bfcache) に保存されるページの状態に保存されてしまいます。 その後、戻るボタンが押されると、ナビゲーション前のページの `pagereveal` イベントハンドラーが、異なる要素に対して同じ `view-transition-name` の値を設定しようと試みます。 複数の要素に同じ `view-transition-name` 設定されている場合、ビュー遷移はスキップされます。
+
+{{domxref("Window.pagereveal_event", "pagereveal")}} イベントのリスナーは、以下のようにします。これは、`pageswap` イベントリスナーと似た方法で動作しますが、新しいページのページ要素に対して "to" アニメーションをカスタマイズしていることに留意してください。
+
+```js
+window.addEventListener("pagereveal", async (e) => {
+  // "from" 履歴項目が存在しない場合は、戻る
+  if (!navigation.activation.from) return;
+
+  // アクティブなビュー遷移が存在する場合のみ実行
+  if (e.viewTransition) {
+    const fromUrl = new URL(navigation.activation.from.url);
+    const currentUrl = new URL(navigation.activation.entry.url);
+
+    // プロフィールページからホームページに移動
+    // ~> VT 名を関連するリストアイテムに設定
+    if (isProfilePage(fromUrl) && isHomePage(currentUrl)) {
+      const profile = extractProfileNameFromUrl(fromUrl);
+
+      // アニメーションさせる要素に view-transition-name の値を設定
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが撮影された後に名前を除去する
+      // そのため、次のナビゲーションに備えることができる
+      await e.viewTransition.ready;
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "none";
+    }
+
+    // プロフィールページへ移動した
+    // ~> メインタイトルと画像に VT 名を追加
+    if (isProfilePage(currentUrl)) {
+      // アニメーションさせる要素に view-transition-name の値を設定
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが撮影された後に名前を除去する
+      // そのため、次のナビゲーションに備えることができる
+      await e.viewTransition.ready;
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "none";
+    }
+  }
+});
+```
+
+## ページの状態を安定化させ、文書間の遷移を一貫性のあるものにする
+
+文書間の遷移を実行する前に、[レンダーブロック](/ja/docs/Glossary/Render_blocking)を利用してページの状態が安定するまで待つのが理想的です。
+
+1. 重要なスタイルが読み込まれ、適用されます。
+2. 重要なスクリプトが読み込まれ、実行されます。
+3. ユーザーが最初にページを表示した際に目にする HTML は解釈できるので、一貫した表示が可能です。
+
+スタイルは既定ではレンダーブロックされ、スクリプトは [`blocking="render"`](/ja/docs/Web/HTML/Element/script#blocking) 属性を使用してレンダーブロックすることができます。
+
+遷移アニメーションが実行される前に、初期の HTML が確実に解析され、常に一貫したレンダリングが行われることを保証するには、[`<link rel="expect">`](/ja/docs/Web/HTML/Attributes/rel#expect) を使用することができます。この要素には、以下の属性を含めることができます。
+
+- `rel="expect"` は、この `<link>` 要素を使用して、ページ上の HTML をレンダーブロックすることを示します。
+- `href="#element-id"` は、レンダーブロックしたい要素の ID を示します。
+- `blocking="render"` は、指定された HTML のレンダーブロックをします。
+
+この例を単純な例の HTML 文書で見ていきましょう。
+
+```html-nolint
+<!doctype html>
+<html lang="ja">
+  <head>
+    <!-- これは既定でレンダーブロックされる -->
+    <link rel="stylesheet" href="style.css" />
+
+    <!-- 重要なスクリプトをレンダーブロックとしてマークすると、
+         ビュー遷移が有効化される前に確実に実行されるよう保証される -->
+    <script async href="layout.js" blocking="render"></script>
+
+    <!-- rel="expect" およびお blocking="render" を使用して、
+         "#lead-content" 要素が確実に表示され、完全に解釈できる状態に
+         したまま、遷移を起動する -->
+    <link rel="expect" href="#lead-content" blocking="render" />
+  </head>
+  <body>
+    <h1>Page title</h1>
+    <nav>...</nav>
+    <div id="lead-content">
+      <section id="first-section">最初の節</section>
+      <section>二番目の節</section>
+    </div>
+  </body>
+</html>
+```
+
+その結果、リードコンテンツである `<div>` が解釈できるまで、文書内のレンダリングがブロックされ、一貫したビュー遷移を保証できます。
+
+また、 [`media`](/ja/docs/Web/HTML/Element/link#media) 属性を `<link rel="expect">` 要素に指定することもできます。例えば、画面が狭い端末でページを読み込んだ際には、広い画面の端末で読み込む場合よりも、コンテンツのレンダリングをブロックしたい場合があるかもしれません。これは理にかなっています。モバイル端末では、デスクトップの場合よりも、ページが最初に読み込まれた際にはコンテンツが少なく表示されるからです。
+
+これは、次の HTML で実現できます。
+
+```html
+<link
+  rel="expect"
+  href="#lead-content"
+  blocking="render"
+  media="screen and (min-width: 641px)" />
+<link
+  rel="expect"
+  href="#first-section"
+  blocking="render"
+  media="screen and (max-width: 640px)" />
+```

From c9657aa0406112239eb3a60e7481fa34aa0238b7 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 22:51:58 +0900
Subject: [PATCH 060/115] =?UTF-8?q?2024/07/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pagerevealevent/index.md | 103 ++++++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 files/ja/web/api/pagerevealevent/index.md

diff --git a/files/ja/web/api/pagerevealevent/index.md b/files/ja/web/api/pagerevealevent/index.md
new file mode 100644
index 00000000000000..c5519c8a648ad2
--- /dev/null
+++ b/files/ja/web/api/pagerevealevent/index.md
@@ -0,0 +1,103 @@
+---
+title: PageRevealEvent
+slug: Web/API/PageRevealEvent
+l10n:
+  sourceCommit: 6336af7a3880c350919e5b29f83b938fb1594362
+---
+
+{{APIRef("HTML DOM")}}{{SeeCompatTable}}
+
+**`PageRevealEvent`** イベントオブジェクトは、{{domxref("Window.pagereveal_event", "pagereveal")}} イベントのハンドラー関数内で利用できます。
+
+文書間の移動中、ナビゲーションによってビュー遷移が起動された場合、移動先の文書から関連する[ビュー遷移](/ja/docs/Web/API/View_Transitions_API)（関連の {{domxref("ViewTransition")}} オブジェクトにアクセスする）を操作することができます。
+
+ビュー遷移以外にも、このイベントは、開始アニメーションの起動やページビューの報告などの場合に役立ちます。これは、文書の {{htmlelement("head")}} 内で `requestAnimationFrame()` を起動した場合、文書間移動後に最初の {{domxref("Window.requestAnimationFrame()")}} が実行されるのと同じです。例えば、次の `reveal()` 関数を `<head>` 内で実行した場合:
+
+```js
+function reveal() {
+  // 開始アニメーションをここに入れる
+}
+/* これは、読み込んだ後にレンダリングされる最初のフレームで発行されます。 */
+requestAnimationFrame(() => reveal());
+
+/* ページが BFCache から復元された場合に発行されます。 */
+window.onpagehide = () => requestAnimationFrame(() => reveal());
+```
+
+## コンストラクター
+
+- {{domxref("PageRevealEvent.PageRevealEvent", "PageRevealEvent()")}} {{experimental_inline}}
+  - : 新しい `PageRevealEvent` オブジェクトのインスタンスを作成します。
+
+## インスタンスプロパティ
+
+- {{domxref("PageRevealEvent.viewTransition", "viewTransition")}} {{ReadOnlyInline}} {{Experimental_Inline}}
+  - : 文書間のナビゲーションにおけるアクティブなビュー遷移を 表す {{domxref("ViewTransition")}} オブジェクトを保持しています。
+
+## 例
+
+```js
+window.addEventListener("pagereveal", async (e) => {
+  // "from" 履歴項目が存在しない場合は戻る
+  if (!navigation.activation.from) return;
+
+  // アクティブなビュー遷移が存在する場合のみ実行
+  if (e.viewTransition) {
+    const fromUrl = new URL(navigation.activation.from.url);
+    const currentUrl = new URL(navigation.activation.entry.url);
+
+    // プロフィールページからホームページに移動
+    // ~> VT 名を関連するリストアイテムに設定
+    if (isProfilePage(fromUrl) && isHomePage(currentUrl)) {
+      const profile = extractProfileNameFromUrl(fromUrl);
+
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、名前を除去
+      // そうすることで、次のナビゲーションの準備ができる
+      await e.viewTransition.ready;
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "none";
+    }
+
+    // Went to profile page
+    // ~> Set VT names on the main title and image
+    if (isProfilePage(currentUrl)) {
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、名前を除去
+      // そうすることで、次のナビゲーションの準備ができる
+      await e.viewTransition.ready;
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "none";
+    }
+  }
+});
+```
+
+> [!NOTE]
+> このコードの採取元のライブデモは、[List of Chrome DevRel team members](https://view-transitions.netlify.app/profiles/mpa/) を参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)

From 39b21c739069adf48653a8ec9ca2f2a7ac6bd03b Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 23:00:24 +0900
Subject: [PATCH 061/115] =?UTF-8?q?2024/07/25=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pagerevealevent/pagerevealevent/index.md  | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 files/ja/web/api/pagerevealevent/pagerevealevent/index.md

diff --git a/files/ja/web/api/pagerevealevent/pagerevealevent/index.md b/files/ja/web/api/pagerevealevent/pagerevealevent/index.md
new file mode 100644
index 00000000000000..eeda9105249dc5
--- /dev/null
+++ b/files/ja/web/api/pagerevealevent/pagerevealevent/index.md
@@ -0,0 +1,42 @@
+---
+title: "PageRevealEvent: PageRevealEvent() コンストラクター"
+short-title: PageRevealEvent()
+slug: Web/API/PageRevealEvent/PageRevealEvent
+l10n:
+  sourceCommit: cd809f324e890917837ebe5194c934543d4a5464
+---
+
+{{APIRef("HTML DOM")}}{{SeeCompatTable}}
+
+**`PageRevealEvent()`** コンストラクターは、新しい {{domxref("PageRevealEvent")}} オブジェクトインスタンスを作成します。
+
+## 構文
+
+```js-nolint
+new PageRevealEvent(type, init)
+```
+
+### 引数
+
+- `type`
+  - : イベントの種類の表す文字列。 `PageRevealEvent` の場合は、常に `pagereveal` です。
+- `init`
+  - : 以下のプロパティを持つオブジェクト。
+    - `viewTransition` {{optional_inline}}
+      - : {{domxref("ViewTransition")}} オブジェクトで、関連するナビゲーションにおけるアクティブなビュー遷移を表します。アクティブなビュー遷移がない場合は、既定で `null` となります。
+
+## 例
+
+開発者はこのコンストラクターを手動で使用することはありません。 {{domxref("Window.pagereveal_event", "pagereveal")}} イベントが発生した結果としてハンドラーが呼び出されたときに、新しい `PageRevealEvent` オブジェクトが構築されます。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)

From fd01646e67c5086930fa11653643e744629ba3e7 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 8 Sep 2024 23:07:16 +0900
Subject: [PATCH 062/115] =?UTF-8?q?2024/06/23=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../pagerevealevent/viewtransition/index.md   | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 files/ja/web/api/pagerevealevent/viewtransition/index.md

diff --git a/files/ja/web/api/pagerevealevent/viewtransition/index.md b/files/ja/web/api/pagerevealevent/viewtransition/index.md
new file mode 100644
index 00000000000000..979c1b62adc4f4
--- /dev/null
+++ b/files/ja/web/api/pagerevealevent/viewtransition/index.md
@@ -0,0 +1,32 @@
+---
+title: "PageRevealEvent: viewTransition プロパティ"
+short-title: viewTransition
+slug: Web/API/PageRevealEvent/viewTransition
+l10n:
+  sourceCommit: 722311032dbf520bf6aeba3d1f432aca38779ffd
+---
+
+{{APIRef("HTML DOM")}}{{SeeCompatTable}}
+
+**`viewTransition`** は {{domxref("PageRevealEvent")}} インターフェイスの読み取り専用プロパティで、文書間のナビゲーションでアクティブなビュー遷移を表す {{domxref("ViewTransition")}} オブジェクトが含まれています。
+
+## 値
+
+{{domxref("ViewTransition")}} オブジェクト、またはイベントが発行される際にアクティブなビュー遷移がない場合は `null`。
+
+## 例
+
+{{domxref("PageRevealEvent")}} のメインページを参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ナビゲーション API](/ja/docs/Web/API/Navigation_API)
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)

From 234e6e93f29908e6144e2ea622f3d9abfc7b83d9 Mon Sep 17 00:00:00 2001
From: Takayoshi Sawada <sawadasuiren@gmail.com>
Date: Fri, 13 Sep 2024 00:17:08 +0900
Subject: [PATCH 063/115] fix: patch webxr document for ja (#23475)

fix: patch webxr document
---
 files/ja/web/api/webxr_device_api/fundamentals/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/ja/web/api/webxr_device_api/fundamentals/index.md b/files/ja/web/api/webxr_device_api/fundamentals/index.md
index 5cd70dc45ca888..01ab96802cbb84 100644
--- a/files/ja/web/api/webxr_device_api/fundamentals/index.md
+++ b/files/ja/web/api/webxr_device_api/fundamentals/index.md
@@ -149,7 +149,7 @@ XR ゴーグルは、シミュレーションシーンの奥行きを再現す
 
 没入型仮想現実のもう一つの潜在的な問題は、ユーザーがヘッドセットを装着したまま部屋の中を移動した場合、物理的な障害物に衝突してしまうことです。安全な環境でない限り、物理的な環境の中で安全だとわかっている空間をシミュレーションするなど、ユーザーの動きを制限する手がかりを提供することが重要です。
 
-ユーザーのヘッドセットが機器につながれている場合、ユーザーがヘッドセットのコードを引っ張ったり引っ張ったりするような動きを促したり誘惑したりしないようにするのがよいでしょう。これは、怪我を引き起こすだけでなく、ユーザーのヘッドセットまたは機器（電話かコンピュータかにかかわらず）に大きな損傷を与える可能性があります。
+ユーザーのヘッドセットが機器につながれている場合、ユーザーがヘッドセットのコードを引っ張ったりするような動きを促したり誘惑したりしないようにするのがよいでしょう。これは、怪我を引き起こすだけでなく、ユーザーのヘッドセットまたは機器（電話かコンピュータかにかかわらず）に大きな損傷を与える可能性があります。
 
 どのようなユーザーにとっても危険な状況になる可能性があるコンテンツがある場合は、警告メッセージを表示する必要があります。同様に、可能であれば座ったままでいること、完全没入型バーチャルリアリティを体験する場合は、ヘッドセットを装着したまま動き回ることに注意するよう、ユーザーに注意を促すとよいでしょう。後悔するよりも、安全であることが一番です。
 

From dd2e9072ecda89dec7de7b7bcefef1a9cc4521fe Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 13 Sep 2024 08:53:09 +0800
Subject: [PATCH 064/115] build(deps): bump husky from 9.1.5 to 9.1.6 (#23524)

---
 package.json | 2 +-
 yarn.lock    | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/package.json b/package.json
index 5caa1f10656461..0adf8aabd2276c 100644
--- a/package.json
+++ b/package.json
@@ -31,7 +31,7 @@
     "cld": "^2.10.0",
     "fdir": "^6.3.0",
     "front-matter": "^4.0.2",
-    "husky": "9.1.5",
+    "husky": "9.1.6",
     "lint-staged": "15.2.10",
     "markdown-it": "^14.1.0",
     "markdownlint-cli2": "0.14.0",
diff --git a/yarn.lock b/yarn.lock
index 752e67ea06ee4f..96df4edfd2f8dc 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -402,10 +402,10 @@ human-signals@^5.0.0:
   resolved "https://registry.yarnpkg.com/human-signals/-/human-signals-5.0.0.tgz#42665a284f9ae0dade3ba41ebc37eb4b852f3a28"
   integrity sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==
 
-husky@9.1.5:
-  version "9.1.5"
-  resolved "https://registry.yarnpkg.com/husky/-/husky-9.1.5.tgz#2b6edede53ee1adbbd3a3da490628a23f5243b83"
-  integrity sha512-rowAVRUBfI0b4+niA4SJMhfQwc107VLkBUgEYYAOQAbqDCnra1nYh83hF/MDmhYs9t9n1E3DuKOrs2LYNC+0Ag==
+husky@9.1.6:
+  version "9.1.6"
+  resolved "https://registry.yarnpkg.com/husky/-/husky-9.1.6.tgz#e23aa996b6203ab33534bdc82306b0cf2cb07d6c"
+  integrity sha512-sqbjZKK7kf44hfdE94EoX8MZNk0n7HeW37O4YrVGCF4wzgQjp+akPAkfUK5LZ6KuR/6sqeAVuXHji+RzQgOn5A==
 
 ignore@^5.2.4:
   version "5.2.4"

From c5a252c219f22bbd5be1d0d5e5d0e84cd1ea7aec Mon Sep 17 00:00:00 2001
From: abing <abing22333@163.com>
Date: Fri, 13 Sep 2024 10:56:27 +0800
Subject: [PATCH 065/115] zh-CN: update 'images in html' (#23515)

---
 .../images_in_html/index.md                        | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/files/zh-cn/learn/html/multimedia_and_embedding/images_in_html/index.md b/files/zh-cn/learn/html/multimedia_and_embedding/images_in_html/index.md
index 4eaf45067f5a81..c0c28e44d35e30 100644
--- a/files/zh-cn/learn/html/multimedia_and_embedding/images_in_html/index.md
+++ b/files/zh-cn/learn/html/multimedia_and_embedding/images_in_html/index.md
@@ -306,12 +306,12 @@ window.addEventListener("load", updateCode);
 // 而是在当前光标位置插入一个制表符
 
 textarea.onkeydown = (e) => {
-  if (e.keyCode === 9) {
+  if (e.code === "Tab") {
     e.preventDefault();
     insertAtCaret("\t");
   }
 
-  if (e.keyCode === 27) {
+  if (e.code === "Escape") {
     textarea.blur();
   }
 };
@@ -370,7 +370,7 @@ textarea.onkeyup = function () {
 
 #### 自由许可
 
-如果图像是根据自由许可发布的，例如 [MIT](https://mit-license.org/)、[BSD](https://opensource.org/license/BSD-3-clause/) 或适当的[知识共享（CC）许可](https://creativecommons.org/choose/)，你无需支付许可费用或寻求许可即可使用它。但是，你仍需履行各种许可条件，这些条件因许可而异。
+如果图像是根据自由许可发布的，例如 [MIT](https://mit-license.org/)、[BSD](https://opensource.org/license/BSD-3-clause) 或适当的[知识共享（CC）许可](https://chooser-beta.creativecommons.org/)，你无需支付许可费用或寻求许可即可使用它。但是，你仍需履行各种许可条件，这些条件因许可而异。
 
 例如，你可能需要：
 
@@ -394,7 +394,7 @@ Copyleft 许可在软件界中很常见。其基本思想是使用 copyleft 许
 
 进入公共领域的作品有时被称为“无版权保留”——它们不受版权保护，可以在未经许可且无需履行任何许可条件的情况下使用。作品可以因为版权到期或特定放弃权利等方式进入公共领域。
 
-将作品置于公共领域的最有效方法之一是将其许可为 [CC0](https://creativecommons.org/share-your-work/public-domain/cc0/)，这是一种特定的创作共用许可，为此目的提供了清晰明确的法律工具。
+将作品置于公共领域的最有效方法之一是将其许可为 [CC0](https://creativecommons.org/public-domain/cc0/)，这是一种特定的创作共用许可，为此目的提供了清晰明确的法律工具。
 
 在使用公共领域图像时，请获取证明该图像属于公共领域的证据，并将该证据保存记录。例如，使用截图记录原始来源（该来源需要清晰显示许可状态），并考虑在你的网站上添加一个页面，列出所获得的图像及其许可要求。
 
@@ -406,7 +406,7 @@ Copyleft 许可在软件界中很常见。其基本思想是使用 copyleft 许
 
 某些搜索引擎会提供工具，帮助你查找具有自由许可的图像。例如，使用 Google 时，转到“图片”选项卡搜索图像，然后单击“工具”。在结果工具栏中有一个“使用权限”下拉菜单，你可以选择专门搜索根据创作共用许可授权的图像。
 
-图像存储库网站，例如 [Flickr](https://flickr.com/)、[ShutterStock](https://www.shutterstock.com) 和 [Pixabay](https://pixabay.com/)，具有搜索选项，允许你仅搜索具有自由许可的图像。一些网站专门分发具有自由许可的图像和图标，例如 [Picryl](https://picryl.com) 和 [The Noun Project](https://thenounproject.com/)。
+图像存储库网站，例如 [Flickr](https://flickr.com/)、[ShutterStock](https://www.shutterstock.com/) 和 [Pixabay](https://pixabay.com/)，具有搜索选项，允许你仅搜索具有自由许可的图像。一些网站专门分发具有自由许可的图像和图标，例如 [Picryl](https://picryl.com/) 和 [The Noun Project](https://thenounproject.com/)。
 
 要想遵守图像发布的许可条件，你需要找到许可详细信息，阅读来源提供的许可证或指示页面，然后按照这些说明操作。值得信赖的图像存储库会清楚地列出其许可条件，并且易于查找。
 
@@ -551,12 +551,12 @@ window.addEventListener("load", updateCode);
 // 而是在当前光标位置插入一个制表符
 
 textarea.onkeydown = (e) => {
-  if (e.keyCode === 9) {
+  if (e.code === "Tab") {
     e.preventDefault();
     insertAtCaret("\t");
   }
 
-  if (e.keyCode === 27) {
+  if (e.code === "Escape") {
     textarea.blur();
   }
 };

From a6a6691053b5e22acbdf2861bb3875585d99ded2 Mon Sep 17 00:00:00 2001
From: contradiction29 <sora32127@gmail.com>
Date: Mon, 9 Sep 2024 22:25:17 +0900
Subject: [PATCH 066/115] Correct notation distortion

---
 files/ja/learn/server-side/express_nodejs/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/ja/learn/server-side/express_nodejs/index.md b/files/ja/learn/server-side/express_nodejs/index.md
index cc12427f57cd2b..ea3b09f7e5f21f 100644
--- a/files/ja/learn/server-side/express_nodejs/index.md
+++ b/files/ja/learn/server-side/express_nodejs/index.md
@@ -20,7 +20,7 @@ Express は、JavaScript で書かれ、Node.js 実行環境内でホストさ
 
 ## ガイド
 
-- [Express/Node の入門](/ja/docs/Learn/Server-side/Express_Nodejs/Introduction)
+- [Express/Node の紹介](/ja/docs/Learn/Server-side/Express_Nodejs/Introduction)
   - : この最初の Express 記事では、"Node とは何ですか？"、"Express とは何ですか？" という質問に答えます。Express ウェブフレームワークが特別になった理由の概要を説明します。主な機能の概要を説明し、Express アプリケーションの主な構成要素をいくつか紹介します (ただし、現時点ではテスト用の開発環境はまだありません)。
 - [Node (Express) 開発環境の設定](/ja/docs/Learn/Server-side/Express_Nodejs/development_environment)
   - : Express の目的がわかったので、Windows、Linux (Ubuntu)、および macOS 上で Node/Express 開発環境を設定およびテストする方法を説明します。この記事は、オペレーティングシステム共通の、Express アプリの開発を始めるために必要なものを提供します。

From fe98c353451e8d9045337240ddde56b193d23cd0 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 10 Sep 2024 00:13:43 +0900
Subject: [PATCH 067/115] =?UTF-8?q?2024/07/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/pageswapevent/index.md | 91 +++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 files/ja/web/api/pageswapevent/index.md

diff --git a/files/ja/web/api/pageswapevent/index.md b/files/ja/web/api/pageswapevent/index.md
new file mode 100644
index 00000000000000..cf6867173a23e4
--- /dev/null
+++ b/files/ja/web/api/pageswapevent/index.md
@@ -0,0 +1,91 @@
+---
+title: PageSwapEvent
+slug: Web/API/PageSwapEvent
+l10n:
+  sourceCommit: 6336af7a3880c350919e5b29f83b938fb1594362
+---
+
+{{APIRef("HTML DOM")}}{{SeeCompatTable}}
+
+**`PageSwapEvent`** イベントオブジェクトは、 {{domxref("Window.pageswap_event", "pageswap")}} イベントのハンドラー関数内で利用できます。
+
+`pageswap` イベントは、前の文書がアンロードされようとしているときに、文書間を移動するときに発行されます。文書間の移動中に、`PageSwapEvent` イベントオブジェクトを使用すると、移動元の文書から関連する[ビュー遷移](/ja/docs/Web/API/View_Transitions_API)（関連する {{domxref("ViewTransition")}} オブジェクトにアクセス）を操作することができます。また、ナビゲーションの種類や現在の文書と出力先文書に関する情報にもアクセスできます。
+
+## コンストラクター
+
+- {{domxref("PageSwapEvent.PageSwapEvent", "PageSwapEvent()")}} {{experimental_inline}}
+  - : 新しい `PageSwapEvent` オブジェクトインスタンスを作成します。
+
+## インスタンスプロパティ
+
+- {{domxref("PageSwapEvent.activation", "activation")}} {{ReadOnlyInline}} {{Experimental_Inline}}
+  - : {{domxref("NavigationActivation")}} オブジェクトを保持しており、これは、同一オリジン内の移動に関するナビゲーション種別と、移動元および移動先の文書履歴項目が含まれています。ナビゲーションのリダイレクトチェーンのどこかにオリジンをまたぐ URL がある場合は、`null` が返されます。
+- {{domxref("PageSwapEvent.viewTransition", "viewTransition")}} {{ReadOnlyInline}} {{Experimental_Inline}}
+  - : 文書間のナビゲーションにおけるアクティブなビュー遷移を表す {{domxref("ViewTransition")}} オブジェクトを保持しています。
+
+## 例
+
+```js
+window.addEventListener("pageswap", async (e) => {
+  // アクティブなビュー遷移が存在する場合のみ実行
+  if (e.viewTransition) {
+    const currentUrl = e.activation.from?.url
+      ? new URL(e.activation.from.url)
+      : null;
+    const targetUrl = new URL(e.activation.entry.url);
+
+    // プロフィールページからホームページへ移動
+    // ~> それぞれの大きな画像とタイトル
+    if (isProfilePage(currentUrl) && isHomePage(targetUrl)) {
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、view-transition-names を除去
+      // BFCacheにページの状態が保持されたことによる名前の競合を回避
+      await e.viewTransition.finished;
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "none";
+    }
+
+    // プロフィールページへ移動
+    // ~> クリックしたアイテム
+    if (isProfilePage(targetUrl)) {
+      const profile = extractProfileNameFromUrl(targetUrl);
+
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、view-transition-names を除去
+      // BFCacheにページの状態が保持されたことによる名前の競合を回避
+      await e.viewTransition.finished;
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "none";
+    }
+  }
+});
+```
+
+> [!NOTE]
+> このコードの採取元のライブデモは、[List of Chrome DevRel team members](https://view-transitions.netlify.app/profiles/mpa/) を参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)

From a77a88a4b74f5d44e9c0fc1da40e000a01d10504 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 10 Sep 2024 00:21:39 +0900
Subject: [PATCH 068/115] =?UTF-8?q?2024/07/25=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../api/pageswapevent/pageswapevent/index.md  | 44 +++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 files/ja/web/api/pageswapevent/pageswapevent/index.md

diff --git a/files/ja/web/api/pageswapevent/pageswapevent/index.md b/files/ja/web/api/pageswapevent/pageswapevent/index.md
new file mode 100644
index 00000000000000..50ab3ffe07a984
--- /dev/null
+++ b/files/ja/web/api/pageswapevent/pageswapevent/index.md
@@ -0,0 +1,44 @@
+---
+title: "PageSwapEvent: PageSwapEvent() コンストラクター"
+short-title: PageSwapEvent()
+slug: Web/API/PageSwapEvent/PageSwapEvent
+l10n:
+  sourceCommit: cd809f324e890917837ebe5194c934543d4a5464
+---
+
+{{APIRef("HTML DOM")}}{{SeeCompatTable}}
+
+**`PageSwapEvent()`** コンストラクターは、新しい {{domxref("PageSwapEvent")}} オブジェクトのインスタンスを作成します。
+
+## 構文
+
+```js-nolint
+new PageSwapEvent(type, init)
+```
+
+### 引数
+
+- `type`
+  - : イベントの型を表す文字列。`PageSwapEvent` の場合、これは常に `pageswap` です。
+- `init`
+  - : 以下のプロパティを持つオブジェクト。
+    - `activation`
+      - : {{domxref("NavigationActivation")}} オブジェクトを保持しており、これは、同一オリジン内の移動に関するナビゲーション種別と、移動元および移動先の文書履歴項目が含まれています。ナビゲーションのリダイレクトチェーンのどこかにオリジンをまたぐ URL がある場合は、`null` が返されます。
+    - `viewTransition`
+      - : 文書間のナビゲーションにおけるアクティブなビュー遷移を表す {{domxref("ViewTransition")}} オブジェクトを保持しています。アクティブなビュー遷移がない場合は既定で `null` です。
+
+## 例
+
+開発者はこのコンストラクターを手動で使用することはありません。 {{domxref("Window.pageswap_event", "pageswap")}} イベントが発生した結果としてハンドラーが呼び出されたときに、新しい `PageSwapEvent` オブジェクトが構築されます。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)

From b3cb32b01410f77a13b227bbc8afaf4c32962c4f Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 10 Sep 2024 00:25:42 +0900
Subject: [PATCH 069/115] =?UTF-8?q?2024/06/23=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../web/api/pageswapevent/activation/index.md | 31 +++++++++++++++++++
 .../api/pageswapevent/viewtransition/index.md | 31 +++++++++++++++++++
 2 files changed, 62 insertions(+)
 create mode 100644 files/ja/web/api/pageswapevent/activation/index.md
 create mode 100644 files/ja/web/api/pageswapevent/viewtransition/index.md

diff --git a/files/ja/web/api/pageswapevent/activation/index.md b/files/ja/web/api/pageswapevent/activation/index.md
new file mode 100644
index 00000000000000..7086fca5ed9def
--- /dev/null
+++ b/files/ja/web/api/pageswapevent/activation/index.md
@@ -0,0 +1,31 @@
+---
+title: "PageSwapEvent: activation プロパティ"
+short-title: activation
+slug: Web/API/PageSwapEvent/activation
+l10n:
+  sourceCommit: 722311032dbf520bf6aeba3d1f432aca38779ffd
+---
+
+{{APIRef("HTML DOM")}}{{SeeCompatTable}}
+
+**`activation`** は {{domxref("PageSwapEvent")}} インターフェイスの読み取り専用プロパティで、これは、同一オリジン内の移動に関するナビゲーション種別と、移動元および移動先の文書履歴項目が含む {{domxref("NavigationActivation")}} オブジェクトを保持しています。
+
+## 値
+
+{{domxref("NavigationActivation")}} オブジェクト、または関連するナビゲーションのリダイレクトチェーンのどこかに別オリジンの URL が含まれる場合は `null` です。
+
+## 例
+
+{{domxref("PageSwapEvent")}} ページを参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)
diff --git a/files/ja/web/api/pageswapevent/viewtransition/index.md b/files/ja/web/api/pageswapevent/viewtransition/index.md
new file mode 100644
index 00000000000000..88fcd39fc29c71
--- /dev/null
+++ b/files/ja/web/api/pageswapevent/viewtransition/index.md
@@ -0,0 +1,31 @@
+---
+title: "PageSwapEvent: viewTransition プロパティ"
+short-title: viewTransition
+slug: Web/API/PageSwapEvent/viewTransition
+l10n:
+  sourceCommit: 722311032dbf520bf6aeba3d1f432aca38779ffd
+---
+
+{{APIRef("HTML DOM")}}{{SeeCompatTable}}
+
+**`viewTransition`** は {{domxref("PageRevealEvent")}} インターフェイスの読み取り専用プロパティで、文書間のナビゲーションにおけるアクティブなビュー遷移を表す {{domxref("ViewTransition")}} オブジェクトを保持しています。
+
+## 値
+
+{{domxref("ViewTransition")}} オブジェクト、またはイベントが発行される際にアクティブなビュー遷移がない場合は `null`。
+
+## 例
+
+{{domxref("PageSwapEvent")}} ページを参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)

From 9267f7e30d0b6c83a6867d71ae3f44561834b995 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 10 Sep 2024 00:39:26 +0900
Subject: [PATCH 070/115] =?UTF-8?q?2024/07/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../web/api/window/pagereveal_event/index.md  | 102 +++++++++++++++++
 .../ja/web/api/window/pageswap_event/index.md | 105 ++++++++++++++++++
 2 files changed, 207 insertions(+)
 create mode 100644 files/ja/web/api/window/pagereveal_event/index.md
 create mode 100644 files/ja/web/api/window/pageswap_event/index.md

diff --git a/files/ja/web/api/window/pagereveal_event/index.md b/files/ja/web/api/window/pagereveal_event/index.md
new file mode 100644
index 00000000000000..f5850fbf4db6a7
--- /dev/null
+++ b/files/ja/web/api/window/pagereveal_event/index.md
@@ -0,0 +1,102 @@
+---
+title: "Window: pagereveal イベント"
+short-title: pagereveal
+slug: Web/API/Window/pagereveal_event
+l10n:
+  sourceCommit: e561fa67af347b9770b359ba93e8579d2a540682
+---
+
+{{APIRef("HTML DOM")}}{{seecompattable}}
+
+**`pagereveal`** イベントは、ネットワークから新しい文書を読み込んだり、文書（[バック/フォワードキャッシュ](/ja/docs/Glossary/bfcache) (bfcache) または[事前レンダリング](/ja/docs/Glossary/Prerender)）をアクティブにしたりして、文書が最初にレンダリングされたときに発行されます。
+
+これは、文書間 (MPA) の移動の[ビュー遷移](/ja/docs/Web/API/View_Transitions_API)において、移動の流入ページからのアクティブな遷移を操作する場合に便利です。例えば、遷移をスキップしたり、JavaScript で流入遷移アニメーションをカスタマイズしたりしたい場合などです。
+
+## 構文
+
+このイベント名を {{domxref("EventTarget.addEventListener", "addEventListener()")}} 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
+
+```js
+addEventListener("pagereveal", (event) => {});
+onpagereveal = (event) => {};
+```
+
+## イベント型
+
+{{domxref("PageRevealEvent")}} です。{{domxref("Event")}} を継承しています。
+
+{{InheritanceDiagram("PageRevealEvent")}}
+
+## インスタンスプロパティ
+
+- {{domxref("PageRevealEvent.viewTransition")}} {{ReadOnlyInline}}
+- : イベントが発生したときに、アクティブなものがあれば、文書間のナビゲーションにおけるアクティブなビュー遷移を表す {{domxref("ViewTransition")}} オブジェクトを返します。それ以外の場合は `null` を返します。
+
+## 例
+
+```js
+window.addEventListener("pagereveal", async (e) => {
+  // "from" 履歴項目が存在しない場合は戻る
+  if (!navigation.activation.from) return;
+
+  // アクティブなビュー遷移が存在する場合のみ実行
+  if (e.viewTransition) {
+    const fromUrl = new URL(navigation.activation.from.url);
+    const currentUrl = new URL(navigation.activation.entry.url);
+
+    // プロフィールページからホームページに移動
+    // ~> VT 名を関連するリストアイテムに設定
+    if (isProfilePage(fromUrl) && isHomePage(currentUrl)) {
+      const profile = extractProfileNameFromUrl(fromUrl);
+
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、名前を除去
+      // そうすることで、次のナビゲーションの準備ができる
+      await e.viewTransition.ready;
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "none";
+    }
+
+    // プロフィールページに移動
+    // ~> VT 名をメインタイトルと画像に設定
+    if (isProfilePage(currentUrl)) {
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、名前を除去
+      // そうすることで、次のナビゲーションの準備ができる
+      await e.viewTransition.ready;
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "none";
+    }
+  }
+});
+```
+
+> [!NOTE]
+> このコードの採取元のライブデモは、[List of Chrome DevRel team members](https://view-transitions.netlify.app/profiles/mpa/) を参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API の使用](/ja/docs/Web/API/View_Transitions_API/Using)
+- {{domxref("Window.pageswap_event", "pageswap")}} event
diff --git a/files/ja/web/api/window/pageswap_event/index.md b/files/ja/web/api/window/pageswap_event/index.md
new file mode 100644
index 00000000000000..c72cf4754ec42d
--- /dev/null
+++ b/files/ja/web/api/window/pageswap_event/index.md
@@ -0,0 +1,105 @@
+---
+title: "Window: pageswap イベント"
+short-title: pageswap
+slug: Web/API/Window/pageswap_event
+l10n:
+  sourceCommit: e561fa67af347b9770b359ba93e8579d2a540682
+---
+
+{{APIRef("HTML DOM")}}{{seecompattable}}
+
+**`pageswap`** イベントは、文書間の移動時、つまり前回表示していた文書がアンロードされようとする際に発行されます。
+
+これは、文書間 (MPA) の[ビュー遷移](/ja/docs/Web/API/View_Transitions_API)において、移動の流出ページからアクティブな遷移を操作する場合に便利です。例えば、遷移をスキップしたり、JavaScript で流出遷移のアニメーションをカスタマイズしたい場合などです。
+
+また、ナビゲーションの種類や、移動元及び移動先文書内の履歴項目にアクセスすることもできます。
+
+## 構文
+
+このイベント名を {{domxref("EventTarget.addEventListener", "addEventListener()")}} 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
+
+```js
+addEventListener("pageswap", (event) => {});
+onpageswap = (event) => {};
+```
+
+## イベント型
+
+{{domxref("PageSwapEvent")}} です。{{domxref("Event")}} を継承しています。
+
+{{InheritanceDiagram("PageSwapEvent")}}
+
+## インスタンスプロパティ
+
+- {{domxref("PageSwapEvent.activation")}} {{ReadOnlyInline}}
+  - : 同一オリジン内の移動に関するナビゲーション種別と、移動元および移動先の文書履歴項目を含む {{domxref("NavigationActivation")}} オブジェクトを返します。ナビゲーションのリダイレクトチェーンのどこかにオリジンをまたぐ URL がある場合は、`null` が返されます。
+- {{domxref("PageSwapEvent.viewTransition")}} {{ReadOnlyInline}}
+  - : イベント発生時にアクティブなものがあれば、文書間のナビゲーションにおけるアクティブなビュー遷移を表す {{domxref("ViewTransition")}} オブジェクトを返します。そうでない場合は `null` を返します。
+
+## 例
+
+```js
+window.addEventListener("pageswap", async (e) => {
+  // アクティブなビュー遷移が存在する場合のみ実行
+  if (e.viewTransition) {
+    const currentUrl = e.activation.from?.url
+      ? new URL(e.activation.from.url)
+      : null;
+    const targetUrl = new URL(e.activation.entry.url);
+
+    // プロフィールページからホームページへ移動
+    // ~> それぞれの大きな画像とタイトル
+    if (isProfilePage(currentUrl) && isHomePage(targetUrl)) {
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、view-transition-names を除去
+      // BFCacheにページの状態が保持されたことによる名前の競合を回避
+      await e.viewTransition.finished;
+      document.querySelector(`#detail main h1`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#detail main img`).style.viewTransitionName =
+        "none";
+    }
+
+    // プロフィールページへ移動
+    // ~> クリックしたアイテム
+    if (isProfilePage(targetUrl)) {
+      const profile = extractProfileNameFromUrl(targetUrl);
+
+      // view-transition-name の値をアニメーションする要素に設定
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "name";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "avatar";
+
+      // スナップショットが採られた後、view-transition-names を除去
+      // BFCacheにページの状態が保持されたことによる名前の競合を回避
+      await e.viewTransition.finished;
+      document.querySelector(`#${profile} span`).style.viewTransitionName =
+        "none";
+      document.querySelector(`#${profile} img`).style.viewTransitionName =
+        "none";
+    }
+  }
+});
+```
+
+> [!NOTE]
+> このコードの採取元のライブデモは、[List of Chrome DevRel team members](https://view-transitions.netlify.app/profiles/mpa/) を参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [ビュー遷移 API の使用](/ja/docs/Web/API/View_Transitions_API/Using)
+- {{domxref("Window.pagereveal_event", "pagereveal")}} イベント

From 016bf4ba10f439200b24690d0770eb97b1317ce9 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 10 Sep 2024 00:58:57 +0900
Subject: [PATCH 071/115] =?UTF-8?q?Web=20API=E3=81=AE=E6=97=A5=E6=9C=AC?=
 =?UTF-8?q?=E8=AA=9E=E7=B4=A2=E5=BC=95=E3=82=92=E6=8B=A1=E5=85=85?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/index.md | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/files/ja/web/api/index.md b/files/ja/web/api/index.md
index d6f2f9cdd4d079..09fc63ecdcc4c7 100644
--- a/files/ja/web/api/index.md
+++ b/files/ja/web/api/index.md
@@ -5,30 +5,63 @@ l10n:
   sourceCommit: 387d0d4d8690c0d2c9db1b85eae28ffea0f3ac1f
 ---
 
-ウェブのコードを書く時は、数多くの Web API が利用できます。以下に、ウェブアプリやサイトを開発する際に利用することができる可能性があるすべてのインターフェイス（オブジェクト型）のリストを挙げます。j
+ウェブのコードを書く時は、数多くの Web API が利用できます。以下に、ウェブアプリやサイトを開発する際に利用することができる可能性があるすべてのインターフェイス（オブジェクト型）のリストを挙げます。
 
 Web API は通常 JavaScript とともに使用されますが、常にそうとは限りません。
 
-## API 日本語索引
+## API 仕様書日本語索引
 
 <!-- 日本語索引には、"CSS" "Web" などの接頭辞を外した API 名を入れてください。 -->
 
 ### ア
 
 - [位置情報 API](/ja/docs/Web/API/Geolocation_API)
+- [IndexedDB](/ja/docs/Web/API/IndexedDB_API)
+- [ウィンドウ制御 API](/ja/docs/Web/API/Window_Management_API)
+- [ウィンドウ制御オーバーレイ API](/ja/docs/Web/API/Window_Controls_Overlay_API)
+- [ウェブ音声 API](/ja/docs/Web/API/Web_Speech_API)
 
 ### カ
 
 - [CSS カウンタースタイル](/ja/docs/Web/API/CSS_Counter_Styles)
+- [画面起動ロック API](/ja/docs/Web/API/Screen_Wake_Lock_API)
+- [ウェブ共有 API](/ja/docs/Web/API/Web_Share_API)
+- [決済ハンドラー API](/ja/docs/Web/API/Payment_Handler_API)
+- [決済リクエスト API](/ja/docs/Web/API/Payment_Request_API)
+- [権限 API](/ja/docs/Web/API/Permissions_API)
 - [交差オブザーバー API](/ja/docs/Web/API/Intersection_Observer_API)
 
+### サ
+
+- [ストレージ API](/ja/docs/Web/API/Storage_API)
+- [ストレージアクセス API](/ja/docs/Web/API/Storage_Access_API)
+- [センサー API](/ja/docs/Web/API/Sensor_APIs)
+
 ### タ
 
+- [通知 API](/ja/docs/Web/API/Notifications_API)
+- [ウェブ定期バックグラウンド同期 API](/ja/docs/Web/API/Web_Periodic_Background_Synchronization_API)
 - [DOM](/ja/docs/Web/API/Document_Object_Model)
 
+### ナ
+
+- [ネットワーク情報 API](/ja/docs/Web/API/Network_Information_API)
+
 ### ハ
 
+- [バックグラウンド同期 API](/ja/docs/Web/API/Background_Synchronization_API)
+- [バックグラウンドフェッチ API](/ja/docs/Web/API/Background_Fetch_API)
+- [バッジ API](/ja/docs/Web/API/Badging_API)
+- [パフォーマンス API](/ja/docs/Web/API/Performance_API)
+- [ビュー遷移 API](Web/API/View_Transitions_API)
 - [フェッチ API](/ja/docs/Web/API/Fetch_API)
+- [プッシュ通知 API](/ja/docs/Web/API/Push_API)
+- [プレゼンテーション API](/ja/docs/Web/API/Presentation_API)
+
+### マ
+
+- [ウェブ MIDI API](/ja/docs/Web/API/Web_MIDI_API)
+- [メディアキャプチャとストリーム API](/ja/docs/Web/API/Media_Capture_and_Streams_API)
 
 ## 仕様書
 

From d3c40f51d3bffdcde594fadbcf0bad11f88c8c30 Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Sat, 14 Sep 2024 10:01:24 +0800
Subject: [PATCH 072/115] zh-cn: Update learn html (#23486)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
---
 files/zh-cn/learn/html/index.md | 36 +++++++++++++++++----------------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/files/zh-cn/learn/html/index.md b/files/zh-cn/learn/html/index.md
index 56cf6e76a7ff29..95e4965614ffc7 100644
--- a/files/zh-cn/learn/html/index.md
+++ b/files/zh-cn/learn/html/index.md
@@ -1,41 +1,43 @@
 ---
-title: 使用 HTML 组织网站内容
+title: 使用 HTML 构建 Web
 slug: Learn/HTML
+l10n:
+  sourceCommit: 26e2f9883e0e73def04c0e86fec6da3ec42e66b3
 ---
 
 {{LearnSidebar}}
 
-为了创建一个网站，你需要了解 {{Glossary('HTML')}}——一项用于定义网页结构的基本技术。HTML 用于标识你的网页内容是应该被解析为段落、列表、头部、链接、图像、多媒体播放器、表单或是其他众多可用的元素之一，亦或是你定义的新元素。
+构建网站时，你应该了解 {{Glossary('HTML')}}——用于定义网页结构的基本技术。HTML 用于指定你的网页内容应被识别为段落、列表、标题、链接、图像、多媒体播放器、表单或是其他可用元素之一，甚至是你定义的新元素。
 
-## 须知
+## 前提
 
-在开始这个主题的学习之前，你至少要基本熟悉使用电脑和被动地使用网络（即单纯地查看内容）。你应该设置好一个基础的工作环境，详细参照[安装基础软件](/zh-CN/docs/Learn/Getting_started_with_the_web/Installing_basic_software)，并且理解如何新建和管理文件，详细参照[文件处理](/zh-CN/docs/Learn/Getting_started_with_the_web/Dealing_with_files)——这两者都在 [web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)的零基础模块里。
+在开始本主题之前，你应该至少熟悉如何使用电脑，如何被动地使用 Web（例如，只是浏览和消费内容）。你应该按照[安装基本软件](/zh-CN/docs/Learn/Getting_started_with_the_web/Installing_basic_software)中的详细内容搭建基本的工作环境，以及按照[处理文件](/zh-CN/docs/Learn/Getting_started_with_the_web/Dealing_with_files)中的内容理解如何创建和管理文件——这两个都是 [Web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)纯新手模块的一部分。
 
-在尝试学习这个主题之前，建议先完成 [web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)主题，不过这并不是必要的。[HTML 基础](/zh-CN/docs/Learn/Getting_started_with_the_web/HTML_basics)里大多数的文章在 [HTML 介绍](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)中也有涉及，不过要详细得多。
+在开始本主题之前，还是建议你先学习 [Web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)。不过，这并不是绝对必要的；[HTML 基础](/zh-CN/docs/Learn/Getting_started_with_the_web/HTML_basics)这篇文章中涉及的大部分内容在 [HTML 简介](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)模块中也有所涉及，而且更详细。
 
-在学习了 HTML 之后，你就可以继续学习其他进阶主题了，例如：
+学习 HTML 后，你可以继续学习更高级的主题，例如：
 
-- [CSS](/zh-CN/docs/Learn/CSS)，以及如何用它装饰 HTML (例如：更改你的文本字号和字体，添加边框和阴影，将你的页面设计成多栏布局，添加动画和其他视觉效果。)
-- [JavaScript](/zh-CN/docs/Learn/JavaScript)，以及如何用它为网页添加动态功能（例如：找到并在地图上绘制出你的地址，触发按钮时让 UI 元素显示或消失，将用户的数据本地储存在他们的电脑里等等。）
+- [CSS](/zh-CN/docs/Learn/CSS)，以及如何使用它为 HTML 添加样式（例如，更改文本大小和使用的字体、添加边框和阴影、使用多列布局页面，添加动画和其他视觉效果）。
+- [JavaScript](/zh-CN/docs/Learn/JavaScript)，以及如何使用它为 Web 页面添加动态功能（例如，查找你的位置并在地图上标记、切换按钮时让 UI 元素出现/消失、在用户的电脑上本地保存用户数据，等等）。
 
 ## 模块
 
-这个主题由包含以下模块，建议从第一个开始，按顺序进行学习。
+本主题包含以下模块，建议按顺序学习。你应该从第一个模块开始。
 
-- [HTML 介绍](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
-  - : 这一模块将为你铺路，帮你习惯一些重要的概念和语法，着眼于如何对文本应用 HTML，创造超链接，以及使用 HTML 构造一个网页。
+- [HTML 简介](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
+  - : 这个模块为学习 HTML 奠定了基础，让你熟悉重要的概念和语法，了解如何在文本中应用 HTML，如何创建超链接以及如何使用 HTML 构建网页结构。
 - [多媒体和嵌入](/zh-CN/docs/Learn/HTML/Multimedia_and_embedding)
-  - : 这个模块带你探索如何使用 HTML 在你的网页里如何包含多媒体信息，例如用各种方法包含图片，以及嵌入视频、音频，甚至是嵌入其他完整的网页。
+  - : 这个模块探讨如何使用 HTML 在网页中包含多媒体内容，包括：包含图像的不同方式，以及如何嵌入视频、音频，甚至整个其他网页。
 - [HTML 表格](/zh-CN/docs/Learn/HTML/Tables)
-  - : 在网页上用易于理解和{{glossary("Accessibility", "无障碍")}}的方式来表示表格数据是一项挑战。这个模块包括了基本的表格标记及更多复杂的特性，例如实现标题和总结。
+  - : 在网页上以易于理解、{{glossary("Accessibility", "无障碍")}}的方式表示表格数据可能是个挑战。这个模块涵盖基本的表格标记，以及更复杂的特性（诸如实现标题和摘要）。
 
 ## 解决常见的 HTML 问题
 
-[使用 HTML 解决常见问题](/zh-CN/docs/Learn/HTML/Howto)提供了一系列在创建网页过程中可能遇到的常见问题的解决方案：处理标题，添加图片或视频，强调内容，创建一个基础表单等等。
+[使用 HTML 解决常见问题](/zh-CN/docs/Learn/HTML/Howto)提供了用于解释如何使用 HTML 解决创建网页时非常常见的问题的内容的链接：处理标题、添加图像或视频、强调内容、创建基本表单，等等。
 
 ## 参见
 
-- [web 表单](/zh-CN/docs/Learn/Forms)
-  - : 本模块提供了一系列文章以助你掌握 web 表单的要领。web 表单是一种非常强大的用户交互工具--其最常见的应用是收集用户的数据，或允许他们控制用户界面。然而，由于历史和技术原因，想要充分发挥他们的潜能并不是一件易事。本模块将介绍 web 表单的所有基本要素，包括标记其 HTML 结构、表单控件的样式、验证表单数据以及向服务器提交数据。
+- [Web 表单](/zh-CN/docs/Learn/Forms)
+  - : 这个模块提供的系列文章意在帮助你掌握 Web 表单的基本知识。Web 表单是用于和用户交互的强大工具——其常用于收集用户数据和控制用户界面。然而，由于历史和技术原因，如何发挥 Web 表单的全部潜力并不总是显而易见的。我们将涵盖 Web 表单的全部基本内容，包括：标记表单的 HTML 结构、为表单控件添加样式、验证表单数据，以及向服务器提交数据。
 - [MDN 上的 HTML（超文本标记语言）](/zh-CN/docs/Web/HTML)
-  - : MDN 上 HTML 相关参考文档的主入口，涵盖了详细的元素和属性参考——比如说如果你想知道一个元素有什么属性或者一个属性有什么值，此页面是一个查询它们的好地方。
+  - : 这是 MDN 上 HTML 参考文档的主要入口，包括详细的元素和属性参考——如果你想了解一个元素有什么属性或者一个属性有什么值，这是个很好的去处。

From b62fddadf1752b69604ee01b0952325f2c188955 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 10 Sep 2024 23:58:14 +0900
Subject: [PATCH 073/115] =?UTF-8?q?2024/08/08=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/css/@view-transition/index.md | 105 +++++++++++++++++++++
 1 file changed, 105 insertions(+)
 create mode 100644 files/ja/web/css/@view-transition/index.md

diff --git a/files/ja/web/css/@view-transition/index.md b/files/ja/web/css/@view-transition/index.md
new file mode 100644
index 00000000000000..9668854da208b4
--- /dev/null
+++ b/files/ja/web/css/@view-transition/index.md
@@ -0,0 +1,105 @@
+---
+title: "@view-transition"
+slug: Web/CSS/@view-transition
+l10n:
+  sourceCommit: b60bc79c7ad36c56dddf6760d2fd4dbb642d2023
+---
+
+{{CSSRef}}{{SeeCompatTable}}
+
+**`@view-transition`** は [CSS](/ja/docs/Web/CSS) の[アットルール](/ja/docs/Web/CSS/At-rule)で、文書間のナビゲーションの場合に、移動元及び移動先の文書で[ビュー遷移](/ja/docs/Web/API/View_Transitions_API)を行うように指定するために使用します。
+
+文書間のビュー遷移を機能させるには、ナビゲーションの移動元と移動先の文書が同じオリジンにある必要があります。
+
+## 構文
+
+```css
+@view-transition {
+  navigation: auto;
+}
+```
+
+### 記述子
+
+- `navigation`
+
+  - : このアットルールが文書内のビュー遷移の動作に与える効果を指定します。 可能な値は以下のとおりです。
+
+    - `auto`: この文書でビュー遷移が発生するのは、同一オリジン内のナビゲーションで、オリジン間リダイレクトがなく、{{domxref("NavigateEvent.navigationType", "navigationType")}} が`traverse`、`push`、`replace` のいずれかである場合です。`push` または `replace` の場合、ナビゲーションはブラウザーの UI 機能ではなく、ページコンテンツを操作するユーザーによって開始されたものでなければなりません。
+
+    - `none`: この文書でビュー遷移は発生しません。
+
+## 形式文法
+
+{{csssyntax}}
+
+## 例
+
+### ページビューの遷移
+
+以下のコードスニペットは、ページ遷移のデモで使用される主要な概念を示しています。
+このデモでは、文書間のビュー遷移を使用しています。これは、同一サイトの 2 つのページ間を移動する際に発生する 0.5 秒の遷移です。
+デモ全体については、[View transitions multi-page app demo](https://mdn.github.io/dom-examples/view-transitions/mpa/) をご覧ください。
+
+`@view-transition` アットルールは、ナビゲーションの移動元と移動先の両方の文書内の CSS で指定することで、ビュー遷移が有効になります。
+
+```css
+@view-transition {
+  navigation: auto;
+}
+```
+
+`@view-transition` アットルールに加えて、2 つの {{cssxref("@keyframes")}} アニメーションを定義し、{{cssxref("animation")}} 一括指定プロパティを使用して、アニメーションさせたい流出側 ({{cssxref("::view-transition-old()")}}) および流入側 ({{cssxref("::view-transition-new()")}}) ページの要素にそれらのキーフレームアニメーションを適用します。
+
+```css
+/* 独自アニメーションの作成 */
+@keyframes move-out {
+  from {
+    transform: translateY(0%);
+  }
+
+  to {
+    transform: translateY(-100%);
+  }
+}
+
+@keyframes move-in {
+  from {
+    transform: translateY(100%);
+  }
+
+  to {
+    transform: translateY(0%);
+  }
+}
+
+/* 独自アニメーションを新旧のページ状態に適用 */
+::view-transition-old(root) {
+  animation: 0.4s ease-in both move-out;
+}
+
+::view-transition-new(root) {
+  animation: 0.4s ease-in both move-in;
+}
+```
+
+[transitions multi-page app](https://mdn.github.io/dom-examples/view-transitions/mpa/) デモをライブで参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{cssxref("::view-transition", "::view-transition")}}
+- {{cssxref("::view-transition-new", "::view-transition-new()")}}
+- {{cssxref("::view-transition-old", "::view-transition-old()")}}
+- {{cssxref("::view-transition-group", "::view-transition-group()")}}
+- {{cssxref("::view-transition-image-pair", "::view-transition-image-pair()")}}
+- [ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API)
+- [CSS アットルール](/ja/docs/Web/CSS/At-rule)
+- [CSS アットルール関数](/ja/docs/Web/CSS/At-rule_functions)

From 19adf180a334b3ea5fbfb78390fde98e01e77922 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 11 Sep 2024 00:07:22 +0900
Subject: [PATCH 074/115] =?UTF-8?q?2024/08/07=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../ja/web/css/css_view_transitions/index.md  | 80 +++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 files/ja/web/css/css_view_transitions/index.md

diff --git a/files/ja/web/css/css_view_transitions/index.md b/files/ja/web/css/css_view_transitions/index.md
new file mode 100644
index 00000000000000..6e2ca003f7cc8b
--- /dev/null
+++ b/files/ja/web/css/css_view_transitions/index.md
@@ -0,0 +1,80 @@
+---
+title: CSS ビュー遷移
+slug: Web/CSS/CSS_view_transitions
+l10n:
+  sourceCommit: ef793e5764cf3b6371f275233a8e278e692d2ff8
+---
+
+{{CSSRef}}
+
+**CSS ビュー遷移**モジュールは、[ビュー遷移 API](/ja/docs/Web/API/View_Transitions_API) の動作を定義します。これにより、開発者は文書内の異なる状態間や文書間でアニメーションする遷移を作成することができます。このモジュールは、これらの遷移をスタイル設定するための CSS プロパティと擬似要素も定義します。
+
+## リファレンス
+
+### プロパティ
+
+- {{cssxref("view-transition-name")}} {{experimental_inline}}
+
+> [!NOTE]
+> このモジュールでは、`view-transition-class` プロパティも定義していますが、いまのところ、どのブラウザーも対応していません。
+
+### アットルールと記述子
+
+- {{cssxref("@view-transition")}}
+  - [`navigation`](/ja/docs/Web/CSS/@view-transition#navigation) 記述子
+
+### セレクターと擬似要素
+
+- {{cssxref("::view-transition")}} {{experimental_inline}}
+- {{cssxref("::view-transition-image-pair()")}} {{experimental_inline}}
+- {{cssxref("::view-transition-group()")}} {{experimental_inline}}
+- {{cssxref("::view-transition-new()")}} {{experimental_inline}}
+- {{cssxref("::view-transition-old()")}} {{experimental_inline}}
+
+> [!NOTE]
+> このモジュールでは、`:active-view-transition` および `:active-view-transition-type()` 擬似クラスも定義していますが、いまのところ、どのブラウザーも対応していません。
+
+### インターフェイス
+
+- {{domxref("CSSViewTransitionRule")}}
+- {{domxref("ViewTransition")}}
+  - {{domxref("ViewTransition.skipTransition()")}} メソッド
+  - {{domxref("ViewTransition.updateCallbackDone")}}
+  - {{domxref("ViewTransition.ready")}}
+  - {{domxref("ViewTransition.finished")}}
+- {{domxref("Document.startViewTransition()")}} メソッド
+
+## ガイド
+
+- [ビュー遷移 API の使用](/ja/docs/Web/API/View_Transitions_API/Using)
+
+  - : ビュー遷移を作成する方法と、ビュー遷移のアニメーションをカスタマイズする方法について説明します。アクティブなビュー遷移の操作方法についても記載しています。
+
+## 関連概念
+
+- {{domxref("PageRevealEvent", "pagereveal")}} イベント
+- {{domxref("PageSwapEvent", "pageswap")}} イベント
+- {{domxref("Document.visibilityState")}}
+
+- [CSS アニメーション](/ja/docs/Web/CSS/CSS_animations)モジュール
+
+  - {{cssxref("animation")}}
+  - {{cssxref("@keyframes")}}
+  - {{domxref("CSSKeyframesRule")}}
+  - {{domxref("CSSStyleRule")}}
+  - [ウェブアニメーション API](/ja/docs/Web/API/Web_Animations_API)
+
+- [CSS 座標変換](/ja/docs/Web/CSS/CSS_transforms)モジュール
+
+  - {{cssxref("transform")}}
+  - {{cssxref("transform-function")}}
+
+## 仕様書
+
+{{Specifications}}
+
+## 関連情報
+
+- [擬似要素](/ja/docs/Web/CSS/Pseudo-elements)
+- [関数擬似クラス](/ja/docs/Web/CSS/Pseudo-classes#関数擬似クラス)
+- [CSS の構成要素: 擬似クラスと擬似要素](/ja/docs/Learn/CSS/Building_blocks/Selectors/Pseudo-classes_and_pseudo-elements)

From 1a9bc00e01330731bdb5713e1980b009d506190e Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 11 Sep 2024 00:19:56 +0900
Subject: [PATCH 075/115] =?UTF-8?q?API=E5=90=8D=E3=81=AE=E6=8F=BA=E3=82=8C?=
 =?UTF-8?q?=E3=82=92=E7=B5=B1=E4=B8=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/document/index.md                     | 2 +-
 files/ja/web/api/document/startviewtransition/index.md | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/files/ja/web/api/document/index.md b/files/ja/web/api/document/index.md
index 5b55b0c99423f7..9d88342ea53b50 100644
--- a/files/ja/web/api/document/index.md
+++ b/files/ja/web/api/document/index.md
@@ -263,7 +263,7 @@ _このインターフェイスは、{{DOMxRef("Node")}} インターフェイ
 - {{DOMxRef("Document.requestStorageAccessFor()")}} {{experimental_inline}}
   - : 最上位のサイトが、同じ[関連ウェブサイト設定](/ja/docs/Web/API/Storage_Access_API/Related_website_sets)内の別のウェブサイトから発信された埋め込みコンテンツの代わりに、サードパーティクッキーへのアクセスをリクエストできるようにします。
 - {{domxref("Document.startViewTransition()")}}
-  - : 新しい{{domxref("View Transitions API", "ビュートランジション", "", "nocode")}}を開始し、それを表すための {{domxref("ViewTransition")}} オブジェクトを返します。
+  - : 新しい{{domxref("View Transitions API", "ビュー遷移", "", "nocode")}}を開始し、それを表すための {{domxref("ViewTransition")}} オブジェクトを返します。
 
 `Document` インターフェイスは、{{DOMxRef("XPathEvaluator")}} インターフェイスによって拡張されています。
 
diff --git a/files/ja/web/api/document/startviewtransition/index.md b/files/ja/web/api/document/startviewtransition/index.md
index 88d3ded5d6ff3d..e34846e619decc 100644
--- a/files/ja/web/api/document/startviewtransition/index.md
+++ b/files/ja/web/api/document/startviewtransition/index.md
@@ -8,9 +8,9 @@ l10n:
 
 {{APIRef("View Transitions API")}}
 
-**`startViewTransition()`** は {{domxref("Document")}} インターフェイスのメソッドで、新しいビュートランジションを始め、それを表す {{domxref("ViewTransition")}} オブジェクトを返します。
+**`startViewTransition()`** は {{domxref("Document")}} インターフェイスのメソッドで、新しいビュー遷移を始め、それを表す {{domxref("ViewTransition")}} オブジェクトを返します。
 
-`startViewTransition()` を呼び出すと、[ビュートランジションのプロセス](/ja/docs/Web/API/View_Transitions_API#ビュートランジションのプロセス)で説明されている一連の手順が続きます。
+`startViewTransition()` を呼び出すと、[ビュー遷移のプロセス](/ja/docs/Web/API/View_Transitions_API#ビュー遷移のプロセス)で説明されている一連の手順が続きます。
 
 ## 構文
 
@@ -22,7 +22,7 @@ startViewTransition(updateCallback)
 ### 引数
 
 - `updateCallback` {{optional_inline}}
-  - : 通常、ビュートランジションプロセス中に DOM を更新するために呼び出されるオプションのコールバック関数で、プロミス ({{jsxref("Promise")}}) を返します。コールバックは、 API が現在のページのスクリーンショットを導いたら呼び出されます。コールバックが返すプロミスが履行されると、次のフレームでビュートランジションが始まります。コールバックが返すプロミスが拒否された場合、トランジションは放棄されます。
+  - : 通常、ビュー遷移プロセス中に DOM を更新するために呼び出されるオプションのコールバック関数で、プロミス ({{jsxref("Promise")}}) を返します。コールバックは、 API が現在のページのスクリーンショットを導いたら呼び出されます。コールバックが返すプロミスが履行されると、次のフレームでビュー遷移が始まります。コールバックが返すプロミスが拒否された場合、トランジションは放棄されます。
 
 ### 返値
 
@@ -32,7 +32,7 @@ startViewTransition(updateCallback)
 
 ### 基本的な使用方法
 
-[基本的なビュートランジションのデモ](https://mdn.github.io/dom-examples/view-transitions/)では、 `updateView()` 関数はビュートランジション API に対応しているブラウザーと対応していないブラウザーの両方に対応しています。対応しているブラウザーで、返値を気にせずにビュートランジションのプロセスを設定するには `startViewTransition()` を呼び出します。
+[基本的なビュー遷移のデモ](https://mdn.github.io/dom-examples/view-transitions/)では、 `updateView()` 関数はビュー遷移 API に対応しているブラウザーと対応していないブラウザーの両方に対応しています。対応しているブラウザーで、返値を気にせずにビュー遷移のプロセスを設定するには `startViewTransition()` を呼び出します。
 
 ```js
 function updateView(event) {

From 253101131034646f1db5314e9c6c4e0cba392717 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 11 Sep 2024 00:09:36 +0900
Subject: [PATCH 076/115] =?UTF-8?q?2024/08/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/css/css_pseudo-elements/index.md | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/files/ja/web/css/css_pseudo-elements/index.md b/files/ja/web/css/css_pseudo-elements/index.md
index 2ffb120439a98d..dbc5d03b0ff446 100644
--- a/files/ja/web/css/css_pseudo-elements/index.md
+++ b/files/ja/web/css/css_pseudo-elements/index.md
@@ -2,7 +2,7 @@
 title: CSS 擬似要素
 slug: Web/CSS/CSS_pseudo-elements
 l10n:
-  sourceCommit: cebbd9095ac12557c55157355181672027fffc14
+  sourceCommit: 6b730e3cfdf0f51940b44efa71bd59c84ce76e71
 ---
 
 {{CSSRef}}
@@ -61,7 +61,6 @@ l10n:
 
   - {{cssxref("::cue")}}
   - {{cssxref("::cue", "::cue()")}}
-  - {{cssxref("::cue-region")}}
 
 - [CSS スコープ化](/ja/docs/Web/CSS/CSS_scoping)モジュール
 
@@ -74,6 +73,14 @@ l10n:
 
   - {{CSSXref("::part")}}
 
+- [CSS ビュー遷移](/ja/docs/Web/CSS/CSS_view_transitions)モジュール
+
+  - {{cssxref("::view-transition")}} {{Experimental_Inline}}
+  - {{cssxref("::view-transition-image-pair()")}} {{Experimental_Inline}}
+  - {{cssxref("::view-transition-group()")}} {{Experimental_Inline}}
+  - {{cssxref("::view-transition-new()")}} {{Experimental_Inline}}
+  - {{cssxref("::view-transition-old()")}} {{Experimental_Inline}}
+
 - [CSS セレクター](/ja/docs/Web/CSS/CSS_selectors)
 
   - [属性セレクター](/ja/docs/Web/CSS/Attribute_selectors)
@@ -92,7 +99,7 @@ l10n:
   - {{cssxref("content")}} プロパティ
   - {{cssxref("quotes")}} プロパティ
 
-- [テキストフラグメント](/ja/docs/Web/Text_fragments)
+- [テキストフラグメント](/ja/docs/Web/URI/Fragment/Text_fragments)
 
 - {{DOMXref("AnimationEvent.pseudoElement")}} プロパティ
 - {{DOMXref("KeyframeEffect.pseudoElement")}} プロパティ

From d344712321bb187800485c9568dae7a4076e4a91 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Sun, 15 Sep 2024 11:10:25 +0800
Subject: [PATCH 077/115] [zh-cn]: sync translation for User-Agent Client Hints
 API & Network Information API (#23555)

---
 .../web/api/navigatoruadata/gethighentropyvalues/index.md     | 2 +-
 files/zh-cn/web/api/navigatoruadata/index.md                  | 2 +-
 files/zh-cn/web/api/navigatoruadata/tojson/index.md           | 2 +-
 files/zh-cn/web/api/workernavigator/connection/index.md       | 4 ++--
 files/zh-cn/web/api/workernavigator/useragentdata/index.md    | 4 ++--
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/files/zh-cn/web/api/navigatoruadata/gethighentropyvalues/index.md b/files/zh-cn/web/api/navigatoruadata/gethighentropyvalues/index.md
index 6dc2fa06b502cc..671a066ce59c5e 100644
--- a/files/zh-cn/web/api/navigatoruadata/gethighentropyvalues/index.md
+++ b/files/zh-cn/web/api/navigatoruadata/gethighentropyvalues/index.md
@@ -2,7 +2,7 @@
 title: NavigatorUAData：getHighEntropyValues() 方法
 slug: Web/API/NavigatorUAData/getHighEntropyValues
 l10n:
-  sourceCommit: 825bc25e89a95f985f329521bcededf073bb42b6
+  sourceCommit: cfb7587e3e3122630ad6cbd94d834ecadbe0a746
 ---
 
 {{APIRef("User-Agent Client Hints API")}}{{SeeCompatTable}}{{AvailableInWorkers}}
diff --git a/files/zh-cn/web/api/navigatoruadata/index.md b/files/zh-cn/web/api/navigatoruadata/index.md
index bf998e7d3c3012..7ae47c697b0ca1 100644
--- a/files/zh-cn/web/api/navigatoruadata/index.md
+++ b/files/zh-cn/web/api/navigatoruadata/index.md
@@ -2,7 +2,7 @@
 title: NavigatorUAData
 slug: Web/API/NavigatorUAData
 l10n:
-  sourceCommit: 8ccdd482e4723b5393278bba686adc24d1769d0f
+  sourceCommit: cfb7587e3e3122630ad6cbd94d834ecadbe0a746
 ---
 
 {{APIRef("User-Agent Client Hints API")}}{{SeeCompatTable}}{{AvailableInWorkers}}
diff --git a/files/zh-cn/web/api/navigatoruadata/tojson/index.md b/files/zh-cn/web/api/navigatoruadata/tojson/index.md
index b63e061d4f29c5..f5215e7e994229 100644
--- a/files/zh-cn/web/api/navigatoruadata/tojson/index.md
+++ b/files/zh-cn/web/api/navigatoruadata/tojson/index.md
@@ -2,7 +2,7 @@
 title: NavigatorUAData：toJSON() 方法
 slug: Web/API/NavigatorUAData/toJSON
 l10n:
-  sourceCommit: ea68d8f5b27af9c11247dc7d8115c0cfa6bffd1b
+  sourceCommit: cfb7587e3e3122630ad6cbd94d834ecadbe0a746
 ---
 
 {{APIRef("User-Agent Client Hints API")}}{{SeeCompatTable}}{{AvailableInWorkers}}
diff --git a/files/zh-cn/web/api/workernavigator/connection/index.md b/files/zh-cn/web/api/workernavigator/connection/index.md
index b0fafbaf7f07e7..ff78808e38c1ad 100644
--- a/files/zh-cn/web/api/workernavigator/connection/index.md
+++ b/files/zh-cn/web/api/workernavigator/connection/index.md
@@ -2,10 +2,10 @@
 title: WorkerNavigator：connection 属性
 slug: Web/API/WorkerNavigator/connection
 l10n:
-  sourceCommit: 5671055d63552c5a4dc22ce7f6bea408afa1521a
+  sourceCommit: e8fe043f7d2ad7cd9804d1bf96e0310949f1dac7
 ---
 
-{{APIRef("Network Information API")}}
+{{APIRef("Network Information API")}}{{AvailableInWorkers("worker")}}
 
 {{domxref("WorkerNavigator")}} 接口的 **`connection`** 只读属性返回一个包含有关系统网络连接信息的 {{domxref("NetworkInformation")}} 对象，例如用户设备的当前带宽或连接是否按流量计费。这可以用于根据用户的连接状态来选择高清晰度内容或低清晰度内容。
 
diff --git a/files/zh-cn/web/api/workernavigator/useragentdata/index.md b/files/zh-cn/web/api/workernavigator/useragentdata/index.md
index 7e42b1623521e0..72db7cb293fbcb 100644
--- a/files/zh-cn/web/api/workernavigator/useragentdata/index.md
+++ b/files/zh-cn/web/api/workernavigator/useragentdata/index.md
@@ -2,10 +2,10 @@
 title: WorkerNavigator：userAgentData 属性
 slug: Web/API/WorkerNavigator/userAgentData
 l10n:
-  sourceCommit: 8ccdd482e4723b5393278bba686adc24d1769d0f
+  sourceCommit: e8fe043f7d2ad7cd9804d1bf96e0310949f1dac7
 ---
 
-{{APIRef("User-Agent Client Hints API")}}{{SeeCompatTable}}{{securecontext_header}}
+{{APIRef("User-Agent Client Hints API")}}{{SeeCompatTable}}{{securecontext_header}}{{AvailableInWorkers("worker")}}
 
 {{domxref("WorkerNavigator")}} 接口的 **`userAgentData`** 只读属性返回一个 {{domxref("NavigatorUAData")}} 对象，其可用于访问{{domxref("User-Agent Client Hints API", "用户代理客户端提示 API", "", "nocode")}}。
 

From 003d875afcd8b479d98207c8de315255726fb137 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 15 Sep 2024 16:11:15 +0900
Subject: [PATCH 078/115] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0=20(#23509)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 2024/07/26 時点の英語版に基づき更新

* 2024/07/26 時点の英語版に基づき更新
---
 .../symbol/isconcatspreadable/index.md        | 53 +++++++++++--------
 1 file changed, 30 insertions(+), 23 deletions(-)

diff --git a/files/ja/web/javascript/reference/global_objects/symbol/isconcatspreadable/index.md b/files/ja/web/javascript/reference/global_objects/symbol/isconcatspreadable/index.md
index 4ea6adaee2fa81..50596ca77d7ab9 100644
--- a/files/ja/web/javascript/reference/global_objects/symbol/isconcatspreadable/index.md
+++ b/files/ja/web/javascript/reference/global_objects/symbol/isconcatspreadable/index.md
@@ -1,58 +1,64 @@
 ---
 title: Symbol.isConcatSpreadable
 slug: Web/JavaScript/Reference/Global_Objects/Symbol/isConcatSpreadable
+l10n:
+  sourceCommit: 8421c0cd94fa5aa237c833ac6d24885edbc7d721
 ---
 
 {{JSRef}}
 
-**`Symbol.isConcatSpreadable`** は、{{jsxref("Array.prototype.concat()")}} メソッドを使用してオブジェクトを配列の要素に平坦化する場合の設定として使用されます。
+**`Symbol.isConcatSpreadable`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.isConcatSpreadable` を表します。{{jsxref("Array.prototype.concat()")}} メソッドは、連結される各オブジェクトに対してこのシンボルを探し、配列風オブジェクトとして扱って配列要素を平坦化すべきかどうかを判断します。
 
 {{EmbedInteractiveExample("pages/js/symbol-isconcatspreadable.html")}}
 
-## 説明
+## 値
 
-`@@isConcatSpreadable` シンボル（`Symbol.isConcatSpreadable`）は直接、または継承されたプロパティとして定義でき、その値は boolean です。これは、配列や配列状のオブジェクトの振る舞いを制御します：
+ウェルノウンシンボル `Symbol.isConcatSpreadable` です。
 
-- 配列オブジェクトにとって、既定の動作は要素の展開（平坦化）です。`Symbol.isConcatSpreadable` はこれらの場合に平坦化を避けます。
-- 配列状のオブジェクトにとって、既定の動作は展開や平坦化を行いません。`Symbol.isConcatSpreadable` はこれらの場合に平坦化を強制します。
+{{js_property_attributes(0, 0, 0)}}
 
-{{js_property_attributes(0,0,0)}}
+## 解説
+
+`[Symbol.isConcatSpreadable]` プロパティは、直接または継承されたプロパティとして定義でき、その値は論理値です。これが配列や配列風オブジェクトの挙動を制御できます。
+
+- 配列オブジェクトでは、既定の動作は要素の展開（平坦化）です。`Symbol.isConcatSpreadable` により、これらの場合に平坦化を避けることができます。
+- 配列風オブジェクトでは、既定の動作は展開や平坦化を行いません。`Symbol.isConcatSpreadable` により、これらの場合に平坦化を強制することができます。
 
 ## 例
 
 ### 配列
 
-既定で、{{jsxref("Array.prototype.concat()")}} は配列を次の結果のように展開（平坦化）します：
+既定で、{{jsxref("Array.prototype.concat()")}} は配列を次の結果のように展開（平坦化）します。
 
 ```js
-let alpha = ['a', 'b', 'c'],
-let numeric = [1, 2, 3]
+const alpha = ["a", "b", "c"];
+const numeric = [1, 2, 3];
 
-let alphaNumeric = alpha.concat(numeric)
+const alphaNumeric = alpha.concat(numeric);
 
-console.log(alphaNumeric)  // Result: ['a', 'b', 'c', 1, 2, 3]
+console.log(alphaNumeric); // 結果: ['a', 'b', 'c', 1, 2, 3]
 ```
 
-`Symbol.isConcatSpreadable` を `false` に設定した場合、既定の動作を使用できなくなります：
+`Symbol.isConcatSpreadable` を `false` に設定すると、既定の動作を無効にすることができます。
 
 ```js
-let alpha = ['a', 'b', 'c'],
-let numeric = [1, 2, 3]
+const alpha = ["a", "b", "c"];
+const numeric = [1, 2, 3];
 
-numeric[Symbol.isConcatSpreadable] = false
-let alphaNumeric = alpha.concat(numeric)
+numeric[Symbol.isConcatSpreadable] = false;
+const alphaNumeric = alpha.concat(numeric);
 
-console.log(alphaNumeric)  // Result: ['a', 'b', 'c', [1, 2, 3] ]
+console.log(alphaNumeric); // 結果: ['a', 'b', 'c', [1, 2, 3] ]
 ```
 
-### 配列状のオブジェクト
+### 配列風オブジェクト
 
-配列状のオブジェクトは、既定で展開しません。`Symbol.isConcatSpreadable` 平坦化した配列を取得するには、`true` に設定する必要があります：
+配列風オブジェクトは、既定で展開されません。平坦化された配列を取得するには、`Symbol.isConcatSpreadable` を `true` に設定する必要があります。
 
 ```js
-let x = [1, 2, 3];
+const x = [1, 2, 3];
 
-let fakeArray = {
+const fakeArray = {
   [Symbol.isConcatSpreadable]: true,
   length: 2,
   0: "hello",
@@ -64,14 +70,15 @@ x.concat(fakeArray); // [1, 2, 3, "hello", "world"]
 
 > **メモ:** `length` プロパティは、追加するオブジェクトプロパティの数を制御するために使用されます。上記の例では、`length:2` は 2 つのプロパティを追加する必要があることを示しています。
 
-## 仕様
+## 仕様書
 
 {{Specifications}}
 
-## ブラウザー実装状況
+## ブラウザーの互換性
 
 {{Compat}}
 
 ## 関連情報
 
+- [`Symbol.isConcatSpreadable` のポリフィル (`core-js`)](https://github.com/zloirock/core-js#ecmascript-symbol)
 - {{jsxref("Array.prototype.concat()")}}

From 1cf56c43ed7d8377236031910cfbbcf40850a24b Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Sun, 15 Sep 2024 16:11:37 +0900
Subject: [PATCH 079/115] =?UTF-8?q?2024/07/13=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0=20(#23510)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 2024/07/13 時点の英語版に基づき更新

* 2024/07/13 時点の英語版に基づき更新
---
 .../reference/global_objects/symbol/asynciterator/index.md      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/ja/web/javascript/reference/global_objects/symbol/asynciterator/index.md b/files/ja/web/javascript/reference/global_objects/symbol/asynciterator/index.md
index f7eebaa72bbec0..2b2158f2b6de08 100644
--- a/files/ja/web/javascript/reference/global_objects/symbol/asynciterator/index.md
+++ b/files/ja/web/javascript/reference/global_objects/symbol/asynciterator/index.md
@@ -7,7 +7,7 @@ l10n:
 
 {{JSRef}}
 
-**`Symbol.asyncIterator`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.asyncIterator` を表します。[非同期反復可能プロトコル](/ja/docs/Web/JavaScript/Reference/Iteration_protocols#非同期イテレーターと非同期反復可能プロトコル)は、オブジェクトの非同期反復子を返すメソッドについてこのシンボルを検索します。オブジェクトが非同期反復可能であるためには、`[Symbol.asyncIterator]` キーを持つ必要があります。
+**`Symbol.asyncIterator`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.asyncIterator` を表します。[非同期反復可能プロトコル](/ja/docs/Web/JavaScript/Reference/Iteration_protocols#非同期イテレーターと非同期反復可能プロトコル)は、オブジェクトの非同期反復子を返すメソッドをこのシンボルで探します。オブジェクトが非同期反復可能であるためには、`[Symbol.asyncIterator]` キーを持つ必要があります。
 
 {{EmbedInteractiveExample("pages/js/symbol-asynciterator.html", "taller")}}
 

From a9e1834ebf100dc576325e1ddc30c8371441513a Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 11 Sep 2024 14:48:54 +0900
Subject: [PATCH 080/115] =?UTF-8?q?2024/07/15=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../symbol/hasinstance/index.md               | 26 ++++++++++++++++---
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/files/ja/web/javascript/reference/global_objects/symbol/hasinstance/index.md b/files/ja/web/javascript/reference/global_objects/symbol/hasinstance/index.md
index 2bfcfd72ec4535..45242bee0f5f59 100644
--- a/files/ja/web/javascript/reference/global_objects/symbol/hasinstance/index.md
+++ b/files/ja/web/javascript/reference/global_objects/symbol/hasinstance/index.md
@@ -1,13 +1,30 @@
 ---
 title: Symbol.hasInstance
 slug: Web/JavaScript/Reference/Global_Objects/Symbol/hasInstance
+l10n:
+  sourceCommit: 6fbdb78c1362fae31fbd545f4b2d9c51987a6bca
 ---
 
 {{JSRef}}
 
-**`Symbol.hasInstance`** は、コンストラクターオブジェクトが、そのインスタンスのオブジェクトとして認識されるかどうかを決定するために使用されます。このシンボルで、{{jsxref("Operators/instanceof", "instanceof")}} 演算子の動作をカスタマイズすることができます。
+**`Symbol.hasInstance`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.hasInstance` を表します。{{jsxref("Operators/instanceof", "instanceof")}} 演算子は右辺オペランドに対して、コンストラクターオブジェクトがオブジェクトをそのインスタンスとして認識するかどうかを判断する際に使用されるメソッドを、このシンボルで探します。
 
-{{EmbedInteractiveExample("pages/js/symbol-hasinstance.html")}}{{js_property_attributes(0,0,0)}}
+{{EmbedInteractiveExample("pages/js/symbol-hasinstance.html")}}
+
+## 値
+
+ウェルノウンシンボル `Symbol.hasInstance` です。
+
+{{js_property_attributes(0, 0, 0)}}
+
+## 解説
+
+`instanceof` 演算子は、`object instanceof constructor` の返値を計算するために以下のアルゴリズムを使用します。
+
+1. `constructor` に `[Symbol.hasInstance]()` メソッドがあった場合、`object` を最初のオブジェクトとして呼び出し、結果を[論理値に変換](/ja/docs/Web/JavaScript/Reference/Global_Objects/Boolean##論理値への型強制)して返します。`constructor` がオブジェクトでない場合、または `constructor[Symbol.hasInstance]` が `null`、`undefined`、関数のいずれでもでない場合、{{jsxref("TypeError")}} が発生します。
+2. それ以外の場合、`constructor` に `[Symbol.hasInstance]()` メソッドがない場合（`constructor[Symbol.hasInstance]` が `null` または `undefined`）、 [`Function.prototype[Symbol.hasInstance]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Function/Symbol.hasInstance) と同じアルゴリズムを使用して結果を決定します。`constructor` が関数でない場合、{{jsxref("TypeError")}} が発生します。
+
+Because all functions inherit from `Function.prototype` by default, most of the time, the [`Function.prototype[Symbol.hasInstance]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Function/Symbol.hasInstance) method specifies the behavior of `instanceof` when the right-hand side is a function.
 
 ## 例
 
@@ -27,7 +44,7 @@ console.log([] instanceof MyArray); // true
 ```js
 function MyArray() {}
 Object.defineProperty(MyArray, Symbol.hasInstance, {
-  value: function (instance) {
+  value(instance) {
     return Array.isArray(instance);
   },
 });
@@ -48,7 +65,7 @@ const cat = new Animal();
 console.log(Animal[Symbol.hasInstance](cat)); // true
 ```
 
-## 仕様
+## 仕様書
 
 {{Specifications}}
 
@@ -59,3 +76,4 @@ console.log(Animal[Symbol.hasInstance](cat)); // true
 ## 関連情報
 
 - {{jsxref("Operators/instanceof", "instanceof")}}
+- [`Function.prototype[Symbol.hasInstance]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Function/Symbol.hasInstance)

From 5ea0a725023573daf54cb65f4b849e1f4849db8f Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 11 Sep 2024 19:12:09 +0900
Subject: [PATCH 081/115] =?UTF-8?q?2024/07/15=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../global_objects/symbol/iterator/index.md   | 52 +++++++++++--------
 1 file changed, 30 insertions(+), 22 deletions(-)

diff --git a/files/ja/web/javascript/reference/global_objects/symbol/iterator/index.md b/files/ja/web/javascript/reference/global_objects/symbol/iterator/index.md
index f36e07b96cbf24..70fc2dfda79437 100644
--- a/files/ja/web/javascript/reference/global_objects/symbol/iterator/index.md
+++ b/files/ja/web/javascript/reference/global_objects/symbol/iterator/index.md
@@ -1,33 +1,39 @@
 ---
 title: Symbol.iterator
 slug: Web/JavaScript/Reference/Global_Objects/Symbol/iterator
+l10n:
+  sourceCommit: 6fbdb78c1362fae31fbd545f4b2d9c51987a6bca
 ---
 
-<div>{{JSRef}}</div>
+{{JSRef}}
 
-**`Symbol.iterator`** はウェルノウンシンボルで、オブジェクトの既定のイテレーターを指定します。 [`for...of`](/ja/docs/Web/JavaScript/Reference/Statements/for...of) で使用されます。
+**`Symbol.iterator`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.iterator` を表します。[反復可能プロトコル](/ja/docs/Web/JavaScript/Reference/Iteration_protocols#反復可能プロトコル)は、オブジェクトのイテレーターを返すメソッドを、このシンボルで探します。オブジェクトが反復可能であるためには、`[Symbol.iterator]` キーを持っていなければなりません。
 
 {{EmbedInteractiveExample("pages/js/symbol-iterator.html")}}
 
+## 値
+
+ウェルノウンシンボル `Symbol.iterator` です。
+
+{{js_property_attributes(0, 0, 0)}}
+
 ## 解説
 
-オブジェクトを反復処理する必要がある場合（`for..of` ループの開始時など）は常に、その `@@iterator` メソッドが引数なしで呼び出され、返された**イテレーター**を使用して反復処理される値が取得されます。
+オブジェクトを反復処理する必要がある場合（`for..of` ループの開始時など）は、その `[Symbol.iterator]()` メソッドが引数なしで呼び出され、返された**イテレーター**を使用して反復処理される値が取得されます。
 
-一部の組み込み型には既定の反復動作がありますが、他の型（{{jsxref("Object")}} など）にはありません。`@@iterator` メソッドの組み込み型は次のとおりです。
+一部の組み込み型には既定の反復動作がありますが、他の型（{{jsxref("Object")}} など）にはありません。`[Symbol.iterator]()` メソッドの組み込み型は次のとおりです。
 
-- {{jsxref("Array.@@iterator", "Array.prototype[@@iterator]()")}}
-- {{jsxref("TypedArray.@@iterator", "TypedArray.prototype[@@iterator]()")}}
-- {{jsxref("String.@@iterator", "String.prototype[@@iterator]()")}}
-- {{jsxref("Map.@@iterator", "Map.prototype[@@iterator]()")}}
-- {{jsxref("Set.@@iterator", "Set.prototype[@@iterator]()")}}
+- [`Array.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Array/Symbol.iterator)
+- [`TypedArray.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/Symbol.iterator)
+- [`String.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/String/Symbol.iterator)
+- [`Map.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/Symbol.iterator)
+- [`Set.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Set/Symbol.iterator)
 
 詳細については、[反復処理プロトコル](/ja/docs/Web/JavaScript/Reference/Iteration_protocols)も参照してください。
 
-{{js_property_attributes(0,0,0)}}
-
 ## 例
 
-### ユーザー定義の反復可能項目
+### ユーザー定義の反復可能オブジェクト
 
 次のように独自の反復可能オブジェクトを作成できます。
 
@@ -41,7 +47,7 @@ myIterable[Symbol.iterator] = function* () {
 [...myIterable]; // [1, 2, 3]
 ```
 
-または、[計算されたプロパティ](/ja/docs/Web/JavaScript/Reference/Operators/Object_initializer#computed_property_names)を使用して、クラスやオブジェクト内で反復可能オブジェクトを直接定義できます。
+または、[計算プロパティ](/ja/docs/Web/JavaScript/Reference/Operators/Object_initializer#computed_property_names)を使用して、クラスやオブジェクト内で反復可能オブジェクトを直接定義できます。
 
 ```js
 class Foo {
@@ -65,12 +71,12 @@ console.log(...someObj); // 'a', 'b'
 
 ### 非整形反復処理
 
-もし反復可能項目の `@@iterator` メソッドがイテレーターオブジェクトを返さない場合、それは非整形反復可能項目です。それを使用すると、実行時に例外が発生したり、バグが発生したりする可能性があります。
+もし反復可能項目の `[Symbol.iterator]()` メソッドがイテレーターオブジェクトを返さない場合、それは非整形反復可能項目です。それを使用すると、実行時に例外が発生したり、バグが発生したりする可能性があります。
 
 ```js example-bad
-const nonWellFormedIterable = {}
-nonWellFormedIterable[Symbol.iterator] = () => 1
-[...nonWellFormedIterable] // TypeError: [] is not a function
+const nonWellFormedIterable = {};
+nonWellFormedIterable[Symbol.iterator] = () => 1;
+[...nonWellFormedIterable]; // TypeError: [Symbol.iterator]() returned a non-object value
 ```
 
 ## 仕様書
@@ -85,8 +91,10 @@ nonWellFormedIterable[Symbol.iterator] = () => 1
 
 - [`Symbol.iterator` のポリフィル (`core-js`)](https://github.com/zloirock/core-js#ecmascript-symbol)
 - [反復処理プロトコル](/ja/docs/Web/JavaScript/Reference/Iteration_protocols)
-- {{jsxref("Array.@@iterator", "Array.prototype[@@iterator]()")}}
-- {{jsxref("TypedArray.@@iterator", "TypedArray.prototype[@@iterator]()")}}
-- {{jsxref("String.@@iterator", "String.prototype[@@iterator]()")}}
-- {{jsxref("Map.@@iterator", "Map.prototype[@@iterator]()")}}
-- {{jsxref("Set.@@iterator", "Set.prototype[@@iterator]()")}}
+- [`Array.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Array/Symbol.iterator)
+- [`TypedArray.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/Symbol.iterator)
+- [`String.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/String/Symbol.iterator)
+- [`Map.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/Symbol.iterator)
+- [`Set.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Set/Symbol.iterator)
+- [`arguments[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Functions/arguments/Symbol.iterator)
+- [`Segments.prototype[Symbol.iterator]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Intl/Segmenter/segment/Segments/Symbol.iterator)

From e205de83827b39c64c4a6766638425ea35cbe0f3 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Wed, 11 Sep 2024 19:25:07 +0900
Subject: [PATCH 082/115] =?UTF-8?q?2024/07/15=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../global_objects/symbol/match/index.md      | 35 ++++++++++------
 .../global_objects/symbol/matchall/index.md   | 40 +++++++++----------
 .../global_objects/symbol/replace/index.md    | 23 ++++++++---
 3 files changed, 59 insertions(+), 39 deletions(-)

diff --git a/files/ja/web/javascript/reference/global_objects/symbol/match/index.md b/files/ja/web/javascript/reference/global_objects/symbol/match/index.md
index 17897b9f5e68a5..f8a1af80e56cff 100644
--- a/files/ja/web/javascript/reference/global_objects/symbol/match/index.md
+++ b/files/ja/web/javascript/reference/global_objects/symbol/match/index.md
@@ -1,19 +1,27 @@
 ---
 title: Symbol.match
 slug: Web/JavaScript/Reference/Global_Objects/Symbol/match
+l10n:
+  sourceCommit: 6fbdb78c1362fae31fbd545f4b2d9c51987a6bca
 ---
 
 {{JSRef}}
 
-**`Symbol.match`** は、文字列に対して正規表現のマッチングを指定します。この関数は {{jsxref("String.prototype.match()")}} メソッドによって呼び出されます。
+**`Symbol.match`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.match` を表します。{{jsxref("String.prototype.match()")}} メソッドは第 1 引数に対して、入力文字列と現在のオブジェクトとの照合に使われるメソッドを、このシンボルで探します。このシンボルは、オブジェクトが[正規表現として扱われる](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp#special_handling_for_regexes)べきかどうかを決定するためにも使用されます。
 
-{{EmbedInteractiveExample("pages/js/symbol-match.html")}}
+詳しくは、[`RegExp.prototype[Symbol.match]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/Symbol.match) および {{jsxref("String.prototype.match()")}} を参照してください。
 
-## 説明
+{{EmbedInteractiveExample("pages/js/symbol-match.html", "taller")}}
 
-この関数は、オブジェクトが正規表現の動作をするかどうかを識別するためにも使用されます。たとえば、{{jsxref("String.prototype.startsWith()")}}, {{jsxref("String.prototype.endsWith()")}}, {{jsxref("String.prototype.includes()")}} メソッドは、最初の引数が正規表現であるかどうかを確認し、正規表現である場合は {{jsxref("TypeError")}} を投げます。ここで、`一致`記号が `false`（または[偽値](/ja/docs/Glossary/Falsy)）に設定されている場合、そのオブジェクトが正規表現オブジェクトとして使用されることを意図していないことを示します。
+## 値
 
-{{js_property_attributes(0,0,0)}}
+ウェルノウンシンボル `Symbol.match` です。
+
+{{js_property_attributes(0, 0, 0)}}
+
+## 解説
+
+この関数は、[オブジェクトが正規表現の動作をするかどうか](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp#正規表現の特殊な扱い)を識別するためにも使用されます。たとえば、{{jsxref("String.prototype.startsWith()")}}, {{jsxref("String.prototype.endsWith()")}}, {{jsxref("String.prototype.includes()")}} メソッドは、最初の引数が正規表現であるかどうかを確認し、正規表現である場合は {{jsxref("TypeError")}} が発生します。ここで、`match` シンボルが `false`（または[偽値](/ja/docs/Glossary/Falsy)、ただし `undefined` でないもの）に設定されている場合、そのオブジェクトが正規表現オブジェクトとして使用されることを意図していないことを示します。
 
 ## 例
 
@@ -24,30 +32,33 @@ slug: Web/JavaScript/Reference/Global_Objects/Symbol/match
 ```js
 "/bar/".startsWith(/bar/);
 
-// Throws TypeError, as /bar/ is a regular expression
-// and Symbol.match is not modified.
+// TypeError が発生。/bar/ が正規表現であり、
+// Symbol.match が変更されていないため。
 ```
 
-ただし、`Symbol.match` を `false` に設定すると、（`match` プロパティを使用する）`isRegExp` チェックは、オブジェクトが正規表現オブジェクトではないことを示します。結果として、`startsWith` と `endsWith` メソッドは、TypeError を投げません。
+ただし、`Symbol.match` を `false` に設定すると、オブジェクトが[正規表現オブジェクトではない](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp#正規表現の特殊な扱い)ことを示します。結果として、`startsWith` と `endsWith` メソッドは、`TypeError` を発生させません。
 
 ```js
-var re = /foo/;
+const re = /foo/;
 re[Symbol.match] = false;
 "/foo/".startsWith(re); // true
 "/baz/".endsWith(re); // false
 ```
 
-## 仕様
+## 仕様書
 
 {{Specifications}}
 
-## ブラウザー実装状況
+## ブラウザーの互換性
 
 {{Compat}}
 
 ## 関連情報
 
+- [`Symbol.match` のポリフィル (`core-js`)](https://github.com/zloirock/core-js#ecmascript-symbol)
+- {{jsxref("Symbol.matchAll")}}
 - {{jsxref("Symbol.replace")}}
 - {{jsxref("Symbol.search")}}
 - {{jsxref("Symbol.split")}}
-- {{jsxref("RegExp.@@match", "RegExp.prototype[@@match]()")}}
+- {{jsxref("String.prototype.match()")}}
+- [`RegExp.prototype[Symbol.match]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/Symbol.match)
diff --git a/files/ja/web/javascript/reference/global_objects/symbol/matchall/index.md b/files/ja/web/javascript/reference/global_objects/symbol/matchall/index.md
index 8fbeca029fbffe..21a2e610359f3d 100644
--- a/files/ja/web/javascript/reference/global_objects/symbol/matchall/index.md
+++ b/files/ja/web/javascript/reference/global_objects/symbol/matchall/index.md
@@ -1,35 +1,30 @@
 ---
 title: Symbol.matchAll
 slug: Web/JavaScript/Reference/Global_Objects/Symbol/matchAll
+l10n:
+  sourceCommit: 6fbdb78c1362fae31fbd545f4b2d9c51987a6bca
 ---
 
 {{JSRef}}
 
-**`Symbol.matchAll`** は、文字列に対する正規表現の一致を生成するイテレーターを返します。この関数は {{jsxref("String.prototype.matchAll()")}} メソッドによって呼び出されます。
+**`Symbol.matchAll`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.match` を表します。{{jsxref("String.prototype.matchAll()")}} メソッドは最初の引数に対して、文字列に対する現在のオブジェクトの照合を行うイテレーターを返すメソッドを、このシンボルで探します。
 
-{{EmbedInteractiveExample("pages/js/symbol-matchall.html","shorter")}}
+詳しくは、[`RegExp.prototype[Symbol.matchAll]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/Symbol.matchAll) および {{jsxref("String.prototype.matchAll()")}} を参照してください。
 
-## 説明
+{{EmbedInteractiveExample("pages/js/symbol-matchall.html")}}
 
-このシンボルは {{jsxref("String.prototype.matchAll()")}}、特に {{jsxref("RegExp.@@matchAll", "RegExp.prototype[@@matchAll]()")}} で使用されます。以下の 2 つの例は同じ結果を返します。
+## 値
 
-```js
-"abc".matchAll(/a/);
-
-/a/[Symbol.matchAll]("abc");
-```
+ウェルノウンシンボル `Symbol.matchAll` です。
 
-このメソッドは、{{jsxref("RegExp")}} サブクラス内の一致動作をカスタマイズするために存在します。
-
-{{js_property_attributes(0,0,0)}}
+{{js_property_attributes(0, 0, 0)}}
 
 ## 例
 
-### Symbol.matchAll を使用する
+### Symbol.matchAll の使用
 
 ```js
-let re = /[0-9]+/g;
-let str = "2016-01-02|2019-03-07";
+const str = "2016-01-02|2019-03-07";
 
 const numbers = {
   *[Symbol.matchAll](str) {
@@ -38,20 +33,23 @@ const numbers = {
 };
 
 console.log(Array.from(str.matchAll(numbers)));
-//  Array ["2016", "01", "02", "2019", "03", "07"]
+// ["2016", "01", "02", "2019", "03", "07"]
 ```
 
-その他の例については、{{jsxref("String.prototype.matchAll()")}} と {{jsxref("RegExp.@@matchAll", "RegExp.prototype[@@matchAll]()")}} を参照してください。
-
-## 仕様
+## 仕様書
 
 {{Specifications}}
 
-## ブラウザー実装状況
+## ブラウザーの互換性
 
 {{Compat}}
 
 ## 関連情報
 
+- [`Symbol.matchAll` のポリフィル (`core-js`)](https://github.com/zloirock/core-js#ecmascript-symbol)
+- {{jsxref("Symbol.match")}}
+- {{jsxref("Symbol.replace")}}
+- {{jsxref("Symbol.search")}}
+- {{jsxref("Symbol.split")}}
 - {{jsxref("String.prototype.matchAll()")}}
-- {{jsxref("RegExp.@@matchAll", "RegExp.prototype[@@matchAll]()")}}
+- [`RegExp.prototype[Symbol.matchAll]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/Symbol.matchAll)
diff --git a/files/ja/web/javascript/reference/global_objects/symbol/replace/index.md b/files/ja/web/javascript/reference/global_objects/symbol/replace/index.md
index 2862353e59134c..9b55fe3d8acbad 100644
--- a/files/ja/web/javascript/reference/global_objects/symbol/replace/index.md
+++ b/files/ja/web/javascript/reference/global_objects/symbol/replace/index.md
@@ -1,15 +1,23 @@
 ---
 title: Symbol.replace
 slug: Web/JavaScript/Reference/Global_Objects/Symbol/replace
+l10n:
+  sourceCommit: 6fbdb78c1362fae31fbd545f4b2d9c51987a6bca
 ---
 
 {{JSRef}}
 
-**`Symbol.replace`** ウェルノウンシンボルは、文字列の一致した部分を置き換えるメソッドを指定します。この関数は {{jsxref("String.prototype.replace()")}} メソッドから呼び出されます。
+**`Symbol.replace`** は静的データプロパティで、[ウェルノウンシンボル](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol#ウェルノウンシンボル)である `Symbol.replace` を表します。{{jsxref("String.prototype.replace()")}} および {{jsxref("String.prototype.replaceAll()")}} メソッドは第 1 引数で、現在のオブジェクトに一致する部分文字列を置き換えるメソッドを、このシンボルで探します。
 
-詳しくは、 {{jsxref("RegExp.@@replace", "RegExp.prototype[@@replace]()")}} と {{jsxref("String.prototype.replace()")}} を参照してください。
+詳しくは、[`RegExp.prototype[Symbol.replace]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/Symbol.replace)、{{jsxref("String.prototype.replace()")}}、{{jsxref("String.prototype.replaceAll()")}} を参照してください。
 
-{{EmbedInteractiveExample("pages/js/symbol-replace.html")}}{{js_property_attributes(0,0,0)}}
+{{EmbedInteractiveExample("pages/js/symbol-replace.html")}}
+
+## 値
+
+ウェルノウンシンボル `Symbol.replace` です。
+
+{{js_property_attributes(0, 0, 0)}}
 
 ## 例
 
@@ -25,8 +33,7 @@ class CustomReplacer {
   }
 }
 
-console.log("football".replace(new CustomReplacer("foo")));
-// expected output: "#!@?tball"
+console.log("football".replace(new CustomReplacer("foo"))); // "#!@?tball"
 ```
 
 ## 仕様書
@@ -39,7 +46,11 @@ console.log("football".replace(new CustomReplacer("foo")));
 
 ## 関連情報
 
+- [`Symbol.replace` のポリフィル (`core-js`)](https://github.com/zloirock/core-js#ecmascript-symbol)
 - {{jsxref("Symbol.match")}}
+- {{jsxref("Symbol.matchAll")}}
 - {{jsxref("Symbol.search")}}
 - {{jsxref("Symbol.split")}}
-- {{jsxref("RegExp.@@replace", "RegExp.prototype[@@replace]()")}}
+- {{jsxref("String.prototype.replace()")}}
+- {{jsxref("String.prototype.replaceAll()")}}
+- [`RegExp.prototype[Symbol.replace]()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/RegExp/Symbol.replace)

From a81941476b39992e1cc3c7418fa9a24892e0d951 Mon Sep 17 00:00:00 2001
From: Vitor Schirmer <vitor.roberto3022@gmail.com>
Date: Sun, 15 Sep 2024 10:28:06 -0300
Subject: [PATCH 083/115] [pt-br] update of `web/http/cookies` (#22449)

* [pt-br] update Cookie HTTP.

- Improve `Lax` attribute description.
- Fix `note` card with the backend languages.
- Fix `SameSite` description

* [pt-br] update `web/http/cookies/`

update note block

Co-authored-by: Josiel Rocha <1158643+josielrocha@users.noreply.github.com>

---------

Co-authored-by: Josiel Rocha <1158643+josielrocha@users.noreply.github.com>
---
 files/pt-br/web/http/cookies/index.md | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/files/pt-br/web/http/cookies/index.md b/files/pt-br/web/http/cookies/index.md
index c2cee46557631a..a3cee5521207c9 100644
--- a/files/pt-br/web/http/cookies/index.md
+++ b/files/pt-br/web/http/cookies/index.md
@@ -36,11 +36,7 @@ Set-Cookie: <cookie-name>=<cookie-value>
 Este cabeçalho de servidor informa ao cliente para armazenar um cookie.
 
 > [!NOTE]
-> Eis as formas de utilização do cabeçalho `Set-Cookie` em várias aplicações de servidor:- [PHP](https://secure.php.net/manual/en/function.setcookie.php)
->
-> - [Node.JS](https://nodejs.org/dist/latest-v8.x/docs/api/http.html#http_response_setheader_name_value)
-> - [Python](https://docs.python.org/3/library/http.cookies.html)
-> - [Ruby on Rails](http://api.rubyonrails.org/classes/ActionDispatch/Cookies.html)
+> Eis as formas de utilização do cabeçalho `Set-Cookie` em várias aplicações de servidor: [PHP](https://secure.php.net/manual/en/function.setcookie.php), [Node.JS](https://nodejs.org/dist/latest-v8.x/docs/api/http.html#http_response_setheader_name_value), [Python](https://docs.python.org/3/library/http.cookies.html), [Ruby on Rails](http://api.rubyonrails.org/classes/ActionDispatch/Cookies.html)
 
 ```
 HTTP/1.0 200 OK
@@ -117,11 +113,11 @@ O atributo SameSite pode receber um ou dois valores (case-insensitive):
 - `None`
   - : O navegador irá enviar os cookies tanto para as requisições _cross-site_ quanto _same-site_.
 - `Strict`
-  - : Se o cookie same-site possuir este atributo, o navegador enviará cookies apenas se a requisição for enviada do website que configurou este cookie, Se a requisição tem origem em outra URL, nenhum cookie com o atributo`Strict` será incluído.
+  - : Se o cookie same-site possuir este atributo, o navegador enviará cookies apenas se a requisição for enviada do website que configurou este cookie, Se a requisição tem origem em outra URL, nenhum cookie com o atributo `Strict` será incluído.
 - `Lax`
-  - : Se o atributo receber o valor Lax, os cookies same-site ficarão retidos nas sub-requisições entre sites, como chamadas para carregar imagens ou frames, mas serão enviadas quando um usuário navegar para o URL de um site externo.
+  - : Se o atributo receber o valor Lax, os cookies same-site ficarão retidos nas sub-requisições entre sites, como chamadas para carregar imagens ou frames, e também quando o usuário navegar para o URL de um site externo através de métodos "seguros" (ex.: [GET](/pt-BR/docs/Web/HTTP/Methods/GET) ou [HEAD](/pt-BR/docs/Web/HTTP/Methods/GET)) como cliques em links, mas não serão enviados em requisições "não seguras" como [POST](/pt-BR/docs/Web/HTTP/Methods/POST).
 
-O comportamento padrão se a flag não estiver setada ou sem suporte do navegador é incluir os cookies em qualquer solicitação, incluindo solicitações cross-origin.
+Se a flag não estiver setada, o atributo recebe o valor `Lax` por padrão.
 
 ### Acesso via JavaScript usando `Document.cookie`
 

From d7a513e6fbb4cd30242ba463046ecc7de17dec22 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o?= <102933429+joaugustoo@users.noreply.github.com>
Date: Sun, 15 Sep 2024 10:28:28 -0300
Subject: [PATCH 084/115] Translating SSL to pt-br (#23370)

* Translating SSL to Portuguese

* Translating SSL to pt-br

* Update files/pt-br/glossary/ssl/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 files/pt-br/glossary/ssl/index.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 files/pt-br/glossary/ssl/index.md

diff --git a/files/pt-br/glossary/ssl/index.md b/files/pt-br/glossary/ssl/index.md
new file mode 100644
index 00000000000000..5e4220fbda81d3
--- /dev/null
+++ b/files/pt-br/glossary/ssl/index.md
@@ -0,0 +1,16 @@
+---
+title: SSL
+slug: Glossary/SSL
+---
+
+{{GlossarySidebar}}
+
+Secure Sockets Layer, ou SSL, era a antiga tecnologia padrão de segurança para criar um link de rede criptografado entre um servidor e um cliente, garantindo que todos os dados transmitidos fossem privados e seguros. A versão atual do SSL é a versão 3.0, lançada pela Netscape em 1996, e foi substituída pelo protocolo {{Glossary("TLS", "Transport Layer Security (TLS)")}}.
+
+## Veja também
+
+- [Transport Layer Security](https://en.wikipedia.org/wiki/Transport_Layer_Security) (Wikipedia)
+- [Transport Layer Security (TLS)](/pt-BR/docs/Web/Security/Transport_Layer_Security)
+- Termos relacionados do glossário:
+  - {{Glossary("HTTPS")}}
+  - {{Glossary("TLS")}}

From 205e0b529b31a6b9344c0882d5e2cf285762db29 Mon Sep 17 00:00:00 2001
From: Fabricio Fodi <159970835+FabricioFodi@users.noreply.github.com>
Date: Sun, 15 Sep 2024 10:34:37 -0300
Subject: [PATCH 085/115] Update index.md (#23553)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

algumas palavras pelo que andei percebendo estavam com a escrita errada. "caraceteres" e "diponíveis"
---
 .../javascript/first_steps/useful_string_methods/index.md   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/files/pt-br/learn/javascript/first_steps/useful_string_methods/index.md b/files/pt-br/learn/javascript/first_steps/useful_string_methods/index.md
index 7b6b7ccc8de654..da4f0218ff8e68 100644
--- a/files/pt-br/learn/javascript/first_steps/useful_string_methods/index.md
+++ b/files/pt-br/learn/javascript/first_steps/useful_string_methods/index.md
@@ -36,7 +36,7 @@ Como dissemos antes e diremos novamente — _tudo_ é um objeto em JavaScript. Q
 var string = "This is my string";
 ```
 
-sua variável torna-se uma instância do objeto string e, como resultado, tem um grande número de propriedades e métodos diponíveis para ela. Você pode ver isso se você for na página do objeto {{jsxref("String")}} e olhar para baixo na lista do lado da página!
+sua variável torna-se uma instância do objeto string e, como resultado, tem um grande número de propriedades e métodos disponíveis para ela. Você pode ver isso se você for na página do objeto {{jsxref("String")}} e olhar para baixo na lista do lado da página!
 
 **Agora, antes de seu cérebro começar a derreter, não se preocupe!** Você não precisa saber sobre a maioria deles no início da sua jornada de aprendizado. Mas há alguns que você potencialmente usará com bastante frequência que veremos aqui.
 
@@ -180,7 +180,7 @@ O comprimento de "mozilla" é 7, mas porque a contagem começa de 0, a posição
    browserType.indexOf("zilla");
    ```
 
-   Isso nos dá o resultado 2, porque a substring "zilla" se inicia na posição 2 (0, 1, 2 — então, 3 caraceteres) dentro de "mozilla". Esse código poderia ser usado para filtrar cadeias de caracteres. Por exemplo, podemos ter uma lista de endereços da web e apenas queremos imprimir aqueles que contenham "mozilla".
+   Isso nos dá o resultado 2, porque a substring "zilla" se inicia na posição 2 (0, 1, 2 — então, 3 caracteres) dentro de "mozilla". Esse código poderia ser usado para filtrar cadeias de caracteres. Por exemplo, podemos ter uma lista de endereços da web e apenas queremos imprimir aqueles que contenham "mozilla".
 
 2. Isso pode ser feito de outro jeito, que é possivelmente mais eficaz. Experimente isso:
 
@@ -215,7 +215,7 @@ browserType.slice(2);
 Isso retornará "zilla" — isso é porque a posição de caracter 2 é a letra z, e porque você não incluiu o segundo parametro, a substring retornou todos os caracteres restantes na string.
 
 > [!NOTE]
-> O segundo parametro do `slice()` é opcional: Se você não incluir ele, o slice finaliza no fim da string original. Existem outras opções também; estude a {{jsxref("String.prototype.slice()", "slice()")}} pagina para ver o que mais você pode descobrir.
+> O segundo parametro do `slice()` é opcional: Se você não incluir ele, o slice finaliza no fim da string original. Existem outras opções também; estude a {{jsxref("String.prototype.slice()", "slice()")}} página para ver o que mais você pode descobrir.
 
 ### Mudando entre maiúsculas e minúsculas
 

From af6764e478b4a4a37acef66486526162f5ffa974 Mon Sep 17 00:00:00 2001
From: Edgar Santos Estevam <167450710+Edd-Estevam@users.noreply.github.com>
Date: Sun, 15 Sep 2024 10:34:57 -0300
Subject: [PATCH 086/115] Update index.md (#23574)

Fix a typo
---
 files/pt-br/web/html/element/code/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/files/pt-br/web/html/element/code/index.md b/files/pt-br/web/html/element/code/index.md
index 088faca66073ae..8526e5a62877a3 100644
--- a/files/pt-br/web/html/element/code/index.md
+++ b/files/pt-br/web/html/element/code/index.md
@@ -75,7 +75,7 @@ Um parágrafo que inlcui `<code>`:
 </p>
 ```
 
-A sainda gerada por esse trecho HTML se parece com isso:
+A saída gerada por esse trecho HTML se parece com isso:
 
 {{EmbedLiveSample("Example", 640, 70)}}
 

From 0e397f1316e2aaca7c251c3bf4be060d7ef70611 Mon Sep 17 00:00:00 2001
From: RoXoM <xyy94813@sina.com>
Date: Mon, 16 Sep 2024 23:11:19 +0800
Subject: [PATCH 087/115] zh-cn: translate for visual viewport api (#23278)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 .../web/api/visual_viewport_api/index.md      | 116 ++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 files/zh-cn/web/api/visual_viewport_api/index.md

diff --git a/files/zh-cn/web/api/visual_viewport_api/index.md b/files/zh-cn/web/api/visual_viewport_api/index.md
new file mode 100644
index 00000000000000..60b0f4232dddfa
--- /dev/null
+++ b/files/zh-cn/web/api/visual_viewport_api/index.md
@@ -0,0 +1,116 @@
+---
+title: 可视视口 API
+slug: Web/API/Visual_Viewport_API
+l10n:
+  sourceCommit: 4b5b3e16c8260a429db07dd54420ae40794b96c2
+---
+
+{{DefaultAPISidebar("Visual Viewport")}}
+
+**可视视口 API** 提供了一种用于查询和修改窗口{{Glossary("visual viewport", "可视视口")}}属性的显式机制。可视视口是屏幕的可视部分，不包括屏幕键盘、缩放区域以外的区域或任何其他不随页面尺寸缩放的屏幕工具。
+
+## 概念和用法
+
+移动 web 包含两个视口，即布局视口和可视视口。布局视口涵盖页面上的所有元素，而可视视口则是屏幕上实际可见的内容。当用户缩放页面时，可视视口会缩小，但布局视口保持不变。屏幕键盘（OSK）等用户界面功能可以缩小可视视口，而不影响布局视口。
+
+如果网页元素需要在屏幕上可见，而与网页的可见部分无关，该怎么办？例如，如果你需要一组图像控件无论设备的捏合缩放级别如何都能保持在屏幕上，该怎么办？目前各浏览器在处理这个问题上存在差异。可视视口可让网页开发人员根据屏幕上显示的内容对元素进行相对定位，从而解决这个问题。
+
+要访问窗口的可视视口，可以从 {{domxref("window.visualViewport")}} 属性中获取 {{domxref("VisualViewport")}} 对象。该对象包含一组描述视口的属性。它包含三个事件：{{domxref("VisualViewport/resize_event", "resize")}}、{{domxref("VisualViewport/scroll_event", "scroll")}} 和 {{domxref("VisualViewport/scrollend_event", "scrollend")}}，分别在视口调整大小、滚动和完成滚动操作时触发。
+
+通过前两个事件，可以在滚动或缩放时相对于可视视口定位元素，这些元素通常会锚定在布局视口上。通过 `scrollend` 事件，可以在滚动操作完成时更新元素。例如，你可以使用这些事件在缩放和滚动时将元素固定在可视视窗上，并在滚动结束时对其进行更新。
+
+## 接口
+
+- {{DOMxRef("VisualViewport")}}
+  - : 表示给定窗口的可视视口。窗口的 `VisualViewport` 对象提供有关视口位置和大小的信息，并接收 {{domxref("VisualViewport.resize_event", "resize")}}、{{domxref("VisualViewport.scroll_event", "scroll")}} 和 {{domxref("VisualViewport.scrollend_event", "scrollend")}} 事件。
+
+### 对其他接口的扩展
+
+- {{domxref("Window.visualViewport")}} {{ReadOnlyInline}}
+  - : 窗口 {{domxref("VisualViewport")}} 对象的只读引用。如果该属性不存在，则不支持此 API。
+
+## 示例
+
+[可视视口 API 示例](https://mdn.github.io/dom-examples/visual-viewport-api/)提供了不同可视视口特性（包括三种事件类型）如何工作的基本演示。在支持的台式机和手机浏览器中加载页面，并尝试滚动页面和缩放。当调整大小和滚动时，信息框会重新定位，以保持相对于可视视口的位置不变，同时更新其显示的视口和滚动信息。此外，在调整大小（`resize`）和滚动（`scroll`）时，我们会改变方框的颜色，以显示正在发生的事情，而在滚动结束（`scrollend`）时又会变回原来的颜色。
+
+你会发现，在桌面浏览器上，{{domxref("Window.scrollX")}} 和 {{domxref("Window.scrollY")}} 值会随着窗口的滚动而更新，视觉视口位置不会改变。不过，在移动浏览器上，{{domxref("VisualViewport.offsetLeft")}} 和 {{domxref("VisualViewport.offsetTop")}} 值通常会被更新——通常是可视视口发生变化，而不是窗口位置发生变化。
+
+HTML 示例如下。信息框由 `id` 为 `output` 的 {{htmlelement("div")}} 表示。
+
+```html
+<p id="instructions">尝试滚动和缩放，看看报告的数值有什么变化。</p>
+<div id="output">
+  <p id="visual-info"></p>
+  <hr />
+  <p id="window-info"></p>
+</div>
+```
+
+为了简洁起见，我们将不解释示例的 CSS，因为这对理解演示并不重要。你可以通过上面的示例链接查看。
+
+在 JavaScript 中，我们首先要获取信息框的引用，以便在页面缩放和滚动时更新信息框，以及信息框中的两个段落。第一个将包含报告的 {{domxref("VisualViewport.offsetLeft")}} 和 {{domxref("VisualViewport.offsetTop")}} 值，第二个将包含报告的 {{domxref("Window.scrollX")}} 和 {{domxref("Window.scrollY")}} 值。
+
+```js
+const output = document.getElementById("output");
+const visualInfo = document.getElementById("visual-info");
+const windowInfo = document.getElementById("window-info");
+```
+
+接下来，我们定义事件触发时要运行的两个关键函数：
+
+- `scrollUpdater()` 将在 `resize` 和 `scroll` 事件触发时调用：此函数通过查询 {{domxref("VisualViewport.offsetTop")}} 和 {{domxref("VisualViewport.offsetLeft")}} 属性更新信息框相对于可视视图的位置，并使用它们的值更新相关 {{glossary("inset properties", "inset 属性")}}的值。我们还更改了信息框的背景颜色，以显示正在发生的事情，并运行 `updateText()` 函数更新框中显示的值。
+- `scrollEndUpdater()` 函数将在 `scrollend` 事件触发时调用：它会将信息框恢复为原来的颜色，并运行 `updateText()` 函数以确保在滚动结束时显示最新值。
+
+```js
+const scrollUpdater = () => {
+  output.style.top = `${visualViewport.offsetTop + 10}px`;
+  output.style.left = `${visualViewport.offsetLeft + 10}px`;
+  output.style.background = "yellow";
+  updateText();
+};
+
+const scrollendUpdater = () => {
+  output.style.background = "lime";
+  updateText();
+};
+```
+
+`updateText()` 函数如下所示。它将第一段的 {{domxref("HTMLElement.innerText")}} 设置为显示当前的 {{domxref("VisualViewport.offsetLeft")}} 和 {{domxref("VisualViewport.offsetTop")}} 值，并将第二段的 {{domxref("HTMLElement.innerText")}} 设置为显示当前的 {{domxref("Window.scrollX")}} 和 {{domxref("Window.scrollY")}} 值。定义 `updateText()` 后，我们立即调用它，以便在页面加载时正确显示信息框。
+
+```js
+function updateText() {
+  visualInfo.innerText = `可视视口 left: ${visualViewport.offsetLeft.toFixed(2)}
+    top: ${visualViewport.offsetTop.toFixed(2)}`;
+  windowInfo.innerText = `当前窗口（window）scrollX: ${window.scrollX.toFixed(2)}
+    scrollY: ${window.scrollY.toFixed(2)}`;
+}
+
+updateText();
+```
+
+> [!NOTE]
+> 我们使用 {{jsxref("Number.toFixed()")}} 方法将所有数值截断到小数点后两位，因为有些浏览器会将它们显示为亚像素数值，可能会有大量小数位。
+
+现在，我们在可视视口和 {{domxref("Window")}} 对象上都设置了事件处理器属性，以便在移动设备和桌面设备上的适当时间运行关键功能：
+
+- 我们在 `window` 上设置了处理器，这样信息框的位置和内容就能在常规的窗口滚动操作中更新，例如在桌面浏览器上滚动页面时。
+- 我们在 `visualViewport` 上设置了处理器，这样信息框的位置和内容就会在视觉视口滚动或缩放操作时更新，例如在移动浏览器上滚动和缩放页面时。
+
+```js
+visualViewport.onresize = scrollUpdater;
+visualViewport.onscroll = scrollUpdater;
+visualViewport.onscrollend = scrollendUpdater;
+window.onresize = scrollUpdater;
+window.onscroll = scrollUpdater;
+window.onscrollend = scrollendUpdater;
+```
+
+`scrollUpdater()` 会在 `resize` 和 `scroll` 事件触发时执行，而 `scrollEndUpdater()` 会在 `scrollend` 事件触发时执行。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}

From af7eb4c4249dd5010ae7b661f6bfa2e675fc13b1 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Mon, 16 Sep 2024 23:22:44 +0800
Subject: [PATCH 088/115] [zh-cn]: sync translation for `MessagePort` (#23554)

sync
---
 files/zh-cn/web/api/messageport/postmessage/index.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/files/zh-cn/web/api/messageport/postmessage/index.md b/files/zh-cn/web/api/messageport/postmessage/index.md
index 27f1272d970bcf..9f68a3e8794ab2 100644
--- a/files/zh-cn/web/api/messageport/postmessage/index.md
+++ b/files/zh-cn/web/api/messageport/postmessage/index.md
@@ -2,7 +2,7 @@
 title: MessagePort：postMessage() 方法
 slug: Web/API/MessagePort/postMessage
 l10n:
-  sourceCommit: e4c0939929e1b3e1fa3fd3da82b827fca3ed4c79
+  sourceCommit: e0310b3f565d3147fa80d9e63ace41e0fc244fa6
 ---
 
 {{APIRef("Channel Messaging API")}} {{AvailableInWorkers}}
@@ -13,18 +13,20 @@ l10n:
 
 ```js-nolint
 postMessage(message)
-postMessage(message, options)
 postMessage(message, transfer)
+postMessage(message, options)
 ```
 
 ### 参数
 
 - `message`
   - : 需要通过 channel 发送的消息。可以是任何基本数据类型。多个数据项可以作为数组发送。
-- `options` {{optional_inline}}
-  - : 一个可选对象，包含一个带有[数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array)的 `transfer` 的字段，数组中包含要转让所有权的[可转移对象](/zh-CN/docs/Web/API/Web_Workers_API/Transferable_objects)。这些对象的所有权将转移到接收方，发送方将不能再使用它们。
 - `transfer` {{optional_inline}}
-  - : 一个可选[数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array)，包含要转让所有权的[可转移对象](/zh-CN/docs/Web/API/Web_Workers_API/Transferable_objects)。这些对象的所有权将转移到接收方，发送方将不能再使用它们。
+  - : 一个包含要转让所有权的[可转移对象](/zh-CN/docs/Web/API/Web_Workers_API/Transferable_objects)的可选的[数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array)。这些对象的所有权将转移到接收方，发送方将不能再使用它们。这些可转移对象应附加到消息中；否则它们将被转移，但实际上在接收方无法访问。
+- `options` {{optional_inline}}
+  - : 包含以下属性的可选对象：
+    - `transfer` {{optional_inline}}
+      - : 与 `transfer` 参数含义相同。
 
 ### 返回值
 

From 25de931700ffa04a271f5c71420c2deef0b65b1f Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 17 Sep 2024 11:46:10 +0900
Subject: [PATCH 089/115] =?UTF-8?q?2024/07/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3=20(#23527)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 2024/07/27 時点の英語版に基づき新規翻訳

* Update files/ja/web/api/webvtt_api/web_video_text_tracks_format/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 .../web_video_text_tracks_format/index.md     | 636 ++++++++++++++++++
 1 file changed, 636 insertions(+)
 create mode 100644 files/ja/web/api/webvtt_api/web_video_text_tracks_format/index.md

diff --git a/files/ja/web/api/webvtt_api/web_video_text_tracks_format/index.md b/files/ja/web/api/webvtt_api/web_video_text_tracks_format/index.md
new file mode 100644
index 00000000000000..82ef3f69e4f1e0
--- /dev/null
+++ b/files/ja/web/api/webvtt_api/web_video_text_tracks_format/index.md
@@ -0,0 +1,636 @@
+---
+title: ウェブ動画テキストトラック形式 (WebVTT)
+slug: Web/API/WebVTT_API/Web_Video_Text_Tracks_Format
+l10n:
+  sourceCommit: 44c4ec928281dc2d7c5ea42b7d2c74a2013f16ac
+---
+
+{{DefaultAPISidebar("WebVTT")}}
+
+<!-- need to add info on region block -->
+
+**ウェブ動画テキストトラック形式 (WebVTT)** は、{{HTMLElement("video")}} および {{HTMLElement("audio")}} 要素内のコンテンツと同期するタイミング設定されたテキストトラックを表示するためのプレーンテキストファイル形式です。
+例えば、クローズドキャプションや字幕テキストを {{HTMLElement("video")}} に追加する際に使用することができます。
+
+メディア要素に関連付けられた WebVTT ファイルは、{{HTMLElement("track")}} 要素を使用して追加します。[ファイルで定義された VTT コンテンツの表示](/ja/docs/Web/API/WebVTT_API#ファイルで定義された_vtt_コンテンツの表示)を参照してください。
+メディア要素は、異なる時点のデータを表す複数のファイルに関連付けることができます。例えば、さまざまなロケールに翻訳された、クローズドキャプション、字幕、チャプター見出しなどです。
+
+> [!NOTE]
+> WebVTT コンテンツは、[WebVTT API](/ja/docs/Web/API/WebVTT_API) を使用してプログラムで作成し、管理することもできます。
+
+## 概要
+
+WebVTT ファイルは、MIME タイプが `text/vtt` で、ファイル拡張子が `.vtt` です。
+コンテンツは {{Glossary("UTF-8")}} を使用してエンコードする必要があります。
+
+WebVTT の構造は、以下の部品から構成されます。オプションの部品も含まれますが、この順序に則って構成されます。
+
+- ヘッダーは、オプションのバイトオーダーマーク (BOM) と、"`WEBVTT`" という文字列に続き、1 つ以上の空白またはタブ文字で区切られたオプションのテキストヘッダーが続きます（WebVTT ファイルでは、タブと空白は同等です）。
+- 1 つ以上の空行は、それぞれ 2 つの連続した改行に相当します。
+- 1 行以上の空白行で区切られた、ゼロ個以上の `STYLE`、`REGION`、`NOTE` ブロックのいずれか。
+- 1 行以上の空白行で区切られた、ゼロ個以上のキューまたは `NOTE` ブロック。
+
+下記に、`WEBVTT` 文字列（ヘッダーテキストなし）、メモブロック、および 2 つのキューを保有する単純な WebVTT ファイルを示します。
+
+```plain
+WEBVTT
+
+NOTE これは複数行のノートブロックです。
+これらは著者のコメントに使用します。
+2 つのキューブロックが以下で定義されています。
+
+00:01.000 --> 00:04.000
+- 液体窒素を絶対に飲まないでください。
+
+00:05.000 --> 00:09.000
+なぜなら、
+- 胃に穴をあけます。
+- 死ぬ可能性があります。
+```
+
+以下の節では、上記の例で使用されていないものも含め、ファイルの各部分について説明します。
+
+## WebVTT ヘッダー
+
+WebVTT ファイルは、以下の内容が格納されたヘッダーブロックから始まります。
+
+- オプションのバイトオーダーマーク (BOM)、Unicode 文字 `U+FEFF` です。
+- "`WEBVTT`" という文字列。
+- オプションで、`WEBVTT` の右側のテキストヘッダー。
+
+  - `WEBVTT` の後に少なくとも 1 つの空白が必要です。
+  - このヘッダーを使用して、ファイルに説明を追加することができます。
+  - テキストヘッダーでは、改行または "`-->`" という文字列を除いて、どのようなものも使用することができます。
+
+`WEBVTT` 文字列は、`WEBVTT` ファイルで唯一要求される部分であるため、最もシンプルな　`WEBVTT` ファイルは次のようになります。
+
+```plain
+WEBVTT
+```
+
+例えば、下記はテキスト入りのヘッダーを示しています。
+このテキストは、少なくとも 1 つの空白またはタブで隔てる必要があります。
+
+```plain
+WEBVTT このファイルにはキューがありません。
+```
+
+## WebVTT キュー
+
+キューは、具体的な時間経過に伴って表示される単一のキャプション、字幕、その他のテキストブロックを定義します。
+キューはヘッダーと、`STYLE` または `REGION` ブロックの後に現れなければなりません。
+
+各キューは 3 行以上の行で構成されます。
+
+- オプションのキュー識別子に続く改行。
+- 本文テキストをどの時点に表示すべきかを示すキューのタイミング。これらはオプションで、最初の設定の前に少なくとも1つの空間があり、各設定の間にも空間があり、単一の改行が続くキュー設定に従うことができます。
+  キューの本文テキストは、複数行にまたがる可能性があり、空行で終了します。
+
+単純なキューの例を以下に示します。
+最初の行では、文字列 "`-->`" を使用して別個の時刻を指定することで、キューの表示開始時点と終了時点を指定します。
+2 行目は表示するテキストを定義します。
+
+```plain
+00:01.000 --> 00:04.000
+Never drink liquid nitrogen.
+```
+
+次のキューは少し複雑です。
+キュー識別子 "`1 - Title Crawl`" で始まり、これは JavaScript や CSS でキューを参照するために使用することができます。
+また、キューの時点の後にキュー設定があり、キューの位置を設定します。
+
+```plain
+1 - Title Crawl
+00:05.000 --> 00:09.000 line:0 position:20% size:60% align:start
+Because:
+- It will perforate your stomach.
+- You could die.
+```
+
+出力は内容テキスト内の改行をそのまま反映しますので、表示されているように、ハイフン (`-`) 文字を用いて箇条書きリストを作成することができます。
+一般的に、ブラウザーがテキストを適切に折り返すため、改行は必要な場合のみ挿入するようにしましょう。
+
+キューの中で「余分な」空行を使用しないことが重要です。例えば、タイミングラインとキューの内容の間や、キューの内容の中に空行を入れないようにしてください。
+これは、空行があると現在のキューがそこで終わってしまうからです。
+
+キューの各部分については、以下の節でさらに詳しく説明します。
+
+### キュー識別子
+
+識別子は、キューを識別する名前です。スクリプトからキューを参照するために使用できます。改行を含むことはできず、文字列 "`-->`" を含むことはできません。それは単一の改行で終わらなければなりません。番号をつけるのが一般的ですが（例えば、1、2、3、...）、それらは一意である必要はありません。
+
+例えば、下記は識別子を記載した複数のキューを含むファイルを示しています。
+
+```plain
+WEBVTT
+
+1
+00:00:22.230 --> 00:00:24.606
+これは最初の字幕です。
+
+2 Some Text
+00:00:30.739 --> 00:00:34.074
+これは 2 番目です。
+
+3
+00:00:34.159 --> 00:00:35.743
+これは 3 番目です。
+```
+
+### キューのタイミング
+
+キューのタイミングは、キューがいつ表示されるかを示します。タイムスタンプで表される開始時刻と終了時刻があります。終了時刻は開始時刻より後でなければならず、開始時刻は前のすべての開始時刻より後でなければなりません。キューは、タイミングが重複するかもしれません。
+
+WebVTT ファイルをチャプターに使用している場合（{{HTMLElement("track")}} の [`kind`](/ja/docs/Web/HTML/Element/track#kind) は `chapters` です）、ファイルは重複するタイミングを持つことはできません。
+
+各キューのタイミングには次の 5 つの要素があります。
+
+- 開始時刻のタイムスタンプ。
+- 少なくとも 1 つのスペース。
+- 文字列 "`-->`"。
+- 少なくとも 1 つのスペース。
+- 終了時刻のタイムスタンプ。開始時刻より後でなければなりません。
+
+タイムスタンプは、次の 2 つの形式のいずれかになります。
+
+- `mm:ss.ttt`
+- `hh:mm:ss.ttt`
+
+そのコンポーネントは次のように定義されています。
+
+- `hh`
+  - : 時を表し、2 桁以上でなければなりません。2 桁を超えることがあります（例えば、`9999:00:00.00`）。
+- `mm`
+  - : 分を表し、00 以上 59 以下でなければなりません。
+- `ss`
+  - : 秒を表し、00 以上 59 以下でなければなりません。
+- `ttt`
+  - : ミリ秒を表し、000 以上 999 以下でなければなりません。
+
+キューのタイミングの例をいくつか示します。
+
+- 基本的なキューのタイミングの例
+
+  ```plain
+  00:00:22.230 --> 00:00:24.606
+  00:00:30.739 --> 00:00:34.074
+  00:00:34.159 --> 00:00:35.743
+  00:00:35.827 --> 00:00:40.122
+  ```
+
+- 重複するキューのタイミングの例
+
+  ```plain
+  00:00:00.000 --> 00:00:10.000
+  00:00:05.000 --> 00:01:00.000
+  00:00:30.000 --> 00:00:50.000
+  ```
+
+- 重複しないキューのタイミングの例
+
+  ```plain
+  00:00:00.000 --> 00:00:10.000
+  00:00:10.000 --> 00:01:00.581
+  00:01:00.581 --> 00:02:00.100
+  00:02:01.000 --> 00:02:01.000
+  ```
+
+### キュー設定
+
+キュー設定は、動画上にキュー本体のテキストを表示する位置を決めるために使用するオプションのコンポーネントです。これには、テキストを水平に表示するか垂直に表示するかが含まれます。それらは 0 個以上存在することができ、各設定が 2 回以上使用されない限り、それらは任意の順序で使用できます。
+
+キュー設定は、キューのタイミングの右側に追加します。キューのタイミングと最初の設定の間、および各設定の間には 1 つ以上のスペースが必要です。設定の名前と値はコロンで区切ります。設定では大文字と小文字が区別されるため、次のように小文字を使用してください。次の 5 つのキュー設定があります。
+
+- `vertical`
+  - : 一部のアジアの言語のように、テキストを水平ではなく垂直に表示することを示します。取りうる値は 2 つあります。
+    - `rl`
+      - : 書字方向は右から左
+    - `lr`
+      - : 書字方向は左から右
+- `line`
+
+  - : vertical が設定されていない場合は、テキストを垂直方向に表示する場所を指定します。vertical が設定されている場合、line はテキストを水平方向に表示する場所を指定します。値は次の何れかです。
+
+    - 行番号
+      - : 数値は、映像に表示されるキューの最初の行の垂直位置です。正の数値はトップダウン、負の数値はボトムアップを示します。
+    - パーセント値
+      - : 0 から 100 までの整数（小数点を含まない）で、その後にパーセント記号 (%) を付けなければなりません。
+
+    | line        | `vertical` を省略 | `vertical:rl` | `vertical:lr` |
+    | ----------- | ----------------- | ------------- | ------------- |
+    | `line:0`    | 上端              | 右端          | 左端          |
+    | `line:-1`   | 下端              | 左端          | 右端          |
+    | `line:0%`   | 上端              | 右端          | 左端          |
+    | `line:100%` | 下端              | 左端          | 右端          |
+
+- `position`
+
+  - : `vertical` を設定しなかった場合、`position` はテキストが水平に現れる位置を指定します。`vertical` を設定した場合、`position` はテキストが垂直に現れる位置を指定します。値は 0 以上 100 以下のパーセント値です。
+
+    | position        | `vertical` を省略 | `vertical:rl` | `vertical:lr` |
+    | --------------- | ----------------- | ------------- | ------------- |
+    | `position:0%`   | 左端              | 上端          | 上端          |
+    | `position:100%` | 右端              | 下端          | 下端          |
+
+- `size`
+
+  - : `vertical` を設定しなかった場合、`size` はテキスト領域の幅を指定します。`vertical` を設定した場合、`size` はテキスト領域の高さを指定します。値は 0 以上 100 以下のパーセント値です。
+
+    | size        | `vertical` を省略 | `vertical:rl` | `vertical:lr` |
+    | ----------- | ----------------- | ------------- | ------------- |
+    | `size:100%` | 幅全体            | 高さ全体      | 高さ全体      |
+    | `size:50%`  | 半分の幅          | 半分の高さ    | 半分の高さ    |
+
+- `align`
+
+  - : テキストの配置を指定します。設定している場合、テキストは size キュー設定で指定された領域内に配置されます。
+
+    | align          | `vertical` を省略  | `vertical:rl`      | `vertical:lr`      |
+    | -------------- | ------------------ | ------------------ | ------------------ |
+    | `align:start`  | 左端               | 上端               | 上端               |
+    | `align:center` | 水平方向に中央揃え | 垂直方向に中央揃え | 垂直方向に中央揃え |
+    | `align:end`    | 右端               | 下端               | 下端               |
+
+キュー設定の例を見てみましょう。
+最初の行は設定がないことを示しています。2 行目は、サインやラベルの上にテキストを重ねるために使用します。3 行目はタイトルに使用できます。最後の行はアジアの言語に使われるかもしれません。
+
+```plain
+00:00:05.000 --> 00:00:10.000
+00:00:05.000 --> 00:00:10.000 line:63% position:72% align:start
+00:00:05.000 --> 00:00:10.000 line:0 position:20% size:60% align:start
+00:00:05.000 --> 00:00:10.000 vertical:rt line:-1 align:end
+00:00:05.000 --> 00:00:10.000 position:10%,line-left align:left size:31%
+00:00:05.000 --> 00:00:10.000 position:90% align:right size:35%
+00:00:05.000 --> 00:00:10.000 position:45%,line-right align:center size:90%
+```
+
+### キュー本体
+
+本体は、字幕やクローズドキャプションのテキストのようなキューのコンテンツを定義するところです。
+本体のテキストには改行を含めることができますが、空白行を含めることはできません。これは、2 つの連続する改行に相当します。空白行はキューの終わりを表します。
+
+キュー本体のテキストには、文字列 `-->`、アンパサンド文字 (`&`)、小なり記号 (`<`) を含めることはできません。
+必要であれば、代わりに{{glossary("character reference", "文字参照")}}を使用することができます。たとえば、アンパサンドには `&amp;` を、小なりには `&lt;` を使用します。
+タグとの混同を避けるために、大なり記号 (`>`) の代わりに大なりエスケープシーケンス `&gt;` を使用することをお勧めします。
+メタデータに WebVTT ファイルを使用している場合、これらの制限は適用されません。
+
+すべての主要ブラウザーでは、キュー、メモ、または他のテキストに任意の{{glossary("character reference", "文字参照")}}を使用できます。
+古いバージョンのブラウザーでは、名前付き文字参照の以下のサブセットのみに対応している場合があります。
+
+| 名前         | 文字   | エスケープシーケンス |
+| ------------ | ------ | -------------------- |
+| アンパサンド | `&`    | `&amp;`              |
+| 小なり       | `<`    | `&lt;`               |
+| 大なり       | `>`    | `&gt;`               |
+| 左書きマーク | _なし_ | `&lrm;`              |
+| 右書きマーク | _なし_ | `&rlm;`              |
+| 無改行空白   |        | `&nbsp;`             |
+
+### キュー本体テキストタグ
+
+キュー内のテキストのマークアップやスタイル設定には、`<b>` などの多数のタグを使用することができます。
+ただし、WebVTT ファイルが {{HTMLElement("track")}} 要素の中で使われていて、その属性 [`kind`](/ja/docs/Web/HTML/Element/track#kind) が `chapters` である場合は、タグを使うことができません。
+
+- タイムスタンプタグ
+
+  - : タイムスタンプは、キューの開始タイムスタンプより大きく、キュー本体内の前のタイムスタンプより大きく、キューの終了タイムスタンプより小さくなければなりません。*アクティブテキスト*は、タイムスタンプと次のタイムスタンプの間、または本体に別のタイムスタンプがない場合は本体の最後までのテキストです。本体内の*アクティブテキスト*より前のテキストはすべて*過去のテキスト*です。*アクティブテキスト*より後のテキストはすべて*将来のテキスト*です。これによりカラオケ風のキャプションが実現できます。
+
+    ```plain
+    1
+    00:16.500 --> 00:18.500
+    When the moon <00:17.500>hits your eye
+
+    1
+    00:00:18.500 --> 00:00:20.500
+    Like a <00:19.000>big-a <00:19.500>pizza <00:20.000>pie
+
+    1
+    00:00:20.500 --> 00:00:21.500
+    That's <00:00:21.000>amore
+    ```
+
+次のタグは、キューで使用できる HTML タグで、開始タグと終了タグ（例えば、`<b>テキスト</b>`）が必要です。
+これらのタグでマークアップされたテキストは、{{cssxref("::cue")}} 擬似要素を使用して [`STYLE` ブロック](#style_ブロック)で書式化することができます。
+
+- イタリック体タグ (`<i></i>`)
+
+  - : 含まれているテキストをイタリック体にします。
+
+    ```xml
+    <i>text</i>
+    ```
+
+- 太字タグ (`<b></b>`)
+
+  - : 含まれているテキストを太字にします。
+
+    ```xml
+    <b>text</b>
+    ```
+
+- 下線タグ (`<u></u>`)
+
+  - : 含まれているテキストに下線を引きます。
+
+    ```xml
+    <u>text</u>
+    ```
+
+- クラスタグ (`<c></c>`)
+
+  - : CSS クラスを使用して含まれているテキストをスタイルします。
+
+    ```xml
+    <c.classname>text</c>
+    ```
+
+- ルビタグ (`<ruby></ruby>`)
+
+  - : [ルビ文字](https://ja.wikipedia.org/wiki/%E3%83%AB%E3%83%93)（すなわち、他の文字の上にある小さな注釈文字）を表示するためにルビテキストタグと共に使用します。
+
+    ```xml
+    <ruby>WWW<rt>World Wide Web</rt>oui<rt>yes</rt></ruby>
+    ```
+
+- ルビテキストタグ (`<rt></rt>`)
+
+  - : [ルビ文字](https://ja.wikipedia.org/wiki/%E3%83%AB%E3%83%93)（つまり、他の文字の上にある小さな注釈文字）を表示するためにルビタグとともに使用します。
+
+    ```xml
+    <ruby>WWW<rt>World Wide Web</rt>oui<rt>yes</rt></ruby>
+    ```
+
+- ボイスタグ (`<v></v>`)
+
+  - : クラスタグと同様に、CSS を使用して含まれているテキストをスタイル設定するためにも使用します。
+
+    ```xml
+    <v Bob>text</v>
+    ```
+
+- 言語タグ (`<lang></lang>`)
+
+  - : {{RFC(5646, "Tags for Identifying Languages (別名 BCP 47)")}} で定義された形式を使用して、具体的な言語または言語のバリエーションに属するものとしてマークアップされたテキストをハイライトする際に使用します。
+
+    ```xml
+    <lang en-GB>Engish text as spoken in Great Britain!</lang>
+    ```
+
+## NOTE ブロック
+
+NOTE ブロックは、WebVTT ファイルにコメントを追加するために使用できるオプションの節です。
+これは、ファイルを読む人々を意図したものであり、ユーザーには表示されません。
+例えば、作成者の連絡先を記録したり、構造の概要を提供したり、まだ書く必要があるキューのプレースホルダを追加したりするために使用することができます。
+
+これらは、ヘッダーの後に続く WebVTT ファイル内のどこでも使用することができます。
+
+NOTE ブロックには改行を入れることができますが、2 つの改行を連続して格納することはできません。2 つの改行を連続して格納すると、ブロックの終わりを示す空行が作成されます。
+
+コメントには、文字列 `-->`、アンパサンド文字 (`&`)、小なり記号 (`<`) を含めることはできません。
+必要であれば、代わりに{{glossary("character reference", "文字参照")}}を使用することができます。たとえば、アンパサンドには `&amp;` を、小なりには `&lt;` を使用します。
+タグとの混同を避けるために、大なり記号 (`>`) の代わりに大なりエスケープシーケンス `&gt;` を使用することをお勧めします。
+
+コメントは 3 つの部分から構成されます。
+
+- 文字列 `NOTE`
+- 空白または改行
+- 上記に示した以外の 0 以上の文字。
+
+いくつか例を示します。
+
+```plain
+NOTE これは単一行コメントです
+
+NOTE
+これは単純な複数行コメントです
+
+NOTE
+複数行にまたがる
+単一のコメントです。
+
+NOTE このように複数行にまたがる
+コメントを作成できます。
+
+NOTE TODO まだ作業が残っていることを示す行を追加することができます。
+```
+
+## STYLE ブロック
+
+`STYLE` ブロックはオプションの節で、WebVTT ファイル内にキューの CSS スタイルを埋め込むために使用することができます。
+これらのスタイルはキューの外観とサイズを指定するために使用しますが、位置やレイアウトは指定できません。これらは[キュー設定](#キュー設定)で制御できます。
+
+> [!NOTE]
+> WebVTT キューは、[video/audio 要素を埋め込んだ]((/ja/docs/Web/API/WebVTT_API#styling_webvtt_in_html_or_a_stylesheet))関連文書から読み込まれた CSS スタイルにも一致します。
+
+`STYLE` ブロックは、ファイル内のすべてのキューブロックより前に現れなければなりません。
+
+各ブロックは以下の行で構成されています。
+
+- 文字列 `STYLE` に続く、0 個以上の空白またはタブ文字、そして改行。
+- 一致する CSS スタイルを定義し、適用する文字列は、{{cssxref("::cue")}} 擬似要素を使用します。
+
+ブロックには文字列 `-->` を含めることはできません。
+改行は含めることができますが、2 行の改行を連続して含めることはできません。2 行の改行は空白行を作成し、ブロックの終わりを示します。
+
+下記に、2 つの `STYLE` ブロックを含む単純な WebVTT ファイルを示します。
+{{cssxref("::cue")}} を使用して、すべてのキューテキストにテキスト色を適用し、`<b></b>` タグでタグ付けされたテキストだけに異なるテキスト色を適用しています。
+
+```plain
+WEBVTT
+
+STYLE
+::cue {
+  background-image: linear-gradient(to bottom, dimgray, lightgray);
+  color: papayawhip;
+}
+/* スタイルブロックでは、空行や「ダッシュダッシュ大なり」を使用することはできません。 */
+
+NOTE コメントブロックはスタイルブロックの間に使用することができます。
+
+STYLE
+::cue(b) {
+  color: peachpuff;
+}
+
+00:00:00.000 --> 00:00:10.000
+- Hello <b>world</b>.
+
+NOTE スタイルブロックは最初のキューの後には現れることができません。
+```
+
+> [!NOTE]
+> WebVTT API の[キュースタイル設定例](/ja/docs/Web/API/WebVTT_API#more_cue_styling_examples)では、次の多くの例に従うことで、ライブの例が示されています。
+
+### すべてのキュー本体テキストとの照合
+
+{{cssxref("::cue")}} を使用して、キューの内容テキストすべてについて照合します。
+
+例えば、次の `STYLE` ブロックは、すべてのキューテキストと一致し、それを黄色に色付けするというものです。
+
+```plain
+STYLE
+cue {
+  color: yellow;
+}
+```
+
+### タグ型との照合
+
+{{cssxref("::cue()")}} にタグを型セレクターとして入力すると、`c`、`i`、`b`、`u`、`ruby`、`rt`、`v`、`lang`な どの具体的なキュー本体テキストタグでマークアップされたキューテキストと一致するキューテキストと一致します。
+
+例えば、次のブロックは、 `lang` で黄色にマークアップされたキュー本体テキストと、その他のタグが赤でマークアップされたものに一致します。
+
+```plain
+STYLE
+cue(c),
+cue(i),
+cue(b),
+cue(u),
+cue(ruby),
+cue(rt),
+cue(v) {
+  color: red;
+}
+cue(lang) {
+  color: yellow;
+}
+```
+
+### クラスセレクターの照合
+
+クラスセレクターを `::cue()` で使用すると、マークアップされたすべてのタグと照合します。
+
+次の WebVTT ファイルの `STYLE` ブロックは、すべてのタグが `myclass` クラスを保有しているため、続くすべてのテキストと一致します。
+
+```plain
+WEBVTT
+
+STYLE
+::cue(.myclass) {
+  color: yellow;
+}
+
+00:00:00.000 --> 00:00:08.000
+<c.myclass>Yellow!</c>
+<i.myclass>Yellow!</i>
+<u.myclass>Yellow!</u>
+<b.myclass>Yellow!</b>
+<u.myclass>Yellow!</u>
+<ruby.myclass>Yellow! <rt.myclass>Yellow!</rt></ruby>
+<v.myclass Kathryn>Yellow!</v>
+<lang.myclass en>Yellow!</lang>
+```
+
+具体的なタグとクラスを選択するには、`::cue()` のどちらも指定する必要があります。
+
+```css
+STYLE ::cue(b.myclass) {
+  color: yellow;
+}
+```
+
+### 属性の照合
+
+特定のタグと属性でマークアップされたキュー本体テキストは、属性セレクターを使用して照合することができます。
+
+例えば、次の WebVTT ファイルを考えてみましょう。このファイルには、`v` と `lang` の[キュー本体テキストタグ](#キュー本体テキストタグ)を使用してマークアップされたテキストがあり、属性を使用して具体的な音声 ("Salame") と言語を指定します。
+
+```plain
+WEBVTT
+
+STYLE
+::cue([lang="en-US"]) {
+color: yellow;
+}
+::cue(lang[lang="en-GB"]) {
+color: cyan;
+}
+::cue(v[voice="Salame"]) {
+color: lime;
+}
+
+00:00:00.000 --> 00:00:08.000
+Yellow!
+
+00:00:08.000 --> 00:00:16.000
+<lang en-GB>Cyan!</lang>
+
+00:00:16.000 --> 00:00:24.000
+I like <v Salame>lime.</v>
+```
+
+### 擬似クラスの照合
+
+例えば、属性の照合を使用して、具体的な言語のテキストにスタイル設定を行うことができます。
+下記 `STYLE` ブロックで示されているように、`:lang()` 疑似クラスを使用して言語を照合することもできます。
+
+```plain
+STYLE
+::cue(:lang(en)) {
+  color: yellow;
+}
+::cue(:lang(en-GB)) {
+  color: cyan;
+}
+```
+
+同様に、`:past` および `:future` 擬似クラスと照合させることで、カラオケのような体験を提供することができます。
+
+```css
+video::cue(:past) {
+  color: yellow;
+}
+video::cue(:future) {
+  color: cyan;
+}
+```
+
+他にも、`link`、`nth-last-child`、`nth-child` などの疑似クラスも同様に動作します。
+
+### キュー ID の照合
+
+{{cssxref("::cue()")}} 内の `id` を指定することで、特定のキューの `id` と照合します。
+
+> [!NOTE]
+> これを書いている時点では、主要ブラウザーのいずれにも対応していないようです。
+
+例えば、次の WebVTT ファイルは、識別子 `cue1` のキューを緑色にスタイル設定するでしょう。
+
+```plain
+WEBVTT
+
+STYLE ::cue(#cue1) {
+  color: green;
+}
+
+cue1
+00:00:00.000 --> 00:00:08.000
+Green!
+```
+
+WebVTT CSS では、HTML ページと同様にエスケープシーケンスを使用します。下記は、キュー識別子内の空間をエスケープする方法を示す例です。
+
+```plain
+WEBVTT
+
+STYLE
+::cue(#crédit\ de\ transcription) {
+  color: red;
+}
+
+crédit de transcription
+00:04.000 --> 00:05.000
+Transcrit par Célestes™
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- CSS の [`::cue` および `::cue()`](/ja/docs/Web/CSS/::cue) 擬似要素

From d112517208c94d4ba61830ab878720faa8e5a9f6 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 17 Sep 2024 11:46:34 +0900
Subject: [PATCH 090/115] =?UTF-8?q?2024/08/09=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0=20(#23528)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 2024/08/09 時点の英語版に基づき更新

* Update files/ja/web/api/webvtt_api/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 files/ja/web/api/webvtt_api/index.md | 739 ++++++++++-----------------
 1 file changed, 259 insertions(+), 480 deletions(-)

diff --git a/files/ja/web/api/webvtt_api/index.md b/files/ja/web/api/webvtt_api/index.md
index d6bdf1b9d40aed..d27e070e3ec19d 100644
--- a/files/ja/web/api/webvtt_api/index.md
+++ b/files/ja/web/api/webvtt_api/index.md
@@ -1,589 +1,376 @@
 ---
-title: ウェブビデオテキストトラック形式 (WebVTT)
+title: WebVTT API
 slug: Web/API/WebVTT_API
 l10n:
-  sourceCommit: c6dbc4ff96451887b908b46c8e70bcfec1c2c48c
+  sourceCommit: c99afd3cafe73c93831bd73ad1dac285c3c713b1
 ---
 
 {{DefaultAPISidebar("WebVTT")}}
 
-**ウェブビデオテキストトラック形式 (WebVTT)** は、{{HTMLElement("track")}} 要素を使用して時間指定のテキストトラック（字幕やキャプションなど）を表示するための形式です。 WebVTT ファイルの主な目的は、テキストオーバーレイを {{HTMLElement("video")}} に追加することです。WebVTT はテキストベースの形式であり、{{Glossary("UTF-8")}} を使用してエンコードする必要があります。スペースを使用できる場所では、タブも使用できます。これらのトラックと、正しい時刻にテキストの再生を実行するために必要なデータを表現および管理するために使用できる小さな API もあります。
+**ウェブ動画テキストトラック** (**WebVTT**) 動画や音声トラックなどの他のメディアと時間軸を合わせて配置された特定のテキスト「キュー」を提供するテキストトラックです。**WebVTT API** は、これらのテキストトラックを定義し、操作するための機能を提供します。
+WebVTT API は主に、動画コンテンツに重ねて表示される字幕やキャプションの表示に使用されますが、他にも、ナビゲーションを容易にするためのチャプター情報の提供や、音声や動画コンテンツと時間軸を合わせて配置する必要がある一般的なメタデータの提供など、他にも用途があります。
 
-## WebVTT ファイル
+## 概念と使用方法
 
-WebVTT の MIME タイプは `text/vtt` です。
+テキストトラックとは、時間軸に沿って配置されたテキストデータを格納するコンテナーで、映像や音声トラックと並行して再生することで、コンテンツの翻訳、文字起こし、概要を提供することができます。
+動画や音声のメディア要素は、異なる種類や言語のトラックを定義することができ、ユーザーは好みやニーズに応じて適切なトラックを表示することができます。
 
-WebVTT ファイル（`.vtt`）にはキューが含まれています。キューは、次のように単一行または複数行になります。
+指定できるテキストデータの種類は以下の一覧に掲載されています。
+ブラウザーがテキストトラックのすべてに対応しているとは限らないことに注意してください。
 
-```plain
-WEBVTT
-
-00:01.000 --> 00:04.000
-- 液体窒素を絶対に飲まないでください。
+- `subtitles` は、音声のダイアログにテキスト翻訳を提供します。
+  これは既定のテキストトラックの型であり、使用する場合はソース言語を指定する必要があります。
+- `captions` は、話されたテキストの文字起こしを提供し、音楽や背景の音など、の音声に関する情報を記載することができます。
+  これらは聴覚障害のあるユーザーのためのものです。
+- `chapters` は、高レベルなナビゲーション情報を提供し、ユーザーが関連するコンテンツに簡単に切り替えられるようにします。
+- `metadata` は、他にもあらゆる時系列情報に用いられます。
 
-00:05.000 --> 00:09.000
-- それはあなたの胃に穴をあけます。
-- あなたは死ぬ可能性があります。
-```
-
-## WebVTT の本体
+トラック内の時間軸に沿って配置された個々のテキストデータの単位は「キュー」と呼ばれます。
+各キューには開始時刻、終了時刻、テキスト本文が含まれます。
+また、表示領域、位置指定、配置、サイズに影響を与える「キュー設定」を持つこともできます。
+最後に、キューにはラベルを付けることができ、CSS スタイル指定のためにキューを選択する際に使用することができます。
 
-WebVTT の構造は、以下のコンポーネントで構成されています。一部のコンポーネントはオプションです。
+テキストトラックとキューは、[WebVTT ファイル形式](/ja/docs/Web/API/WebVTT_API/Web_Video_Text_Tracks_Format)を使用してファイル内で定義し、その後、特定の {{HTMLElement("video")}} 要素に {{HTMLElement("track")}} 要素を使用して関連付けられます。
 
-- オプションのバイトオーダーマーク (BOM)。
-- 文字列 "`WEBVTT`"。
-- `WEBVTT` の右側にあるオプションのテキストヘッダー。
+あるいは、{{domxref("TextTrack")}} を JavaScript で [`HTMLMediaElement.addTextTrack()`](/ja/docs/Web/API/HTMLMediaElement/addTextTrack) を使用してメディア要素にテキストトラックを追加し、個々の {{domxref("VTTCue")}} オブジェクトを {{domxref("TextTrack.addCue()")}} によってトラックに追加することができます。
 
-  - `WEBVTT` の後には少なくとも 1 つのスペースが必要です。
-  - これを使用してファイルに説明を追加できます。
-  - 改行または文字列 "`-->`" を除いて、テキストヘッダーには何でも使用できます。
+{{cssxref("::cue")}} は [CSS](/ja/docs/Web/CSS) [擬似要素](/ja/docs/Web/CSS/Pseudo-elements)で、HTML と WebVTT ファイルのどちらでも使用することができ、特定の要素、キュー内の特定のタグ、VTT クラス、または特定のラベルを持つキューのスタイルを設定することができます。
+`::cue-region` 擬似要素は、特定の領域のキューをスタイル設定するためのものですが、どのブラウザーも対応していません。
 
-- 空白行。2 つの連続した改行に相当します。
-- ゼロ個以上のキューまたはコメント。（訳注：これらのブロックは 1 つ以上の空白行で互いに区切られています。）
-- ゼロ行以上の空白行。（訳注：ファイルの終りも空白行という扱いです。）
+WebVTTの最も重要な機能は、ファイル形式またはウェブ API を使用してアクセスすることができます。
 
-### 例
+## インターフェイス
 
-- 最も単純な WebVTT ファイル
+- {{domxref("VTTCue")}}
+  - : メディア要素に関連付けられたテキストトラックの特定の時間枠に表示されるテキスト、つまりキューを表します。
+- {{domxref("VTTRegion")}}
+  - : 動画要素の一部を表し、{{domxref("VTTCue")}} がレンダリングされることがあります。
+- {{domxref("TextTrack")}}
+  - : テキストトラックを表し、再生中にさまざまなポイントで関連するメディア要素とともに表示するキューのリストを保持します。
+- {{domxref("TextTrackCue")}}
+  - : {{domxref("VTTCue")}} などのさまざまなキュー型用の抽象ベースクラスです。
+- {{domxref("TextTrackCueList")}}
+  - : 配列風オブジェクトで、{{domxref("TextTrackCue")}} オブジェクトの動的に更新されるリストを表します。
+    この型のインスタンスは {{domxref('TextTrack.cues')}} から、{{domxref("TextTrack")}} オブジェクト内のすべてのキューを取得するために取得します。
+- {{domxref("TextTrackList")}}
+  - : メディア要素に対して定義されたテキストトラックの一覧を表し、各トラックは、一覧に別個の {{domxref("TextTrack")}} インスタンスとして表されます。
 
-  ```plain
-  WEBVTT
-  ```
+### 関連するインターフェイス
 
-- テキストヘッダーを持つ非常に単純な WebVTT ファイル
+- {{domxref("TrackEvent")}}
+  - : HTML DOM API の一部で、{{domxref("TextTrackList")}} にトラックが追加されたり削除されたりしたとき（より一般的には、HTML のメディア要素にトラックが追加されたり削除されたりしたとき）に発生する `addtrack` イベントと `removetrack` イベントのインターフェイスです。
 
-  ```plain
-  WEBVTT - このファイルにはキューがありません。
-  ```
+### 関連する CSS の拡張
 
-- ヘッダーとキューを使用した一般的な WebVTT の例
+これらの [CSS](/ja/docs/Web/CSS) [擬似要素](/ja/docs/Web/CSS/Pseudo-elements)は、VTT トラックを持つメディアのキューをスタイルするために使用されます。
 
-  ```plain
-  WEBVTT - このファイルにはキューがあります。
+- {{CSSxRef("::cue")}}
+  - : メディアの中で選択された要素内のキューを VTT トラックと照合します。
 
-  14
-  00:01:14.815 --> 00:01:18.114
-  - What?
-  - Where are we now?
+> [!NOTE]
+> この仕様では、もう一つの擬似要素である `::cue-region` を定義していますが、これはどのブラウザーも対応していません。
 
-  15
-  00:01:18.171 --> 00:01:20.991
-  - This is big bat country.
+## 例
 
-  16
-  00:01:21.058 --> 00:01:23.868
-  - [ Bats Screeching ]
-  - They won't get in your hair. They're after the bugs.
-  ```
+### WebVTT API を使用してキャプションを追加
 
-### WebVTT ファイルの内部構造
+#### HTML
 
-前の例の 1 つを再検討し、キューの構造をもう少し詳しく見てみましょう。
+次の例では、新しい {{domxref("TextTrack")}} を動画に追加し、{{domxref("TextTrack.addCue()")}} メソッドを使用して、作成した `VTTCue` オブジェクトを引数としてキューを追加しています。
 
-```plain
-WEBVTT
-
-00:01.000 --> 00:04.000
-- 液体窒素を絶対に飲まないでください。
-
-00:05.000 --> 00:09.000
-- それはあなたの胃に穴をあけます。
-- あなたは死ぬ可能性があります。
+```html
+<video
+  controls
+  src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/friday.mp4"></video>
 ```
 
-各キューは、
-
-- 最初の行は時刻で始まります。これは、下にあるテキストを表示するための開始時刻です。
-- 同じ行に、`-->` という文字列があります。
-- 最初の行を 2 つ目の時刻で終了します。これは、関連するテキストを表示するための終了時刻です。
-- ハイフン (-) で始まる 1 行以上の行を表示できます。各行には表示するテキストトラックの一部が含まれています。
-
-ファイルの一部に関する重要な情報を思い出すのに役立つように、`.vtt` ファイルにコメントを入れることもできます。これらは、文字列 `NOTE` で始まる別々の行にあるべきです。以下のセクションでこれらについての詳細を見つけるでしょう。
-
-タイミング行とキュー本体の間など、キュー内で「余分な」空白行を使用しないことが重要です。WebVTT は行ベースで、空白行がキューを閉じます。
-
-## WebVTT のコメント
-
-コメントは、WebVTT ファイルに情報を追加するために使用できるオプションのコンポーネントです。コメントはファイルを読む人のためのものであり、ユーザーには見えません。コメントには改行を含めることができますが、空白行を含めることはできません。これは、連続する 2 行の改行と同じです。空白行はコメントの終わりを表します。
-
-コメントには、文字列 "`-->`"、アンパサンド文字 (`&`)、小なり記号 (`<`) を含めることはできません。このような文字を使用したい場合は、アンパサンドには `&amp;`、小なりには `&lt;` を使用してエスケープする必要があります。タグとの混同を避けるために、大なり記号（`>`）の代わりに大なりエスケープシーケンス (`&gt;`) を使用することをお勧めします。
-
-コメントは次の 3 つの部分で構成されています。
-
-- 文字列 `NOTE`。
-- スペースまたは改行。
-- 上記以外のゼロ個以上の文字。
-
-### 例
-
-- 一般的な WebVTT の例
-
-  ```plain
-  NOTE これはコメントです
-  ```
+#### CSS
 
-- 複数行のコメント
+```css
+video {
+  width: 420px;
+  height: 300px;
+}
+```
 
-  ```plain
-  NOTE
-  複数行に
-  またがる別のコメント。
+#### JavaScript
+
+```js
+let video = document.querySelector("video");
+let track = video.addTextTrack("captions", "Captions", "en");
+track.mode = "showing";
+track.addCue(new VTTCue(0, 0.9, "Hildy!"));
+track.addCue(new VTTCue(1, 1.4, "How are you?"));
+track.addCue(new VTTCue(1.5, 2.9, "Tell me, is the lord of the universe in?"));
+track.addCue(new VTTCue(3, 4.2, "Yes, he's in - in a bad humor"));
+track.addCue(new VTTCue(4.3, 6, "Somebody must've stolen the crown jewels"));
+console.log(track.cues);
+```
 
-  NOTE このように複数行にまたがって
-  コメントすることもできます。
-  ```
+#### 結果
 
-- 一般的なコメントの使い方
+{{EmbedLiveSample('Using the WebVTT API to add captions','400','330')}}
 
-  ```plain
-  WEBVTT - 好きな映画の翻訳
+### ファイルで定義された VTT コンテンツの表示
 
-  NOTE
-  何人かの友人が両親と一緒に見ることができるように、
-  Kyle が翻訳しました。
+この例では、上記の [WebVTT API を使用してキャプションを追加](#webvtt_api_を使用してキャプションを追加)の例で見たのと同じテロップを、動画に設定する方法を示します。ただし今回は、{{htmlelement("track")}} 要素を使用して宣言的に行います。
 
-  1
-  00:02:15.000 --> 00:02:20.000
-  - Ta en kopp varmt te.
-  - Det är inte varmt.
+まず、"captions.vtt" ファイルでキャプションを定義します。
 
-  2
-  00:02:20.000 --> 00:02:25.000
-  - Har en kopp te.
-  - Det smakar som te.
+```plain
+WEBVTT
 
-  NOTE この最後の行はうまく翻訳されていないかもしれません。
+00:00.000 --> 00:00.900
+Hildy!
 
-  3
-  00:02:25.000 --> 00:02:30.000
-  - Ta en kopp
-  ```
+00:01.000 --> 00:01.400
+How are you?
 
-## WebTT キューのスタイル設定
+00:01.500 --> 00:02.900
+Tell me, is the lord of the universe in?
 
-{{cssxref("::cue")}} 擬似要素に一致する要素を探すことで WebTT キューをスタイル設定することができます。
+00:03.000 --> 00:04.200
+Yes, he's in - in a bad humor
 
-### サイトの CSS の中
+00:04.300 --> 00:06.000
+Somebody must've stolen the crown jewels
+```
 
-```css
-video::cue {
-  background-image: linear-gradient(to 下端, dimgray, lightgray);
-  color: papayawhip;
-}
+これを {{HTMLElement("video")}} 要素に {{HTMLElement("track")}} 要素を用いて追加することができます。
+次の HTML は前回と同じテキストトラックになります。
 
-video::cue(b) {
-  color: peachpuff;
-}
+```html
+<video controls src="video.webm">
+  <track default kind="captions" src="captions.vtt" srclang="en" />
+</video>
 ```
 
-ここでは、すべての動画要素は背景として灰色の線形グラデーションを使用するようにスタイル設定しており、前景色は `"papayawhip"` です。また、{{HTMLElement("b")}} 要素を使用して太字になっているテキストは、`"peachpuff"` で色づけしています。
-
-以下の HTML スニペットは実際にメディア自体の表示を処理します。
+複数の {{HTMLElement("track")}} 要素を追加して、`kind` 属性と `srclang` 属性を用いると、複数の言語で異なる種類のトラックを指定することができます。`kind` を指定する場合は、`srclang` も設定しなければならないことに注意してください。
+`default` 属性は 1 つの `<track>` だけに追加することができます。これはユーザーの環境設定で具体的な言語や種類を指定しない場合に再生されるものです。
 
 ```html
-<video controls autoplay src="video.webm">
-  <track default src="track.vtt" />
+<video controls src="video.webm">
+  <track default kind="captions" src="captions.vtt" srclang="en" />
+  <track kind="subtitles" src="subtitles.vtt" srclang="en" />
+  <track kind="descriptions" src="descriptions.vtt" srclang="en" />
+  <track kind="chapters" src="chapters_de.vtt" srclang="de" />
+  <track kind="subtitles" src="subtitles_en.vtt" srclang="en" />
 </video>
 ```
 
-### WebVTT ファイル自体の中
+### HTML またはスタイルシートは WebVTT のスタイル設定
 
-WebVTT ファイルで直接スタイルを定義することもできます。この場合、CSS のルールをファイルに挿入します。次に示すように、各ルールの前には、すべてに一行のテキストで文字列 `"STYLE"` が付いています。
+WebVTT キューは、{{cssxref("::cue")}} 擬似要素を使用して要素と照合することで、スタイル設定することができます。
+これにより、すべてのキューテキストの外観を変更することも、特定の要素だけを変更することもできます。この例では、[上記の最初の例](#webvtt_api_を使用してキャプションを追加)にスタイル設定を追加します。
 
-```plain
-WEBVTT
+> [!NOTE]
+> また、[WebVTT ファイル形式](/ja/docs/Web/API/WebVTT_API/Web_Video_Text_Tracks_Format)でスタイルを定義することも可能です。
 
-STYLE
-::cue {
-  background-image: linear-gradient(to 下端, dimgray, lightgray);
-  color: papayawhip;
-}
-/* スタイルブロックは空白行も "ハイフンハイフン大なり" も使用できません */
+#### HTML
 
-NOTE コメントブロックはスタイルブロックの間で使用できます。
+動画自体の HTML は前回と同じです。
 
-STYLE
-::cue(b) {
-  color: peachpuff;
+```css hidden
+video {
+  width: 420px;
+  height: 300px;
 }
-
-00:00:00.000 --> 00:00:10.000
-- Hello <b>world</b>.
-
-NOTE スタイルブロックは、最初のキューの後には出現できません。
 ```
 
-WebVTT ファイル内で識別子を使用することもできます。これは、ファイル内の特定のキューに対する新しいスタイルを定義するために使用できます。転記テキスト (transcription text) を赤で強調表示し、他の部分を通常のままにしたい例は、CSS を使用して次のように定義できます。CSS が HTML のページで使用しているのと同じ方法でエスケープシーケンスを使用していることに注意する必要があります。
-
-```plain
-WEBVTT
+```html
+<video
+  controls
+  src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/friday.mp4"></video>
+```
 
-1
-00:00.000 --> 00:02.000
-That's an, an, that's an L!
+#### CSS
 
-crédit de transcription
-00:04.000 --> 00:05.000
-Transcrit par Célestes™
-```
+まず、{{cssxref("::cue")}} 擬似要素を使用して動画のすべてのテキストキューを選択し、赤を大きくして背景をグラデーションにします。
 
 ```css
-::cue(#\31) {
-  color: lime;
-}
-::cue(#crédit\ de\ transcription) {
+video::cue {
+  font-size: 1.5rem;
+  background-image: linear-gradient(to bottom, yellow, lightyellow);
   color: red;
 }
 ```
 
-以下に示すように、キュー内のタイミングの後に位置情報を含めることで、テキストトラックの位置指定にも対応しています（詳細については、[キュー設定](#キュー設定)を参照してください）。
-
-```plain
-WEBVTT
+次に、{{cssxref("::cue")}} を使用して、`u` 要素と `b` 要素を使用してマークアップされたテキストを選択し、それぞれ緑と黄色のスタイル設定を行います。
 
-00:00:00.000 --> 00:00:04.000 position:10%,line-left align:left size:35%
-Where did he go?
-
-00:00:03.000 --> 00:00:06.500 position:90% align:right size:35%
-I think he went down this lane.
+```css
+video::cue(u) {
+  color: green;
+}
 
-00:00:04.000 --> 00:00:06.500 position:45%,line-right align:center size:35%
-What are you waiting for?
+video::cue(b) {
+  color: purple;
+}
 ```
 
-## WebVTT のキュー
-
-キューは、単一の開始時刻、終了時刻、およびテキスト本体を持つ単一の字幕ブロックです。キューは次の 5 つの要素で構成されています。
-
-- オプションのキュー識別子とそれに続く改行。
-- キューのタイミング。
-- 最初の設定の前と各設定の間に少なくとも 1 つのスペースを持つオプションのキュー設定。
-- 1 つの改行。
-- キュー本体のテキスト。
-
-こちらがキューの例です。
-
-```plain
-1 - Title Crawl
-00:00:05.000 --> 00:00:10.000 line:0 position:20% size:60% align:start
-Some time ago in a place rather distant....
+#### JavaScript
+
+JavaScriptは最初の例と同じですが、`<b>` タグ（太字）と `<u>` タグ（下線）を用いてキューテキストの一部をマークアップしています。
+既定では、マークされたテキストは太字または下線（タグによって異なる）として表示されますが、前のセクションで {{cssxref("::cue")}} を使用して、テキストをそれぞれ緑色と紫色にスタイル設定しています。
+
+```js
+let video = document.querySelector("video");
+let track = video.addTextTrack("captions", "Captions", "en");
+track.mode = "showing";
+track.addCue(new VTTCue(0, 0.9, "Hildy!"));
+track.addCue(new VTTCue(1, 1.4, "How are you?"));
+track.addCue(
+  new VTTCue(1.5, 2.9, "Tell me, is the <u>lord of the universe</u> in?"),
+);
+track.addCue(new VTTCue(3, 4.2, "Yes, he's in - in a bad humor"));
+track.addCue(
+  new VTTCue(4.3, 6, "Somebody must've <b>stolen</b> the crown jewels"),
+);
+console.log(track.cues);
 ```
 
-### キュー識別子
-
-識別子は、キューを識別する名前です。スクリプトからキューを参照するために使用できます。改行を含むことはできず、文字列 "`-->`" を含むことはできません。それは単一の改行で終わらなければなりません。番号をつけるのが一般的ですが（例えば、1、2、3、...）、それらは一意である必要はありません。
-
-いくつか例を紹介します。
-
-- 基本的なキュー識別子
-
-  ```plain
-  1 - Title Crawl
-  ```
-
-- 識別子の一般的な使い方
-
-  ```plain
-  WEBVTT
-
-  1
-  00:00:22.230 --> 00:00:24.606
-  This is the first subtitle.
-
-  2
-  00:00:30.739 --> 00:00:34.074
-  This is the second.
-
-  3
-  00:00:34.159 --> 00:00:35.743
-  Third
-  ```
-
-### キューのタイミング
-
-キューのタイミングは、キューがいつ表示されるかを示します。タイムスタンプで表される開始時刻と終了時刻があります。終了時刻は開始時刻より後でなければならず、開始時刻は前のすべての開始時刻より後でなければなりません。キューは、タイミングが重複するかもしれません。
-
-WebVTT ファイルをチャプターに使用している場合（{{HTMLElement("track")}} の [`kind`](/ja/docs/Web/HTML/Element/track#kind) は `chapters` です）、ファイルは重複するタイミングを持つことはできません。
-
-各キューのタイミングには次の 5 つの要素があります。
-
-- 開始時刻のタイムスタンプ。
-- 少なくとも 1 つのスペース。
-- 文字列 "`-->`"。
-- 少なくとも 1 つのスペース。
-- 終了時刻のタイムスタンプ。開始時刻より後でなければなりません。
-
-タイムスタンプは、次の 2 つの形式のいずれかになります。
-
-- `mm:ss.ttt`
-- `hh:mm:ss.ttt`
-
-そのコンポーネントは次のように定義されています。
-
-- `hh`
-  - : 時を表し、2 桁以上でなければなりません。2 桁を超えることがあります（例えば、9999:00:00.00）。
-- `mm`
-  - : 分を表し、00 以上 59 以下でなければなりません。
-- `ss`
-  - : 秒を表し、00 以上 59 以下でなければなりません。
-- `ttt`
-  - : ミリ秒を表し、000 以上 999 以下でなければなりません。
-
-キューのタイミングの例をいくつか示します。
-
-- 基本的なキューのタイミングの例
+#### 結果
 
-  ```plain
-  00:00:22.230 --> 00:00:24.606
-  00:00:30.739 --> 00:00:34.074
-  00:00:34.159 --> 00:00:35.743
-  00:00:35.827 --> 00:00:40.122
-  ```
+{{EmbedLiveSample('Styling WebVTT in HTML or a stylesheet','400','330')}}
 
-- 重複するキューのタイミングの例
+### もっとスタイル設定をしたキューの例
 
-  ```plain
-  00:00:00.000 --> 00:00:10.000
-  00:00:05.000 --> 00:01:00.000
-  00:00:30.000 --> 00:00:50.000
-  ```
+この例では、キューテキストをタグでマークアップし、スタイル設定する方法を詳しく示します。
+同じマークアップとスタイル設定を [WebVTT ファイル形式](/ja/docs/Web/API/WebVTT_API/Web_Video_Text_Tracks_Format)で使用することができます。
 
-- 重複しないキューのタイミングの例
+動画自体を表示するための HTML と CSS は上記の[最初の例](#webvtt_api_を使用してキャプションを追加)と同じなので、ここではテキストのマークアップとスタイル設定のための特定のコードのみを示します。
 
-  ```plain
-  00:00:00.000 --> 00:00:10.000
-  00:00:10.000 --> 00:01:00.581
-  00:01:00.581 --> 00:02:00.100
-  00:02:01.000 --> 00:02:01.000
-  ```
-
-### キュー設定
-
-キュー設定は、動画上にキュー本体のテキストを表示する位置を決めるために使用するオプションのコンポーネントです。これには、テキストを水平に表示するか垂直に表示するかが含まれます。それらは 0 個以上存在することができ、各設定が 2 回以上使用されない限り、それらは任意の順序で使用できます。
-
-キュー設定は、キューのタイミングの右側に追加します。キューのタイミングと最初の設定の間、および各設定の間には 1 つ以上のスペースが必要です。設定の名前と値はコロンで区切ります。設定では大文字と小文字が区別されるため、次のように小文字を使用してください。次の 5 つのキュー設定があります。
-
-- `vertical`
-  - : 一部のアジアの言語のように、テキストを水平ではなく垂直に表示することを示します。取りうる値は 2 つあります。
-    - `rl`
-      - : 記述方向は右から左
-    - `lr`
-      - : 記述方向は左から右
-- `line`
-
-  - : vertical が設定されていない場合は、テキストを垂直方向に表示する場所を指定します。vertical が設定されている場合、line はテキストを水平方向に表示する場所を指定します。値は次の何れかです。
-
-    - 行番号
-      - : 数値は、映像に表示されるキューの最初の行の垂直位置です。正の数値はトップダウン、負の数値はボトムアップを示します。
-    - パーセント値
-      - : 0 から 100 までの整数（小数点を含まない）で、その後にパーセント記号 (%) を付けなければなりません。
-
-    | line        | `vertical` を省略 | `vertical:rl` | `vertical:lr` |
-    | ----------- | ----------------- | ------------- | ------------- |
-    | `line:0`    | 上端              | 右端          | 左端          |
-    | `line:-1`   | 下端              | 左端          | 右端          |
-    | `line:0%`   | 上端              | 右端          | 左端          |
-    | `line:100%` | 下端              | 左端          | 右端          |
-
-- `position`
-
-  - : テキストを水平方向に表示する場所を指定します。vertical を設定している場合、position はテキストを垂直方向に表示する場所を指定します。値はパーセント値で、0 から 100 までの整数（小数点なし）でなければならず、その後にパーセント記号（`%`）を付ける必要があります。
-
-    | position        | `vertical` を省略 | `vertical:rl` | `vertical:lr` |
-    | --------------- | ----------------- | ------------- | ------------- |
-    | `position:0%`   | 左端              | 上端          | 上端          |
-    | `position:100%` | 右端              | 下端          | 下端          |
-
-- `size`
-
-  - : テキスト領域の幅を指定します。vertical を設定している場合、size はテキスト領域の高さを指定します。値はパーセントで、0 から 100 までの整数（つまり、小数点なし）でなければならず、その後にパーセント記号 (`%`) を付ける必要があります。
-
-    | size        | `vertical` omitted | `vertical:rl` | `vertical:lr` |
-    | ----------- | ------------------ | ------------- | ------------- |
-    | `size:100%` | full width         | full height   | full height   |
-    | `size:50%`  | half width         | half height   | half height   |
-
-- `align`
-
-  - : テキストの配置を指定します。設定している場合、テキストは size キュー設定で指定したスペース内に配置されます。
-
-    | align          | `vertical` を省略  | `vertical:rl`      | `vertical:lr`      |
-    | -------------- | ------------------ | ------------------ | ------------------ |
-    | `align:start`  | 左端               | 上端               | 上端               |
-    | `align:center` | 水平方向に中央揃え | 垂直方向に中央揃え | 垂直方向に中央揃え |
-    | `align:end`    | 右端               | 下端               | 下端               |
-
-キュー設定の例を見てみましょう。
-
-最初の行は設定がないことを示しています。2 行目は、サインやラベルの上にテキストを重ねるために使用します。3 行目はタイトルに使用できます。最後の行はアジアの言語に使われるかもしれません。
-
-```plain
-00:00:05.000 --> 00:00:10.000
-00:00:05.000 --> 00:00:10.000 line:63% position:72% align:start
-00:00:05.000 --> 00:00:10.000 line:0 position:20% size:60% align:start
-00:00:05.000 --> 00:00:10.000 vertical:rt line:-1 align:end
+```css hidden
+video {
+  width: 420px;
+  height: 300px;
+}
 ```
 
-### キュー本体
-
-本体は、主な情報またはコンテンツを配置する場所です。通常の使用法では、本体には表示する字幕が含まれています。本体のテキストには改行を含めることができますが、空白行を含めることはできません。これは、2 つの連続する改行に相当します。空白行はキューの終わりを表します。
-
-キュー本体のテキストには、文字列 `-->`、アンパサンド文字 (`&`)、小なり記号 (`<`) を含めることはできません。代わりに、アンパサンドにはエスケープシーケンス `&amp;` を使用し、小なりには `&lt;` を使用します。タグとの混同を避けるために、大なり記号 (`>`) の代わりに大なりエスケープシーケンス `&gt;` を使用することをお勧めします。メタデータに WebVTT ファイルを使用している場合、これらの制限は適用されません。
-
-上記の 3 つのエスケープシーケンスに加えて、他にも 4 つあります。以下の表に示します。
-
-| 名前             | 文字   | エスケープシーケンス |
-| ---------------- | ------ | -------------------- |
-| アンパサンド     | `&`    | `&amp;`              |
-| 小なり           | `<`    | `&lt;`               |
-| 大なり           | `>`    | `&gt;`               |
-| 左書き           | _なし_ | `&lrm;`              |
-| 右書き           | _なし_ | `&rlm;`              |
-| 改行なしスペース |        | `&nbsp;`             |
-
-### キュー本体のテキストタグ
-
-使用できるタグは `<b>` など多数あります。ただし、WebVTT ファイルが {{HTMLElement("track")}} 要素の中で使われていて、その属性 [`kind`](/ja/docs/Web/HTML/Element/track#kind) が `chapters` である場合は、タグを使うことができません。
-
-- タイムスタンプタグ
-
-  - : タイムスタンプは、キューの開始タイムスタンプより大きく、キュー本体内の前のタイムスタンプより大きく、キューの終了タイムスタンプより小さくなければなりません。*アクティブテキスト*は、タイムスタンプと次のタイムスタンプの間、または本体に別のタイムスタンプがない場合は本体の最後までのテキストです。本体内の*アクティブテキスト*より前のテキストはすべて*過去のテキスト*です。*アクティブテキスト*より後のテキストはすべて*将来のテキスト*です。これによりカラオケ風のキャプションが実現できます。
-
-    ```plain
-    1
-    00:16.500 --> 00:18.500
-    When the moon <00:17.500>hits your eye
-
-    1
-    00:00:18.500 --> 00:00:20.500
-    Like a <00:19.000>big-a <00:19.500>pizza <00:20.000>pie
-
-    1
-    00:00:20.500 --> 00:00:21.500
-    That's <00:00:21.000>amore
-    ```
-
-次のタグは、キューで使用できる HTML タグで、開始タグと終了タグ（例えば、`<b>テキスト</b>`）が必要です。
-
-- クラスタグ (`<c></c>`)
-
-  - : CSS クラスを使用して含まれているテキストをスタイルします。
-
-    ```xml
-    <c.classname>text</c>
-    ```
-
-- イタリック体タグ (`<i></i>`)
-
-  - : 含まれているテキストをイタリック体にします。
-
-    ```xml
-    <i>text</i>
-    ```
-
-- **太字タグ** (`<b></b>`)
-
-  - : 含まれているテキストを太字にします。
-
-    ```xml
-    <b>text</b>
-    ```
-
-- 下線タグ (`<u></u>`)
-
-  - : 含まれているテキストに下線を引きます。
-
-    ```xml
-    <u>text</u>
-    ```
-
-- ルビタグ (`<ruby></ruby>`)
-
-  - : [ルビ文字](https://ja.wikipedia.org/wiki/%E3%83%AB%E3%83%93)（すなわち、他の文字の上にある小さな注釈文字）を表示するためにルビテキストタグと共に使用します。
+```html hidden
+<video
+  controls
+  src="https://interactive-examples.mdn.mozilla.net/media/cc0-videos/friday.mp4"></video>
+```
 
-    ```xml
-    <ruby>WWW<rt>World Wide Web</rt>oui<rt>yes</rt></ruby>
-    ```
+#### タグ種別によるスタイル設定
 
-- ルビテキストタグ (`<rt></rt>`)
+最初に作成するキューは、動画の 6 秒間すべて表示され、`b`、`u`、`i`、`c` タグでマークアップされたテキストが表示されます。
 
-  - : [ルビ文字](https://ja.wikipedia.org/wiki/%E3%83%AB%E3%83%93)（つまり、他の文字の上にある小さな注釈文字）を表示するためにルビタグとともに使用します。
+```js
+let video = document.querySelector("video");
 
-    ```xml
-    <ruby>WWW<rt>World Wide Web</rt>oui<rt>yes</rt></ruby>
-    ```
+let track = video.addTextTrack("captions", "Captions", "en");
+track.mode = "showing";
 
-- ボイスタグ (`<v></v>`)
+track.addCue(
+  new VTTCue(
+    0,
+    6,
+    "スタイル: 標準 <b>太字</b> <u>下線</u> <i>斜体</i> <c>クラス</c>",
+  ),
+);
+```
 
-  - クラスタグと同様に、CSS を使用して含まれているテキストをスタイルするためにも使用します。
+まず、すべてのキューを通常の 1.2 倍の大きさにするルールを追加します。
 
-    ```xml
-    <v Bob>text</v>
-    ```
+```css
+video::cue {
+  font-size: 1.2rem;
+}
+```
 
-## インスタンスメソッドとプロパティ
+次に、上記のタグをそれぞれ違う色でスタイル設定します。
 
-WebVTT で使用するメソッドは、両方のインターフェイスの属性が異なるため、キューまたは領域を変更するために使用するものです。WebVTT の各インターフェイスに関する理解を深めるために、それらを分類することができます。
+```css
+video::cue(u) {
+  color: green;
+}
 
-### VTTCue
+video::cue(b) {
+  color: purple;
+}
 
-- {{domxref("VTTCue")}} インターフェイスで利用できるメソッドは次のとおりです。
+video::cue(i) {
+  color: red;
+}
 
-- {{domxref("VTTCue.getCueAsHTML", "getCueAsHTML()")}}: そのキューの HTML を取得します。
-- コンストラクター、{{domxref("VTTCue.VTTCue", "VTTCue()")}} はこのインターフェイスの新しいインスタンスを生成します。
+video::cue(c) {
+  color: lightpurple;
+}
+```
 
-キューの位置、配置、サイズなど、キューの特性を読み取り、設定するためのさまざまなプロパティも用意されています。完全なリストは {{domxref("VTTCue")}} を参照してください。
+#### クラスによるスタイル設定
 
-### VTTRegion
+2 つ目のキューは、最初のキューの直後に表示され、同じタグがあります。しかし、すべて `myclass` クラスが適用されています。
 
-{{domxref("VTTRegion")}} では、機能の説明とともにメソッドを提供します。特に、与えられた領域内に存在するすべてのノードのスクロール設定を調整することができます。
+```js
+track.addCue(
+  new VTTCue(
+    1,
+    6,
+    "スタイル: クラスマークアップ: <b.myclass>太字</b> <u.myclass>下線</u> <i.myclass>斜体</i> <c.myclass>クラス</c>",
+  ),
+);
+```
 
-## WebVTT ファイルの書き方に関するチュートリアル
+`c.myclass`の特定の仕様を除いて、`.myclass` クラスを持つすべてのアイテムを水色の文字色でスタイル設定します。
 
-簡単な WebVTT ファイルを作成するには、いくつかのステップを踏む必要があります。まず、メモ帳を使い、'.vtt' ファイルとして保存します。手順は以下の通りです。
+```css
+video::cue(.myclass) {
+  color: lightblue;
+}
 
-- メモ帳を開きます。
-- WebVTT の最初の行は、ファイルがファイルの種類を示し始めるときに他の言語ではヘッダーを配置するように要求されるのと同様に標準化されています。最初の 1 行は次のように書く必要があります。
+video::cue(c.myclass) {
+  color: blue;
+}
+```
 
-  ```plain
-  WEBVTT
-  ```
+#### 属性を使用したスタイル設定
 
-- 2 行目を空白のままにして、3 行目で最初のキューの時間を指定します。例えば、時間が 1 秒で始まり 5 秒で終わる最初のキューでは、次のようになります。
+次の 2 つのキューは 2 秒後と 3 秒後に表示されます。
+最初のキューは `lang` タグでマークアップされた英語の 3 つのロケールのテキストを表示し、2 つ目は "Bob" 属性を持つ `<v>`（音声）タグを表示します。
 
-  ```plain
-  00:01.000 --> 00:05.000
-  ```
+```js
+track.addCue(
+  new VTTCue(
+    2,
+    6,
+    "<lang en>言語マークアップ: 'en'</lang>  <lang en-GB>テキスト: 'en-GB'</lang> <lang en-US>テキスト: 'en-US'</lang>",
+  ),
+);
 
-- 次の行に、このキューのキャプションを書くことができます。キャプションは 1 秒から 5 秒までです。
-- 同様の手順に従って、特定の動画または音声ファイル用の完全な WebVTT ファイルを作成できます。
+track.addCue(new VTTCue(3, 6, "<v Bob>ボブの声</v>"));
+```
 
-## CSS 擬似クラス
+`lang` 属性セレクターを使用して、各言語に異なる文字色を与えています。
 
-CSS 擬似クラスを使用すると、他の種類のオブジェクトと区別したいオブジェクトの種類を分類できます。WebVTT ファイルでも HTML ファイルと同じように機能します。
+```css
+video::cue([lang="en"]) {
+  color: lightgreen;
+}
 
-WebVTT が備えている優れた機能には、ローカライズと class 要素の使用があります。class 要素は、HTML や CSS で特定の型のオブジェクトのスタイルを分類するために使われるのと同じように使用できますが、ここでは、以下のようにキューのスタイルと分類に使用されています。
+video::cue([lang="en-GB"]) {
+  color: darkgreen;
+}
 
-```plain
-WEBVTT
+video::cue(:lang(en-US)) {
+  color: #6082b6;
+}
+```
 
-04:02.500 --> 04:05.000
-J'ai commencé le basket à l'âge de 13, 14 ans
+次に、`v` タグと `voice` の属性セレクターを使用して、"ボブの声" のテキストをオレンジ色にします。
 
-04:05.001 --> 04:07.800
-Sur les <i.foreignphrase><lang en>playground</lang></i>, ici à Montpellier
+```css
+video::cue(v[voice="Bob"]) {
+  color: orange;
+}
 ```
 
-上記の例では、キャプションの言語を定義するために識別子と擬似クラス名を使用できることがわかります。`<i>` タグはイタリック体のためのものです。
+#### 結果
 
-擬似クラスの型はそれを使用しているセレクターによって決定し、それは HTML で機能するのと同じように機能します。以下の CSS 擬似クラスを使用することができます。
+例では、上記のスタイル設定に一致する色でキューを表示する必要があります（テキストに色が付いていない場合は、ブラウザーが `::cue` に対応していません）。
 
-- `lang` (Language): 例えば、`p:lang(it)`。
-- `link`: 例えば、`a:link`。
-- `nth-last-child`: 例えば、`p:nth-last-child(2)`。
-- `nth-child(n)`: 例えば、`p:nth-child(2)`。
-
-ここで、`p` と `a` はそれぞれ HTML で段落とリンクに使われるタグで、WebVTT ファイルの Cue に使われる識別子に置き換えることができます。
+{{EmbedLiveSample('More cue styling examples','400','330')}}
 
 ## 仕様書
 
@@ -593,14 +380,6 @@ Sur les <i.foreignphrase><lang en>playground</lang></i>, ici à Montpellier
 
 {{Compat}}
 
-### メモ
-
-Firefox 50 より前のバージョンでは、`AlignSetting` 列挙体（{{domxref("VTTCue.align")}} に指定可能な値を表す）に、`"center"` ではなく `"middle"` という値が誤って含まれていました。これは修正されました。
-
-WebVTT は Firefox 24 では `media.webvtt.enabled` の設定に隠されて実装されており、既定では無効になっています。この設定を `true` に設定することで有効にできます。WebVTT は Firefox 31 以降では既定で有効になっていますが、設定を `false` に設定することで無効にすることができます。
-
-Firefox 58 より前のバージョンでは、`REGION` キーワードは {{domxref("VTTRegion")}} オブジェクトを作成していましたが、使用していませんでした。Firefox 58 は現在 `VTTRegion` とその使用を完全にサポートしています。ただし、この機能は設定 `media.webvtt.regions.enabled` に隠されて既定で無効になっています。Firefox 58 で領域のサポートを有効にするには、`true` に設定してください。領域は Firefox 59 以降で既定で有効になっています（[Firefox bug 1338030](https://bugzil.la/1338030) および [Firefox bug 1415805](https://bugzil.la/1415805) のバグを参照）。
-
 ## 関連情報
 
 - CSS の [`::cue` および `::cue()`](/ja/docs/Web/CSS/::cue) 擬似要素

From 12f38303c888d53599db8c229ac03585abc5dac7 Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Tue, 17 Sep 2024 14:52:45 +0800
Subject: [PATCH 091/115] fix: code example (#23441)

---
 files/ko/learn/server-side/django/sessions/index.md    | 3 ++-
 files/pt-br/learn/server-side/django/sessions/index.md | 3 ++-
 files/zh-tw/learn/server-side/django/sessions/index.md | 3 ++-
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/files/ko/learn/server-side/django/sessions/index.md b/files/ko/learn/server-side/django/sessions/index.md
index 393f4c63dcb544..49e34066ec34a4 100644
--- a/files/ko/learn/server-side/django/sessions/index.md
+++ b/files/ko/learn/server-side/django/sessions/index.md
@@ -120,7 +120,8 @@ def index(request):
 
     # Number of visits to this view, as counted in the session variable.
     num_visits = request.session.get('num_visits', 0)
-    request.session['num_visits'] = num_visits + 1
+    num_visits += 1
+    request.session['num_visits'] = num_visits
 
     context = {
         'num_books': num_books,
diff --git a/files/pt-br/learn/server-side/django/sessions/index.md b/files/pt-br/learn/server-side/django/sessions/index.md
index 1b713e7629c8bb..d7db7b278dab3b 100644
--- a/files/pt-br/learn/server-side/django/sessions/index.md
+++ b/files/pt-br/learn/server-side/django/sessions/index.md
@@ -120,7 +120,8 @@ def index(request):
 
     # Number of visits to this view, as counted in the session variable.
     num_visits = request.session.get('num_visits', 0)
-    request.session['num_visits'] = num_visits + 1
+    num_visits += 1
+    request.session['num_visits'] = num_visits
 
     context = {
         'num_books': num_books,
diff --git a/files/zh-tw/learn/server-side/django/sessions/index.md b/files/zh-tw/learn/server-side/django/sessions/index.md
index c1c761ddf917e6..5e2a962564ad73 100644
--- a/files/zh-tw/learn/server-side/django/sessions/index.md
+++ b/files/zh-tw/learn/server-side/django/sessions/index.md
@@ -122,7 +122,8 @@ def index(request):
 
     # Number of visits to this view, as counted in the session variable.
     num_visits = request.session.get('num_visits', 0)
-    request.session['num_visits'] = num_visits + 1
+    num_visits += 1
+    request.session['num_visits'] = num_visits
 
     context = {
         'num_books': num_books,

From 9c0a9fccbb7b1329f6ca623e8febc4f08c9b7144 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Tue, 17 Sep 2024 14:54:47 +0800
Subject: [PATCH 092/115] [zh-cn]: sync translation for using channel messaging
 (#23526)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../using_channel_messaging/index.md          | 76 +++++++++----------
 1 file changed, 38 insertions(+), 38 deletions(-)

diff --git a/files/zh-cn/web/api/channel_messaging_api/using_channel_messaging/index.md b/files/zh-cn/web/api/channel_messaging_api/using_channel_messaging/index.md
index b253c4028a875d..bf17d5d2537b75 100644
--- a/files/zh-cn/web/api/channel_messaging_api/using_channel_messaging/index.md
+++ b/files/zh-cn/web/api/channel_messaging_api/using_channel_messaging/index.md
@@ -1,47 +1,47 @@
 ---
-title: 使用 channel messaging
+title: 使用频道传递消息
 slug: Web/API/Channel_Messaging_API/Using_channel_messaging
+l10n:
+  sourceCommit: c7edf2734fccb185c5e93ee114ea3d5edc0177b5
 ---
 
-{{DefaultAPISidebar("Channel Messaging API")}}
+{{DefaultAPISidebar("Channel Messaging API")}} {{AvailableInWorkers}}
 
-[Channel Messaging API](/zh-CN/docs/Web/API/Channel_Messaging_API) 可以让运行在不同浏览器上下文中的独立脚本，连接到同一份文档（比如：两个 IFrame, 或者主文档和一个 IFrame, 或者使用同一个 {{domxref("SharedWorker")}} 的两份文档），并直接通信，通过每端一个 port 的双向频道（或管道）在两者之间传递消息。
+[Channel Messaging API](/zh-CN/docs/Web/API/Channel_Messaging_API) 可以让两个在附加到同一文档的不同浏览上下文中运行的单独脚本（比如：两个 {{HTMLElement("iframe")}} 元素，或者主文档和一个 {{HTMLElement("iframe")}}，或者使用同一个 {{domxref("SharedWorker")}} 的两个文档）直接通信，通过两端都有端口的双向频道（或管道）相互传递消息。
 
-在文本中，我们将探索这项技术的基本用法。
-
-{{AvailableInWorkers}}
+在本文中，我们将探索这项技术的基本用法。
 
 ## 用例
 
-Channel messaging 在这样的场景中特别有用：假如你有一个社交站点，它在主界面中通过 IFrame 内嵌了来自其他站点的内容，比如游戏，通讯录或者一个音乐播放器，有着个性化的音乐选择。当这些内容作为独立的单元时，一切都是 OK 的，但是当你想在主站点和 IFrame, 或者在不同的 IFrame 中交互时，困难就出现了。举例来说，假如你想从主站点向通讯录里添加一个联系人；或者想从游戏里，把最高分加入到个人资料；又或者，希望从音频播放器里，添加新的背景音乐到游戏中？因为浏览器使用的安全模型，使用传统的 web 技术来做这些事并不容易。你必须去考虑不同的源之间彼此是否信任，以及如何传递消息。
+频道消息传递在这样的场景中特别有用：假如你有一个社交站点，它在主界面中通过 iframe 内嵌了来自其他站点的内容，比如游戏，通讯录或者一个音乐播放器，有着个性化的音乐选择。当这些内容作为独立的单元时，一切都是 OK 的，但是当你想在主站点和 {{HTMLElement("iframe")}}，或者在不同的 {{HTMLElement("iframe")}} 间交互时，困难就出现了。举例来说，假如你想从主站点向通讯录里添加一个联系人；或者想从游戏里，把最高分加入到个人资料；又或者，希望从音频播放器里，添加新的背景音乐到游戏中？因为浏览器使用的安全模型，使用传统的 Web 技术来做这些事并不容易。你必须去考虑不同的源之间彼此是否信任，以及如何传递消息。
 
-换个角度说，Message Channels 可以提供一个安全的通道让你在不同的浏览器上下文间传递数据。
+换个角度说，消息频道可以提供一个让你在不同的浏览上下文间传递数据的安全频道。
 
 > [!NOTE]
-> 要了解更多信息和思考，规范的 [Ports 作为 Web 上一个对象兼容模型的基础](https://html.spec.whatwg.org/multipage/comms.html#ports-as-the-basis-of-an-object-capability-model-on-the-web) 章节值得一读。
+> 要了解更多信息和想法，规范的[端口作为 Web 上一个对象兼容模型的基础](https://html.spec.whatwg.org/multipage/comms.html#ports-as-the-basis-of-an-object-capability-model-on-the-web)章节值得一读。
 
-## 简单的例子
+## 简单的示例
 
-为了帮助你开始，我们在 Github 上传了一些 demo. 一开始可以先看我们的 [channel messaging 基本示例](https://github.com/mdn/dom-examples/tree/main/channel-messaging-basic)（[也可以在线运行](https://mdn.github.io/dom-examples/channel-messaging-basic/)），它展示了一个非常简单的消息传递，发生在页面和内嵌 {{htmlelement("iframe")}} 之间。
+为了帮助你开始，我们在 Github 上发布了一些演示。一开始可以先看我们的[消息传递基本示例](https://github.com/mdn/dom-examples/tree/main/channel-messaging-basic)（[也可以在线运行](https://mdn.github.io/dom-examples/channel-messaging-basic/)），它展示了一个非常简单的消息传递，发生在页面和内嵌 {{htmlelement("iframe")}} 之间。
 
-然后，看看我们的 [multimessaging 演示](https://github.com/mdn/dom-examples/tree/main/channel-messaging-multimessage)（[在线运行](https://mdn.github.io/dom-examples/channel-messaging-multimessage/)），它展示了一个稍微复杂一点的例子，可以在主页面和 IFrame 之间发送多条消息。
+然后，看看我们的[多条消息传递演示](https://github.com/mdn/dom-examples/tree/main/channel-messaging-multimessage)（[在线运行](https://mdn.github.io/dom-examples/channel-messaging-multimessage/)），它展示了一个稍微复杂一点的例子，可以在主页面和 IFrame 之间发送多条消息。
 
 本文中，我们重点说后面的这个例子。它看起来像是这样：
 
-![](channel-messaging-demo.png)
+![演示中“你好，这是我的演示”以五条单独的消息发送。这些消息以项目符号列表的形式显示。](channel-messaging-demo.png)
 
-## 创建 channel
+## 创建频道
 
 在例子的主页面，我们有一个简单的表单，内含一个文本输入框，用来输入要发送到 {{htmlelement("iframe")}} 的消息。我们还有一个段落，我们在稍后将会用它来显示 {{htmlelement("iframe")}} 回传回来的确认消息。
 
 ```js
-var input = document.getElementById("message-input");
-var output = document.getElementById("message-output");
-var button = document.querySelector("button");
-var iframe = document.querySelector("iframe");
+const input = document.getElementById("message-input");
+const output = document.getElementById("message-output");
+const button = document.querySelector("button");
+const iframe = document.querySelector("iframe");
 
-var channel = new MessageChannel();
-var port1 = channel.port1;
+const channel = new MessageChannel();
+const port1 = channel.port1;
 
 // 等待 iframe 加载
 iframe.addEventListener("load", onLoad);
@@ -70,30 +70,30 @@ function onMessage(e) {
 }
 ```
 
-我们从使用 {{domxref( "MessageChannel.MessageChannel","MessageChannel()")}} 构造函数创建了一个 message channel 开始。
+我们从使用 {{domxref( "MessageChannel.MessageChannel","MessageChannel()")}} 构造函数创建了一个消息频道开始。
 
-当 IFrame 加载完成，我们在按钮上注册了`onclick` 事件处理函数，在 {{domxref("MessageChannel.port1")}} 注册了 `onmessage` 事件处理函数。最后，我们使用 {{domxref("window.postMessage")}} 方法把 {{domxref("MessageChannel.port2")}} 传给 IFrame.
+当 IFrame 加载完成，我们在按钮上注册了 `onclick` 事件处理器，在 {{domxref("MessageChannel.port1")}} 注册了 `onmessage` 事件处理器。最后，我们使用 {{domxref("window.postMessage")}} 方法把 {{domxref("MessageChannel.port2")}} 传递给 IFrame。
 
-让我们来了解一下 `iframe.contentWindow.postMessage` 更多的工作细节。它接受三个参数：
+让我们更详细地了解一下 `iframe.contentWindow.postMessage` 行的工作原理。它接受三个参数：
 
-1. 被发送的消息。对于一开始的 port 传递，这个消息可以是个空字符串，但是在例子里，我们传了 `'init'`.
-2. 消息将被发送到的源（origin）。 `*` 意思是 "任何源".
-3. 一个对象，它的所有权会被传给接受的浏览器上下文。在本例中，我们把 {{domxref("MessageChannel.port2")}} 传给了 IFrame, 然后它就可以用于与主页面通信了。
+1. 被发送的消息。对于一开始的端口传递，这个消息可以是个空字符串，但是在例子里，我们传了 `'init'`。
+2. 消息将被发送到的源。`*` 意思是“任何源”。
+3. 一个对象，它的所有权会被传递给接受的浏览器上下文。在本例中，我们把 {{domxref("MessageChannel.port2")}} 传给了 IFrame，然后它就可以用于与主页面通信了。
 
-当我们的按钮被点击时，我们阻止了默认的表单提交，然后把输入到输入框里的内容通过 {{domxref("MessageChannel")}} 发送给 IFrame.
+当我们的按钮被点击时，我们阻止了默认的表单提交，然后把输入到输入框里的内容通过 {{domxref("MessageChannel")}} 发送给 IFrame。
 
-## 在 IFrame 里接收 port 和消息
+## 在 IFrame 里接收端口和消息
 
-在 IFrame 里，我们有下面的 JavaScript:
+在 IFrame 里，我们有下面的 JavaScript：
 
 ```js
-var list = document.querySelector("ul");
-var port2;
+const list = document.querySelector("ul");
+let port2;
 
-// 监听初始的 port 传递消息
+// 监听初始的端口传递消息
 window.addEventListener("message", initPort);
 
-// 设置传过来的 port
+// 设置传递过来的端口
 function initPort(e) {
   port2 = e.ports[0];
   port2.onmessage = onMessage;
@@ -101,22 +101,22 @@ function initPort(e) {
 
 // 处理 port2 收到的消息
 function onMessage(e) {
-  var listItem = document.createElement("li");
+  const listItem = document.createElement("li");
   listItem.textContent = e.data;
   list.appendChild(listItem);
-  port2.postMessage('Message received by IFrame: "' + e.data + '"');
+  port2.postMessage(`IFrame 收到的消息：“${e.data}”`);
 }
 ```
 
-当收到从主页面通过 {{domxref("window.postMessage")}} 方法传来的初始化消息时，我们运行 `initPort` 函数。它会保存传来的 port, 并且注册了一个 onmessage 事件处理器，每当有消息通过我们的 {{domxref("MessageChannel")}} 传来时，它都会被调用。
+当收到从主页面通过 {{domxref("window.postMessage")}} 方法传来的初始化消息时，我们运行 `initPort` 函数。它会保存传递过来的端口，并且注册了一个 onmessage 事件处理器，每当有消息通过我们的 {{domxref("MessageChannel")}} 传来时，它都会被调用。
 
 当收到从主页面发来的消息时，我们创建一个列表项，并把它插入到这个无序列表中，然后把这个列表项的 {{domxref("Node.textContent","textContent")}} 设置为事件的 `data` 属性（里面包含真正的消息）。
 
-然后，我们通过在初始化时传到 IFrame 的 {{domxref("MessageChannel.port2")}} 上调用 {{domxref("MessagePort.postMessage")}} 来使用 message channel 发送一个确认消息给主页面。
+接下来，我们通过在初始化时传递到 IFrame 的 {{domxref("MessageChannel.port2")}} 上调用 {{domxref("MessagePort.postMessage")}} 来使用消息频道将确认消息发送回主页面。
 
 ## 在主页面中接收确认消息
 
-回到主页面，我们来一起看看 onmessage 事件处理函数。
+回到主页面，我们来一起看看 `onmessage` 事件处理器。
 
 ```js
 // 处理 port1 上收到的消息

From 97da864615233d01f889635606539b53054da995 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Tue, 17 Sep 2024 14:55:17 +0800
Subject: [PATCH 093/115] [zh-CN]: sync translation for Channel Message API
 (#23525)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../web/api/channel_messaging_api/index.md    | 36 +++++++++----------
 1 file changed, 17 insertions(+), 19 deletions(-)

diff --git a/files/zh-cn/web/api/channel_messaging_api/index.md b/files/zh-cn/web/api/channel_messaging_api/index.md
index cfd349de7325bd..f507ad3fb073da 100644
--- a/files/zh-cn/web/api/channel_messaging_api/index.md
+++ b/files/zh-cn/web/api/channel_messaging_api/index.md
@@ -1,39 +1,37 @@
 ---
 title: Channel Messaging API
 slug: Web/API/Channel_Messaging_API
+l10n:
+  sourceCommit: 2c641e08878722bf29fb784d58c61873ce4a133a
 ---
 
-{{DefaultAPISidebar("Channel Messaging API")}}
+{{DefaultAPISidebar("Channel Messaging API")}} {{AvailableInWorkers}}
 
-**Channel Messaging API** 允许两个不同的脚本运行在同一个文档的不同浏览器上下文（比如两个 iframe，或者文档主体和一个 iframe，使用 {{domxref("SharedWorker")}} 的两个文档，或者两个 worker）来直接通讯，在每端使用一个端口（port）通过双向频道（channel）向彼此传递消息。
+**Channel Messaging API** 允许两个运行在同一个文档的不同浏览上下文（比如两个 iframe，或者文档主体和一个 iframe，使用 {{domxref("SharedWorker")}} 的两个文档，或者两个 worker）中的独立脚本直接进行通讯，在每端使用一个端口（port）通过双向频道（channel）或管道（pipe）向彼此传递消息。
 
-{{AvailableInWorkers}}
+## 概念和用法
 
-## Channel 通信的概念和用法
+使用 {{domxref("MessageChannel.MessageChannel", "MessageChannel()")}} 构造函数来创建消息频道。一旦创建，可以通过 {{domxref("MessageChannel.port1")}} 和 {{domxref("MessageChannel.port2")}} 属性访问频道的两个端口（这两个属性都会返回 {{domxref("MessagePort")}} 对象）。创建频道的应用程序使用 `port1`，在另一端的程序使用 `port2`——你向 `port2` 发送信息，然后携带 2 个参数（需要传递的消息，要传递所有权的对象，在这种情况下是端口自身）调用 {{domxref("window.postMessage")}} 方法将端口传递到另一个浏览器上下文。
 
-使用 {{domxref("MessageChannel.MessageChannel", "MessageChannel()")}} 构造函数来创建通讯信道。一旦创建，信道的两个端口即可通过 {{domxref("MessageChannel.port1")}} 和 {{domxref("MessageChannel.port2")}} 属性进行访问（都会返回 {{domxref("MessagePort")}} 对象）。创建信道的应用程序使用 `port1`，在另一端的程序使用 `port2`——你向 `port2` 发送信息，然后携带 2 个参数（需要传递的消息，要传递所有权的对象，在这里是 port 自身）调用 {{domxref("window.postMessage")}} 方法将端口信息传递到另一个浏览器上下文。
+当这些可转移的对象被传递后，它们就从之前所属的上下文中消失了。比如一个端口，一旦被发送，在原本的上下文中就再也不可用了。
 
-当这些可传递的对象被传递后，他们就从之前所属的上下文中消失了。比如一个 port，一旦被发送，在原本的上下文中就再也不可用了。注意当前仅有 {{domxref("ArrayBuffer")}} 和 {{domxref("MessagePort")}} 对象可以被发送。
+另一个浏览器上下文可以使用 {{domxref("MessagePort.message_event", "onmessage")}} 监听信息，并使用事件的 `data` 属性获取消息内容。你可以通过 {{domxref("MessagePort.postMessage")}} 将消息发送回原始文档进行响应。
 
-另一个浏览器上下文可以使用 {{domxref("MessagePort.onmessage")}} 监听信息，并使用事件的 `data` 属性获取消息内容。你可以通过 {{domxref("MessagePort.postMessage")}} 向原来的文档发送应答消息。
+当你想要停止通过频道发送消息时，你可以调用 {{domxref("MessagePort.close")}} 来关闭端口。
 
-当你想要停止通过信道发送消息时，你可以调用来关闭 {{domxref("MessagePort.close")}} 端口。
+请参阅[使用频道传递消息](/zh-CN/docs/Web/API/Channel_Messaging_API/Using_channel_messaging)，了解有关如何使用此 API 的更多信息。
 
-更多使用这个 API 的资料参见：[Using channel messaging](/zh-CN/docs/Web/API/Channel_Messaging_API/Using_channel_messaging) 。
-
-## Channel 通信接口
+## 接口
 
 - {{domxref("MessageChannel")}}
-  - : 创建一个新的发送消息的信道。
+  - : 创建一个新的消息频道来发送消息。
 - {{domxref("MessagePort")}}
-  - : 控制消息信道的端口，允许从一个端口发送消息，并监听另一端消息的到来。
-- {{domxref("PortCollection")}}
-  - : `MessagePort` 数组，一种同时向多个端口广播消息的实验性解决方案。
+  - : 控制消息频道的端口，允许从一个端口发送消息，并监听到达另一个端口。
 
-## 例子
+## 示例
 
-- 我们在 Github 上发布了 [channel messaging 基本演示](https://github.com/mdn/dom-examples/tree/main/channel-messaging-basic)，在[这里](http://mdn.github.io/dom-examples/channel-messaging-basic/)直接尝试。这个例子展示了一次页面和嵌入 {{htmlelement("iframe")}} 间的真实而简易的消息传递。
-- 你也可以参考[多个消息演示](https://github.com/mdn/dom-examples/tree/main/channel-messaging-multimessage)（[在线演示](http://mdn.github.io/dom-examples/channel-messaging-multimessage/)）。这个例子展示了稍微复杂些的设置，可以在主页面和 IFrame 之间传递多条消息。
+- 我们在 Github 上发布了[频道消息传递基本演示](https://github.com/mdn/dom-examples/tree/main/channel-messaging-basic)，在[这里](https://mdn.github.io/dom-examples/channel-messaging-basic/)直接尝试。这个例子展示了一次页面和嵌入 {{htmlelement("iframe")}} 间的非常简单的消息传递。
+- 你也可以参考[多个消息演示](https://github.com/mdn/dom-examples/tree/main/channel-messaging-multimessage)（[在线演示](https://mdn.github.io/dom-examples/channel-messaging-multimessage/)）。这个例子展示了稍微复杂些的设置，可以在主页面和 IFrame 之间传递多条消息。
 
 ## 规范
 
@@ -45,6 +43,6 @@ slug: Web/API/Channel_Messaging_API
 
 ## 参见
 
-- [Using channel messaging](/zh-CN/docs/Web/API/Channel_Messaging_API/Using_channel_messaging)
+- [使用频道传递消息](/zh-CN/docs/Web/API/Channel_Messaging_API/Using_channel_messaging)
 - [Web Workers API](/zh-CN/docs/Web/API/Web_Workers_API)
 - [Broadcast Channel API](/zh-CN/docs/Web/API/Broadcast_Channel_API)

From 6eb4d69092813f4207758464cb4720092139ccc1 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 13 Sep 2024 22:56:30 +0900
Subject: [PATCH 094/115] =?UTF-8?q?2024/09/01=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/htmlelement/index.md | 141 +++++++++++---------------
 1 file changed, 62 insertions(+), 79 deletions(-)

diff --git a/files/ja/web/api/htmlelement/index.md b/files/ja/web/api/htmlelement/index.md
index 6ea470aa85ac07..a21125bedb3619 100644
--- a/files/ja/web/api/htmlelement/index.md
+++ b/files/ja/web/api/htmlelement/index.md
@@ -2,7 +2,7 @@
 title: HTMLElement
 slug: Web/API/HTMLElement
 l10n:
-  sourceCommit: 51a663ab797d3766a77e40af6565e43ae7af3d07
+  sourceCommit: bc7e82aa6db60568d7146ee285918550bbe4b8ce
 ---
 
 {{APIRef("HTML DOM")}}
@@ -13,24 +13,30 @@ l10n:
 
 ## インスタンスプロパティ
 
-_親である {{DOMxRef("Element")}} からプロパティを継承しています。_
+_親である {{DOMxRef("Element")}} から継承したプロパティもあります。_
 
 - {{DOMxRef("HTMLElement.accessKey")}}
   - : 要素に割り当てられたアクセスキーを表す文字列です。
 - {{DOMxRef("HTMLElement.accessKeyLabel")}} {{ReadOnlyInline}}
   - : 要素に割り当てられたアクセスキーを含む文字列を返します。
+- {{DOMxRef("HTMLElement.anchorElement")}} {{ReadOnlyInline}}&nbsp;{{non-standard_inline}} {{experimental_inline}}
+  - : 要素のアンカー要素への参照を返すか、アンカー要素がない場合は `null` を返します。
 - {{DOMxRef("HTMLElement.attributeStyleMap")}} {{ReadOnlyInline}}
   - : {{DOMxRef("StylePropertyMap")}} で、その要素の [`style`](/ja/docs/Web/HTML/Global_attributes#style) 属性の宣言を表します。
+- {{domxref("HTMLElement.autocapitalize", "autocapitalize")}}
+  - : ユーザー入力に対する要素の大文字小文字の動作を表す文字列。有効な値は `none`、`off`、`on`、`characters`、`words`、`sentences`　です。
+- {{domxref("HTMLElement.autofocus")}}
+  - : 論理値で、HTML の [`autofocus`](/ja/docs/Web/HTML/Element/select#autofocus) グローバル属性を反映し、ページが読み込まれたとき、または {{htmlelement("dialog")}} 要素やポップオーバー属性が設定されている要素内の要素に指定した場合、ダイアログやポップオーバーが表示されたときに、コントロールにフォーカスを当てるかどうかを示します。
 - {{DOMxRef("HTMLElement.contentEditable")}}
   - : 文字列で、 `true` の場合は要素が編集可能、`false` の場合は編集不可であることを表します。
-- {{DOMxRef("HTMLElement.isContentEditable")}} {{ReadOnlyInline}}
-  - : 論理値で、要素のコンテンツが編集可能か否かを示します。
 - {{DOMxRef("HTMLElement.dataset")}} {{ReadOnlyInline}}
   - : {{DOMxRef("DOMStringMap")}} で、スクリプトが読み書きできる要素の[カスタムデータ属性](/ja/docs/Learn/HTML/Howto/Use_data_attributes) (`data-*`) を表します。
 - {{DOMxRef("HTMLElement.dir")}}
   - : 文字列で、要素の書字方向を表す `dir` グローバル属性を反映します。利用可能な値は、`"ltr"` および `"rtl"`、`"auto"` です。
 - {{DOMxRef("HTMLElement.draggable")}}
   - : 論理値で、要素がドラッグ可能かどうかを示します。
+- {{DOMxRef("HTMLElement.editContext")}} {{experimental_inline}}
+  - : この要素に関連付けられた {{DOMxRef("EditContext")}} を返します。なければ `null` を返します。
 - {{DOMxRef("HTMLElement.enterKeyHint")}}
   - : 文字列で、仮想キーボードの Enter キーに表示するアクションラベル（またはアイコン）を定義します。
 - {{DOMxRef("HTMLElement.hidden")}}
@@ -43,12 +49,10 @@ _親である {{DOMxRef("Element")}} からプロパティを継承していま
     セッターとしては、この要素の子要素を指定された値で置き換え、すべての改行を {{HTMLElement("br")}} 要素に変換します。
 - {{DOMxRef("HTMLElement.inputMode")}}
   - : 文字列で、この要素の [`inputmode`](/ja/docs/Web/HTML/Global_attributes/inputmode) 属性の値を反映します。
-- {{domxref("HTMLElement.popover")}} {{Experimental_Inline}}
-  - : JavaScript から要素のポップオーバー状態を取得・設定し（`"auto"`または`"manual"`）、機能検出のために使用することもできます。グローバル HTML 属性 [`popover`](/ja/docs/Web/HTML/Global_attributes/popover) の値を反映します。
+- {{DOMxRef("HTMLElement.isContentEditable")}} {{ReadOnlyInline}}
+  - : 論理値で、要素のコンテンツが編集可能か否かを示します。
 - {{DOMxRef("HTMLElement.lang")}}
   - : 文字列で、要素の属性およびテキスト、要素のコンテンツの言語を表します。
-- {{DOMxRef("HTMLElement.noModule")}}
-  - : 論理値で、モジュールスクリプトに対応しているユーザーエージェントでインポートしたスクリプトが実行されるかどうかを示します。
 - {{DOMxRef("HTMLElement.nonce")}}
   - : 指定されたフェッチが実行を許可されるかどうかを判断するためにコンテンツセキュリティポリシーが使用する、一度だけ使用される暗号学的な数値を返します。
 - {{DOMxRef("HTMLElement.offsetHeight")}} {{ReadOnlyInline}}
@@ -65,10 +69,10 @@ _親である {{DOMxRef("Element")}} からプロパティを継承していま
   - : ノードとその子孫の表示されるテキストコンテンツを表します。
     ゲッターとしては {{DOMxRef("HTMLElement.innerText")}} と同じです（要素とその子孫の表示されるテキストの内容を表します）。
     セッターとしては、選択されたノードとその内容を指定された値で置き換え、改行を {{HTMLElement("br")}} 要素に変換します。
-- {{DOMxRef("HTMLElement.properties")}} {{Experimental_Inline}} {{ReadOnlyInline}}
-  - : {{DOMxRef("HTMLPropertiesCollection")}} を返します…
+- {{domxref("HTMLElement.popover")}}
+  - : JavaScript から要素のポップオーバー状態を取得・設定し（`"auto"`または`"manual"`）、機能検出のために使用することもできます。グローバル HTML 属性 [`popover`](/ja/docs/Web/HTML/Global_attributes/popover) の値を反映します。
 - {{DOMxRef("HTMLElement.spellcheck")}}
-  - : 論理値で、[スペルチェック](/ja/docs/Web/HTML/Global_attributes/spellcheck) を制御します。これはすべての HTML 要素に提供されていますが、すべての要素に効果があるとは限りません。
+  - : 論理値で、[スペルチェック](/ja/docs/Web/HTML/Global_attributes/spellcheck) のヒントを制御します。これはすべての HTML 要素で利用できますが、すべての要素に効果があるとは限りません。
 - {{DOMxRef("HTMLElement.style")}}
   - : {{DOMxRef("CSSStyleDeclaration")}} で、この要素の [`style`](/ja/docs/Web/HTML/Global_attributes#style) 属性の宣言を表します。
 - {{DOMxRef("HTMLElement.tabIndex")}}
@@ -77,10 +81,12 @@ _親である {{DOMxRef("Element")}} からプロパティを継承していま
   - : 文字列で、マウスポインターを要素に当てた時に現れるポップアップボックスのテキストを表します。
 - {{DOMxRef("HTMLElement.translate")}}
   - : 論理値で、翻訳を行うかどうかを表します。
+- {{DOMxRef("HTMLElement.virtualKeyboardPolicy")}} {{Experimental_Inline}}
+  - : 文字列で、タブレットやモバイル端末、その他ハードウェアキーボードが利用できない端末において、要素のコンテンツが編集可能な場合（例えば、{{htmlelement("input")}} 要素や {{htmlelement("textarea")}} 要素、[`contenteditable`](/ja/docs/Web/HTML/Global_attributes/contenteditable) 属性が設定されている要素）、画面に表示される仮想キーボードの動作を示します。
 
 ## インスタンスメソッド
 
-_親である {{DOMxRef("Element")}} からメソッドを継承しています。_
+_親である {{DOMxRef("Element")}} から継承したメソッドもあります。_
 
 - {{DOMxRef("HTMLElement.attachInternals()")}}
   - : {{DOMxRef("ElementInternals")}} オブジェクトを返し、カスタム要素を HTML フォームに参加できるようにします。
@@ -90,83 +96,60 @@ _親である {{DOMxRef("Element")}} からメソッドを継承しています
   - : 要素にマウスクリックイベントを送信します。
 - {{DOMxRef("HTMLElement.focus()")}}
   - : 要素に現在のキーボードフォーカスを当てます。
-- {{DOMxRef("HTMLElement.hidePopover()")}} {{Experimental_Inline}}
+- {{DOMxRef("HTMLElement.hidePopover()")}}
   - : ポップオーバー要素を{{glossary("top layer", "最上位レイヤー")}}から取り除き、`display: none` でスタイル設定することで、ポップオーバー要素を非表示にします。
-- {{DOMxRef("HTMLElement.showPopover()")}} {{Experimental_Inline}}
+- {{DOMxRef("HTMLElement.showPopover()")}}
   - : ポップオーバー要素を{{glossary("top layer", "最上位レイヤー")}}に追加し、`display: none;` スタイル設定を削除することで、ポップオーバー要素を表示します。
-- {{DOMxRef("HTMLElement.togglePopover()")}} {{Experimental_Inline}}
+- {{DOMxRef("HTMLElement.togglePopover()")}}
   - : ポップオーバー要素を非表示状態と表示状態を切り替えます。
 
 ## イベント
 
-これらのイベントを待ち受けするには `addEventListener()` を用いるか、イベントリスナーをこのインターフェイスの `onイベント名` プロパティに代入するかしてください。
+これらのイベントを待ち受けするには {{domxref("EventTarget.addEventListener", "addEventListener()")}} を用いるか、イベントリスナーをこのインターフェイスの `onイベント名` プロパティに代入するかしてください。
+
+_親である {{DOMxRef("Element")}} から継承したイベントもあります。_
+
+- {{DOMxRef("HTMLElement/cancel_event", "cancel")}}
+  - : {{HTMLElement("input")}} および {{HTMLElement("dialog")}} 要素で、ユーザーが現在開いているダイアログを <kbd>Esc</kbd> キーで閉じてキャンセルしたときに発行されます。
+- {{DOMxRef("HTMLElement/change_event", "change")}}
+  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素の `value` が変更され、ユーザーが確定したときに発行されます。{{domxref("Element/input_event", "input")}} イベントとは異なり、`change` イベントは要素の `value` が変更されるたびに発行されるわけではありません。
+- {{DOMxRef("HTMLElement/error_event", "error")}}
+  - : リソースの読み込みに失敗した、または使用することができない場合に発行されます。
+- {{DOMxRef("HTMLElement/load_event", "load")}}
+  - : リソースが正常に読み込まれたときに、リソースを保持する要素に対して発行されます。
 
-- {{DOMxRef("HTMLElement.copy_event", "copy")}}
+### クリップボードイベント
+
+- {{DOMxRef("HTMLElement/copy_event", "copy")}}
   - : ユーザーがブラウザーのユーザーインターフェイスを通じてコピー操作を開始したときに発生します。
-- {{DOMxRef("HTMLElement.cut_event", "cut")}}
+- {{DOMxRef("HTMLElement/cut_event", "cut")}}
   - : ユーザーがブラウザーのユーザーインターフェイスから切り取り操作を開始したときに発生します。
-- {{DOMxRef("HTMLElement.paste_event", "paste")}}
+- {{DOMxRef("HTMLElement/paste_event", "paste")}}
   - : ユーザーがブラウザーのユーザーインターフェイスを通じて貼り付け操作を開始したときに発生します。
-- {{domxref("HTMLInputElement/invalid_event", "invalid")}}
-  - : 制約の検証で、要素が制約を満たさなかった場合に発行されます。
-- {{DOMxRef("HTMLElement.beforetoggle", "beforetoggle")}}
-  - : 要素がポップオーバーの場合、非表示になる前、または表示される前に発行されます。
-- {{DOMxRef("HTMLElement.toggle", "toggle")}}
-  - : 要素がポップオーバーの場合、非表示になった後、または表示された後に発行されます。
-
-### アニメーションイベント
-
-- {{domxref("Element/animationcancel_event", "animationcancel")}}
-  - : アニメーションが予期せず中断されたときに発行されます。
-- {{domxref("Element/animationend_event", "animationend")}}
-  - : アニメーションが正常に完了したときに発行されます。
-- {{domxref("Element/animationiteration_event", "animationiteration")}}
-  - : アニメーションが 1 回分完了したときに発行されます。
-- {{domxref("Element/animationstart_event", "animationstart")}}
-  - : アニメーションが開始されたときに発行されます。
-
-### 入力イベント
-
-- {{domxref("HTMLElement/beforeinput_event", "beforeinput")}}
-  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素が変更される前に発行されます。
-- {{domxref("HTMLElement/input_event", "input")}}
-  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素の `value` が変更されたときに発行されます。
-- {{domxref("HTMLElement/change_event", "change")}}
-  - : {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}} のいずれかの要素の `value` が変更され、ユーザーが確定したときに発行されます。{{domxref("HTMLElement/input_event", "input")}} イベントとは異なり、`change` イベントは要素の `value` が変更されるたびに発行されるわけではありません。
-
-### ポインターイベント
-
-- {{domxref("Element/gotpointercapture_event", "gotpointercapture")}}
-  - : {{domxref("Element/setPointerCapture", "setPointerCapture()")}} を用いて要素がポインターをキャプチャしたときに発行されます。
-- {{domxref("Element/lostpointercapture_event", "lostpointercapture")}}
-  - : [キャプチャされたポインター](/ja/docs/Web/API/Pointer_events#pointer_capture)が解放されたときに発行されます。
-- {{domxref("Element/pointercancel_event", "pointercancel")}}
-  - : ポインターイベントがキャンセルされたときに発行されます。
-- {{domxref("Element/pointerdown_event", "pointerdown")}}
-  - : ポインターがアクティブになったときに発行されます。
-- {{domxref("Element/pointerenter_event", "pointerenter")}}
-  - : ポインターが要素またはその子孫の一つのヒットテスト境界に入ったときに発行されます。
-- {{domxref("Element/pointerleave_event", "pointerleave")}}
-  - : ポインターが要素のヒットテスト境界から出たときに発行されます。
-- {{domxref("Element/pointermove_event", "pointermove")}}
-  - : ポインターの座標が変化したときに発行されます。
-- {{domxref("Element/pointerout_event", "pointerout")}}
-  - : ポインターが要素の*ヒットテスト*境界を (他の理由で) 出たときに発行されます。
-- {{domxref("Element/pointerover_event", "pointerover")}}
-  - : ポインターが要素のヒットテスト境界に入ったときに発行されます。
-- {{domxref("Element/pointerup_event", "pointerup")}}
-  - : ポインターがアクティブではなくなったときに発行されます。
-
-### トランジションイベント
-
-- {{domxref("Element/transitioncancel_event", "transitioncancel")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)がキャンセルされたときに発行されます。
-- {{domxref("Element/transitionend_event", "transitionend")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が完了したときに発行されます。
-- {{domxref("Element/transitionrun_event", "transitionrun")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が最初に作成されたときに発行されます。
-- {{domxref("Element/transitionstart_event", "transitionstart")}}
-  - : [CSS トランジション](/ja/docs/Web/CSS/CSS_Transitions/Using_CSS_transitions)が実際に開始されたときに発行されます。
+
+### ドラッグ & ドロップイベント
+
+- {{DOMxRef("HTMLElement/drag_event", "drag")}}
+  - : このイベントは、要素やテキスト選択がドラッグされたときに発行されます。
+- {{DOMxRef("HTMLElement/dragend_event", "dragend")}}
+  - : このイベントは、ドラッグ操作が（マウスボタンを離すか、エスケープキーを押すかして）終わったときに発行されます。
+- {{DOMxRef("HTMLElement/dragenter_event", "dragenter")}}
+  - : このイベントは、ドラッグされた要素やテキスト選択が有効なドロップ対象に入ると発行されます。
+- {{DOMxRef("HTMLElement/dragleave_event", "dragleave")}}
+  - : このイベントは、ドラッグされた要素やテキスト選択が有効なドロップ対象から外れたときに発行されます。
+- {{DOMxRef("HTMLElement/dragover_event", "dragover")}}
+  - : このイベントは、要素またはテキスト選択がドラッグされ、マウスポインターが有効なドロップ対象の上にあるとき（マウスが移動していないときは 50 ミリ秒ごと、移動中およそ 5 ミリ秒（移動が遅いとき）から 1 ミリ秒（移動が速いとき）の間に発生します。この発行パターンは {{domxref("Element/mouseover_event", "mouseover")}} とは異なります。）
+- {{DOMxRef("HTMLElement/dragstart_event", "dragstart")}}
+  - : このイベントは、ユーザーが要素やテキスト選択のドラッグを始めるには発行されます。
+- {{DOMxRef("HTMLElement/drop_event", "drop")}}
+  - : このイベントは、要素またはテキスト選択が有効なドロップ対象にドロップされたときに発行されます。
+
+### ポップオーバーイベント
+
+- {{DOMxRef("HTMLElement/beforetoggle_event", "beforetoggle")}}
+  - : 要素がポップオーバー要素である場合、非表示または表示される前に発行されます。
+- {{DOMxRef("HTMLElement/toggle_event", "toggle")}}
+  - : 要素がポップオーバー要素の時、非表示または表示された直後に発行されます。
 
 ## 仕様書
 

From da6f09c9661456d33834ebe0d69d971e460b9dbf Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 13 Sep 2024 22:58:12 +0900
Subject: [PATCH 095/115] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/htmlelement/accesskey/index.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/files/ja/web/api/htmlelement/accesskey/index.md b/files/ja/web/api/htmlelement/accesskey/index.md
index 3b5b7059a65cd4..4a752956e6affc 100644
--- a/files/ja/web/api/htmlelement/accesskey/index.md
+++ b/files/ja/web/api/htmlelement/accesskey/index.md
@@ -1,8 +1,9 @@
 ---
 title: "HTMLElement: accessKey プロパティ"
+short-title: accessKey
 slug: Web/API/HTMLElement/accessKey
 l10n:
-  sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18
+  sourceCommit: e9e2ec643ac69c132f31427a0b586ab2cf83ed58
 ---
 
 {{APIRef("DOM")}}
@@ -11,6 +12,10 @@ l10n:
 
 > **メモ:** `HTMLElement.accessKey` プロパティは、ブラウザーにすでに存在するキーバインドとよく衝突するため、めったに使われることはありません。これを回避するために、ブラウザーは accesskey の動作を他の「修飾」キー（<kbd>Alt</kbd> + accesskey など）と一緒に押された場合に動作するよう実装しています。
 
+## 仕様書
+
+{{Specifications}}
+
 ## ブラウザーの互換性
 
 {{Compat}}

From 2df036bf83f821593da02bc524f7d0eb3206cf7c Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 13 Sep 2024 22:59:32 +0900
Subject: [PATCH 096/115] =?UTF-8?q?short-title=20=E3=82=92=E8=BF=BD?=
 =?UTF-8?q?=E5=8A=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/api/htmlelement/accesskeylabel/index.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/files/ja/web/api/htmlelement/accesskeylabel/index.md b/files/ja/web/api/htmlelement/accesskeylabel/index.md
index 4ffffcbc68865e..6dd6e3ac188d05 100644
--- a/files/ja/web/api/htmlelement/accesskeylabel/index.md
+++ b/files/ja/web/api/htmlelement/accesskeylabel/index.md
@@ -1,5 +1,6 @@
 ---
 title: "HTMLElement: accessKeyLabel プロパティ"
+short-title: accessKeyLabel
 slug: Web/API/HTMLElement/accessKeyLabel
 l10n:
   sourceCommit: a3d9f61a8990ba7b53bda9748d1f26a9e9810b18

From 1f2284eae409e5a8163759d1cf369b411a8fada3 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Fri, 13 Sep 2024 23:35:32 +0900
Subject: [PATCH 097/115] =?UTF-8?q?2024/06/27=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../api/htmlelement/anchorelement/index.md    | 75 +++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 files/ja/web/api/htmlelement/anchorelement/index.md

diff --git a/files/ja/web/api/htmlelement/anchorelement/index.md b/files/ja/web/api/htmlelement/anchorelement/index.md
new file mode 100644
index 00000000000000..4dc04fef2ce126
--- /dev/null
+++ b/files/ja/web/api/htmlelement/anchorelement/index.md
@@ -0,0 +1,75 @@
+---
+title: "HTMLElement: anchorElement プロパティ"
+short-title: anchorElement
+slug: Web/API/HTMLElement/anchorElement
+l10n:
+  sourceCommit: bba05bf24a714715f3517cf1296274dd41d6e811
+---
+
+{{APIRef("HTML DOM")}}{{Non-standard_Header}}{{SeeCompatTable}}
+
+**`anchorElement`** は {{domxref("HTMLElement")}} インターフェイスのプロパティで、この要素のアンカー要素への参照を返します。これは、HTML の [`anchor`](/ja/docs/Web/HTML/Global_attributes/anchor) 属性でアンカーに関連付けられた要素の場合にのみ動作し、CSS の {{cssxref("anchor-name")}} および {{cssxref("position-anchor")}} プロパティでアンカーに関連付けられた要素では動作しません。
+
+アンカーの機能と使用法の詳細情報については、[CSS アンカー位置指定](/ja/docs/Web/CSS/CSS_anchor_positioning)モジュールのランディングページと [CSS アンカー位置指定の使用](/ja/docs/Web/CSS/CSS_anchor_positioning/Using)のガイドを参照してください。
+
+## 値
+
+要素のアンカー要素を表す {{domxref("HTMLElement")}} インスタンス、またはアンカー要素を保有していない場合は `null` です。
+
+## 例
+
+### 基本的な使い方
+
+この例はHTMLで要素とアンカーを関連付け、JavaScript を使用してアンカー要素への参照を取得します。
+
+#### HTML
+
+HTML では、{{htmlelement("div")}} を作成し、[`id`](/ja/docs/Web/HTML/Global_attributes/id) を `example-anchor` にします。これがアンカー要素となります。次に、もう一つの `<div>` を作成し、クラスを `infobox` に、[`anchor`](/ja/docs/Web/HTML/Global_attributes/anchor) 属性を `example-anchor` に設定します。これにより、最初の `<div>` が 2 つ目の `<div>` のアンカーとして指定され、2 つが関連付けられます。
+
+また、結果を出力するために {{htmlelement("p")}} 要素を記載します。
+
+```html
+<div class="anchor" id="example-anchor">⚓︎</div>
+
+<div class="infobox" anchor="example-anchor">
+  <p>これは情報ボックスです。</p>
+</div>
+
+<p class="output"></p>
+```
+
+#### JavaScript
+
+JavaScript を使用して位置指定要素と出力要素の参照を取得し、位置指定要素の `anchorElement` プロパティに関連付けられた `id` の値を output に表示させ、アンカー要素が位置指定要素の `anchorElement` であることを示します。
+
+```js
+const posElem = document.querySelector(".infobox");
+const outputElem = document.querySelector(".output");
+
+try {
+  outputElem.textContent = `位置指定要素のアンカー要素は ${posElem.anchorElement.id} です。`;
+} catch (e) {
+  outputElem.textContent = `このブラウザーは anchorElement プロパティに対応していません。`;
+}
+```
+
+#### 結果
+
+結果は次のようになります。
+
+{{EmbedLiveSample("Basic usage", "100%", 110)}}
+
+## 仕様書
+
+この属性は現在 HTML の仕様書には属していません。`anchorElement` プロパティの追加に関する議論は [https://github.com/whatwg/html/pull/9144](https://github.com/whatwg/html/pull/9144) を参照してください。
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- HTML [`anchor`](/ja/docs/Web/HTML/Global_attributes/anchor) 属性
+- CSS {{cssxref("anchor-name")}} および {{cssxref("position-anchor")}} プロパティ
+- [CSS アンカー位置指定](/ja/docs/Web/CSS/CSS_anchor_positioning)モジュール
+- [CSS アンカー位置指定の使用](/ja/docs/Web/CSS/CSS_anchor_positioning/Using)のガイド

From 5b3f150483c1665ab578b88c327af2a9bb33f431 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Tue, 17 Sep 2024 16:23:33 +0900
Subject: [PATCH 098/115] =?UTF-8?q?2024/06/14=20=E6=99=82=E7=82=B9?=
 =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?=
 =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3=20(#23552)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 2024/06/14 時点の英語版に基づき新規翻訳

* Update files/ja/web/api/htmlelement/attributestylemap/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 .../htmlelement/attributestylemap/index.md    | 63 +++++++++++++++
 .../api/svgelement/attributestylemap/index.md | 77 +++++++++++++++++++
 2 files changed, 140 insertions(+)
 create mode 100644 files/ja/web/api/htmlelement/attributestylemap/index.md
 create mode 100644 files/ja/web/api/svgelement/attributestylemap/index.md

diff --git a/files/ja/web/api/htmlelement/attributestylemap/index.md b/files/ja/web/api/htmlelement/attributestylemap/index.md
new file mode 100644
index 00000000000000..17290aa75e72ef
--- /dev/null
+++ b/files/ja/web/api/htmlelement/attributestylemap/index.md
@@ -0,0 +1,63 @@
+---
+title: "HTMLElement: attributeStyleMap プロパティ"
+short-title: attributeStyleMap
+slug: Web/API/HTMLElement/attributeStyleMap
+l10n:
+  sourceCommit: bba05bf24a714715f3517cf1296274dd41d6e811
+---
+
+{{APIRef("CSSOM")}}
+
+**`attributeStyleMap`** は {{domxref("HTMLElement")}} インターフェイスの読み取り専用のプロパティで、生きた {{domxref("StylePropertyMap")}} を返します。これには、要素のインライン スタイル属性で定義されているか、スクリプト経由で {{domxref("HTMLElement")}} インターフェイスの {{domxref("HTMLElement.style", "style")}} プロパティを使用して割り当てられた、要素のスタイルプロパティのリストが入ります。
+
+一括指定プロパティは展開されます。`border-top: 1px solid black` を設定すると、代わりに個別指定プロパティ ({{cssxref("border-top-color")}}, {{cssxref("border-top-style")}}, {{cssxref("border-top-width")}}) が設定されます。
+
+{{domxref("HTMLElement.style", "style")}} プロパティと `attributeStyleMap` プロパティの主な違いは、`style` プロパティが {{domxref("CSSStyleDeclaration")}} オブジェクトを返すのに対し、`attributeStyleMap` プロパティは {{domxref("StylePropertyMap")}} オブジェクトを返すことです。
+
+このプロパティ自身は書き込みできませんが、`style` プロパティを通じて返す {{domxref("CSSStyleDeclaration")}} オブジェクトと同様に、このプロパティが返す {{domxref("StylePropertyMap")}} オブジェクトを通じてインラインスタイルを読み書きすることができます。
+
+## 値
+
+生きた {{domxref("StylePropertyMap")}} オブジェクトです。
+
+## 例
+
+次のコードは `style` 属性と `attributeStyleMap` プロパティの関係を示しています。
+
+```html
+<div style="white-space: pre-line;">
+  <div id="el" style="border-top: 1px solid blue; color: red;">要素の例</div>
+  <div id="output"></div>
+</div>
+```
+
+```css
+#el {
+  font-size: 16px;
+}
+```
+
+```js
+const element = document.getElementById("el");
+const output = document.getElementById("output");
+
+for (const property of element.attributeStyleMap) {
+  output.textContent += `${property[0]} = ${property[1][0].toString()}\n`;
+}
+```
+
+{{EmbedLiveSample("Examples", "200", "200")}}
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{domxref("HTMLElement.style")}}
+- {{domxref("SVGElement.attributeStyleMap")}}
+- {{domxref("MathMLElement.attributeStyleMap")}}
diff --git a/files/ja/web/api/svgelement/attributestylemap/index.md b/files/ja/web/api/svgelement/attributestylemap/index.md
new file mode 100644
index 00000000000000..21b3d89867ca4f
--- /dev/null
+++ b/files/ja/web/api/svgelement/attributestylemap/index.md
@@ -0,0 +1,77 @@
+---
+title: "SVGElement: attributeStyleMap プロパティ"
+short-title: attributeStyleMap
+slug: Web/API/SVGElement/attributeStyleMap
+l10n:
+  sourceCommit: bba05bf24a714715f3517cf1296274dd41d6e811
+---
+
+{{APIRef("CSSOM")}}
+
+**`attributeStyleMap`** は {{domxref("SVGElement")}} インターフェイスの読み取り専用のプロパティで、生きた {{domxref("StylePropertyMap")}} を返します。これには、要素のインライン スタイル属性で定義されているか、スクリプト経由で {{domxref("SVGElement")}} インターフェイスの {{domxref("SVGElement.style", "style")}} プロパティを使用して割り当てられた、要素のスタイルプロパティのリストが入ります。
+
+一括指定プロパティは展開されます。`border-top: 1px solid black` を設定すると、代わりに個別指定プロパティ ({{cssxref("border-top-color")}}, {{cssxref("border-top-style")}}, {{cssxref("border-top-width")}}) が設定されます。
+
+{{domxref("SVGElement.style", "style")}} プロパティと `attributeStyleMap` プロパティの主な違いは、`style` プロパティが {{domxref("CSSStyleDeclaration")}} オブジェクトを返すのに対し、`attributeStyleMap` プロパティは {{domxref("StylePropertyMap")}} オブジェクトを返すことです。
+
+このプロパティ自身は書き込みできませんが、`style` プロパティを通じて返す {{domxref("CSSStyleDeclaration")}} オブジェクトと同様に、このプロパティが返す {{domxref("StylePropertyMap")}} オブジェクトを通じてインラインスタイルを読み書きすることができます。
+
+## 値
+
+生きた {{domxref("StylePropertyMap")}} オブジェクトです。
+
+## 例
+
+次のコードは `style` 属性と `attributeStyleMap` プロパティの関係を示しています。
+
+```html
+<div style="white-space: pre-line;">
+  <svg
+    width="50"
+    height="50"
+    xmlns="http://www.w3.org/2000/svg"
+    viewBox="0 0 250 250"
+    width="250"
+    height="250"
+    style="white-space: pre-line;">
+    <circle
+      cx="100"
+      cy="100"
+      r="50"
+      id="el"
+      style="border-top: 1px solid blue; color: red;" />
+  </svg>
+  <div id="output"></div>
+</div>
+```
+
+```css
+#el {
+  font-size: 16px;
+}
+```
+
+```js
+const element = document.getElementById("el");
+const output = document.getElementById("output");
+
+for (const property of element.attributeStyleMap) {
+  output.textContent += `${property[0]} = ${property[1][0].toString()}\n`;
+}
+```
+
+{{EmbedLiveSample("Examples", "200", "200")}}
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{domxref("SVGElement.style")}}
+- {{domxref("HTMLElement.attributeStyleMap")}}
+- {{domxref("MathMLElement.attributeStyleMap")}}

From eeb5839c0bc0e4090d8f3109ab488a7bf81465d7 Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Tue, 17 Sep 2024 16:39:28 +0800
Subject: [PATCH 099/115] zh-CN: create `extensionTypes` (#23547)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../webextensions/api/extensiontypes/index.md | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/index.md

diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/index.md
new file mode 100644
index 00000000000000..6fcba089d9da55
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/index.md
@@ -0,0 +1,62 @@
+---
+title: extensionTypes
+slug: Mozilla/Add-ons/WebExtensions/API/extensionTypes
+l10n:
+  sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262
+---
+
+{{AddonSidebar}}
+
+一些常见的用于其他 WebExtension API 的类型。
+
+## 类型
+
+- {{WebExtAPIRef("extensionTypes.ImageDetails")}}
+  - : 图片的格式与质量的详情信息。
+- {{WebExtAPIRef("extensionTypes.ImageFormat")}}
+  - : 图片的格式。
+- {{WebExtAPIRef("extensionTypes.InjectDetails")}}
+  - : 向页面插入详情信息。
+- {{WebExtAPIRef("extensionTypes.RunAt")}}
+  - : 尽快将 JavaScript、CSS 插入到标签页中的时间点。
+- `extensionTypes.CSSOrigin`
+  - : 指示通过 [`tabs.insertCSS`](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS) 插入到页面中的 CSS 样式表是否应该被当作一个“作者”（“用户”）样式表。
+
+## 浏览器兼容性
+
+{{Compat}}
+
+{{WebExtExamples("h2")}}
+
+> [!NOTE]
+> 此 API 基于 Chromium 的 [`chrome.extensionTypes`](https://developer.chrome.com/docs/extensions/reference/api/extensionTypes) API。该文档衍生自 Chromium 代码中的 [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json)。
+
+<!--
+// Copyright 2015 The Chromium Authors. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+-->

From 1bf68bde46ddf7c683014cd368702f79850f52b5 Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Tue, 17 Sep 2024 20:26:15 +0800
Subject: [PATCH 100/115] zh-cn: update the translation of the 'tools and
 testing' (#23522)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
---
 files/zh-cn/learn/tools_and_testing/index.md | 26 ++++++++++++--------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/files/zh-cn/learn/tools_and_testing/index.md b/files/zh-cn/learn/tools_and_testing/index.md
index 3280e19dfbbfec..5eceee060852de 100644
--- a/files/zh-cn/learn/tools_and_testing/index.md
+++ b/files/zh-cn/learn/tools_and_testing/index.md
@@ -1,28 +1,34 @@
 ---
 title: 工具和测试
 slug: Learn/Tools_and_testing
+l10n:
+  sourceCommit: 11a08e7da75bfb0b3e606eb26a9a0ad9301a1be5
 ---
 
 {{LearnSidebar}}
 
-一旦你开始使用 web 的核心技术（如 HTML,CSS 和 Javascript）进行编程，并且开始获得更多的体验，读更多的资料，学习更多的提示和技巧，你就会遇到各种工具，从优化的 CSS 和 Javascript 到测试和自动化应用，再到其他更多的领域。当你的 web 项目变得更大更复杂，如果你希望利用一些工具为你的代码做出可靠的测试计划。本节教程旨在帮助你开始并做出明智的选择。
+一旦你开始熟悉使用核心 Web 技术（如 HTML、CSS 和 JavaScript）进行编程，并且开始获得更多经验，阅读更多资源，学习更多技巧和窍门，你就会开始接触到各种各样的工具，从 JavaScript 框架到测试和自动化工具，以及其他更多工具。随着你的 Web 项目变得更大更复杂，你将希望开始利用其中一些工具，构建一个可靠的工具链，为你的开发过程赋予超能力。
 
-web 行业是个让人兴奋的地方，但它也有并发症。现在我们用来构建网站的核心技术是相当稳定的，但是新的特性一直不断地加进来，还有建立在这些技术之上的能够方便我们工作的新的工具，都在不断出现。在此之前，我们仍然需要保持前台的跨浏览器支持，并且保证我们的代码遵循最佳实践以允许我们的项目可以工作在不同的浏览器和设备上，让我们的用户能够正常浏览我们的网页，还要保证对残障人士可用。
+除此之外，我们仍然需要将跨浏览器支持放在首要位置，并确保我们的代码遵循使我们的项目能够在用户用来浏览 Web 的不同浏览器和设备上运行并可供残障人士使用的最佳实践。
 
-找出你应该用什么样的工具是个困难的过程，所以我们这系列文章来告诉你哪些工具是可用的，它们能为你做什么，和如何利用行业的热门工具。
+确定你应该使用哪些工具可能是一个困难的过程，因此我们编写了这一系列文章，以告知你有哪些类型的工具可用，它们能为你做什么，以及如何利用当前行业中的热门工具。
 
 > [!NOTE]
-> 因为一直以来都是新的工具出现伴随着旧的工具过时，所以我们有意将材料写得尽可能地中立—我们想优先关注那些能够帮你完成通用类型任务的工具，而不是一些特殊工具。我们显然需要展示某些工具的用途来演示特殊的技术，但是要清楚我们并不是把它们作为最好的或者唯一的工具进行推荐—大多数情况下有很多其他的方式可以备选，我们只是想提供给你一个清晰的可用的方法。
+> 我们在本主题中引用了许多工具，并不是因为我们推荐它们或认为它们是最好的，而是因为我们知道它们有效并且有良好的行业支持。在大多数情况下，还有其他工具可用；旧的工具会过时，新的工具无疑会出现。
 
-## 学习途径
+## 前提
 
-尝试详细地使用这些工具之前，你首先应该学习 [HTML](/zh-CN/docs/Learn/HTML), [CSS](/zh-CN/docs/Learn/CSS)，和 [JavaScript](/zh-CN/docs/Learn/JavaScript) 的基础知识。比如，在你开始调试复杂 web 代码之前，你需要知道这些语言的基础知识，或者能有效地使用 Javascript 库，或者能够使用测试工具为你的代码编写和运行测试等等。
+在尝试使用这里详细介绍的许多工具之前，你真的应该首先学习核心 [HTML](/zh-CN/docs/Learn/HTML)、[CSS](/zh-CN/docs/Learn/CSS) 和 [JavaScript](/zh-CN/docs/Learn/JavaScript) 语言的基础知识。例如，在开始调试复杂的 Web 代码、有效使用 JavaScript 框架或使用测试运行器编写测试并针对你的代码运行测试之前，你需要了解这些语言的基础知识。
 
-首先你需要一个扎实的基础。
+此外，你应该从本主题的第一个模块开始，其提供了该领域的有用概述。
 
 ## 模块
 
-- 真实世界 web 开发工具 (TBD)
-  - : 在这个模块中，我们探索各种可用的 web 开发工具。这包括审查你不得不解决的最基本的任务，如何让它们在一个工作流中协调配合以及目前能够完成这些任务的最好的工具。
+- [理解客户端 Web 开发工具](/zh-CN/docs/Learn/Tools_and_testing/Understanding_client-side_tools)
+  - : 客户端工具可能令人望而生畏，但这一系列文章旨在说明一些最常见的客户端工具类型的用途，解释你可以将哪些工具链在一起，如何使用包管理器安装它们，以及如何使用命令行控制它们。我们最后提供了一个完整的展示如何提高生产力的工具链示例。
+- [理解客户端 JavaScript 框架](/zh-CN/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks)
+  - : JavaScript 框架是现代前端 Web 开发的重要组成部分，为开发人员提供了经过验证的用于构建可扩展、交互式的 Web 应用程序的工具。许多现代公司将框架作为其工具的标准部分，因此许多前端开发工作现在需要框架经验。这个模块为你提供了一些关于客户端框架如何工作以及它们如何适应你的工具集的基本背景知识，然后继续涵盖一些当今最流行的框架的教程系列。
+- [Git 和 GitHub](/zh-CN/docs/Learn/Tools_and_testing/GitHub)
+  - : 所有开发人员都会使用某种**版本控制系统**（**VCS**），这是一种允许他们在一个项目上与其他开发人员协作，而不会覆盖彼此的工作，并在发现问题后回滚到代码库的先前版本的工具。最流行的 VCS（至少在 Web 开发人员中）是 **Git**，以及 **GitHub**（一个为你的仓库提供托管和多种工具的网站）。这个模块旨在教你关于这两者的知识。
 - [跨浏览器测试](/zh-CN/docs/Learn/Tools_and_testing/Cross_browser_testing)
-  - : 这个模块在测试 web 项目跨不同浏览器的领域看起来很特别。我们要识别你的目标受众（比如，你最担心的是哪些用户、浏览器和设备？），如何做测试，主要的问题是你将面临不同类型的代码和如何修复它们，有什么有用的工具能够帮助你测试和修复问题，如何通过自动化来增加测试效率。
+  - : 这个模块专门研究跨不同浏览器测试 Web 项目的领域。在这里，我们看看如何识别你的目标受众（例如，你需要最担心哪些用户、浏览器和设备？），如何进行测试，不同类型的代码面临的主要问题以及如何修复/减轻这些问题，哪些工具在帮助你测试和解决问题方面最有用，以及如何使用自动化来加快测试速度。

From c18e72be31e62224e93003f0b7b816d106081a26 Mon Sep 17 00:00:00 2001
From: MikeCAT <mikecat@users.noreply.github.com>
Date: Mon, 16 Sep 2024 22:14:36 +0900
Subject: [PATCH 101/115] Translate GPUCanvasContext

---
 .../web/api/gpucanvascontext/canvas/index.md  | 36 +++++++++
 .../api/gpucanvascontext/configure/index.md   | 76 +++++++++++++++++++
 .../getcurrenttexture/index.md                | 71 +++++++++++++++++
 files/ja/web/api/gpucanvascontext/index.md    | 51 +++++++++++++
 .../api/gpucanvascontext/unconfigure/index.md | 52 +++++++++++++
 5 files changed, 286 insertions(+)
 create mode 100644 files/ja/web/api/gpucanvascontext/canvas/index.md
 create mode 100644 files/ja/web/api/gpucanvascontext/configure/index.md
 create mode 100644 files/ja/web/api/gpucanvascontext/getcurrenttexture/index.md
 create mode 100644 files/ja/web/api/gpucanvascontext/index.md
 create mode 100644 files/ja/web/api/gpucanvascontext/unconfigure/index.md

diff --git a/files/ja/web/api/gpucanvascontext/canvas/index.md b/files/ja/web/api/gpucanvascontext/canvas/index.md
new file mode 100644
index 00000000000000..dedcf806fb9b8c
--- /dev/null
+++ b/files/ja/web/api/gpucanvascontext/canvas/index.md
@@ -0,0 +1,36 @@
+---
+title: "GPUCanvasContext: canvas プロパティ"
+slug: Web/API/GPUCanvasContext/canvas
+l10n:
+  sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e
+---
+
+{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}}
+
+{{domxref("GPUCanvasContext")}} インターフェイスの読み取り専用プロパティ **`canvas`** は、このコンテキストの作成元であるキャンバスへの参照を返します。
+
+## 値
+
+{{domxref("HTMLCanvasElement")}} または {{domxref("OffscreenCanvas")}} オブジェクトのインスタンスです。
+
+## 例
+
+```js
+const canvas = document.querySelector("#gpuCanvas");
+const context = canvas.getContext("webgpu");
+
+// HTMLCanvasElement への参照を返す
+context.canvas;
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [WebGPU API](/ja/docs/Web/API/WebGPU_API)
diff --git a/files/ja/web/api/gpucanvascontext/configure/index.md b/files/ja/web/api/gpucanvascontext/configure/index.md
new file mode 100644
index 00000000000000..80b3f37d63587c
--- /dev/null
+++ b/files/ja/web/api/gpucanvascontext/configure/index.md
@@ -0,0 +1,76 @@
+---
+title: "GPUCanvasContext: configure() メソッド"
+slug: Web/API/GPUCanvasContext/configure
+l10n:
+  sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e
+---
+
+{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}}
+
+{{domxref("GPUCanvasContext")}} インターフェイスの **`configure()`** メソッドは、指定の {{domxref("GPUDevice")}} でレンダリングを行う用にコンテキストを設定します。このメソッドが呼ばれると、キャンバスはまず透明な黒に初期化されます。
+
+## 構文
+
+```js-nolint
+configure(configuration)
+```
+
+### 引数
+
+- `configuration`
+
+  - : 以下のプロパティを持つオブジェクトです。
+
+    - `alphaMode` {{optional_inline}}
+      - : {{domxref("GPUCanvasContext.getCurrentTexture()", "getCurrentTexture()")}} が返したテクスチャが読み取り・表示・画像ソースとしての使用をされるとき、アルファ値が持つ効果を指定する列挙値です。以下の値が使用可能です。
+        - `opaque`: アルファ値は無視されます。テクスチャが不透明ではない場合は、画像ソースとして使用されたり画面に表示される際にアルファチャンネルは 1.0 にクリアされます。これがデフォルト値です。
+        - `premultiplied`: 色の値はアルファ値を掛けた後の値です。たとえば、アルファ値 50% の 100% 赤は `[0.5, 0, 0, 0.5]` です。
+    - `colorSpace` {{optional_inline}}
+      - : `getCurrentTexture()` が返すテクスチャに書き込まれる値を表示する際に用いる色空間です。`srgb` (デフォルト) および `display-p3` が使用できます。
+    - `device`
+      - : このコンテキストで使用するレンダリング情報の取得元となる {{domxref("GPUDevice")}} です。
+    - `format`
+      - : `getCurrentTexture()` が返すテクスチャの形式です。`bgra8unorm`・`rgba8unorm`・`rgba16float` のいずれかの値をとれます。現在のシステムで最適なキャンバスのテクスチャ形式は、{{domxref("GPU.getPreferredCanvasFormat()")}} で取得できます。これを使用することが推奨されます。キャンバスコンテキストを設定する際に好ましい形式を使用しないと、プラットフォームによっては、テクスチャのコピーが増えるなど、オーバーヘッドが増加する可能性があります。
+    - `usage` {{optional_inline}}
+
+      - : `getCurrentTexture()` が返すテクスチャで許可する使用法を指定する{{glossary("Bitwise flags", "ビットフラグ")}}です。以下の値が使用可能です。
+
+        - `GPUTextureUsage.COPY_SRC`: テクスチャは、コピー操作のソースとして使用できます。たとえば、{{domxref("GPUCommandEncoder.copyTextureToBuffer()")}} を呼び出す際の引数 `source` で使用できます。
+        - `GPUTextureUsage.COPY_DST`: テクスチャは、コピー操作や書き込み操作のデスティネーションとして使用できます。たとえば、{{domxref("GPUCommandEncoder.copyTextureToTexture()")}} を呼び出す際の引数 `destination` で使用できます。
+        - `GPUTextureUsage.RENDER_ATTACHMENT`: テクスチャは、レンダーパスにおけるカラーアタッチメントとして使用できます。たとえば、{{domxref("GPUCommandEncoder.beginRenderPass()")}} を呼び出す際のカラーアタッチメントビューとして使用できます。`GPUTextureUsage.RENDER_ATTACHMENT` はデフォルトの `usage` ですが、他の値を明示的に設定した場合は自動で含まれないことに注意してください。この場合、自分で追加で含めなければなりません。
+        - `GPUTextureUsage.TEXTURE_BINDING`: テクスチャは、シェーダーでサンプルドテクスチャとして用いるためにバインドできます。たとえば、{{domxref("GPUDevice.createBindGroup()")}} を呼び出す際のバインドグループのエントリーで使用できます。
+        - `GPUTextureUsage.STORAGE_BINDING`: テクスチャは、シェーダーでストレージテクスチャとして用いるためにバインドできます。たとえば、{{domxref("GPUDevice.createBindGroup()")}} を呼び出す際のバインドグループのエントリーで使用できます。
+
+        `usage: GPUTextureUsage.COPY_SRC | GPUTextureUsage.RENDER_ATTACHMENT` のように、[ビット論理和演算子](/ja/docs/Web/JavaScript/Reference/Operators/Bitwise_OR)を用いて複数の可能な使用法を指定できます。
+
+    - `viewFormats` {{optional_inline}}
+      - : `getCurrentTexture()` が返すテクスチャから作成されるビューで使用可能な形式の配列です。指定可能なすべての値は、[Texture Formats](https://gpuweb.github.io/gpuweb/#texture-formats) を参照してください。
+
+### 返値
+
+なし (`undefined`)
+
+## 例
+
+```js
+const canvas = document.querySelector("#gpuCanvas");
+const context = canvas.getContext("webgpu");
+
+context.configure({
+  device: device,
+  format: navigator.gpu.getPreferredCanvasFormat(),
+  alphaMode: "premultiplied",
+});
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [WebGPU API](/ja/docs/Web/API/WebGPU_API)
diff --git a/files/ja/web/api/gpucanvascontext/getcurrenttexture/index.md b/files/ja/web/api/gpucanvascontext/getcurrenttexture/index.md
new file mode 100644
index 00000000000000..70548d2c389421
--- /dev/null
+++ b/files/ja/web/api/gpucanvascontext/getcurrenttexture/index.md
@@ -0,0 +1,71 @@
+---
+title: "GPUCanvasContext: getCurrentTexture() メソッド"
+slug: Web/API/GPUCanvasContext/getCurrentTexture
+l10n:
+  sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e
+---
+
+{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}}
+
+{{domxref("GPUCanvasContext")}} インターフェイスの **`getCurrentTexture()`** メソッドは、このキャンバスコンテキストによって文書に次に合成される {{domxref("GPUTexture")}} を返します。
+
+## 構文
+
+```js-nolint
+getCurrentTexture()
+```
+
+### 引数
+
+なし
+
+### 返値
+
+{{domxref("GPUTexture")}} オブジェクトのインスタンスです。
+
+### 例外
+
+- `InvalidStateError` {{domxref("DOMException")}}
+  - : 設定をする前 (すなわち、{{domxref("GPUCanvasContext.configure()")}} を呼び出す前) のキャンバスコンテキストで `getCurrentTexture()` が呼ばれたとき投げられます。
+
+## 例
+
+```js
+const canvas = document.querySelector("#gpuCanvas");
+const context = canvas.getContext("webgpu");
+
+context.configure({
+  device: device,
+  format: navigator.gpu.getPreferredCanvasFormat(),
+  alphaMode: "premultiplied",
+});
+
+//...
+// 後で
+const commandEncoder = device.createCommandEncoder();
+
+const renderPassDescriptor = {
+  colorAttachments: [
+    {
+      clearValue: [0, 0, 0, 1], // 不透明な黒
+      loadOp: "clear",
+      storeOp: "store",
+      view: context.getCurrentTexture().createView(),
+    },
+  ],
+};
+
+const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [WebGPU API](/ja/docs/Web/API/WebGPU_API)
diff --git a/files/ja/web/api/gpucanvascontext/index.md b/files/ja/web/api/gpucanvascontext/index.md
new file mode 100644
index 00000000000000..62daa40f869b51
--- /dev/null
+++ b/files/ja/web/api/gpucanvascontext/index.md
@@ -0,0 +1,51 @@
+---
+title: GPUCanvasContext
+slug: Web/API/GPUCanvasContext
+l10n:
+  sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e
+---
+
+{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}}
+
+{{domxref("WebGPU API", "WebGPU API", "", "nocode")}} の **`GPUCanvasContext`** インターフェイスは、`contextType` を `"webgpu"` にして呼び出した {{domxref("HTMLCanvasElement.getContext()")}} から返される、{{htmlelement("canvas")}} 要素の WebGPU レンダリングコンテキストを表します。
+
+{{InheritanceDiagram}}
+
+## インスタンスプロパティ
+
+- {{domxref("GPUCanvasContext.canvas", "canvas")}} {{Experimental_Inline}} {{ReadOnlyInline}}
+  - : このコンテキストの作成元であるキャンバスへの参照を返します。
+
+## インスタンスメソッド
+
+- {{domxref("GPUCanvasContext.configure", "configure()")}} {{Experimental_Inline}}
+  - : 指定の {{domxref("GPUDevice")}} でレンダリングを行う用にコンテキストを設定し、キャンバスを透明な黒に初期化します。
+- {{domxref("GPUCanvasContext.getCurrentTexture", "getCurrentTexture()")}} {{Experimental_Inline}}
+  - : このキャンバスコンテキストによって文書に次に合成される {{domxref("GPUTexture")}} を返します。
+- {{domxref("GPUCanvasContext.unconfigure", "unconfigure()")}} {{Experimental_Inline}}
+  - : これまでのコンテキスト設定をすべて消去し、キャンバスコンテキストが設定されていた間に作成されたテクスチャをすべて破棄します。
+
+## 例
+
+```js
+const canvas = document.querySelector("#gpuCanvas");
+const context = canvas.getContext("webgpu");
+
+context.configure({
+  device: device,
+  format: navigator.gpu.getPreferredCanvasFormat(),
+  alphaMode: "premultiplied",
+});
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [WebGPU API](/ja/docs/Web/API/WebGPU_API)
diff --git a/files/ja/web/api/gpucanvascontext/unconfigure/index.md b/files/ja/web/api/gpucanvascontext/unconfigure/index.md
new file mode 100644
index 00000000000000..80dbfc2083c293
--- /dev/null
+++ b/files/ja/web/api/gpucanvascontext/unconfigure/index.md
@@ -0,0 +1,52 @@
+---
+title: "GPUCanvasContext: unconfigure() メソッド"
+slug: Web/API/GPUCanvasContext/unconfigure
+l10n:
+  sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e
+---
+
+{{APIRef("WebGPU API")}}{{SeeCompatTable}}{{SecureContext_Header}}
+
+{{domxref("GPUCanvasContext")}} インターフェイスの **`unconfigure()`** メソッドは、これまでのコンテキスト設定をすべて消去し、キャンバスコンテキストが設定されていた間に {{domxref("GPUCanvasContext.getCurrentTexture", "getCurrentTexture()")}} から返されたテクスチャをすべて破棄します。
+
+## 構文
+
+```js-nolint
+unconfigure()
+```
+
+### 引数
+
+なし
+
+### 返値
+
+なし (`undefined`)
+
+## 例
+
+```js
+const canvas = document.querySelector("#gpuCanvas");
+const context = canvas.getContext("webgpu");
+
+context.configure({
+  device: device,
+  format: navigator.gpu.getPreferredCanvasFormat(),
+  alphaMode: "premultiplied",
+});
+
+// 後で
+context.unconfigure();
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [WebGPU API](/ja/docs/Web/API/WebGPU_API)

From 0a50d4f58adc9684a80ed5465d87022237c22ab5 Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Tue, 17 Sep 2024 22:37:10 +0800
Subject: [PATCH 102/115] zh-cn: update the translation of the 'javascript'
 (#23523)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
---
 files/zh-cn/learn/javascript/index.md | 60 +++++++++++++++++----------
 1 file changed, 38 insertions(+), 22 deletions(-)

diff --git a/files/zh-cn/learn/javascript/index.md b/files/zh-cn/learn/javascript/index.md
index 5be08ad26ba936..b5ff0304fe918a 100644
--- a/files/zh-cn/learn/javascript/index.md
+++ b/files/zh-cn/learn/javascript/index.md
@@ -1,47 +1,63 @@
 ---
-title: JavaScript
+title: JavaScript——动态客户端脚本语言
 slug: Learn/JavaScript
+l10n:
+  sourceCommit: 70f49e78d0f6830748fcaa490d98b4ae3e2da161
 ---
 
 {{LearnSidebar}}
 
-{{Glossary("JavaScript")}} 编程语言允许你在 Web 页面上实现复杂的功能。如果你看到一个网页不仅仅显示静态的信息，而是显示依时间更新的内容，或者交互式地图，或者 2D/3D 动画图像，或者滚动的视频播放器，等等——你基本可以确定，这需要 JavaScript 的参与。
+{{Glossary("JavaScript")}} 是一种允许你在网页上实现复杂功能的编程语言。每次网页不仅仅只是显示静态信息——而是显示及时的内容更新、交互式地图、2D/3D 动画图形、滚动的视频播放器，等等——你都可以打赌 JavaScript 可能参与其中。
 
-## 学习路线
+## 前提
 
-很多人认为，与相关技术如 [HTML](/zh-CN/docs/Learn/HTML) 和 [CSS](/zh-CN/docs/Learn/CSS) 相比，学习 JavaScript 更为困难。在尝试学习 JavaScript 之前，我们强烈建议你首先至少熟悉上述这两种技术，一些其他知识可能也会有帮助。你可以从以下模块开始学习之旅：
+JavaScript 可以说比相关技术（如 [HTML](/zh-CN/docs/Learn/HTML) 和 [CSS](/zh-CN/docs/Learn/CSS)）更难学习。在尝试学习 JavaScript 之前，强烈建议你首先至少熟悉这两种技术，甚至其他技术。请先学习以下模块：
 
-- [开始了解 Web](/zh-CN/docs/Learn/Getting_started_with_the_web)
-- [HTML 入门](/zh-CN/docs/Web/Guide/HTML/Introduction)
-- [CSS 入门](/zh-CN/docs/Learn/CSS/Introduction_to_CSS)
+- [Web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)
+- [HTML 简介](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
+- [CSS 第一步](/zh-CN/docs/Learn/CSS/First_steps)
 
-拥有其他编程语言的经验也许会有帮助。
+拥有其他编程语言的经验也可能会有所帮助。
 
-熟悉 JavaScript 的基本概念之后，你将具备学习更多高级主题的能力，比如这些：
+熟悉 JavaScript 的基础知识后，你应该能够学习更高级的主题，例如：
 
-- 深入理解 JavaScript，如 [JavaScript 指南](/zh-CN/docs/Web/JavaScript/Guide)中的内容
-- [Web APIs](/zh-CN/docs/Web/API)
+- 深入 JavaScript，如我们的 [JavaScript 指南](/zh-CN/docs/Web/JavaScript/Guide)所教授的
+- [Web API](/zh-CN/docs/Web/API)
 
 ## 模块
 
-本主题包含以下模块，我们建议你按照下列顺序阅读。
+> [!CALLOUT]
+>
+> **我们对现代 JavaScript 的政策**
+>
+> JavaScript 是一种不断发展的语言，多年来发生了很大变化。特别是在 2015 年引入的第 6 版（有时称为 ECMAScript 2015 或 ES6），增加了许多新特性。与此同时，为了保持与旧网站的向后兼容性，即使不再被认为是好的实践，语言的旧特性也被保留了下来。
+>
+> 我们认为，ECMAScript 2015 及后续版本中添加到 JavaScript 的特性使开发人员能够编写更易读、可靠和富有表现力的代码，因此了解它们很重要。
+>
+> 我们在这门课程中教授的是稳定的并且多年来一直受到所有主要浏览器支持的特性。
+
+本主题包含以下模块，建议按顺序学习。
 
 - [JavaScript 第一步](/zh-CN/docs/Learn/JavaScript/First_steps)
-  - : 作为 JavaScript 学习的第一个模块，在开始编写第一段代码之前，我们首先回答一些基础的问题，比如“JavaScript 是什么？”、“它的代码长什么样？”、以及“它能做什么？”。之后我们会详细讨论一些 JavaScript 的关键功能，比如变量、字符串、数字、数组等。
-- [构建 JavaScript 代码块](/zh-CN/docs/Learn/JavaScript/Building_blocks)
-  - : 在这个模块中，我们继续介绍 JavaScript 的关键的基础功能，并逐渐将注意力转移到常见类型的代码块，比如条件语句、循环、函数、以及事件等。你应该已经遇到过这些概念，而这里我们将正式学习。
-- [JavaScript 对象初识](/zh-CN/docs/Learn/JavaScript/Objects)
-  - : 在 JavaScript 中，绝大多数东西都是对象；从作为 JavaScript 核心功能的字符串和数组，到建立在 JavaScript 之上的浏览器 API，无一不是对象。你甚至可以自己创建对象，将相关的函数和变量封装打包。想要进一步学习 JavaScript 语言知识、写出高效的代码的话，理解这种面向对象的特性是必不可少的。这个模块将帮助你了解“对象”，我们将详细介绍对象的设计思想和语法、如何创建对象，并解释 JSON 数据是什么、如何使用。
+  - : 在第一个 JavaScript 模块中，我们首先回答一些基本问题，例如“什么是 JavaScript？”、“它看起来是什么样的？”和“它能做什么？”，然后带你体验第一次实际编写 JavaScript。之后，我们将详细讨论一些关键的 JavaScript 特性，如变量、字符串、数字和数组。
+- [创建 JavaScript 代码块](/zh-CN/docs/Learn/JavaScript/Building_blocks)
+  - : 在这个模块中，我们将继续涵盖所有 JavaScript 的关键基础特性，重点关注常见的代码块类型，如条件语句、循环、函数和事件。你已经在课程中看到了这些内容，但只是顺便提及——在这里我们将明确讨论它们。
+- [介绍 JavaScript 对象](/zh-CN/docs/Learn/JavaScript/Objects)
+  - : 在 JavaScript 中，大多数东西都是对象，从 JavaScript 核心特性（如字符串和数组）到构建在 JavaScript 之上的浏览器 API。你甚至可以创建自己的对象，将相关的函数和变量封装起来。如果你想进一步提高对语言的了解并编写更高效的代码，理解 JavaScript 的面向对象特性非常重要，因此我们提供了这个模块来帮助你。在这里，我们将详细教授对象理论和语法，看看如何创建你自己的对象，并解释 JSON 数据是什么以及如何使用它。
 - [异步 JavaScript](/zh-CN/docs/Learn/JavaScript/Asynchronous)
-  - : 这个模块介绍异步 JavaScript：为什么重要，如何用它来处理 可能引起阻塞的操作（比如从服务器获取资源）
+  - : 在这个模块中，我们将了解异步 JavaScript，为什么它很重要，以及如何使用它有效地处理潜在的阻塞操作（如从服务器获取资源）。
 - [客户端 Web API](/zh-CN/docs/Learn/JavaScript/Client-side_web_APIs)
-  - : 为网站或应用编写客户端 JavaScript 脚本时，你很难不用到 Web API 接口。这些接口允许你一定程度上操纵网页所运行在的浏览器和操作系统、甚至来自其他网站和服务的数据。在这个模块中，我们将了解有哪些 API，并学习使用开发过程中最常见的 API。
+  - : 在为网站或应用程序编写客户端 JavaScript 时，你很快就会开始使用 API——用于操作浏览器和操作系统不同方面的接口，或者甚至是从其他网站或服务获取数据。在这个模块中，我们将探讨 API 是什么，以及如何使用一些你经常遇到的常见 API。
 
 ## 解决常见的 JavaScript 问题
 
-[解决常见的 JavaScript 问题](/zh-CN/docs/Learn/JavaScript/Howto) 提供一些链接，解释如何使用 JavaScript 来解决创建网页时非常常见的问题。
+[解决 JavaScript 代码中常见的问题](/zh-CN/docs/Learn/JavaScript/Howto)提供了一些帮助你避免常见的 JavaScript 编程错误的建议，并提供了许多有用的展示如何解决常见的 JavaScript 编程问题的链接。
 
 ## 参见
 
-- [Coding math](https://www.youtube.com/user/codingmath)
-  - : 由 [Keith Peters](https://twitter.com/bit101) 制作的一个优秀的视频教程系列，向你传授高效编程所需的必备技能。
+- [MDN 上的 JavaScript](/zh-CN/docs/Web/JavaScript)
+  - : 这是 MDN 上核心 JavaScript 文档的主要入口——在这里你将找到关于 JavaScript 语言所有方面的广泛参考文档，以及一些针对有经验的 JavaScript 开发人员的高级教程。
+- [学习 JavaScript](https://learnjavascript.online/)
+  - : 非常适合有抱负的 Web 开发人员的优秀资源——在交互式环境中通过自动评估引导的短课程和交互式测试学习 JavaScript。前 40 节课是免费的。
+- [编码数学](https://www.youtube.com/user/codingmath)
+  - : 一个由 [Keith Peters](https://www.bit-101.com/2017/about-me/) 创建的优秀的视频教程系列，教你成为高效的程序员所需的数学知识。

From cf1a2a2672a320313888007efc9db17d9db2cf2e Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Tue, 17 Sep 2024 22:41:03 +0800
Subject: [PATCH 103/115] zh-cn: update the translation of the 'MathML'
 (#23521)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 files/zh-cn/learn/mathml/index.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/files/zh-cn/learn/mathml/index.md b/files/zh-cn/learn/mathml/index.md
index e1c0559e3270c0..a7d6d12a2de163 100644
--- a/files/zh-cn/learn/mathml/index.md
+++ b/files/zh-cn/learn/mathml/index.md
@@ -1,6 +1,8 @@
 ---
 title: 使用 MathML 编写数学公式
 slug: Learn/MathML
+l10n:
+  sourceCommit: 865acb22b74a49927b98267566369d4677414f53
 ---
 
 {{LearnSidebar}}
@@ -16,13 +18,13 @@ slug: Learn/MathML
 
 - [Web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)
 - [HTML 简介](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
-- [CSS 入门](/zh-CN/docs/Learn/CSS/First_steps)
+- [CSS 第一步](/zh-CN/docs/Learn/CSS/First_steps)
 
 尽管所需的概念将根据需要进行解释，但对数学符号和 [TeX](https://zh.wikipedia.org/wiki/TeX) 渲染规则有一定的了解可能会对你有帮助。
 
 ## 模块
 
-- [MathML 入门](/zh-CN/docs/Learn/MathML/First_steps)
+- [MathML 第一步](/zh-CN/docs/Learn/MathML/First_steps)
   - : MathML 是用于在网页中编写数学公式的标记语言。该模块将以比较轻松的方式开始你的 MathML 掌握之旅，介绍其工作原理、语法以及如何在 HTML 中开始使用它。
 
 ## 参见

From dfa3197386a38309fda32d2bff029069f2fb2d28 Mon Sep 17 00:00:00 2001
From: A1lo <yin199909@aliyun.com>
Date: Wed, 18 Sep 2024 08:25:42 +0800
Subject: [PATCH 104/115] chore(zh-cn): add language tags for fenced codes 
 (part 4) (#23300)

---
 files/zh-cn/.markdownlint.jsonc               | 21 ++++++
 files/zh-cn/web/api/mediaquerylist/index.md   | 19 -----
 files/zh-cn/web/api/node/index.md             |  6 --
 files/zh-cn/web/api/uievent/which/index.md    |  8 +-
 .../web/css/-webkit-touch-callout/index.md    | 12 +--
 files/zh-cn/web/css/_colon_target/index.md    |  2 +-
 files/zh-cn/web/css/_colon_where/index.md     | 14 ++--
 .../web/css/_doublecolon_backdrop/index.md    |  6 +-
 files/zh-cn/web/css/_doublecolon_cue/index.md |  6 +-
 .../web/css/_doublecolon_selection/index.md   |  9 +--
 files/zh-cn/web/css/attr/index.md             | 13 +++-
 .../web/css/background-blend-mode/index.md    | 21 ++++--
 .../zh-cn/web/css/background-origin/index.md  | 35 +++++----
 .../web/css/background-position/index.md      |  6 +-
 .../web/css/border-image-outset/index.md      | 38 ++++++----
 .../web/css/border-image-repeat/index.md      | 41 +++++++----
 files/zh-cn/web/css/clear/index.md            |  8 +-
 files/zh-cn/web/css/clip/index.md             | 30 +++++---
 .../css/color-interpolation-method/index.md   |  4 +-
 files/zh-cn/web/css/content/index.md          | 73 +++++++++++++------
 files/zh-cn/web/css/counter/index.md          | 18 ++---
 .../using_css_counters/index.md               |  4 +-
 .../using_media_queries/index.md              |  2 +-
 .../stacking_context/index.md                 | 40 ++++++----
 files/zh-cn/web/css/cursor/index.md           |  2 +-
 files/zh-cn/web/css/element/index.md          |  2 +-
 .../css/filter-function/drop-shadow/index.md  | 24 +++++-
 files/zh-cn/web/css/hex-color/index.md        |  2 +-
 .../web/css/hue-interpolation-method/index.md |  2 +-
 .../zh-cn/web/css/image-orientation/index.md  | 32 ++++----
 files/zh-cn/web/css/image/index.md            | 29 +++++---
 files/zh-cn/web/css/mix-blend-mode/index.md   | 12 ++-
 files/zh-cn/web/css/outline/index.md          | 40 ++++++----
 files/zh-cn/web/css/time/index.md             |  2 +-
 .../css/transform-function/matrix3d/index.md  |  4 +-
 .../transform-function/perspective/index.md   |  6 +-
 .../css/transform-function/rotate/index.md    |  2 +-
 .../css/transform-function/rotate3d/index.md  |  2 +-
 .../css/transform-function/rotatex/index.md   |  2 +-
 .../css/transform-function/rotatey/index.md   |  2 +-
 .../css/transform-function/rotatez/index.md   |  2 +-
 .../web/css/transform-function/skew/index.md  |  2 +-
 files/zh-cn/web/css/word-break/index.md       | 11 ++-
 files/zh-cn/web/http/caching/index.md         |  4 +-
 .../corsalloworiginnotmatchingorigin/index.md |  4 +-
 .../errors/corsmissingalloworigin/index.md    |  8 +-
 files/zh-cn/web/http/headers/cookie/index.md  |  4 +-
 .../zh-cn/web/http/headers/expect-ct/index.md |  4 +-
 files/zh-cn/web/http/headers/origin/index.md  |  2 +-
 .../permissions-policy/camera/index.md        |  4 +-
 files/zh-cn/web/http/status/404/index.md      |  4 +-
 .../guide/indexed_collections/index.md        |  2 +-
 .../guide/loops_and_iteration/index.md        |  2 +-
 .../deprecated_and_obsolete_features/index.md |  2 +-
 .../errors/not_a_valid_code_point/index.md    |  2 +-
 .../object/constructor/index.md               |  2 +-
 .../global_objects/regexp/exec/index.md       |  2 +-
 .../reference/iteration_protocols/index.md    |  2 +-
 files/zh-cn/web/uri/schemes/data/index.md     |  2 +-
 59 files changed, 405 insertions(+), 261 deletions(-)

diff --git a/files/zh-cn/.markdownlint.jsonc b/files/zh-cn/.markdownlint.jsonc
index cb48f009c18eba..6ef149968c88f4 100644
--- a/files/zh-cn/.markdownlint.jsonc
+++ b/files/zh-cn/.markdownlint.jsonc
@@ -3,6 +3,7 @@
   "no-trailing-punctuation": {
     "punctuation": ".,;:。，",
   },
+  "fenced-code-language": true,
   "search-replace": {
     "rules": [
       {
@@ -73,6 +74,26 @@
         "searchPattern": "/您/g",
         "searchScope": "text",
       },
+      {
+        "name": "text-code-fence",
+        "message": "Use 'plain' tag",
+        "searchPattern": "/(^ *`{3,})(text|none|unix)/gm",
+        "replace": "$1plain",
+        "searchScope": "text",
+      },
+      {
+        "name": "gfm-alert",
+        "message": "Use the GFM syntax: https://developer.mozilla.org/zh-CN/docs/MDN/Writing_guidelines/Howto/Markdown_in_MDN#备注、警告和标注",
+        "searchPattern": "/^ *> \\*\\*(Note|Warning|Callout):\\*\\*(?! [[{`_*])/gm",
+        "searchScope": "text",
+      },
+      {
+        "name": "bad-gfm-alert",
+        "message": "Use the correct GFM syntax: `> [!NOTE]`",
+        // TODO this should use the modifier syntax; until it has better Node support
+        "searchPattern": "/^ *> !?\\[!?((?!NOTE)[Nn][Oo][Tt][Ee]|(?!WARNING)[Ww][Aa][Rr][Nn][Ii][Nn][Gg]|(?!CALLOUT)[Cc][Aa][Ll][Ll][Oo][Uu][Tt])\\]\\n|^ *> (?!\\[!)!?\\[!?(NOTE|WARNING|CALLOUT)\\]\\n/gm",
+        "searchScope": "text",
+      },
     ],
   },
 }
diff --git a/files/zh-cn/web/api/mediaquerylist/index.md b/files/zh-cn/web/api/mediaquerylist/index.md
index 58d6416be5841b..56229f85642473 100644
--- a/files/zh-cn/web/api/mediaquerylist/index.md
+++ b/files/zh-cn/web/api/mediaquerylist/index.md
@@ -9,13 +9,6 @@ slug: Web/API/MediaQueryList
 
 如果你需要以编程方式来检测一个 document 上的媒体查询的值的变化，这个 `MediaQueryList` 对象使得通过观察其 document 而检测它的媒体查询的值的变化成为可能，而不是周期性地对这些媒体查询的值进行检查。
 
-## 方法概述
-
-```
-void addListener(MediaQueryListListener listener);
-void removeListener(MediaQueryListListener listener);
-```
-
 ## 实例属性
 
 _`MediaQueryList` 接口从它的父接口 {{DOMxRef("EventTarget")}} 继承了属性。_
@@ -31,12 +24,6 @@ _`MediaQueryList` 接口从它的父接口 {{DOMxRef("EventTarget")}} 继承了
 
 在媒体查询列表上增加一个新的监听器，如果列表中已经存在了这个指定的监听器，这个方法将失去作用。
 
-```
-void addListener(
-  MediaQueryListListener listener
-);
-```
-
 #### 参数 ( 针对 addListener 方法)
 
 - `listener`
@@ -46,12 +33,6 @@ void addListener(
 
 从媒体查询列表中移除一个监听器，如果列表中不存在这个指定的监听器，则这个方法将失去作用。
 
-```
-void removeListener(
-  MediaQueryListListener listener
-);
-```
-
 #### 参数 (针对 removeListener 方法)
 
 - `listener`
diff --git a/files/zh-cn/web/api/node/index.md b/files/zh-cn/web/api/node/index.md
index 54bbf394d102b2..956f114e8a6e2a 100644
--- a/files/zh-cn/web/api/node/index.md
+++ b/files/zh-cn/web/api/node/index.md
@@ -182,12 +182,6 @@ function eachNode(rootNode, callback) {
 }
 ```
 
-#### 语法
-
-```
-eachNode(rootNode, callback);
-```
-
 #### 描述
 
 使用递归的方式对 `rootNode` 的所有后代节点执行回调函数（包括 `rootNode` 自身）
diff --git a/files/zh-cn/web/api/uievent/which/index.md b/files/zh-cn/web/api/uievent/which/index.md
index 50395809cd8078..492969a520ded6 100644
--- a/files/zh-cn/web/api/uievent/which/index.md
+++ b/files/zh-cn/web/api/uievent/which/index.md
@@ -7,13 +7,7 @@ slug: Web/API/UIEvent/which
 
 {{domxref("KeyboardEvent")}} 接口的 **`which`** 只读属性返回所按下键的数字 `keyCode` 或所按下字母数字键的字符代码 (`charCode`) 。
 
-## 语法
-
-```
-var keyResult = event.which;
-```
-
-### 返回值
+## 值
 
 - `keyResult` contains the numeric code for a particular key pressed, depending on whether an alphanumeric or non-alphanumeric key was pressed. Please see {{domxref("KeyboardEvent.charCode")}} and {{domxref("KeyboardEvent.keyCode")}} for more details.
 
diff --git a/files/zh-cn/web/css/-webkit-touch-callout/index.md b/files/zh-cn/web/css/-webkit-touch-callout/index.md
index c1565508e3de90..29ac876d2f0f89 100644
--- a/files/zh-cn/web/css/-webkit-touch-callout/index.md
+++ b/files/zh-cn/web/css/-webkit-touch-callout/index.md
@@ -13,16 +13,16 @@ slug: Web/CSS/-webkit-touch-callout
 
 ## 语法
 
-```
-Formal syntax: default | none
-```
-
 ```css
--webkit-touch-callout: default; /* displays the callout */
--webkit-touch-callout: none; /* disables the callout */
+/* 关键字值 */
+-webkit-touch-callout: default;
+-webkit-touch-callout: none;
 
+/* 全局值 */
 -webkit-touch-callout: initial;
 -webkit-touch-callout: inherit;
+-webkit-touch-callout: revert;
+-webkit-touch-callout: revert-layer;
 -webkit-touch-callout: unset;
 ```
 
diff --git a/files/zh-cn/web/css/_colon_target/index.md b/files/zh-cn/web/css/_colon_target/index.md
index 79b3a0d5dd1f7f..c5cb03ece4a580 100644
--- a/files/zh-cn/web/css/_colon_target/index.md
+++ b/files/zh-cn/web/css/_colon_target/index.md
@@ -16,7 +16,7 @@ slug: Web/CSS/:target
 
 例如，以下 URL 具有一个片段（由 # 符号表示），指向名为 `section2` 的元素：
 
-```
+```url
 http://www.example.com/index.html#section2
 ```
 
diff --git a/files/zh-cn/web/css/_colon_where/index.md b/files/zh-cn/web/css/_colon_where/index.md
index 3a1d63517a956d..f7d4951a3e97a1 100644
--- a/files/zh-cn/web/css/_colon_where/index.md
+++ b/files/zh-cn/web/css/_colon_where/index.md
@@ -26,6 +26,14 @@ footer p:hover {
 
 `:where()` 和 {{CSSxRef(":is", ":is()")}} 的不同之处在于，`:where()` 的[优先级](/zh-CN/docs/Web/CSS/Specificity)总是为 0，但是 `:is()` 的优先级是由它的选择器列表中优先级最高的[选择器](/zh-CN/docs/Glossary/CSS_Selector)决定的。
 
+## 语法
+
+```css-nolint
+:where(<complex-selector-list>) {
+  /* ... */
+}
+```
+
 ### 可容错选择器解析
 
 规范将 `:is()` 和 `:where()` 定义为接受一个[可容错选择器列表](https://drafts.csswg.org/selectors-4/#typedef-forgiving-selector-list)。
@@ -143,12 +151,6 @@ footer a {
 
 {{EmbedLiveSample('示例', '100%', 600)}}
 
-## 语法
-
-```
-:where( <complex-selector-list> )
-```
-
 ## 规范
 
 {{Specifications}}
diff --git a/files/zh-cn/web/css/_doublecolon_backdrop/index.md b/files/zh-cn/web/css/_doublecolon_backdrop/index.md
index e28d1c9d9a79da..9108da5cf1b992 100644
--- a/files/zh-cn/web/css/_doublecolon_backdrop/index.md
+++ b/files/zh-cn/web/css/_doublecolon_backdrop/index.md
@@ -20,8 +20,10 @@ dialog::backdrop {
 
 ## 语法
 
-```
-::backdrop
+```css
+::backdrop {
+  /* ... */
+}
 ```
 
 ## 示例
diff --git a/files/zh-cn/web/css/_doublecolon_cue/index.md b/files/zh-cn/web/css/_doublecolon_cue/index.md
index 19c2873ab6f4c0..d9848efe9cbb1c 100644
--- a/files/zh-cn/web/css/_doublecolon_cue/index.md
+++ b/files/zh-cn/web/css/_doublecolon_cue/index.md
@@ -26,8 +26,10 @@ slug: Web/CSS/::cue
 
 ## 语法
 
-```
-::cue | ::cue( <selector> )
+```css-nolint
+::cue | ::cue(<selector>) {
+  /* ... */
+}
 ```
 
 ## 示例
diff --git a/files/zh-cn/web/css/_doublecolon_selection/index.md b/files/zh-cn/web/css/_doublecolon_selection/index.md
index f2b32e411f6b5b..2a7303899e6081 100644
--- a/files/zh-cn/web/css/_doublecolon_selection/index.md
+++ b/files/zh-cn/web/css/_doublecolon_selection/index.md
@@ -31,11 +31,10 @@ slug: Web/CSS/::selection
 
 ## 语法
 
-```
-/* Legacy Firefox syntax (version 61 and below) */
-::-moz-selection
-
-{{CSSSyntax}}
+```css
+::selection {
+  /* ... */
+}
 ```
 
 ## 示例
diff --git a/files/zh-cn/web/css/attr/index.md b/files/zh-cn/web/css/attr/index.md
index 58d61216bef0bb..9257cdcb5801ae 100644
--- a/files/zh-cn/web/css/attr/index.md
+++ b/files/zh-cn/web/css/attr/index.md
@@ -17,8 +17,17 @@ CSS 表达式 `attr()` 用来获取选择到的元素的某一 HTML 属性值，
 
 ## 语法
 
-```
-语法：attr( attribute-name <type-or-unit>? [, <fallback> ]? )
+```css
+/* 关键字值 */
+-webkit-touch-callout: default;
+-webkit-touch-callout: none;
+
+/* 全局值 */
+-webkit-touch-callout: initial;
+-webkit-touch-callout: inherit;
+-webkit-touch-callout: revert;
+-webkit-touch-callout: revert-layer;
+-webkit-touch-callout: unset;
 ```
 
 ### 解释
diff --git a/files/zh-cn/web/css/background-blend-mode/index.md b/files/zh-cn/web/css/background-blend-mode/index.md
index 066ac355cbc7dc..55a2bf6c3b1a06 100644
--- a/files/zh-cn/web/css/background-blend-mode/index.md
+++ b/files/zh-cn/web/css/background-blend-mode/index.md
@@ -15,19 +15,18 @@ slug: Web/CSS/background-blend-mode
 
 ## 语法
 
-```
-Formal syntax:  {{csssyntax("background-blend-mode")}}
-```
-
-```
+```css
 /* 单值 */
 background-blend-mode: normal;
 
-/* 双值，每个背景一个值 */
+/* 双值，一个值对应一个背景 */
 background-blend-mode: darken, luminosity;
 
-background-blend-mode: initial;
+/* 全局值 */
 background-blend-mode: inherit;
+background-blend-mode: initial;
+background-blend-mode: revert;
+background-blend-mode: revert-layer;
 background-blend-mode: unset;
 ```
 
@@ -36,6 +35,14 @@ background-blend-mode: unset;
 - {{cssxref("&lt;blend-mode&gt;")}}
   - : 一个定义混合的模式，可以有多个值，用逗号间隔。
 
+## 形式定义
+
+{{cssinfo}}
+
+## 形式语法
+
+{{csssyntax}}
+
 ## 示例
 
 ```html hidden
diff --git a/files/zh-cn/web/css/background-origin/index.md b/files/zh-cn/web/css/background-origin/index.md
index dde1de731b09d5..80edbbd1e18061 100644
--- a/files/zh-cn/web/css/background-origin/index.md
+++ b/files/zh-cn/web/css/background-origin/index.md
@@ -14,20 +14,20 @@ slug: Web/CSS/background-origin
 > [!NOTE]
 > 假如{{cssxref("background")}}简写中没有设置该值，那么在 background 简写值后指定 background-origin，那么后面的值就会覆盖简写值，其实说白了，就是后出现的值会覆盖前面的值。
 
-{{cssinfo}}
-
 ## 语法
 
-```
-Formal syntax: {{csssyntax("background-origin")}}
-```
-
-```
-background-origin: border-box
-background-origin: padding-box
-background-origin: content-box
-
-background-origin: inherit
+```css
+/* 关键字值 */
+background-origin: border-box;
+background-origin: padding-box;
+background-origin: content-box;
+
+/* 全局值 */
+background-origin: inherit;
+background-origin: initial;
+background-origin: revert;
+background-origin: revert-layer;
+background-origin: unset;
 ```
 
 ### 属性值
@@ -39,12 +39,15 @@ background-origin: inherit
 - `content-box`
   - : 背景图片的摆放以 content 区域为参考
 
-### 形式化语法
+## 形式语法
+
+{{cssinfo}}
+
+## 形式定义
 
-[How to read CSS syntax.](/zh-CN/docs/Web/CSS/Value_definition_syntax)
-{{csssyntax("background-origin")}}
+{{csssyntax}}
 
-## 例子
+## 示例
 
 ```css
 .example {
diff --git a/files/zh-cn/web/css/background-position/index.md b/files/zh-cn/web/css/background-position/index.md
index 4e3a127c8f50d7..96f78e5b3e3990 100644
--- a/files/zh-cn/web/css/background-position/index.md
+++ b/files/zh-cn/web/css/background-position/index.md
@@ -84,20 +84,20 @@ background-position: unset;
 
 基本上发生的情况是从相应的容器尺寸中*减去*背景图像尺寸，然后将结果值的百分比用作从左（或顶部）边界的直接偏移量。
 
-```
+```plain
 (container width - image width) * (position x%) = (x offset value)
 (container height - image height) * (position y%) = (y offset value)
 ```
 
 以 X 轴为例，假设我们有一个 300px 宽的图像，我们在一个 100px 宽的容器中使用它，`background-size` 设置为 `auto`：
 
-```
+```plain
 100px - 300px = -200px (container & image difference)
 ```
 
 因此，位置百分比为 -25%、0%、50%、100%、125%，我们得到这些图像到容器边界偏移值：
 
-```
+```plain
 -200px * -25% = 50px
 -200px * 0% = 0px
 -200px * 50% = -100px
diff --git a/files/zh-cn/web/css/border-image-outset/index.md b/files/zh-cn/web/css/border-image-outset/index.md
index b148d0fbfcc705..8e28dca7620e77 100644
--- a/files/zh-cn/web/css/border-image-outset/index.md
+++ b/files/zh-cn/web/css/border-image-outset/index.md
@@ -9,28 +9,30 @@ slug: Web/CSS/border-image-outset
 
 `border-image-outset` 属性定义边框图像可超出边框盒的大小。
 
-{{cssinfo}}
-
 ## 语法
 
-```
-Formal syntax: {{csssyntax("border-image-outset")}}
-```
+```css
+/* <length> 值 */
+border-image-outset: 1rem;
 
-```
-/* border-image-outset: sides */
-border-image-outset: 30%;
+/* <number> 值 */
+border-image-outset: 1.5;
 
-/* border-image-outset:垂直 水平 */
-border-image-outset: 10% 30%;
+/* 上、下 | 左、右 */
+border-image-outset: 1 1.2;
 
-/* border-image-outset: 顶 水平 底 */
-border-image-outset: 30px 30% 45px;
+/* 上 | 左、右 | 下 */
+border-image-outset: 30px 2 45px;
 
-/* border-image-outset:顶 右 底 左  */
+/* 上 | 右 | 下 | 左 */
 border-image-outset: 7px 12px 14px 5px;
 
-border-image-repeat: inherit;
+/* 全局值值 */
+border-image-outset: inherit;
+border-image-outset: initial;
+border-image-outset: revert;
+border-image-outset: revert-layer;
+border-image-outset: unset;
 ```
 
 ### 值
@@ -52,6 +54,14 @@ border-image-repeat: inherit;
 - `inherit`
   - : 四个方向的值都继承于父元素的该属性计算后值。
 
+## 形式定义
+
+{{CSSInfo}}
+
+## 形式语法
+
+{{csssyntax}}
+
 ## 规范
 
 {{Specifications}}
diff --git a/files/zh-cn/web/css/border-image-repeat/index.md b/files/zh-cn/web/css/border-image-repeat/index.md
index 4a90f193cfa7e5..d8e753384ffe79 100644
--- a/files/zh-cn/web/css/border-image-repeat/index.md
+++ b/files/zh-cn/web/css/border-image-repeat/index.md
@@ -7,22 +7,27 @@ slug: Web/CSS/border-image-repeat
 
 `border-image-repeat` 定义图片如何填充边框。或为单个值，设置所有的边框；或为两个值，分别设置水平与垂直的边框。
 
-{{cssinfo}}
+## 语法
 
-## Syntax
+```css
+/* 关键字值 */
+border-image-repeat: stretch;
+border-image-repeat: repeat;
+border-image-repeat: round;
+border-image-repeat: space;
 
-```
-Formal syntax: {{csssyntax("border-image-repeat")}}
-```
-
-```
-border-image-repeat: type                      /* One-value syntax */       E.g. border-image-value: stretch;
-border-image-repeat: horizontal vertical       /* Two-value syntax */       E.g. border-image-width: round space;
+/* 上、下 | 左、右 */
+border-image-repeat: round stretch;
 
-border-image-repeat: inherit
+/* 全局值 */
+border-image-repeat: inherit;
+border-image-repeat: initial;
+border-image-repeat: revert;
+border-image-repeat: revert-layer;
+border-image-repeat: unset;
 ```
 
-### Values
+### 值
 
 - _type_
   - : `stretch`, `repeat`, `round`, `space` 选一。属于单个值的情况。
@@ -41,14 +46,22 @@ border-image-repeat: inherit
 - `inherit`
   - : 继承父级元素的计算值。
 
-## Examples
+## 形式定义
+
+{{CSSInfo}}
+
+## 形式语法
+
+{{csssyntax}}
+
+## 示例
 
 不同的取值，查看 {{cssxref("border-image")}} 的示例。
 
-## Specifications
+## 规范
 
 {{Specifications}}
 
-## Browser compatibility
+## 浏览器兼容性
 
 {{Compat}}
diff --git a/files/zh-cn/web/css/clear/index.md b/files/zh-cn/web/css/clear/index.md
index 33a593cb61469d..525febe434d436 100644
--- a/files/zh-cn/web/css/clear/index.md
+++ b/files/zh-cn/web/css/clear/index.md
@@ -28,8 +28,8 @@ slug: Web/CSS/clear
 
 ## 语法
 
-```
-/* Keyword values */
+```css
+/* 关键字值 */
 clear: none;
 clear: left;
 clear: right;
@@ -37,9 +37,11 @@ clear: both;
 clear: inline-start;
 clear: inline-end;
 
-/* Global values */
+/* 全局值 */
 clear: inherit;
 clear: initial;
+clear: revert;
+clear: revert-layer;
 clear: unset;
 ```
 
diff --git a/files/zh-cn/web/css/clip/index.md b/files/zh-cn/web/css/clip/index.md
index 3f0d23b0c58692..6d061e4b7c9d5a 100644
--- a/files/zh-cn/web/css/clip/index.md
+++ b/files/zh-cn/web/css/clip/index.md
@@ -12,17 +12,21 @@ slug: Web/CSS/clip
 > [!WARNING]
 > 这个属性已被废弃。建议使用 {{cssxref("clip-path")}} 。
 
-{{cssinfo}}
-
 ## 语法
 
-[形式语法](/zh-CN/docs/CSS/Value_definition_syntax): {{csssyntax("clip")}}
-
-```
-clip: rect(1px, 10em, 3rem, 2ch)
-clip: auto
-
-clip: inherit
+```css
+/* 关键字值 */
+clip: auto;
+
+/* <shape> 值 */
+clip: rect(1px, 10em, 3rem, 2ch);
+
+/* 全局值 */
+clip: inherit;
+clip: initial;
+clip: revert;
+clip: revert-layer;
+clip: unset;
 ```
 
 ### 值
@@ -47,6 +51,14 @@ clip: inherit
 - `auto`
   - : 元素不裁剪 (默认值)
 
+## 形式定义
+
+{{cssinfo}}
+
+## 形式语法
+
+{{csssyntax}}
+
 ## 示例
 
 ### 裁剪图像
diff --git a/files/zh-cn/web/css/color-interpolation-method/index.md b/files/zh-cn/web/css/color-interpolation-method/index.md
index 110efeb50f138b..a4efad8c1093d8 100644
--- a/files/zh-cn/web/css/color-interpolation-method/index.md
+++ b/files/zh-cn/web/css/color-interpolation-method/index.md
@@ -13,9 +13,9 @@ slug: Web/CSS/color-interpolation-method
 
 `<color-interpolation-method>` 指定了插值应使用直角坐标颜色空间还是带可选色相插值方法的极坐标颜色空间：
 
-```
+```plain
 in <rectangular-color-space>
-/* 或者 */
+// 或者
 in <polar-color-space>[ <hue-interpolation method>]
 ```
 
diff --git a/files/zh-cn/web/css/content/index.md b/files/zh-cn/web/css/content/index.md
index 2056bdd29ef42a..c3236a92026edd 100644
--- a/files/zh-cn/web/css/content/index.md
+++ b/files/zh-cn/web/css/content/index.md
@@ -9,30 +9,51 @@ slug: Web/CSS/content
 
 CSS 的 `content` CSS 属性用于在元素的 {{ cssxref("::before") }} 和 {{ cssxref("::after") }} 伪元素中插入内容。使用 `content` 属性插入的内容都是匿名的[_可替换元素_](/zh-CN/docs/Web/CSS/Replaced_element)。
 
-{{cssinfo}}
-
 ## 语法
 
-```
-Formal syntax: {{csssyntax("content")}}
-```
-
-```
-content: normal                                /* Keywords that cannot be combined with other values */
-content: none
-
-content: 'prefix'                              /* <string> value, non-latin characters must be encoded e.g. \00A0 for &nbsp; */
-content: url(http://www.example.com/test.html) /* <uri> value */
-content: chapter_counter                       /* <counter> values */
-content: attr(value string)                    /* attr() value linked to the HTML attribute value */
-content: open-quote                            /* Language- and position-dependant keywords */
-content: close-quote
-content: no-open-quote
-content: no-close-quote
-
-content: open-quote chapter_counter            /* Except for normal and none, several values can be used simultaneously */
-
-content: inherit
+```css
+/* 不能与其他值组合的关键字 */
+content: normal;
+content: none;
+
+/* <content-replacement>：<image> 值 */
+content: url("http://www.example.com/test.png");
+content: linear-gradient(#e66465, #9198e5);
+content: image-set("image1x.png" 1x, "image2x.png" 2x);
+
+/* 语音输出：“/”后为替代文本  */
+content: url("../img/test.png") / "这是替代文本";
+
+/* <string> 值 */
+content: "unparsed text";
+
+/* <counter> 值，后跟可选的 <list-style-type> */
+content: counter(chapter_counter);
+content: counter(chapter_counter, upper-roman);
+content: counters(section_counter, ".");
+content: counters(section_counter, ".", decimal-leading-zero);
+
+/* attr() 值会链接到 HTML 属性值 */
+content: attr(href);
+
+/* <quote> 值 */
+content: open-quote;
+content: close-quote;
+content: no-open-quote;
+content: no-close-quote;
+
+/* <content-list>：content 值的列表。
+可以同时使用多个值 */
+content: "prefix" url(http://www.example.com/test.png);
+content: "prefix" url("/img/test.png") "suffix" / "Alt text";
+content: open-quote counter(chapter_counter);
+
+/* 全局值 */
+content: inherit;
+content: initial;
+content: revert;
+content: revert-layer;
+content: unset;
 ```
 
 ### 值
@@ -54,6 +75,14 @@ content: inherit
 - `no-open-quote` | `no-close-quote`
   - : 不会生产任何内容，但是会改变（增加或降低）引号层级。
 
+## 形式定义
+
+{{cssinfo}}
+
+## 形式语法
+
+{{csssyntax}}
+
 ## 示例
 
 ### 标题和引号
diff --git a/files/zh-cn/web/css/counter/index.md b/files/zh-cn/web/css/counter/index.md
index 6b704b83d6a19a..09dd26a8c5abfe 100644
--- a/files/zh-cn/web/css/counter/index.md
+++ b/files/zh-cn/web/css/counter/index.md
@@ -23,6 +23,14 @@ counter(countername, upper-roman)
 
 ## 语法
 
+```css
+/* 简单的用法 */
+counter(countername);
+
+/* 改变计数器的显示 */
+counter(countername, upper-roman)
+```
+
 ### 值
 
 - `<custom-ident> 自定义标识`
@@ -32,15 +40,7 @@ counter(countername, upper-roman)
 
 ### 形式语法
 
-```
-counter( <custom-ident>, <counter-style>? )
-
-where
-<counter-style> = <counter-style-name> | symbols()
-
-where
-<counter-style-name> = <custom-ident>
-```
+{{CSSSyntax}}
 
 ## 示例
 
diff --git a/files/zh-cn/web/css/css_counter_styles/using_css_counters/index.md b/files/zh-cn/web/css/css_counter_styles/using_css_counters/index.md
index 088b9cc26214a2..2060c240df8264 100644
--- a/files/zh-cn/web/css/css_counter_styles/using_css_counters/index.md
+++ b/files/zh-cn/web/css/css_counter_styles/using_css_counters/index.md
@@ -58,7 +58,7 @@ h3::before {
 
 当不需要包含父级上下文的编号，而仅需要嵌套内容的编号时，应使用 {{cssxref("counter", "counter()")}} 函数。例如，以下示例的每一个嵌套内容的计数都从 1 开始：
 
-```
+```plain
 1 One
   1 Nested one
   2 Nested two
@@ -71,7 +71,7 @@ h3::before {
 
 当需要同时包含父级上下文和嵌套内容的编号时，应使用 {{cssxref("counters", "counters()")}} 函数。例如，以下示例的每一个嵌套内容会包含父级编号：
 
-```
+```plain
 1 One
   1.1 Nested one
   1.2 Nested two
diff --git a/files/zh-cn/web/css/css_media_queries/using_media_queries/index.md b/files/zh-cn/web/css/css_media_queries/using_media_queries/index.md
index 60fdf894ba7a05..bcddd2bcdc6f40 100644
--- a/files/zh-cn/web/css/css_media_queries/using_media_queries/index.md
+++ b/files/zh-cn/web/css/css_media_queries/using_media_queries/index.md
@@ -12,7 +12,7 @@ slug: Web/CSS/CSS_media_queries/Using_media_queries
 - 有条件的通过 {{cssxref("@media")}} 和 {{cssxref("@import")}} [at-rules](/zh-CN/docs/Web/CSS/At-rule) 用[CSS](/zh-CN/docs/Web/CSS) 装饰样式。
 - 用 `media=` 属性为{{HTMLElement("style")}}, {{HTMLElement("link")}}, {{HTMLElement("source")}}和其他[HTML](/zh-CN/docs/Web/HTML)元素指定特定的媒体类型。如：
 
-```
+```html
 <link rel="stylesheet" src="styles.css" media="screen" />
 <link rel="stylesheet" src="styles.css" media="print" />
 ```
diff --git a/files/zh-cn/web/css/css_positioned_layout/understanding_z-index/stacking_context/index.md b/files/zh-cn/web/css/css_positioned_layout/understanding_z-index/stacking_context/index.md
index c899641808b7de..c6f227380db29a 100644
--- a/files/zh-cn/web/css/css_positioned_layout/understanding_z-index/stacking_context/index.md
+++ b/files/zh-cn/web/css/css_positioned_layout/understanding_z-index/stacking_context/index.md
@@ -84,40 +84,52 @@ slug: Web/CSS/CSS_positioned_layout/Understanding_z-index/Stacking_context
 
 ### HTML
 
-```
+```html
 <div id="div1">
   <h1>Division Element #1</h1>
-  <code>position: relative;<br/>
-  z-index: 5;</code>
+  <code
+    >position: relative;<br />
+    z-index: 5;</code
+  >
 </div>
 
 <div id="div2">
   <h1>Division Element #2</h1>
-  <code>position: relative;<br/>
-  z-index: 2;</code>
+  <code
+    >position: relative;<br />
+    z-index: 2;</code
+  >
 </div>
 
 <div id="div3">
   <div id="div4">
     <h1>Division Element #4</h1>
-    <code>position: relative;<br/>
-    z-index: 6;</code>
+    <code
+      >position: relative;<br />
+      z-index: 6;</code
+    >
   </div>
 
   <h1>Division Element #3</h1>
-  <code>position: absolute;<br/>
-  z-index: 4;</code>
+  <code
+    >position: absolute;<br />
+    z-index: 4;</code
+  >
 
   <div id="div5">
     <h1>Division Element #5</h1>
-    <code>position: relative;<br/>
-    z-index: 1;</code>
+    <code
+      >position: relative;<br />
+      z-index: 1;</code
+    >
   </div>
 
   <div id="div6">
     <h1>Division Element #6</h1>
-    <code>position: absolute;<br/>
-    z-index: 3;</code>
+    <code
+      >position: absolute;<br />
+      z-index: 3;</code
+    >
   </div>
 </div>
 ```
@@ -195,7 +207,7 @@ h1 {
 }
 ```
 
-### Result
+### 结果
 
 {{EmbedLiveSample('示例源码', '100%', '396') }}
 
diff --git a/files/zh-cn/web/css/cursor/index.md b/files/zh-cn/web/css/cursor/index.md
index 403311433166c0..e80d53d337401b 100644
--- a/files/zh-cn/web/css/cursor/index.md
+++ b/files/zh-cn/web/css/cursor/index.md
@@ -315,7 +315,7 @@ cursor:
 
 ## 示例
 
-```
+```css
 .foo {
   cursor: crosshair;
 }
diff --git a/files/zh-cn/web/css/element/index.md b/files/zh-cn/web/css/element/index.md
index 35834668dba06c..01a72d3522b93c 100644
--- a/files/zh-cn/web/css/element/index.md
+++ b/files/zh-cn/web/css/element/index.md
@@ -13,7 +13,7 @@ slug: Web/CSS/element
 
 ## 语法
 
-```
+```css
 element(id)
 ```
 
diff --git a/files/zh-cn/web/css/filter-function/drop-shadow/index.md b/files/zh-cn/web/css/filter-function/drop-shadow/index.md
index 4bed18910567e5..33de1a3e9214d7 100644
--- a/files/zh-cn/web/css/filter-function/drop-shadow/index.md
+++ b/files/zh-cn/web/css/filter-function/drop-shadow/index.md
@@ -14,10 +14,28 @@ The **`drop-shadow()`** [CSS](/zh-CN/docs/Web/CSS) function applies a drop shado
 > [!NOTE]
 > 这个函数有点类似于 {{Cssxref("box-shadow")}} 属性。`box-shadow` 属性在元素的整个框后面创建一个矩形阴影，而 `drop-shadow()` 过滤器则是创建一个符合图像本身形状 (alpha 通道) 的阴影。
 
-## Syntax
+## 语法
 
-```
-drop-shadow(offset-x offset-y blur-radius spread-radius color)
+```css
+/* 双长度值 */
+/* drop-shadow( <length> <length> ) */
+drop-shadow(5px 5px)
+
+/* 三长度值 */
+/* drop-shadow( <length> <length> <length> ) */
+drop-shadow(5px 5px 15px)
+
+/* 双长度值加一个颜色值 */
+/* drop-shadow( <length> <length> <color> ) */
+drop-shadow(5px 5px red)
+
+/* 三长度值加一个颜色值 */
+/* drop-shadow( <length> <length> <length> <color> ) */
+drop-shadow(5px 5px 15px red)
+
+/* 可以改变颜色和长度值的顺序 */
+/* drop-shadow( <color> <length> <length> <length> ) */
+drop-shadow(#e23 0.5rem 0.5rem 1rem)
 ```
 
 The `drop-shadow()` function accepts a parameter of type `<shadow>` (defined in the {{cssxref("box-shadow")}} property), with the exception that the `inset` keyword is not allowed.
diff --git a/files/zh-cn/web/css/hex-color/index.md b/files/zh-cn/web/css/hex-color/index.md
index 70e32a90ada0d9..678b21acf8b779 100644
--- a/files/zh-cn/web/css/hex-color/index.md
+++ b/files/zh-cn/web/css/hex-color/index.md
@@ -11,7 +11,7 @@ slug: Web/CSS/hex-color
 
 ## 语法
 
-```
+```plain
 #RGB        // 三值语法
 #RGBA       // 四值语法
 #RRGGBB     // 六值语法
diff --git a/files/zh-cn/web/css/hue-interpolation-method/index.md b/files/zh-cn/web/css/hue-interpolation-method/index.md
index db60244877be39..a29882b461d3bd 100644
--- a/files/zh-cn/web/css/hue-interpolation-method/index.md
+++ b/files/zh-cn/web/css/hue-interpolation-method/index.md
@@ -13,7 +13,7 @@ slug: Web/CSS/hue-interpolation-method
 
 `<hue-interpolation-method>` 值由色相插值算法的名称后接字面标记 `hue` 所构成：
 
-```
+```plain
 shorter hue
 longer hue
 increasing hue
diff --git a/files/zh-cn/web/css/image-orientation/index.md b/files/zh-cn/web/css/image-orientation/index.md
index 3e577b8c0897c6..e4f0305a8dcc62 100644
--- a/files/zh-cn/web/css/image-orientation/index.md
+++ b/files/zh-cn/web/css/image-orientation/index.md
@@ -16,19 +16,17 @@ CSS 属性 **`image-orientation`** 用来修正某些图片的预设方向。
 
 ## 语法
 
-```
-语法形式: {{csssyntax("image-orientation")}}
-```
-
-```
-image-orientation: 0deg
-image-orientation: 6.4deg     /* 非 90 度的整数倍，所以会被四舍五入到 0 度 */
-image-orientation: -90deg     /* 相当于 270deg */
-image-orientation: from-image /* 使用图片的 EXIF 数据 */
-image-orientation: 90deg flip /* 旋转 90deg, 再水平翻转 */
-image-orientation: flip       /* 不旋转，只进行水平翻转 */
-
-image-orientation: inherit
+```css
+/* 关键字值 */
+image-orientation: none;
+image-orientation: from-image; /* 使用图片的 EXIF 数据 */
+
+/* 全局值 */
+image-orientation: inherit;
+image-orientation: initial;
+image-orientation: revert;
+image-orientation: revert-layer;
+image-orientation: unset;
 ```
 
 ### 属性值
@@ -40,6 +38,14 @@ image-orientation: inherit
 - `flip`
   - : 对图片进行水平翻转，先进行第二个参数执行的旋转，再进行此次翻转。
 
+## 形式语法
+
+{{cssinfo}}
+
+## 形式定义
+
+{{csssyntax}}
+
 ## 示例
 
 ## 规范
diff --git a/files/zh-cn/web/css/image/index.md b/files/zh-cn/web/css/image/index.md
index da3899336e15e7..fc871d4539b658 100644
--- a/files/zh-cn/web/css/image/index.md
+++ b/files/zh-cn/web/css/image/index.md
@@ -47,19 +47,30 @@ CSS 确定一个图像对象实际尺寸的依据有三条：(1) 图像的原始
 
 以下是有效的图像引用值：
 
-```css
-url(test.jpg)                          url() 方法，只要 test.jpg 是图像文件
-linear-gradient(to bottom, blue, red)  一个 <gradient>标签
-element(#colonne3)                     页面的一部分，使用了 element() 方法，
-                                       如果 colonne3 是存在于页面中的一个元素 id 即可
+```css example-good
+url(test.jpg)               /* <url> 值，只要 test.jpg 是实际的图像 */
+linear-gradient(blue, red)  /* <gradient> 值 */
+element(#realid)            /* 网页中的一部分，如果“realid”是页面上现有的元素，
+                               则会被 element() 函数所引用 */
+image(ltr 'arrow.png#xywh=0,0,16,16', red)
+                            /* <url> 中的一个 16x16 的部分，从原始图像的左上角开始（只要
+                               arrow.png 是受支持的图像，否则为纯红色的方块）。如果语言为从
+                               右到左的（rtl），则图像将水平翻转。 */
+cross-fade(20% url(twenty.png), url(eighty.png))
+                            /* 半透明叠加的图像，其中 twenty 的不透明度为 20%，
+                               而 eighty 的不透明度为 80%。 */
+image-set('test.jpg' 1x, 'test-2x.jpg' 2x)
+                            /* 一系列具有不同分辨率的图像 */
 ```
 
 以下是无效的图像引用值：
 
-```
-cervin.jpg                             图像文件必须使用 url() 方法定义
-url(report.pdf)                        url() 方法指向的文件链接必须是一个图像文件
-element(#fakeid)                       如果 fakeid 是一个不存在与页面的元素 id
+```css example-bad
+nourl.jpg            /* 图像文件必须使用 url() 函数定义。 */
+url(report.pdf)      /* url() 函数指向的文件链接必须是一个图像。 */
+element(#fakeid)     /* 元素 ID 必须是当前页面中存在的 ID。 */
+image(z.jpg#xy=0,0)  /* 块片段的格式必须为 xywh=#,#,#,# */
+image-set('cat.jpg' 1x, 'dog.jpg' 1x) /* 图像集中的每个图像必须具有不同的分辨率 */
 ```
 
 ## 规范
diff --git a/files/zh-cn/web/css/mix-blend-mode/index.md b/files/zh-cn/web/css/mix-blend-mode/index.md
index 23325463c36ca7..691913f9580fc9 100644
--- a/files/zh-cn/web/css/mix-blend-mode/index.md
+++ b/files/zh-cn/web/css/mix-blend-mode/index.md
@@ -11,14 +11,15 @@ slug: Web/CSS/mix-blend-mode
 
 ## 语法
 
-```
+```css
+/* 关键字值 */
 mix-blend-mode: normal;
 mix-blend-mode: multiply;
 mix-blend-mode: screen;
 mix-blend-mode: overlay;
 mix-blend-mode: darken;
 mix-blend-mode: lighten;
-mix-blend-mode: color-dodge
+mix-blend-mode: color-dodge;
 mix-blend-mode: color-burn;
 mix-blend-mode: hard-light;
 mix-blend-mode: soft-light;
@@ -28,9 +29,14 @@ mix-blend-mode: hue;
 mix-blend-mode: saturation;
 mix-blend-mode: color;
 mix-blend-mode: luminosity;
+mix-blend-mode: plus-darker;
+mix-blend-mode: plus-lighter;
 
-mix-blend-mode: initial;
+/* 全局值 */
 mix-blend-mode: inherit;
+mix-blend-mode: initial;
+mix-blend-mode: revert;
+mix-blend-mode: revert-layer;
 mix-blend-mode: unset;
 ```
 
diff --git a/files/zh-cn/web/css/outline/index.md b/files/zh-cn/web/css/outline/index.md
index 245a1ff46cb269..155945bb6dfbfe 100644
--- a/files/zh-cn/web/css/outline/index.md
+++ b/files/zh-cn/web/css/outline/index.md
@@ -20,22 +20,24 @@ slug: Web/CSS/outline
 
 ## 语法
 
-```
+```css
 /* 样式 */
 outline: solid;
 
-/* 颜色 | 样式 */
-outline: #f66 dashed;
+/* 样式 | 颜色 */
+outline: dashed #f66;
 
-/* 样式 | 宽度 */
-outline: inset thick;
+/* 宽度 | 样式 */
+outline: thick inset;
 
-/* 颜色 | 样式 | 宽度 */
-outline: green solid 3px;
+/* 宽度 | 样式 | 颜色 */
+outline: 3px solid green;
 
 /* 全局值 */
 outline: inherit;
 outline: initial;
+outline: revert;
+outline: revert-layer;
 outline: unset;
 ```
 
@@ -53,21 +55,27 @@ outline: unset;
 - `<'outline-width'>`
   - : 设置轮廓的宽度。没有设置时默认值为 `medium`。参见 {{cssxref("outline-width")}}。
 
-### 形式语法
+## 形式定义
+
+{{cssinfo}}
 
-{{csssyntax("outline")}}
+## 形式语法
+
+{{csssyntax}}
 
 ## 示例
 
-### HTML
+### 使用 outline 设置焦点样式
 
-```
-<a href="#">This link has a special focus style.</a>
+#### HTML
+
+```html
+<a href="#">该链接具有特殊的焦点样式。</a>
 ```
 
 ### CSS
 
-```
+```css
 a {
   border: 1px solid;
   border-radius: 3px;
@@ -83,7 +91,9 @@ a:focus {
 }
 ```
 
-### 结果
+#### 结果
+
+{{EmbedLiveSample("使用 outline 设置焦点样式", "100%", 85)}}
 
 ## 无障碍考虑
 
@@ -96,8 +106,6 @@ a:focus {
 
 {{Specifications}}
 
-{{cssinfo}}
-
 ## 浏览器兼容性
 
 {{Compat}}
diff --git a/files/zh-cn/web/css/time/index.md b/files/zh-cn/web/css/time/index.md
index e82e088b86dc5d..dcd2869e973b25 100644
--- a/files/zh-cn/web/css/time/index.md
+++ b/files/zh-cn/web/css/time/index.md
@@ -28,7 +28,7 @@ slug: Web/CSS/time
 
 ### 有效时间
 
-```
+```plain example-good
 12s         正整数
 -456ms      负整数
 4.3ms       非整数
diff --git a/files/zh-cn/web/css/transform-function/matrix3d/index.md b/files/zh-cn/web/css/transform-function/matrix3d/index.md
index db6cbccc9bf87f..c43451f5e44cde 100644
--- a/files/zh-cn/web/css/transform-function/matrix3d/index.md
+++ b/files/zh-cn/web/css/transform-function/matrix3d/index.md
@@ -11,11 +11,11 @@ slug: Web/CSS/transform-function/matrix3d
 
 `matrix3d()` 函数由 16 个参数指定。这些参数以列为主的顺序进行描述。
 
-```
+```css
 matrix3d(a1, b1, c1, d1, a2, b2, c2, d2, a3, b3, c3, d3, a4, b4, c4, d4)
 ```
 
-### Values
+### 值
 
 - _a1_ _b1_ _c1_ _d1_ _a2_ _b2_ _c2_ _d2_ _a3_ _b3_ _c3_ _d3_
   - : Are {{cssxref("&lt;number&gt;")}}s describing the linear transformation.
diff --git a/files/zh-cn/web/css/transform-function/perspective/index.md b/files/zh-cn/web/css/transform-function/perspective/index.md
index 02bd4d64b0e95a..901070091ccff1 100644
--- a/files/zh-cn/web/css/transform-function/perspective/index.md
+++ b/files/zh-cn/web/css/transform-function/perspective/index.md
@@ -11,13 +11,13 @@ T 更小，变化的幅度决定于属性值的变化大小
 
 ## 语法
 
-```
-perspective(l)
+```css
+perspective(d)
 ```
 
 ## 参数
 
-- _l_
+- _d_
   - : 这个{{cssxref("&lt;length&gt;")}} 得到的是距离 0 坐标的距离。被用作提供一个透视渐变属性给某个元素。如果这个值是 0 或者不合法的值，将不会产生透视的变化。
 
 <table class="standard-table">
diff --git a/files/zh-cn/web/css/transform-function/rotate/index.md b/files/zh-cn/web/css/transform-function/rotate/index.md
index 34254c1e1d4e99..bffad77afb1321 100644
--- a/files/zh-cn/web/css/transform-function/rotate/index.md
+++ b/files/zh-cn/web/css/transform-function/rotate/index.md
@@ -15,7 +15,7 @@ CSS 的 **`rotate()`** 函数定义了一种将元素围绕一个定点（由{{
 
 {{cssxref("&lt;angle&gt;")}} 指定了 `rotate()` 的旋转程度。参数为正时，顺时针旋转；参数为负时，逆时针旋转。180° 旋转称为*点反演*。
 
-```
+```css
 rotate(a)
 ```
 
diff --git a/files/zh-cn/web/css/transform-function/rotate3d/index.md b/files/zh-cn/web/css/transform-function/rotate3d/index.md
index 135247803fe2d9..1ad7f5f7bd50b4 100644
--- a/files/zh-cn/web/css/transform-function/rotate3d/index.md
+++ b/files/zh-cn/web/css/transform-function/rotate3d/index.md
@@ -16,7 +16,7 @@ slug: Web/CSS/transform-function/rotate3d
 
 ## 语法
 
-```
+```css
 rotate3d(x, y, z, a)
 ```
 
diff --git a/files/zh-cn/web/css/transform-function/rotatex/index.md b/files/zh-cn/web/css/transform-function/rotatex/index.md
index 5f2906775955f4..633157b3368526 100644
--- a/files/zh-cn/web/css/transform-function/rotatex/index.md
+++ b/files/zh-cn/web/css/transform-function/rotatex/index.md
@@ -20,7 +20,7 @@ slug: Web/CSS/transform-function/rotateX
 
 **`rotateX()`** 引起的旋转量由{{cssxref("&lt;angle&gt;")}}指定。如果为正，则顺时针方向移动；如果为负，则逆时针方向移动。
 
-```
+```css
 rotateX(a)
 ```
 
diff --git a/files/zh-cn/web/css/transform-function/rotatey/index.md b/files/zh-cn/web/css/transform-function/rotatey/index.md
index 2a146181e6df6f..7172108ad0aed4 100644
--- a/files/zh-cn/web/css/transform-function/rotatey/index.md
+++ b/files/zh-cn/web/css/transform-function/rotatey/index.md
@@ -20,7 +20,7 @@ slug: Web/CSS/transform-function/rotateY
 
 **`rotateY()`** 引起的旋转量由{{cssxref("&lt;angle&gt;")}}指定。如果为正，则顺时针方向移动；如果为负，则逆时针方向移动。
 
-```
+```css
 rotateY(a)
 ```
 
diff --git a/files/zh-cn/web/css/transform-function/rotatez/index.md b/files/zh-cn/web/css/transform-function/rotatez/index.md
index 949720a79d1c57..442510d11fb8b0 100644
--- a/files/zh-cn/web/css/transform-function/rotatez/index.md
+++ b/files/zh-cn/web/css/transform-function/rotatez/index.md
@@ -20,7 +20,7 @@ slug: Web/CSS/transform-function/rotateZ
 
 **`rotateZ()`** 引起的旋转量由{{cssxref("&lt;angle&gt;")}}指定。如果为正，则顺时针方向移动；如果为负，则逆时针方向移动。
 
-```
+```css
 rotateZ(a)
 ```
 
diff --git a/files/zh-cn/web/css/transform-function/skew/index.md b/files/zh-cn/web/css/transform-function/skew/index.md
index 16fd6d1e383245..83a3d6d1872633 100644
--- a/files/zh-cn/web/css/transform-function/skew/index.md
+++ b/files/zh-cn/web/css/transform-function/skew/index.md
@@ -13,7 +13,7 @@ slug: Web/CSS/transform-function/skew
 
 `skew()` 函数指定一个或两个参数，它们表示在每个方向上应用的倾斜量。
 
-```
+```css
 skew(ax)
 
 skew(ax, ay)
diff --git a/files/zh-cn/web/css/word-break/index.md b/files/zh-cn/web/css/word-break/index.md
index 40a37253e5eeda..4bd3eef8d6bbb8 100644
--- a/files/zh-cn/web/css/word-break/index.md
+++ b/files/zh-cn/web/css/word-break/index.md
@@ -11,16 +11,19 @@ CSS 属性 `word-break` 指定了怎样在单词内断行。
 
 ## 语法
 
-```
-/* Keyword values */
+```css
+/* 关键字值 */
 word-break: normal;
 word-break: break-all;
 word-break: keep-all;
-word-break: break-word; /* deprecated */
+word-break: auto-phrase; /* 实验性 */
+word-break: break-word; /* 已弃用 */
 
-/* Global values */
+/* 全局值 */
 word-break: inherit;
 word-break: initial;
+word-break: revert;
+word-break: revert-layer;
 word-break: unset;
 ```
 
diff --git a/files/zh-cn/web/http/caching/index.md b/files/zh-cn/web/http/caching/index.md
index e6537f5aafb755..41919cabd465f9 100644
--- a/files/zh-cn/web/http/caching/index.md
+++ b/files/zh-cn/web/http/caching/index.md
@@ -515,7 +515,7 @@ Cache-Control: no-cache, private
 
 因此，你可以使用包含基于版本号或哈希值的更改部分的 URL 来提供 JavaScript 和 CSS。一些方法如下所示。
 
-```
+```plain
 # version in filename
 bundle.v123.js
 
@@ -545,7 +545,7 @@ bundle.js?v=YsAIAAAA-QG4G6kCMAMBAAAAAAAoK
 
 一些常用的缓存头值如下所示。
 
-```
+```plain
 36 cache-control max-age=0
 37 cache-control max-age=604800
 38 cache-control max-age=2592000
diff --git a/files/zh-cn/web/http/cors/errors/corsalloworiginnotmatchingorigin/index.md b/files/zh-cn/web/http/cors/errors/corsalloworiginnotmatchingorigin/index.md
index 4ff77a86610e2f..77741d806b676e 100644
--- a/files/zh-cn/web/http/cors/errors/corsalloworiginnotmatchingorigin/index.md
+++ b/files/zh-cn/web/http/cors/errors/corsalloworiginnotmatchingorigin/index.md
@@ -22,13 +22,13 @@ slug: Web/HTTP/CORS/Errors/CORSAllowOriginNotMatchingOrigin
 > [!WARNING]
 > 你必须将 HTTPS 或 HTTP 协议作为源的一部分。
 
-```
+```apacheconf
 Header set Access-Control-Allow-Origin 'origin'
 ```
 
 在 Nginx 中，对应的配置为：
 
-```
+```nginx
 add_header 'Access-Control-Allow-Origin' 'origin'
 ```
 
diff --git a/files/zh-cn/web/http/cors/errors/corsmissingalloworigin/index.md b/files/zh-cn/web/http/cors/errors/corsmissingalloworigin/index.md
index f4326afbca62ab..952b19baa948f1 100644
--- a/files/zh-cn/web/http/cors/errors/corsmissingalloworigin/index.md
+++ b/files/zh-cn/web/http/cors/errors/corsmissingalloworigin/index.md
@@ -36,14 +36,14 @@ Access-Control-Allow-Origin: *
 
 设置标头的命令取决于你的 Web 服务器。例如，在 Apache 服务器中，将下面一行添加到服务器的配置中（在相应的 `<Directory>`、`<Location>`、`<Files>` 或 `<VirtualHost>` 部分中）。配置通常位于 `.conf` 文件中（`httpd.conf` 和 `apache.conf` 是这些文件的通用名称）或者位于 `.htaccess` 文件中。
 
-```
-Header set Access-Control-Allow-Origin 'origin-list'
+```apacheconf
+Header set Access-Control-Allow-Origin 'https://example.com'
 ```
 
 对于 Nginx，设置此标头的命令是：
 
-```
-add_header 'Access-Control-Allow-Origin' 'origin-list';
+```nginx
+add_header 'Access-Control-Allow-Origin' 'https://example.com' always;
 ```
 
 ## 参见
diff --git a/files/zh-cn/web/http/headers/cookie/index.md b/files/zh-cn/web/http/headers/cookie/index.md
index 3698d647296da2..afbc1f600b1aba 100644
--- a/files/zh-cn/web/http/headers/cookie/index.md
+++ b/files/zh-cn/web/http/headers/cookie/index.md
@@ -24,7 +24,7 @@ slug: Web/HTTP/Headers/Cookie
 
 ## 语法
 
-```
+```http
 Cookie: <cookie-list>
 Cookie: name=value
 Cookie: name=value; name2=value2; name3=value3
@@ -35,7 +35,7 @@ Cookie: name=value; name2=value2; name3=value3
 
 ## 示例
 
-```
+```http
 Cookie: PHPSESSID=298zf09hf012fh2; csrftoken=u32t4o3tb3gg43; _gat=1
 ```
 
diff --git a/files/zh-cn/web/http/headers/expect-ct/index.md b/files/zh-cn/web/http/headers/expect-ct/index.md
index 62122c4154d745..8c0de1c13324e7 100644
--- a/files/zh-cn/web/http/headers/expect-ct/index.md
+++ b/files/zh-cn/web/http/headers/expect-ct/index.md
@@ -36,7 +36,7 @@ slug: Web/HTTP/Headers/Expect-CT
 
 ## 语法
 
-```
+```http
 Expect-CT: report-uri="<uri>",
            enforce,
            max-age=<age>
@@ -66,7 +66,7 @@ Expect-CT: report-uri="<uri>",
 
 以下示例指定在 24 小时内遵守证书透明度政策，并向 `foo.example.com` 报告违规行为。
 
-```
+```http
 Expect-CT: max-age=86400, enforce, report-uri="https://foo.example.com/report"
 ```
 
diff --git a/files/zh-cn/web/http/headers/origin/index.md b/files/zh-cn/web/http/headers/origin/index.md
index 6a8e7ada5044b3..bdfc1ec7bf15de 100644
--- a/files/zh-cn/web/http/headers/origin/index.md
+++ b/files/zh-cn/web/http/headers/origin/index.md
@@ -22,7 +22,7 @@ slug: Web/HTTP/Headers/Origin
 
 ## 语法
 
-```
+```http
 Origin: null
 Origin: <scheme>://<hostname>
 Origin: <scheme>://<hostname>:<port>
diff --git a/files/zh-cn/web/http/headers/permissions-policy/camera/index.md b/files/zh-cn/web/http/headers/permissions-policy/camera/index.md
index a0fcbc1c0ea3a3..9fac02b878d64c 100644
--- a/files/zh-cn/web/http/headers/permissions-policy/camera/index.md
+++ b/files/zh-cn/web/http/headers/permissions-policy/camera/index.md
@@ -9,8 +9,8 @@ HTTP {{HTTPHeader("Permissions-Policy")}} 标头当中的 `camera` 指令控制
 
 ## 语法
 
-```
-Permissions-Policy: camera <allowlist>;
+```http
+Permissions-Policy: camera=<allowlist>;
 ```
 
 - \<allowlist>
diff --git a/files/zh-cn/web/http/status/404/index.md b/files/zh-cn/web/http/status/404/index.md
index 50df6f25992e0e..ab523912fdcb07 100644
--- a/files/zh-cn/web/http/status/404/index.md
+++ b/files/zh-cn/web/http/status/404/index.md
@@ -11,7 +11,7 @@ HTTP 响应状态码 **`404 Not Found`** 指的是服务器无法找到所请求
 
 ## 状态
 
-```
+```http
 404 Not Found
 ```
 
@@ -19,7 +19,7 @@ HTTP 响应状态码 **`404 Not Found`** 指的是服务器无法找到所请求
 
 你可以自定义 404 页面，使其对用户更友好，以及提供一些引导。例如，Apache 服务器可以在 `.htaccess` 文件中指定自定义 404 页面的路径，代码片段如下：
 
-```
+```apacheconf
 ErrorDocument 404 /notfound.html
 ```
 
diff --git a/files/zh-cn/web/javascript/guide/indexed_collections/index.md b/files/zh-cn/web/javascript/guide/indexed_collections/index.md
index edb3e48841aaee..b24f91bb8a6a5b 100644
--- a/files/zh-cn/web/javascript/guide/indexed_collections/index.md
+++ b/files/zh-cn/web/javascript/guide/indexed_collections/index.md
@@ -570,7 +570,7 @@ for (i = 0; i < 4; i++) {
 
 这个例子创建的数组拥有以下行数据：
 
-```
+```plain
 Row 0: [0,0] [0,1] [0,2] [0,3]
 Row 1: [1,0] [1,1] [1,2] [1,3]
 Row 2: [2,0] [2,1] [2,2] [2,3]
diff --git a/files/zh-cn/web/javascript/guide/loops_and_iteration/index.md b/files/zh-cn/web/javascript/guide/loops_and_iteration/index.md
index 3b2294a41bb70e..0349d38e42abe3 100644
--- a/files/zh-cn/web/javascript/guide/loops_and_iteration/index.md
+++ b/files/zh-cn/web/javascript/guide/loops_and_iteration/index.md
@@ -387,7 +387,7 @@ function dump_props(obj, obj_name) {
 
 对于一个拥有 `make` 和 `model` 属性的 `car` 对象来说，执行结果 `result` 是：
 
-```
+```plain
 car.make = Ford
 car.model = Mustang
 ```
diff --git a/files/zh-cn/web/javascript/reference/deprecated_and_obsolete_features/index.md b/files/zh-cn/web/javascript/reference/deprecated_and_obsolete_features/index.md
index 97cbfddc1cf252..a0e451709e2f01 100644
--- a/files/zh-cn/web/javascript/reference/deprecated_and_obsolete_features/index.md
+++ b/files/zh-cn/web/javascript/reference/deprecated_and_obsolete_features/index.md
@@ -184,7 +184,7 @@ console.log("b");
 
 数组推导式和生成器推导式已被移除。
 
-```
+```js-nolint
 // 遗留的数组推导式
 [for (x of iterable) x]
 [for (x of iterable) if (condition) x]
diff --git a/files/zh-cn/web/javascript/reference/errors/not_a_valid_code_point/index.md b/files/zh-cn/web/javascript/reference/errors/not_a_valid_code_point/index.md
index 0cb1fb10bde32f..63f01f4559690d 100644
--- a/files/zh-cn/web/javascript/reference/errors/not_a_valid_code_point/index.md
+++ b/files/zh-cn/web/javascript/reference/errors/not_a_valid_code_point/index.md
@@ -9,7 +9,7 @@ JavaScript 异常“Invalid code point”会在 {{jsxref("String.fromCodePoint()
 
 ## 错误信息
 
-```
+```plain
 RangeError: Invalid code point -1 (V8-based)
 RangeError: -1 is not a valid code point (Firefox)
 RangeError: Arguments contain a value that is out of range of code points (Safari)
diff --git a/files/zh-cn/web/javascript/reference/global_objects/object/constructor/index.md b/files/zh-cn/web/javascript/reference/global_objects/object/constructor/index.md
index d161e50ff2f978..a31044260eef3b 100644
--- a/files/zh-cn/web/javascript/reference/global_objects/object/constructor/index.md
+++ b/files/zh-cn/web/javascript/reference/global_objects/object/constructor/index.md
@@ -67,7 +67,7 @@ console.log(`theTree.constructor 是 ${theTree.constructor}`);
 
 这个示例会打印以下输出：
 
-```
+```plain
 theTree.constructor 是 function Tree(name) {
   this.name = name;
 }
diff --git a/files/zh-cn/web/javascript/reference/global_objects/regexp/exec/index.md b/files/zh-cn/web/javascript/reference/global_objects/regexp/exec/index.md
index af59b04ea9d403..7cfb550536d331 100644
--- a/files/zh-cn/web/javascript/reference/global_objects/regexp/exec/index.md
+++ b/files/zh-cn/web/javascript/reference/global_objects/regexp/exec/index.md
@@ -94,7 +94,7 @@ while ((myArray = myRe.exec(str)) !== null) {
 
 脚本运行结果如下：
 
-```
+```plain
 Found abb. Next match starts at 3
 Found ab. Next match starts at 9
 ```
diff --git a/files/zh-cn/web/javascript/reference/iteration_protocols/index.md b/files/zh-cn/web/javascript/reference/iteration_protocols/index.md
index c6e28f7654dc86..8bcbea1c0f076c 100644
--- a/files/zh-cn/web/javascript/reference/iteration_protocols/index.md
+++ b/files/zh-cn/web/javascript/reference/iteration_protocols/index.md
@@ -125,7 +125,7 @@ JavaScript 语言指定了产生或使用可迭代对象和迭代器的 API。
 
 从内置迭代返回的迭代器实际上都继承了一个公共类（目前尚未暴露），该类实现了上述 `[Symbol.iterator]() { return this; }` 方法，使它们都是可迭代的迭代器。将来，除了迭代器协议要求的 `next()` 方法外，这些内置迭代器可能还有其他[辅助方法](https://github.com/tc39/proposal-iterator-helpers)。你可以通过在图形控制台中记录迭代器的原型链来检查它。
 
-```
+```plain
 console.log([][Symbol.iterator]());
 
 Array Iterator {}
diff --git a/files/zh-cn/web/uri/schemes/data/index.md b/files/zh-cn/web/uri/schemes/data/index.md
index e87f911488ee23..4512d19c287e7c 100644
--- a/files/zh-cn/web/uri/schemes/data/index.md
+++ b/files/zh-cn/web/uri/schemes/data/index.md
@@ -77,7 +77,7 @@ bash$ echo -n hello | base64
 
 下文介绍一些在创建和使用 `data` URL 时遇到的常见问题：
 
-```
+```html
 data:text/html,lots of text…<p><a name%3D"bottom">bottom</a>?arg=val</p>
 ```
 

From 1e6e2288add6c3847c055434889854fa799a0bbd Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Wed, 18 Sep 2024 08:31:20 +0800
Subject: [PATCH 105/115] [zh-CN]: sync translation for Badging API & Web Share
 API (#23626)

---
 files/zh-cn/web/api/badging_api/index.md   | 4 ++--
 files/zh-cn/web/api/web_share_api/index.md | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/files/zh-cn/web/api/badging_api/index.md b/files/zh-cn/web/api/badging_api/index.md
index cf017b55948ed2..0be14b10923789 100644
--- a/files/zh-cn/web/api/badging_api/index.md
+++ b/files/zh-cn/web/api/badging_api/index.md
@@ -2,7 +2,7 @@
 title: Badging API
 slug: Web/API/Badging_API
 l10n:
-  sourceCommit: 8a999418acafeb44b4491e37d02721d32607ec3a
+  sourceCommit: a4675b9077ae32f989c7ecac94f454db2653c4fc
 ---
 
 {{DefaultAPISidebar("Badging API")}}{{securecontext_header}}{{AvailableInWorkers}}
@@ -28,7 +28,7 @@ Web 开发人员经常更新文档图标或标题以指示状态。Badging API 
   - : 表示当前未设置徽章。若徽章被应用程序清除或被用户代理重置，徽章可能会处于此状态。
 - `flag`
   - : 表示已设置徽章，但没有具体数据可显示。如果应用程序已设置徽章，但未将任何值传递给该方法，则徽章将处于此状态。
-- `an integer`
+- 一个整数
   - : 设置徽章时传递的值。该值永远不会是 `0`，设置徽章时传递值 `0` 将导致用户代理通过将其设置为 `nothing` 来清除徽章。
 
 ### 设置徽章
diff --git a/files/zh-cn/web/api/web_share_api/index.md b/files/zh-cn/web/api/web_share_api/index.md
index 4f49bb3b258abe..490b9d8c93c1a8 100644
--- a/files/zh-cn/web/api/web_share_api/index.md
+++ b/files/zh-cn/web/api/web_share_api/index.md
@@ -2,7 +2,7 @@
 title: Web 共享 API
 slug: Web/API/Web_Share_API
 l10n:
-  sourceCommit: 91907f1383139ec2bd1d309d02ffac30b4eee757
+  sourceCommit: 44c4ec928281dc2d7c5ea42b7d2c74a2013f16ac
 ---
 
 {{DefaultAPISidebar("Web Share API")}}{{securecontext_header}}

From 097585d18b1f3c2749d464154e4f0b1b93e95302 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Wed, 18 Sep 2024 08:35:11 +0800
Subject: [PATCH 106/115] [zh-CN]: sync translation for Local Font Access API
 (#23627)

---
 files/zh-cn/web/api/fontdata/blob/index.md          | 2 +-
 files/zh-cn/web/api/fontdata/index.md               | 2 +-
 files/zh-cn/web/api/local_font_access_api/index.md  | 4 ++--
 files/zh-cn/web/api/window/querylocalfonts/index.md | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/files/zh-cn/web/api/fontdata/blob/index.md b/files/zh-cn/web/api/fontdata/blob/index.md
index 61c9974614edac..c7e61f3fdcd1d5 100644
--- a/files/zh-cn/web/api/fontdata/blob/index.md
+++ b/files/zh-cn/web/api/fontdata/blob/index.md
@@ -2,7 +2,7 @@
 title: FontData：blob() 方法
 slug: Web/API/FontData/blob
 l10n:
-  sourceCommit: 4458494807b6f4898d504b6c0af0a45f8031cbf3
+  sourceCommit: d7143e171b5f18fb37a686a7d4947db417fd74f3
 ---
 
 {{APIRef("Local Font Access API")}}{{SeeCompatTable}}
diff --git a/files/zh-cn/web/api/fontdata/index.md b/files/zh-cn/web/api/fontdata/index.md
index db2df67131f207..0329185ec8f576 100644
--- a/files/zh-cn/web/api/fontdata/index.md
+++ b/files/zh-cn/web/api/fontdata/index.md
@@ -2,7 +2,7 @@
 title: FontData
 slug: Web/API/FontData
 l10n:
-  sourceCommit: 4458494807b6f4898d504b6c0af0a45f8031cbf3
+  sourceCommit: d7143e171b5f18fb37a686a7d4947db417fd74f3
 ---
 
 {{APIRef("Local Font Access API")}}{{SeeCompatTable}}
diff --git a/files/zh-cn/web/api/local_font_access_api/index.md b/files/zh-cn/web/api/local_font_access_api/index.md
index d2623d83ca254e..01c9e9aff985f5 100644
--- a/files/zh-cn/web/api/local_font_access_api/index.md
+++ b/files/zh-cn/web/api/local_font_access_api/index.md
@@ -2,7 +2,7 @@
 title: Local Font Access API
 slug: Web/API/Local_Font_Access_API
 l10n:
-  sourceCommit: 4458494807b6f4898d504b6c0af0a45f8031cbf3
+  sourceCommit: d7143e171b5f18fb37a686a7d4947db417fd74f3
 ---
 
 {{SeeCompatTable}}{{DefaultAPISidebar("Local Font Access API")}}
@@ -24,7 +24,7 @@ Local Font Access API 的创建就是为了解决这些问题。
 在隐私和安全方面：
 
 - 本地字体访问 API 旨在仅提供对解决上述问题所需的数据的访问。它既不要求浏览器提供可用本地字体的完整列表，也不要求按照磁盘上出现的顺序提供数据。
-- 当调用 {{domxref("Window.queryLocalFonts()")}} 时，系统会请求用户授予访问其本地字体的权限。此权限的状态可以通过 {{domxref("Permissions API")}}（`local-fonts` 权限）查询。
+- 当调用 {{domxref("Window.queryLocalFonts()")}} 时，系统会请求用户授予访问其本地字体的权限。此权限的状态可以通过 [Permissions API](/zh-CN/docs/Web/API/Permissions_API)（`local-fonts` 权限）查询。
 - 你可以使用 {{httpheader("Permissions-Policy/local-fonts", "local-fonts")}} [权限策略](/zh-CN/docs/Web/HTTP/Permissions_Policy)控制对此特性的访问。
 
 ## 接口
diff --git a/files/zh-cn/web/api/window/querylocalfonts/index.md b/files/zh-cn/web/api/window/querylocalfonts/index.md
index 3b5c5b66c027c8..c02e010252a96f 100644
--- a/files/zh-cn/web/api/window/querylocalfonts/index.md
+++ b/files/zh-cn/web/api/window/querylocalfonts/index.md
@@ -2,7 +2,7 @@
 title: Window：queryLocalFonts() 方法
 slug: Web/API/Window/queryLocalFonts
 l10n:
-  sourceCommit: 89c435da452257b944b403cc9e45036fcb22590e
+  sourceCommit: d7143e171b5f18fb37a686a7d4947db417fd74f3
 ---
 
 {{APIRef("Local Font Access API")}}{{SeeCompatTable}}{{SecureContext_Header}}

From 4042a6e9b041984408d865ed3e47a623607a63f6 Mon Sep 17 00:00:00 2001
From: Tianyi Tao <tianyi.tao@proton.me>
Date: Wed, 18 Sep 2024 10:37:45 +0800
Subject: [PATCH 107/115] [zh-cn]: create the translation of `aria-colspan`
 attribute (#23467)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 .../aria/attributes/aria-colspan/index.md     | 169 ++++++++++++++++++
 1 file changed, 169 insertions(+)
 create mode 100644 files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md

diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md
new file mode 100644
index 00000000000000..88e2ef551b54e0
--- /dev/null
+++ b/files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md
@@ -0,0 +1,169 @@
+---
+title: aria-colspan
+slug: Web/Accessibility/ARIA/Attributes/aria-colspan
+l10n:
+  sourceCommit: 194bd13942ad0c532c92d364e0d5d0c36732d98c
+---
+
+{{AccessibilitySidebar}}
+
+`aria-colspan` 属性定义了在 [`table`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/table_role)、[`grid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/grid_role) 或 [`treegrid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/treegrid_role) 中，单元格或网格单元格跨越的列数。
+
+## 描述
+
+`aria-colspan` 主要用于不包含在原生 HTML {{HTMLElement('table')}} 中的 [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role) 和 [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role)，该属性值定义了一个单元格在 ARIA [`table`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/table_role)、[`grid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/grid_role) 或 [`treegrid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/treegrid_role) 中跨越的列数。
+
+在 HTML 中，{{HTMLElement('th')}} 和 {{HTMLElement('td')}} 元素具有 [`colspan`](/zh-CN/docs/Web/HTML/Element/td#attributes) 属性。当使用语义化的 {{HTMLElement('table')}} 时，按设计使用原生的 `colspan` 属性即可。此 ARIA 属性用于不包含在原生表格中的单元格和网格单元格，如果用于 {{HTMLElement('table')}} 中的单元格，将被忽略。
+
+> [!NOTE]
+> 使用 ARIA 的首要规则是，如果可以使用具有所需语义和行为的原生特性，而不是重新定义元素并**添加** ARIA 角色、状态或属性使其变得无障碍，那么就这样做。尽可能使用 HTML {{HTMLelement('table')}} 元素（包括 {{HTMLelement('td')}} 和 {{HTMLelement('th')}} 以及 `colspan` 属性），而不是带有 ARIA 角色和属性的非语义元素。
+
+`aria-colspan` 的值应为正整数。单元格跨越的默认或假定值为 1。确保所包含的值不会导致单元格或网格单元格与同一行中的下一个单元格重叠，也不会导致单元格跨越超出包含的表格、网格或树网格。
+
+## 示例
+
+以下是一个保龄球锦标赛联赛计分表的部分示例。每场比赛跨越 10 计分格（frame），每个计分格跨越 3 个分数：两球和当前总分。每场比赛的第 10 个（也是最后一个）计分格跨越 4 列，以防有人记全倒。
+
+```html
+<div role="grid" aria-rowcount="27" aria-label="Bowling League Scores">
+  <div role="rowgroup">
+    <div role="row" aria-rowindex="1">
+      <!--
+            aria-rowspan 和 aria-colspan 在当表头单元格跨越多个行或列时会为辅助技术提供正确的数据单元格的表头信息。
+          -->
+
+      <span role="columnheader" aria-rowspan="2">队伍</span>
+      <span role="columnheader" aria-colspan="2">玩家</span>
+      <span role="columnheader" aria-colspan="31">第 1 局计分格</span>
+      <span role="columnheader" aria-colspan="31">第 2 局计分格</span>
+      <span role="columnheader" aria-colspan="31">第 3 局计分格</span>
+      <span role="columnheader" aria-rowspan="2">合计</span>
+    </div>
+    <div role="row" aria-rowindex="2">
+      <span role="columnheader">姓</span>
+      <span role="columnheader">名</span>
+      <span role="columnheader" aria-colspan="3">1</span>
+      <span role="columnheader" aria-colspan="3">2</span>
+      <span role="columnheader" aria-colspan="3">3</span>
+      <span role="columnheader" aria-colspan="3">4</span>
+      <span role="columnheader" aria-colspan="3">5</span>
+      <span role="columnheader" aria-colspan="3">6</span>
+      <span role="columnheader" aria-colspan="3">7</span>
+      <span role="columnheader" aria-colspan="3">8</span>
+      <span role="columnheader" aria-colspan="3">9</span>
+      <span role="columnheader" aria-colspan="4">10</span>
+      <span role="columnheader" aria-colspan="3">1</span>
+      <span role="columnheader" aria-colspan="3">2</span>
+      <span role="columnheader" aria-colspan="3">3</span>
+      <span role="columnheader" aria-colspan="3">4</span>
+      <span role="columnheader" aria-colspan="3">5</span>
+      <span role="columnheader" aria-colspan="3">6</span>
+      <span role="columnheader" aria-colspan="3">7</span>
+      <span role="columnheader" aria-colspan="3">8</span>
+      <span role="columnheader" aria-colspan="3">9</span>
+      <span role="columnheader" aria-colspan="4">10</span>
+      <span role="columnheader" aria-colspan="3">1</span>
+      <span role="columnheader" aria-colspan="3">2</span>
+      <span role="columnheader" aria-colspan="3">3</span>
+      <span role="columnheader" aria-colspan="3">4</span>
+      <span role="columnheader" aria-colspan="3">5</span>
+      <span role="columnheader" aria-colspan="3">6</span>
+      <span role="columnheader" aria-colspan="3">7</span>
+      <span role="columnheader" aria-colspan="3">8</span>
+      <span role="columnheader" aria-colspan="3">9</span>
+      <span role="columnheader" aria-colspan="4">10</span>
+    </div>
+  </div>
+  <div role="rowgroup">
+    <div role="row" aria-rowindex="10">
+      <span role="rowheader" aria-rowspan="3">强力短尾矮袋鼠队</span>
+      <span role="cell">Henderson</span>
+      <span role="cell">Alice</span>
+      <span role="cell">7</span>
+      <span role="cell">/</span>
+      <span role="cell">20</span>
+      <span role="cell" aria-colspan="2">X</span>
+      <span role="cell">39</span>
+      <span role="cell">9</span>
+      <span role="cell">-</span>
+      <span role="cell">48</span>
+      <span role="cell" aria-colspan="2">X</span>
+      <span role="cell">76</span>
+      <span role="cell" aria-colspan="2">X</span>
+      <span role="cell">96</span>
+      <span role="cell">8</span>
+      <span role="cell">/</span>
+      <span role="cell">113</span>
+      <span role="cell">7</span>
+      <span role="cell">-</span>
+      <span role="cell">120</span>
+      <span role="cell" aria-colspan="2">X</span>
+      <span role="cell">146</span>
+      <span role="cell" aria-colspan="2">X</span>
+      <span role="cell">166</span>
+      <span role="cell">6</span>
+      <span role="cell">/</span>
+      <span role="cell">X</span>
+      <span role="cell">186</span>
+      <span role="cell">7</span>
+      <span role="cell">2</span>
+      <span role="cell">9</span>
+      <span role="cell">6</span>
+      <span role="cell">-</span>
+      <span role="cell">15</span>
+      <span role="cell" aria-colspan="2">X</span>
+      <span role="cell">35</span>
+      <span role="cell">7</span>
+      <span role="cell">/</span>
+      …
+    </div>
+    <div role="row" aria-rowindex="11">
+      <span role="cell">McPherson</span>
+      <span role="cell">Leslie</span>
+      <span role="cell">9</span>
+      <span role="cell">-</span>
+      <span role="cell">9</span>
+      <span role="cell">8</span>
+      <span role="cell">1</span>
+      <span role="cell">18</span>
+      …
+    </div>
+  </div>
+</div>
+```
+
+如果我们使用 {{HTMLElement('table')}} 和语义化的表格元素，我们的标记将会更简洁，并且默认具有无障碍性。
+
+## 值
+
+- `<integer>`
+  - : 一个大于或等于默认值 1 的整数，定义单元格跨越的列数。该值必须小于会导致单元格与同一行中的下一个单元格重叠的数值。
+
+## 相关接口
+
+- {{domxref("Element.ariaColSpan")}}
+  - : [`ariaColSpan`](/zh-CN/docs/Web/API/Element/ariaColSpan) 属性，作为每个元素接口的一部分，反映了 `aria-colspan` 属性的值，该属性定义了单元格或网格单元格在表格、网格或树网格中跨越的列数。
+
+## 相关角色
+
+用于角色：
+
+- [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role)
+
+继承到角色：
+
+- [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role)
+- [`rowheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role)
+
+## 规范
+
+{{Specifications}}
+
+## 参见
+
+- {{HTMLElement('th')}} 和 {{HTMLElement('td')}} [`colspan`](/zh-CN/docs/Web/HTML/Element/td#attributes) 属性
+- [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 属性
+- [`aria-rowspan`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-rowspan) 属性
+- [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role) 角色
+- [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) 角色
+- [`rowheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) 角色

From 05fa4858c52617423370dfa8d8b14ec223dcd2fa Mon Sep 17 00:00:00 2001
From: Hoarfroster <hoarfroster@outlook.com>
Date: Wed, 18 Sep 2024 10:40:23 +0800
Subject: [PATCH 108/115] zh-CN: create `extensionTypes.InjectDetails` (#23530)

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

diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/injectdetails/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/injectdetails/index.md
new file mode 100644
index 00000000000000..53a2b96d76f2e2
--- /dev/null
+++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/injectdetails/index.md
@@ -0,0 +1,14 @@
+---
+title: extensionTypes.InjectDetails
+slug: Mozilla/Add-ons/WebExtensions/API/extensionTypes/InjectDetails
+l10n:
+  sourceCommit: 2c5465eab20015868a1eeca59c5623d37b105f7c
+---
+
+{{AddonSidebar}}
+
+这一类型作为参数传递给 `tabs.executeScript()`、`tabs.insertCSS()` 和 `tabs.removeCSS()` 方法。有关其属性的详细信息以及它们的用途，请参阅这些方法的文档页面：
+
+- {{WebExtAPIRef("tabs.executeScript()")}}
+- {{WebExtAPIRef("tabs.insertCSS()")}}
+- {{WebExtAPIRef("tabs.removeCSS()")}}

From 61508412c44f3ce7c4fe049a8adfc039e99ec259 Mon Sep 17 00:00:00 2001
From: ikenk <93726321+ikenk@users.noreply.github.com>
Date: Wed, 18 Sep 2024 11:17:14 +0800
Subject: [PATCH 109/115] updated the Math.sin() method doc (#23584)

Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 .../global_objects/math/sin/index.md          | 22 ++++++++++++-------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/files/zh-cn/web/javascript/reference/global_objects/math/sin/index.md b/files/zh-cn/web/javascript/reference/global_objects/math/sin/index.md
index 07f4c07d685b78..e1877080ce5d30 100644
--- a/files/zh-cn/web/javascript/reference/global_objects/math/sin/index.md
+++ b/files/zh-cn/web/javascript/reference/global_objects/math/sin/index.md
@@ -1,17 +1,19 @@
 ---
 title: Math.sin()
 slug: Web/JavaScript/Reference/Global_Objects/Math/sin
+l10n:
+  sourceCommit: fcd80ee4c8477b6f73553bfada841781cf74cf46
 ---
 
 {{JSRef}}
 
-## 概述
+**`Math.sin()`** 静态方法以弧度为单位返回一个数字的正弦值。
 
-**`Math.sin()`** 函数返回一个数值的正弦值。
+{{EmbedInteractiveExample("pages/js/math-sin.html")}}
 
 ## 语法
 
-```plain
+```js-nolint
 Math.sin(x)
 ```
 
@@ -20,21 +22,25 @@ Math.sin(x)
 - `x`
   - : 一个数值（以弧度为单位）。
 
-## 描述
+### 返回值
+
+`x` 的正弦值，介于 -1 到 1 之间（包含 -1 和 1）。如果 `x` 为 {{jsxref("Infinity")}}、`-Infinity` 或 {{jsxref("NaN")}}，则返回 {{jsxref("NaN")}}。
 
-`sin` 方法返回一个 -1 到 1 之间的数值，表示给定角度（单位：弧度）的正弦值。
+## 描述
 
-由于 `sin` 是 `Math` 的静态方法，所以应该像这样使用：`Math.sin()`，而不是作为你创建的 `Math` 实例的方法。
+由于 `sin()` 是 `Math` 的静态方法，应该总是以 `Math.sin()` 的形式，而不是作为 `Math` 对象的方法来使用它（`Math` 不是构造函数）。
 
 ## 示例
 
-### 示例：使用 `Math.sin`
+### 使用 Math.sin()
 
 ```js
+Math.sin(-Infinity); // NaN
+Math.sin(-0); // -0
 Math.sin(0); // 0
 Math.sin(1); // 0.8414709848078965
-
 Math.sin(Math.PI / 2); // 1
+Math.sin(Infinity); // NaN
 ```
 
 ## 规范

From 68e2195a04edc0e1ad85ee00d77752734ad165ee Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Wed, 18 Sep 2024 11:20:49 +0800
Subject: [PATCH 110/115] [zh-cn]: sync translation for File API (#23412)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Hoarfroster <hoarfroster@outlook.com>
Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 files/zh-cn/web/api/blob/bytes/index.md       | 36 +++++++++++++++++++
 files/zh-cn/web/api/blob/index.md             |  4 ++-
 files/zh-cn/web/api/blob/type/index.md        |  2 +-
 files/zh-cn/web/api/file/index.md             |  4 +--
 .../zh-cn/web/api/file/lastmodified/index.md  | 12 +++----
 .../web/api/file/lastmodifieddate/index.md    | 10 +++---
 files/zh-cn/web/api/file_api/index.md         |  5 +--
 .../index.md                                  | 21 +++++------
 files/zh-cn/web/api/filelist/index.md         |  7 ++--
 files/zh-cn/web/api/filereader/index.md       |  4 +--
 .../api/filereader/readasarraybuffer/index.md |  2 +-
 .../filereader/readasbinarystring/index.md    |  2 +-
 .../web/api/filereader/readasdataurl/index.md |  2 +-
 .../web/api/filereader/readastext/index.md    |  4 +--
 .../web/api/filereader/readystate/index.md    | 10 +++---
 .../filereadersync/filereadersync/index.md    |  2 +-
 .../readasbinarystring/index.md               |  2 +-
 .../api/url/createobjecturl_static/index.md   |  4 +--
 .../api/url/revokeobjecturl_static/index.md   |  2 +-
 19 files changed, 88 insertions(+), 47 deletions(-)
 create mode 100644 files/zh-cn/web/api/blob/bytes/index.md

diff --git a/files/zh-cn/web/api/blob/bytes/index.md b/files/zh-cn/web/api/blob/bytes/index.md
new file mode 100644
index 00000000000000..1ac80778ed31e2
--- /dev/null
+++ b/files/zh-cn/web/api/blob/bytes/index.md
@@ -0,0 +1,36 @@
+---
+title: Blob：bytes() 方法
+slug: Web/API/Blob/bytes
+l10n:
+  sourceCommit: 5ee9d033cacad3a031562be16be43c55a838cc4f
+---
+
+{{APIRef("File API")}}{{AvailableInWorkers}}
+
+{{domxref("Blob")}} 接口的 **`bytes()`** 方法返回一个 {{jsxref("Promise")}}，该 {{jsxref("Promise")}} 兑现为一个包含 blob 内容的字节数组的 {{jsxref("Uint8Array")}}。
+
+## 语法
+
+```js-nolint
+bytes()
+```
+
+### 参数
+
+无。
+
+### 返回值
+
+一个兑现包含 blob 数据的 {{jsxref("Uint8Array")}} 对象的 {{jsxref("Promise")}}。
+
+### 异常
+
+例如，如果用于获取 Blob 数据的读取器抛出异常，则该方法将拒绝返回的 {{jsxref("Promise")}}。
+
+## 规范
+
+{{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}
diff --git a/files/zh-cn/web/api/blob/index.md b/files/zh-cn/web/api/blob/index.md
index ae42dc12817d50..758c1541942451 100644
--- a/files/zh-cn/web/api/blob/index.md
+++ b/files/zh-cn/web/api/blob/index.md
@@ -2,7 +2,7 @@
 title: Blob
 slug: Web/API/Blob
 l10n:
-  sourceCommit: 367b982b93c07f7f99e7bb768a6bf326fa5198e6
+  sourceCommit: de2ef1e9950eebbacdd55f072dfe03014d113bbd
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
@@ -33,6 +33,8 @@ Blob 表示的不一定是 JavaScript 原生格式的数据。{{DOMxRef("File")}
 
 - {{DOMxRef("Blob.arrayBuffer()")}}
   - : 返回一个 promise，其会兑现一个包含 `Blob` 所有内容的二进制格式的 {{jsxref("ArrayBuffer")}}。
+- {{DOMxRef("Blob.bytes()")}}
+  - : 返回一个 promise，其会兑现一个包含 `Blob` 内容的 {{jsxref("Uint8Array")}}。
 - {{DOMxRef("Blob.slice()")}}
   - : 返回一个新的 `Blob` 对象，其中包含调用它的 blob 的指定字节范围内的数据。
 - {{DOMxRef("Blob.stream()")}}
diff --git a/files/zh-cn/web/api/blob/type/index.md b/files/zh-cn/web/api/blob/type/index.md
index a4ba70c965f820..b04ba0cc1597f0 100644
--- a/files/zh-cn/web/api/blob/type/index.md
+++ b/files/zh-cn/web/api/blob/type/index.md
@@ -2,7 +2,7 @@
 title: Blob：type 属性
 slug: Web/API/Blob/type
 l10n:
-  sourceCommit: 84a9afd94f497d4173bde131731ef6bdf0b6135d
+  sourceCommit: be8f7f155a48e11b30c240f8731afb1845f85378
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
diff --git a/files/zh-cn/web/api/file/index.md b/files/zh-cn/web/api/file/index.md
index b99d4fe68a0af0..8dbaf7f9afe65e 100644
--- a/files/zh-cn/web/api/file/index.md
+++ b/files/zh-cn/web/api/file/index.md
@@ -2,7 +2,7 @@
 title: File
 slug: Web/API/File
 l10n:
-  sourceCommit: 467508d83e320be0680f334c3455d3cc232bce42
+  sourceCommit: 58ad1df59f2ffb9ecab4e27fe1bdf1eb5a55f89b
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
@@ -11,7 +11,7 @@ l10n:
 
 `File` 对象通常从用户使用 {{HTMLElement("input")}} 元素选择文件返回的 {{DOMxRef("FileList")}} 对象中检索，或者从拖放操作返回的 {{DOMxRef("DataTransfer")}} 对象中检索。
 
-`File` 对象是一种特定类型的 {{DOMxRef("Blob")}}，并且可以在 Blob 可以使用的任何上下文中使用。特别是，{{DOMxRef("FileReader")}}、{{DOMxRef("URL.createObjectURL_static", "URL.createObjectURL()")}}、{{DOMxRef("createImageBitmap()")}}、{{domxref("fetch()")}} 方法的 [`body`](/zh-CN/docs/Web/API/fetch#body) 选项和 {{DOMxRef("XMLHttpRequest", "", "send( )")}} 都可以接收 `Blob` 对象和 `File` 对象。
+`File` 对象是一种特定类型的 {{DOMxRef("Blob")}}，并且可以在 Blob 可以使用的任何上下文中使用。特别是，{{DOMxRef("FileReader")}}、{{DOMxRef("URL.createObjectURL_static", "URL.createObjectURL()")}}、{{DOMxRef("createImageBitmap()")}}、{{domxref("Window/fetch", "fetch()")}} 方法的 [`body`](/zh-CN/docs/Web/API/RequestInit#body) 选项和 {{DOMxRef("XMLHttpRequest.send()")}} 都可以接收 `Blob` 对象和 `File` 对象。
 
 参见[在 Web 应用程序使用文件](/zh-CN/docs/Web/API/File_API/Using_files_from_web_applications)了解更多信息和例子。
 
diff --git a/files/zh-cn/web/api/file/lastmodified/index.md b/files/zh-cn/web/api/file/lastmodified/index.md
index 2d1c4791289f39..b0438bd2cb5553 100644
--- a/files/zh-cn/web/api/file/lastmodified/index.md
+++ b/files/zh-cn/web/api/file/lastmodified/index.md
@@ -2,7 +2,7 @@
 title: File：lastModified 属性
 slug: Web/API/File/lastModified
 l10n:
-  sourceCommit: 8fd2ee72038310e3ecc387df235ffac1cb08775c
+  sourceCommit: 73b2b6ee411ac094b9fc57dafac6f9c232fc20d9
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
@@ -59,7 +59,7 @@ filepicker.addEventListener("change", (event) => {
 
 ### 动态创建文件
 
-如果文件是动态创建的，可以在 {{domxref("File.File()", "new File()")}} 构造函数中提供最后修改时间。如果未提供则会继承文件对象被创建时的 {{jsxref("Date.now()")}}。
+如果文件是动态创建的，可以在 {{domxref("File.File()", "File()")}} 构造函数中提供最后修改时间。如果未提供该参数，`lastModified` 将会继承文件对象被创建时的时间（来自 {{jsxref("Date.now()")}}）。
 
 ```js
 const fileWithDate = new File([], "file.bin", {
@@ -73,13 +73,14 @@ console.log(fileWithoutDate.lastModified); // 返回当前时间
 
 ## 时间精度降低
 
-为了防止计时攻击和{{glossary("fingerprinting", "指纹识别")}}，`someFile.lastModifiedDate.getTime()` 的精度可能会根据浏览器设置进行舍入。
+为了防止计时攻击和[指纹识别](/zh-CN/docs/Glossary/Fingerprinting)，`someFile.lastModified` 的精度可能会根据浏览器设置进行舍入。在 Firefox 中，`privacy.reduceTimerPrecision` 首选项默认启用，默认为 2ms。你还可以启用 `privacy.resistFingerprinting`，在这种情况下精度将为 100ms 或 `privacy.resistFingerprinting.reduceTimerPrecision.microseconds` 的值，以较大者为准。
 
-在 Firefox 中，`privacy.reduceTimerPrecision` 首选项默认启用，在 Firefox 59 中默认为 20 微秒；Firefox 60 中为 2 毫秒。
+例如，在降低时间精度的情况下，`someFile.lastModified` 的结果将始终是 2 的倍数，或者在启用 `privacy.resistFingerprinting` 的情况下为 100 的倍数（或 `privacy.resistFingerprinting.reduceTimerPrecision.microseconds`）。
 
 ```js
 // Firefox 60 中的时间精度降低（2 毫秒）
 someFile.lastModifiedDate.getTime();
+// 可能是：
 // 1519211809934
 // 1519211810362
 // 1519211811670
@@ -87,14 +88,13 @@ someFile.lastModifiedDate.getTime();
 
 // 启用 `privacy.resistFingerprinting` 会降低时间精度
 someFile.lastModifiedDate.getTime();
+// 可能是：
 // 1519129853500
 // 1519129858900
 // 1519129864400
 // …
 ```
 
-在 Firefox 中，你还可以启用 `privacy.resistFingerprinting`，精度将为 100 毫秒 或 `privacy.resistFingerprinting.reduceTimerPrecision.microseconds` 的值，以较大者为准。
-
 ## 规范
 
 {{Specifications}}
diff --git a/files/zh-cn/web/api/file/lastmodifieddate/index.md b/files/zh-cn/web/api/file/lastmodifieddate/index.md
index 4e3304e9c1c333..0bcf0afc686fa1 100644
--- a/files/zh-cn/web/api/file/lastmodifieddate/index.md
+++ b/files/zh-cn/web/api/file/lastmodifieddate/index.md
@@ -2,7 +2,7 @@
 title: File：lastModifiedDate 属性
 slug: Web/API/File/lastModifiedDate
 l10n:
-  sourceCommit: 367b982b93c07f7f99e7bb768a6bf326fa5198e6
+  sourceCommit: 3b5a1c0dfd59257c0a51052a9efa7b0108f8ecca
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}{{Deprecated_Header}}{{Non-standard_Header}}
@@ -26,13 +26,14 @@ for (const file of fileInput.files) {
 
 ## 时间精度降低
 
-为了防止计时攻击和{{glossary("fingerprinting", "指纹识别")}}，`someFile.lastModifiedDate.getTime()` 的精度可能会根据浏览器设置进行舍入。
+为了防止计时攻击和[指纹识别](/zh-CN/docs/Glossary/Fingerprinting)，`someFile.lastModifiedDate` 的精度可能会根据浏览器设置进行舍入。在 Firefox 中，`privacy.reduceTimerPrecision` 首选项默认启用，默认为 2ms。你还可以启用 `privacy.resistFingerprinting`，在这种情况下精度将为 100ms 或 `privacy.resistFingerprinting.reduceTimerPrecision.microseconds` 的值，以较大者为准。
 
-在 Firefox 中，`privacy.reduceTimerPrecision` 首选项默认启用，在 Firefox 59 中默认为 20 微秒；Firefox 60 中为 2 毫秒。
+例如，在降低时间精度的情况下，`someFile.lastModifiedDate.getTime()` 的结果将始终是 2 的倍数，或者在启用 `privacy.resistFingerprinting` 的情况下为 100 的倍数（或 `privacy.resistFingerprinting.reduceTimerPrecision.microseconds`）。
 
 ```js
 // Firefox 60 中的时间精度降低（2 毫秒）
 someFile.lastModifiedDate.getTime();
+// 可能是：
 // 1519211809934
 // 1519211810362
 // 1519211811670
@@ -40,14 +41,13 @@ someFile.lastModifiedDate.getTime();
 
 // 启用 `privacy.resistFingerprinting` 会降低时间精度
 someFile.lastModifiedDate.getTime();
+// 可能是：
 // 1519129853500
 // 1519129858900
 // 1519129864400
 // …
 ```
 
-在 Firefox 中，你还可以启用 `privacy.resistFingerprinting`，精度将为 100 毫秒或 `privacy.resistFingerprinting.reduceTimerPrecision.microseconds` 的值，以较大者为准。
-
 ## 规范
 
 _尽管存在于文件 API 规范的早期草案中，但此属性已从中删除，并且此属性现在是非标准的。使用 {{domxref("File.lastModified")}} 代替。_
diff --git a/files/zh-cn/web/api/file_api/index.md b/files/zh-cn/web/api/file_api/index.md
index e0c90ace5fc95a..1a107cd676f2ef 100644
--- a/files/zh-cn/web/api/file_api/index.md
+++ b/files/zh-cn/web/api/file_api/index.md
@@ -2,7 +2,7 @@
 title: 文件 API
 slug: Web/API/File_API
 l10n:
-  sourceCommit: 497d322c61511b11e4877a77660f8d7b394a8277
+  sourceCommit: 73b2b6ee411ac094b9fc57dafac6f9c232fc20d9
 ---
 
 {{DefaultAPISidebar("File API")}}{{AvailableInWorkers}}
@@ -78,7 +78,7 @@ fileInput.addEventListener("change", () => {
 });
 ```
 
-### 运行结果
+### 结果
 
 {{EmbedLiveSample("读取文件", "", "300")}}
 
@@ -89,4 +89,5 @@ fileInput.addEventListener("change", () => {
 ## 参见
 
 - [`<input type="file">`](/zh-CN/docs/Web/HTML/Element/input/file)：文件 input 元素
+- {{domxref("Blob.text()")}}
 - {{domxref("DataTransfer")}} 接口
diff --git a/files/zh-cn/web/api/file_api/using_files_from_web_applications/index.md b/files/zh-cn/web/api/file_api/using_files_from_web_applications/index.md
index 8d9a4d26b50f73..4d12ad024c540f 100644
--- a/files/zh-cn/web/api/file_api/using_files_from_web_applications/index.md
+++ b/files/zh-cn/web/api/file_api/using_files_from_web_applications/index.md
@@ -2,7 +2,7 @@
 title: 在 web 应用程序中使用文件
 slug: Web/API/File_API/Using_files_from_web_applications
 l10n:
-  sourceCommit: 94ef07a7b073c2663cbace0667bdb717a40bfa28
+  sourceCommit: 88467d31d2ad7bdfade8b38ec69f6702fee080d1
 ---
 
 {{DefaultAPISidebar("File API")}}{{AvailableInWorkers}}
@@ -335,16 +335,17 @@ fileSelect.addEventListener(
 fileElem.addEventListener("change", handleFiles, false);
 
 function handleFiles() {
+  fileList.textContent = "";
   if (!this.files.length) {
-    fileList.innerHTML = "<p>没有选择任何文件！</p>";
+    const p = document.createElement("p");
+    p.textContent = "没有选择任何文件！";
+    fileList.appendChild(p);
   } else {
-    fileList.innerHTML = "";
     const list = document.createElement("ul");
     fileList.appendChild(list);
     for (let i = 0; i < this.files.length; i++) {
       const li = document.createElement("li");
       list.appendChild(li);
-
       const img = document.createElement("img");
       img.src = URL.createObjectURL(this.files[i]);
       img.height = 60;
@@ -353,7 +354,7 @@ function handleFiles() {
       };
       li.appendChild(img);
       const info = document.createElement("span");
-      info.innerHTML = `${this.files[i].name}: ${this.files[i].size} bytes`;
+      info.textContent = `${this.files[i].name}：${this.files[i].size} 字节`;
       li.appendChild(info);
     }
   }
@@ -400,7 +401,7 @@ function sendFiles() {
 }
 ```
 
-第 2 行获取了文档中所有 CSS 类为 `obj` 的元素的 {{DOMxRef("NodeList")}}，命名为 `imgs`。在我们的例子中，这些是包含所有图像缩略图的列表。有了这个列表，遍历并为每一项创建一个新的 `FileUpload` 实例就很简单了。每个实例都可以处理相应文件的上传。
+`document.querySelectorAll` 获取了文档中所有 CSS 类为 `obj` 的元素的 {{DOMxRef("NodeList")}}，命名为 `imgs`。在我们的例子中，这些是包含所有图像缩略图的列表。有了这个列表，遍历并为每一项创建一个新的 `FileUpload` 实例就很简单了。每个实例都可以处理相应文件的上传。
 
 ### 处理文件的上传过程
 
@@ -486,14 +487,14 @@ function createThrobber(img) {
 
 这个例子演示了如何异步上传文件，在服务器端使用了 PHP，在客户端使用了 JavaScript。
 
-```js
+```php
 <?php
 if (isset($_FILES['myFile'])) {
-    // Example:
+    // 示例：
     move_uploaded_file($_FILES['myFile']['tmp_name'], "uploads/" . $_FILES['myFile']['name']);
     exit;
 }
-?><!DOCTYPE html>
+?><!doctype html>
 <html lang="en-US">
 <head>
   <meta charset="UTF-8">
@@ -544,7 +545,7 @@ if (isset($_FILES['myFile'])) {
 
 对象 URL 可以用于图像之外的其他东西！它可以用于显示嵌入的 PDF 文件或任何其他浏览器能显示的资源。
 
-在 Firefox 中，要让 PDF 嵌入式地显示在 iframe 中（而不是作为下载的文件弹出），必须将 `pdfjs.disabled` 设为 `false` {{non-standard_inline()}}.
+在 Firefox 中，要让 PDF 嵌入式地显示在 iframe 中（而不是作为下载的文件弹出），必须将 `pdfjs.disabled` 设为 `false`。
 
 ```html
 <iframe id="viewer"></iframe>
diff --git a/files/zh-cn/web/api/filelist/index.md b/files/zh-cn/web/api/filelist/index.md
index a8823ac45d943a..e1c2f781e54b83 100644
--- a/files/zh-cn/web/api/filelist/index.md
+++ b/files/zh-cn/web/api/filelist/index.md
@@ -2,7 +2,7 @@
 title: FileList
 slug: Web/API/FileList
 l10n:
-  sourceCommit: 8fd2ee72038310e3ecc387df235ffac1cb08775c
+  sourceCommit: cfa628aedb53a83b315943ef19fa6c73298fb7d5
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
@@ -21,8 +21,9 @@ l10n:
 const file = document.getElementById("fileItem").files[0];
 ```
 
-> [!NOTE]
-> 此接口的出现是[对创建不可修改列表的一次尝试](https://stackoverflow.com/questions/74630989/why-use-domstringlist-rather-than-an-array/74641156#74641156)，并且仅是出于避免破坏已经在使用它的代码而继续受到支持。现代 API 使用围绕 ECMAScript 数组类型的类型，因此你可以像 ECMAScript 数组一样对待它们，同时对其使用施加额外的语义（例如使其项目只读）。
+此接口[试图创建不可修改的列表](https://stackoverflow.com/questions/74630989/why-use-domstringlist-rather-than-an-array/74641156#74641156)，为了不破坏已经使用该接口的代码，才继续支持该接口。现代 API 使用基于 JavaScript [数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array)的类型来表示列表结构，从而提供许多数组方法，同时对其使用施加额外的语义（例如使其项目为只读）。
+
+这些历史原因并不意味着你作为开发人员应该避免使用 `FileList`。你不会自己创建 `FileList` 对象，而是从诸如 {{domxref("HTMLInputElement.files")}} 之类的 API 获取它们，并且这些 API 并未弃用。但是，请注意与真实数组的语义差异。
 
 ## 实例属性
 
diff --git a/files/zh-cn/web/api/filereader/index.md b/files/zh-cn/web/api/filereader/index.md
index ff1d520f9c9182..d61b20668636d9 100644
--- a/files/zh-cn/web/api/filereader/index.md
+++ b/files/zh-cn/web/api/filereader/index.md
@@ -2,7 +2,7 @@
 title: FileReader
 slug: Web/API/FileReader
 l10n:
-  sourceCommit: c2f4a396c85a8f875b592913279e6f116072f622
+  sourceCommit: 58ad1df59f2ffb9ecab4e27fe1bdf1eb5a55f89b
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
@@ -11,7 +11,7 @@ l10n:
 
 文件对象可以从用户使用 {{HTMLElement("input")}} 元素选择文件而返回的 {{domxref("FileList")}} 对象中获取，或者从拖放操作的 {{ domxref("DataTransfer")}} 对象中获取。
 
-`FileReader` 只能访问用户明确选择的文件内容，无论是使用 HTML `<input type="file">` 元素还是通过拖放。它不能用于从用户的文件系统中按路径名读取文件。要按路径名读取客户端文件系统上的文件，请使用[文件系统访问 API](/zh-CN/docs/Web/API/File_System_API)。要读取服务器端文件，请使用 {{domxref("fetch()")}}，如果跨源读取，则需要 [CORS](/zh-CN/docs/Web/HTTP/CORS) 权限。
+`FileReader` 只能访问用户明确选择的文件内容，无论是使用 HTML `<input type="file">` 元素还是通过拖放。它不能用于从用户的文件系统中按路径名读取文件。要按路径名读取客户端文件系统上的文件，请使用[文件系统访问 API](/zh-CN/docs/Web/API/File_System_API)。要读取服务器端文件，请使用 {{domxref("Window/fetch", "fetch()")}}，如果跨源读取，则需要 [CORS](/zh-CN/docs/Web/HTTP/CORS) 权限。
 
 {{InheritanceDiagram}}
 
diff --git a/files/zh-cn/web/api/filereader/readasarraybuffer/index.md b/files/zh-cn/web/api/filereader/readasarraybuffer/index.md
index b6d264b839ab52..183193fd22ecdd 100644
--- a/files/zh-cn/web/api/filereader/readasarraybuffer/index.md
+++ b/files/zh-cn/web/api/filereader/readasarraybuffer/index.md
@@ -2,7 +2,7 @@
 title: FileReader：readAsArrayBuffer() 方法
 slug: Web/API/FileReader/readAsArrayBuffer
 l10n:
-  sourceCommit: e43bfd9b4a6c363a4ba7ef6ffa64c09b38fd111b
+  sourceCommit: d8f04d843dd81ab8cea1cfc0577ae3c5c9b77d5c
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
diff --git a/files/zh-cn/web/api/filereader/readasbinarystring/index.md b/files/zh-cn/web/api/filereader/readasbinarystring/index.md
index f40eda5fcff1dd..925df2d339d3cb 100644
--- a/files/zh-cn/web/api/filereader/readasbinarystring/index.md
+++ b/files/zh-cn/web/api/filereader/readasbinarystring/index.md
@@ -2,7 +2,7 @@
 title: FileReader：readAsBinaryString() 方法
 slug: Web/API/FileReader/readAsBinaryString
 l10n:
-  sourceCommit: e43bfd9b4a6c363a4ba7ef6ffa64c09b38fd111b
+  sourceCommit: d8f04d843dd81ab8cea1cfc0577ae3c5c9b77d5c
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}{{Deprecated_Header}}
diff --git a/files/zh-cn/web/api/filereader/readasdataurl/index.md b/files/zh-cn/web/api/filereader/readasdataurl/index.md
index da312c621f1ee0..2d6589fa07bb62 100644
--- a/files/zh-cn/web/api/filereader/readasdataurl/index.md
+++ b/files/zh-cn/web/api/filereader/readasdataurl/index.md
@@ -2,7 +2,7 @@
 title: FileReader：readAsDataURL() 方法
 slug: Web/API/FileReader/readAsDataURL
 l10n:
-  sourceCommit: e43bfd9b4a6c363a4ba7ef6ffa64c09b38fd111b
+  sourceCommit: 6b730e3cfdf0f51940b44efa71bd59c84ce76e71
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
diff --git a/files/zh-cn/web/api/filereader/readastext/index.md b/files/zh-cn/web/api/filereader/readastext/index.md
index c3fdb02a71cfc3..68f819e1de52ef 100644
--- a/files/zh-cn/web/api/filereader/readastext/index.md
+++ b/files/zh-cn/web/api/filereader/readastext/index.md
@@ -2,10 +2,10 @@
 title: FileReader：readAsText() 方法
 slug: Web/API/FileReader/readAsText
 l10n:
-  sourceCommit: e43bfd9b4a6c363a4ba7ef6ffa64c09b38fd111b
+  sourceCommit: d8f04d843dd81ab8cea1cfc0577ae3c5c9b77d5c
 ---
 
-{{APIRef("File API")}}
+{{APIRef("File API")}}{{AvailableInWorkers}}
 
 {{domxref("FileReader")}} 接口的 **`readAsText()`** 方法用于读取指定的 {{domxref("Blob")}} 或 {{domxref("File")}} 对象的内容。当读操作完成时，{{domxref("FileReader.readyState","readyState")}} 属性更改为 `DONE`，并触发 {{domxref("FileReader/loadend_event", "loadend")}} 事件，并且 {{domxref("FileReader.result","result")}} 属性包含表示文件内容的文本字符串。
 
diff --git a/files/zh-cn/web/api/filereader/readystate/index.md b/files/zh-cn/web/api/filereader/readystate/index.md
index bd2535294a109a..e5094178fa29fb 100644
--- a/files/zh-cn/web/api/filereader/readystate/index.md
+++ b/files/zh-cn/web/api/filereader/readystate/index.md
@@ -2,7 +2,7 @@
 title: FileReader：readyState 属性
 slug: Web/API/FileReader/readyState
 l10n:
-  sourceCommit: 541c4d10b9a1fb1c3400087f2514cd7358f4298f
+  sourceCommit: e932acf254c5dd06e26798b9d8fe01ce8dab1fb7
 ---
 
 {{APIRef("File API")}}{{AvailableInWorkers}}
@@ -11,13 +11,13 @@ l10n:
 
 ## 值
 
-一个数值，是 {{domxref("FileReader")}} API 定义的三个可能状态的常量之一。
+一个数字，它是 {{domxref("FileReader")}} 接口上定义的三个可能的状态常量之一：
 
-- `FileReader.EMPTY`
+- `FileReader.EMPTY`（0）
   - : Reader 已创建，但尚未调用任何读取方法。
-- `FileReader.LOADING`
+- `FileReader.LOADING`（1）
   - : 已调用读取方法。正在读取 {{domxref("File")}} 或 {{domxref("Blob")}}，尚未发生错误。
-- `FileReader.DONE`
+- `FileReader.DONE`（2）
   - : 读取操作完成。这可能意味着：整个 {{domxref("File")}} 或 {{domxref("Blob")}} 已读入内存，发生文件读取错误，或 {{domxref("FileReader.abort()", "abort()")}} 被调用并且读取被取消。
 
 ## 示例
diff --git a/files/zh-cn/web/api/filereadersync/filereadersync/index.md b/files/zh-cn/web/api/filereadersync/filereadersync/index.md
index d12c078843cc9d..dc8bcd2e5c5511 100644
--- a/files/zh-cn/web/api/filereadersync/filereadersync/index.md
+++ b/files/zh-cn/web/api/filereadersync/filereadersync/index.md
@@ -2,7 +2,7 @@
 title: FileReaderSync：FileReaderSync() 构造函数
 slug: Web/API/FileReaderSync/FileReaderSync
 l10n:
-  sourceCommit: 1dad49fff047729e8dcca313a45ccb4cc2d2526f
+  sourceCommit: d8f04d843dd81ab8cea1cfc0577ae3c5c9b77d5c
 ---
 
 {{APIRef("File API")}} {{AvailableInWorkers("worker_except_service")}}
diff --git a/files/zh-cn/web/api/filereadersync/readasbinarystring/index.md b/files/zh-cn/web/api/filereadersync/readasbinarystring/index.md
index aedb8012f63891..228921e907ef21 100644
--- a/files/zh-cn/web/api/filereadersync/readasbinarystring/index.md
+++ b/files/zh-cn/web/api/filereadersync/readasbinarystring/index.md
@@ -2,7 +2,7 @@
 title: FileReaderSync：readAsBinaryString() 方法
 slug: Web/API/FileReaderSync/readAsBinaryString
 l10n:
-  sourceCommit: 502e8c3f0be95c6f42afe6a72113b029b290b9e8
+  sourceCommit: d8f04d843dd81ab8cea1cfc0577ae3c5c9b77d5c
 ---
 
 {{APIRef("File API")}}{{deprecated_header}} {{AvailableInWorkers("worker_except_service")}}
diff --git a/files/zh-cn/web/api/url/createobjecturl_static/index.md b/files/zh-cn/web/api/url/createobjecturl_static/index.md
index fcc6117f9fa9d8..83ca33fa5f1226 100644
--- a/files/zh-cn/web/api/url/createobjecturl_static/index.md
+++ b/files/zh-cn/web/api/url/createobjecturl_static/index.md
@@ -2,7 +2,7 @@
 title: URL：createObjectURL() 静态方法
 slug: Web/API/URL/createObjectURL_static
 l10n:
-  sourceCommit: 367b982b93c07f7f99e7bb768a6bf326fa5198e6
+  sourceCommit: 22080a7cc403f7f45c8e85065b182c9f0d4d383c
 ---
 
 {{APIRef("File API")}} {{AvailableInWorkers("window_and_worker_except_service")}}
@@ -48,7 +48,7 @@ URL.createObjectURL(object)
 在较早版本的媒体源规范中，需要为 {{domxref("MediaStream")}} 创建一个对象 URL 才能将流附加到 {{HTMLElement("video")}} 元素。这已不再必要，浏览器正在逐步取消对此的支持。
 
 > [!WARNING]
-> 如果你还有依赖于 {{domxref("URL.createObjectURL_static", "createObjectURL()")}} 将流附加到媒体元素的代码，你需要更新代码并将 {{domxref("HTMLMediaElement.srcObject", "srcObject")}} 设置为 `MediaStream`。
+> 如果你还有依赖于 `createObjectURL()` 将流附加到媒体元素的代码，你需要更新代码并将 {{domxref("HTMLMediaElement.srcObject", "srcObject")}} 设置为 `MediaStream`。
 
 ## 规范
 
diff --git a/files/zh-cn/web/api/url/revokeobjecturl_static/index.md b/files/zh-cn/web/api/url/revokeobjecturl_static/index.md
index 7d0f9b64c068c6..202e356d902520 100644
--- a/files/zh-cn/web/api/url/revokeobjecturl_static/index.md
+++ b/files/zh-cn/web/api/url/revokeobjecturl_static/index.md
@@ -2,7 +2,7 @@
 title: URL：revokeObjectURL() 静态方法
 slug: Web/API/URL/revokeObjectURL_static
 l10n:
-  sourceCommit: 367b982b93c07f7f99e7bb768a6bf326fa5198e6
+  sourceCommit: 216794e76611c18e53222bb8efa570e898e990de
 ---
 
 {{APIRef("File API")}} {{AvailableInWorkers("window_and_worker_except_service")}}

From 0155042c142fa0a729f554da5fa3efc93eadc34d Mon Sep 17 00:00:00 2001
From: A1lo <yin199909@aliyun.com>
Date: Wed, 18 Sep 2024 12:04:44 +0800
Subject: [PATCH 111/115] zh-cn: update the translation of the
 `HTMLElement.click()` method (#23634)

Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 .../zh-cn/web/api/htmlelement/click/index.md  | 29 ++++++++++++-------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/files/zh-cn/web/api/htmlelement/click/index.md b/files/zh-cn/web/api/htmlelement/click/index.md
index 0ff7eb1e5a003e..03f032fd385dce 100644
--- a/files/zh-cn/web/api/htmlelement/click/index.md
+++ b/files/zh-cn/web/api/htmlelement/click/index.md
@@ -1,14 +1,13 @@
 ---
-title: HTMLElement.click()
+title: HTMLElement：click() 方法
 slug: Web/API/HTMLElement/click
+l10n:
+  sourceCommit: bf0b6c9ae5845fdfca1398541ed26d9946db2495
 ---
 
 {{ APIRef("HTML DOM") }}
 
-**`HTMLElement.click()`** 方法可以用来模拟鼠标左键单击一个元素。
-
-当在支持 `click()` 方法的元素上使用该方法（例如
-{{HTMLElement("input")}}) ，将会产生该元素的一个点击事件。这个事件会冒泡上升到文档树（或事件链）中更高的元素，并触发它们的点击事件。
+**`HTMLElement.click()`** 方法模拟鼠标单击元素。当在某个元素上调用时，会触发元素的 {{domxref("Element/click_event", "click")}} 事件（除非该元素设置了 [`disabled`](/zh-CN/docs/Web/HTML/Attributes/disabled) 属性）。
 
 ## 语法
 
@@ -16,9 +15,17 @@ slug: Web/API/HTMLElement/click
 click()
 ```
 
+### 参数
+
+无。
+
+### 返回值
+
+无（{{jsxref("undefined")}}）。
+
 ## 示例
 
-当鼠标移动过复选框时模拟一个点击事件：
+当鼠标移动过复选框时模拟鼠标点击事件：
 
 ### HTML
 
@@ -28,7 +35,7 @@ click()
     type="checkbox"
     id="myCheck"
     onmouseover="myFunction()"
-    onclick="alert('click event occurred')" />
+    onclick="alert('发生点击事件')" />
 </form>
 ```
 
@@ -51,8 +58,8 @@ function myFunction() {
 
 ## 参见
 
-- 有关的事件处理
+- 有关的事件处理器
 
-  - {{domxref("GlobalEventHandlers.onclick")}}
-  - {{domxref("GlobalEventHandlers.ondblclick")}}
-  - {{domxref("GlobalEventHandlers.onauxclick")}}
+  - {{domxref("Element.click_event", "Element.onclick")}}
+  - {{domxref("Element.dblclick_event", "Element.ondblclick")}}
+  - {{domxref("Element.auxclick_event", "Element.onauxclick")}}

From 072cee95e558966167c7aa18703ea047d888fe53 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Wed, 18 Sep 2024 15:36:05 +0800
Subject: [PATCH 112/115] [zh-CN]: update translation for Broadcast Channel API
 - part II (#23375)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 .../web/api/broadcastchannel/close/index.md   | 20 ++---
 .../broadcastchannel/message_event/index.md   | 26 ++++---
 .../messageerror_event/index.md               | 73 ++++++++++---------
 .../api/broadcastchannel/postmessage/index.md | 30 ++++++--
 4 files changed, 86 insertions(+), 63 deletions(-)

diff --git a/files/zh-cn/web/api/broadcastchannel/close/index.md b/files/zh-cn/web/api/broadcastchannel/close/index.md
index 720574f2abe9eb..f2dc336436482e 100644
--- a/files/zh-cn/web/api/broadcastchannel/close/index.md
+++ b/files/zh-cn/web/api/broadcastchannel/close/index.md
@@ -1,27 +1,27 @@
 ---
-title: BroadcastChannel.close()
+title: BroadcastChannel：close() 方法
 slug: Web/API/BroadcastChannel/close
+l10n:
+  sourceCommit: 50a45d52fd9f45f1ca30b546af5920d0ccda82dc
 ---
 
-{{APIRef("BroadCastChannel API")}}
+{{APIRef("BroadCastChannel API")}} {{AvailableInWorkers}}
 
-通过调用 **`BroadcastChannel.close()`** 方法，可以马上断开其与对应频道的关联，并让其被垃圾回收。这是必要的步骤，因为浏览器没有其他方式知道频道不再被需要。
-
-{{AvailableInWorkers}}
+{{domxref("BroadcastChannel")}} 接口的 **`close()`** 方法终止与底层频道的连接，从而允许对对象进行垃圾回收。这是必须执行的步骤，因为浏览器没有其他方法可以知道不再需要此频道。
 
 ## 语法
 
-```plain
-var str = channel.close();
+```js-nolint
+close()
 ```
 
 ## 示例
 
 ```js
 // 连接到指定频道
-var bc = new BroadcastChannel("test_channel");
+const bc = new BroadcastChannel("test_channel");
 
-// 其他操作 (如：postMessage, …)
+// 其他操作（如：postMessage、……）
 
 // 当完成后，断开与频道的连接
 bc.close();
@@ -37,4 +37,4 @@ bc.close();
 
 ## 参见
 
-- {{domxref("BroadcastChannel")}}, the interface it belongs to.
+- 所属接口：{{domxref("BroadcastChannel")}}
diff --git a/files/zh-cn/web/api/broadcastchannel/message_event/index.md b/files/zh-cn/web/api/broadcastchannel/message_event/index.md
index b5c2b3e1bb252b..38888d824afffd 100644
--- a/files/zh-cn/web/api/broadcastchannel/message_event/index.md
+++ b/files/zh-cn/web/api/broadcastchannel/message_event/index.md
@@ -1,19 +1,21 @@
 ---
 title: BroadcastChannel：message 事件
 slug: Web/API/BroadcastChannel/message_event
+l10n:
+  sourceCommit: 50a45d52fd9f45f1ca30b546af5920d0ccda82dc
 ---
 
-{{APIRef}}
+{{APIRef("BroadCastChannel API")}}{{AvailableInWorkers}}
 
-当频道收到一条消息时，会在关联的 {{domxref('BroadcastChannel')}} 对象上触发 `message` 事件。
+{{domxref("BroadcastChannel")}} 接口的 **`message`** 事件在频道收到一条消息时触发。
 
 ## 语法
 
 在 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 等方法中使用事件名称，或设置事件处理器属性。
 
-```js
-addEventListener("message", (event) => {});
-onmessage = (event) => {};
+```js-nolint
+addEventListener("message", (event) => { })
+onmessage = (event) => { }
 ```
 
 ## 事件类型
@@ -26,20 +28,20 @@ onmessage = (event) => {};
 
 _除了下面列出的属性之外，还可以使用父接口 {{domxref("Event")}} 的属性。_
 
-- {{domxref("MessageEvent.data", "data")}} {{readonlyInline}}
+- {{domxref("MessageEvent.data", "data")}} {{ReadOnlyInline}}
   - : 由消息发送者发送的数据。
-- {{domxref("MessageEvent.origin", "origin")}} {{readonlyInline}}
+- {{domxref("MessageEvent.origin", "origin")}} {{ReadOnlyInline}}
   - : 一个表示消息发送者来源的字符串。
-- {{domxref("MessageEvent.lastEventId", "lastEventId")}} {{readonlyInline}}
+- {{domxref("MessageEvent.lastEventId", "lastEventId")}} {{ReadOnlyInline}}
   - : 一个表示事件唯一 ID 的字符串。
-- {{domxref("MessageEvent.source", "source")}} {{readonlyInline}}
+- {{domxref("MessageEvent.source", "source")}} {{ReadOnlyInline}}
   - : 一个*消息事件源*，可以是一个用于表示消息发送者的 {{glossary("WindowProxy")}}、{{domxref("MessagePort")}} 或 {{domxref("ServiceWorker")}} 对象。
-- {{domxref("MessageEvent.ports", "ports")}} {{readonlyInline}}
+- {{domxref("MessageEvent.ports", "ports")}} {{ReadOnlyInline}}
   - : 一个与发送消息（通过频道发送消息或向 SharedWorker 发送消息）的频道相关联的 {{domxref("MessagePort")}} 对象的数组。
 
 ## 示例
 
-在这个示例中，有一个 [`<iframe>`](/zh-CN/docs/Web/HTML/Element/iframe) 作为发送者，当用户点击按钮之后，会广播 [`<textarea>`](/zh-CN/docs/Web/HTML/Element/textarea) 中的内容。同时，有两个 `iframe` 作为接收者，会监听广播的消息，并将结果写入 [`<div>`](/zh-CN/docs/Web/HTML/Element/div) 元素。
+在这个示例中，有一个 {{HTMLElement("iframe")}} 作为发送者，当用户点击按钮之后，会广播 {{HTMLElement("textarea")}} 中的内容。同时，有两个 `iframe` 作为接收者，会监听广播的消息，并将结果写入 {{HTMLElement("div")}} 元素。
 
 ### 发送者
 
@@ -168,4 +170,4 @@ channel.addEventListener("message", (event) => {
 
 ## 参见
 
-- 相关事件：[`messageerror`](/zh-CN/docs/Web/API/BroadcastChannel/messageerror_event)。
+- 相关事件：{{domxref("BroadcastChannel/messageerror_event", "messageerror")}}。
diff --git a/files/zh-cn/web/api/broadcastchannel/messageerror_event/index.md b/files/zh-cn/web/api/broadcastchannel/messageerror_event/index.md
index 4c540a9684b067..e1c36a9c124531 100644
--- a/files/zh-cn/web/api/broadcastchannel/messageerror_event/index.md
+++ b/files/zh-cn/web/api/broadcastchannel/messageerror_event/index.md
@@ -1,42 +1,47 @@
 ---
-title: "BroadcastChannel: messageerror event"
+title: BroadcastChannel：messageerror 事件
 slug: Web/API/BroadcastChannel/messageerror_event
+l10n:
+  sourceCommit: 50a45d52fd9f45f1ca30b546af5920d0ccda82dc
 ---
 
-{{APIRef}}
-
-当频道收到一条无法反序列化的消息时会在 {{domxref('BroadcastChannel')}} 对象上触发 `messageerror` 事件。
-
-<table class="properties">
-  <tbody>
-    <tr>
-      <th scope="row">Bubbles</th>
-      <td>No</td>
-    </tr>
-    <tr>
-      <th scope="row">Cancelable</th>
-      <td>No</td>
-    </tr>
-    <tr>
-      <th scope="row">Interface</th>
-      <td>{{domxref("MessageEvent")}}</td>
-    </tr>
-    <tr>
-      <th scope="row">Event handler property</th>
-      <td>
-        <code
-          ><a href="/zh-CN/docs/Web/API/BroadcastChannel/onmessageerror"
-            >onmessageerror</a
-          ></code
-        >
-      </td>
-    </tr>
-  </tbody>
-</table>
+{{APIRef("BroadCastChannel API")}}{{AvailableInWorkers}}
+
+{{domxref("BroadcastChannel")}} 接口的 **`messageerror`** 事件在无法反序列化的消息到达频道时触发。
+
+## 语法
+
+在 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 等方法中使用事件名称，或设置事件处理器属性。
+
+```js-nolint
+addEventListener("messageerror", (event) => { })
+onmessageerror = (event) => { }
+```
+
+## 事件类型
+
+一个 {{domxref("MessageEvent")}}。继承自 {{domxref("Event")}}。
+
+{{InheritanceDiagram("MessageEvent")}}
+
+## 事件属性
+
+_除了下面列出的属性之外，还可以使用父接口 {{domxref("Event")}} 的属性。_
+
+- {{domxref("MessageEvent.data", "data")}} {{ReadOnlyInline}}
+  - : 由消息发送者发送的数据。
+- {{domxref("MessageEvent.origin", "origin")}} {{ReadOnlyInline}}
+  - : 一个表示消息发送者来源的字符串。
+- {{domxref("MessageEvent.lastEventId", "lastEventId")}} {{ReadOnlyInline}}
+  - : 一个表示事件唯一 ID 的字符串。
+- {{domxref("MessageEvent.source", "source")}} {{ReadOnlyInline}}
+  - : 一个*消息事件源*，可以是一个用于表示消息发送者的 {{glossary("WindowProxy")}}、{{domxref("MessagePort")}} 或 {{domxref("ServiceWorker")}} 对象。
+- {{domxref("MessageEvent.ports", "ports")}} {{ReadOnlyInline}}
+  - : 一个与发送消息（通过频道发送消息或向 SharedWorker 发送消息）的频道相关联的 {{domxref("MessagePort")}} 对象的数组。
 
 ## 示例
 
-以下代码使用 [`addEventListener`](/zh-CN/docs/Web/API/EventTarget/addEventListener) 来监听消息和错误：
+此代码使用 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 来监听消息和错误：
 
 ```js
 const channel = new BroadcastChannel("example-channel");
@@ -50,7 +55,7 @@ channel.addEventListener("messageerror", (event) => {
 });
 ```
 
-使用 [`onmessage`](/zh-CN/docs/Web/API/BroadcastChannel/onmessage) 和 [`onmessageerror`](/zh-CN/docs/Web/API/BroadcastChannel/onmessageerror) 事件处理程序来实现相同效果：
+下述代码也实现了相同需求，但使用 `onmessage` 和 `onmessageerror` 事件处理器属性：
 
 ```js
 const channel = new BroadcastChannel("example-channel");
@@ -74,4 +79,4 @@ channel.onmessageerror = (event) => {
 
 ## 参见
 
-- 相关事件：[`message`](/zh-CN/docs/Web/API/BroadcastChannel/message_event)
+- 相关事件：{{domxref("BroadcastChannel/message_event", "message")}}。
diff --git a/files/zh-cn/web/api/broadcastchannel/postmessage/index.md b/files/zh-cn/web/api/broadcastchannel/postmessage/index.md
index 81e2d91e0be83f..5584de5c05dac7 100644
--- a/files/zh-cn/web/api/broadcastchannel/postmessage/index.md
+++ b/files/zh-cn/web/api/broadcastchannel/postmessage/index.md
@@ -1,20 +1,36 @@
 ---
-title: BroadcastChannel.postMessage()
+title: BroadcastChannel：postMessage() 方法
 slug: Web/API/BroadcastChannel/postMessage
+l10n:
+  sourceCommit: 50a45d52fd9f45f1ca30b546af5920d0ccda82dc
 ---
 
-{{APIRef("BroadCastChannel API")}}
+{{APIRef("BroadCastChannel API")}} {{AvailableInWorkers}}
 
-可以使用 **`BroadcastChannel.postMessage()`** 发送一条任意 {{jsxref("Object")}} 类型的消息，给所有同{{glossary("origin", "源")}}下监听了该频道的所有{{glossary("browsing context", "浏览器上下文")}}。消息以 [`message`](/zh-CN/docs/Web/API/BroadcastChannel/message_event) 事件的形式发送给每一个绑定到该频道的广播频道。
-
-{{AvailableInWorkers}}
+{{domxref("BroadcastChannel")}} 接口的 **`postMessage()`** 方法向任何{{glossary("browsing context", "浏览上下文")}}中具有相同的{{glossary("origin", "源")}}的每个侦听器发送一条消息，该消息可以是任何类型的 {{jsxref("Object")}}。该消息以 {{domxref("BroadcastChannel/message_event", "message")}} 事件的形式传输，该事件针对绑定到频道的每个 {{domxref("BroadcastChannel")}}。
 
 ## 语法
 
-```plain
-var str = channel.postMessage(object);
+```js-nolint
+postMessage(message)
 ```
 
+### 参数
+
+- `message`
+  - : 要发送到其他窗口的数据。数据使用[结构化克隆算法](/zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)进行序列化。这意味着你可以将各种数据对象安全地传递到目标窗口，而无需自己对其进行序列化。
+
+### 返回值
+
+无。
+
+### 异常
+
+- `InvalidStateError` {{domxref("DOMException")}}
+  - : 如果 {{domxref("BroadcastChannel")}} 已关闭，则抛出此异常。
+- `DataCloneError` {{domxref("DOMException")}}
+  - : 如果输入数据的任何部分不可序列化，则抛出此异常。
+
 ## 规范
 
 {{Specifications}}

From 1900d03d2a982a704569c8fbdfa3b74ee22a0176 Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Wed, 18 Sep 2024 15:43:24 +0800
Subject: [PATCH 113/115] zh-cn: update the translation of the 'performance'
 (#23520)

Co-authored-by: A1lo <yin199909@aliyun.com>
---
 files/zh-cn/learn/performance/index.md | 72 +++++++++++++-------------
 1 file changed, 37 insertions(+), 35 deletions(-)

diff --git a/files/zh-cn/learn/performance/index.md b/files/zh-cn/learn/performance/index.md
index 281fd75a3e2641..e71072a9bb4f1e 100644
--- a/files/zh-cn/learn/performance/index.md
+++ b/files/zh-cn/learn/performance/index.md
@@ -1,60 +1,62 @@
 ---
 title: Web 性能
 slug: Learn/Performance
+l10n:
+  sourceCommit: 5085525b3452de07dbac7fa700aaaf5ff5360a2f
 ---
 
 {{LearnSidebar}}
 
-构建一个网站需要 HTML、CSS 和 JavaScript。为了构建人们需要的、能吸引和留住用户的网站和应用，你需要创建一个良好的用户体验。良好用户体验的一部分是确保内容能够快速加载并响应用户交互。这就是所谓的 **web 性能**，在这个模块中，你将会学到构建性能良好的网站所需要的知识。
+构建网站需要 HTML、CSS 和 JavaScript。要构建人们想要使用、吸引并留住用户的网站和应用程序，你需要创造良好的用户体验。良好用户体验的一部分是确保内容能够快速加载并响应用户交互。这就是所谓的 **Web 性能**，在本模块中，你将专注于创建高性能网站的基础知识。
 
-我们的初学者学习材料的其余部分尽量坚持网络最佳实践，如性能和[无障碍](/zh-CN/docs/Learn/Accessibility)，然而，专门关注此类主题也是不错的，并确保你熟悉它们。
+我们初学者的学习材料的其他部分尽可能地坚持 Web 最佳实践，如性能和[无障碍](/zh-CN/docs/Learn/Accessibility)，然而，专门专注于这些主题并确保你熟悉它们也很好。
 
-## 学习途径
+## 学习路径
 
-虽然了解 HTML、CSS 和 Javascript 是实现许多网页性能提升建议的必要条件，但了解如何构建应用却不是理解和衡量网页性能的必要先决条件。然而，我们建议你在学习本模块之前，至少通过学习我们的 [web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)模块，获得一个网络开发的基本概念。
+虽然了解 HTML、CSS 和 JavaScript 对于实施许多 Web 性能改进建议是必要的，但知道如何构建应用程序并不是理解并测量 Web 性能的必要前提。然而，我们建议你在学习本模块之前，至少通过我们的 [Web 入门](/zh-CN/docs/Learn/Getting_started_with_the_web)模块对 Web 开发有一个基本的了解。
 
-更深入进行以下主题也很有必要，这些模块包括：
+深入了解这些主题也会有所帮助，例如：
 
-- [HTML 入门](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
-- [CSS 初步](/zh-CN/docs/Learn/CSS/First_steps)
-- [JavaScript 初步](/zh-CN/docs/Learn/JavaScript/First_steps)
+- [HTML 简介](/zh-CN/docs/Learn/HTML/Introduction_to_HTML)
+- [CSS 第一步](/zh-CN/docs/Learn/CSS/First_steps)
+- [JavaScript 第一步](/zh-CN/docs/Learn/JavaScript/First_steps)
 
-一旦你完成了这个模块的学习，你可能会对深入研究网络性能感到兴奋——你可以在我们的 [MDN 网络主要性能部分](/zh-CN/docs/Web/Performance)找到很多进一步的教学内容，包括性能 API 的概述、测试和分析工具，以及性能瓶颈问题。
+一旦你完成了本模块的学习，你可能会对深入研究 Web 性能感到兴奋——你可以在我们[主要的 MDN Web 性能部分](/zh-CN/docs/Web/Performance)找到许多进一步的教学内容，包括性能 API 的概述、测试和分析工具，以及性能瓶颈的陷阱。
 
 ## 指南
 
-本专题包含以下指南。以下是建议的学习顺序；你肯定应该从第一个开始。
+本主题包含以下指南。以下是建议的学习顺序；你绝对应该从第一个开始。
 
-- [为什么要提升 web 性能](/zh-CN/docs/Learn/Performance/why_web_performance)
-  - : 本文讨论了为什么网络性能对无障碍、用户体验和你的商业目标很重要。
-- [什么是 web 性能？](/zh-CN/docs/Learn/Performance/What_is_web_performance)
-  - : 你知道网络性能很重要，但什么构成了网络性能？本文介绍了性能的组成部分，从网页的加载和渲染，包括你的内容如何进入用户的浏览器被浏览，到我们在考虑性能时需要考虑哪些群体的问题。
+- [Web 性能的重要性](/zh-CN/docs/Learn/Performance/why_web_performance)
+  - : 这篇文章讨论了 Web 性能对于无障碍、用户体验和你的业务目标的重要性。
+- [什么是 Web 性能？](/zh-CN/docs/Learn/Performance/What_is_web_performance)
+  - : 你知道 Web 性能很重要，但什么是 Web 性能？这篇文章介绍了性能的组成部分，从网页加载和渲染（包括你的内容如何进入用户的浏览器以供查看），到我们在考虑性能时需要考虑的人群。
 - [用户如何感知性能？](/zh-CN/docs/Learn/Performance/Perceived_performance)
-  - : 比你的网站有多快（以毫秒为单位）更重要的是你的用户认为你的网站有多快。这些感知受到实际页面加载时间、空闲、对用户互动的响应能力、滚动和其他动画的流畅度的影响。在这篇文章中，我们将讨论各种加载指标、动画和响应性指标，以及改善用户感知的最佳做法，如果不是实际时间的话。
+  - : 比你的网站以毫秒为单位的加载速度更重要的是用户感知到的网站速度。这些感知受到实际页面加载时间、空闲时间、响应用户交互的速度以及滚动和其他动画的平滑度的影响。在这篇文章中，我们讨论了各种加载指标、动画和响应性指标，以及改进用户感知（即使不是实际时间）的最佳实践。
 - [性能的衡量](/zh-CN/docs/Learn/Performance/Measuring_performance)
-  - : 现在你已经了解了一些性能指标，我们将深入了解性能工具、指标和 API，以及我们如何使性能成为 Web 开发工作流程的一部分。
-- [多媒体：图片](/zh-CN/docs/Learn/Performance/Multimedia)
-  - : 最容易提升网络性能的方式往往是媒体优化。根据每个用户代理的能力、尺寸和像素密度来提供不同的媒体文件是可能的。在这篇文章中，我们讨论了图像对性能的影响，以及减少每张图像发送字节数的方法。
+  - : 现在你已经了解了一些性能指标，接下来我们将深入探讨性能工具、指标和 API，以及如何将性能作为 Web 开发工作流程的一部分。
+- [多媒体：图像](/zh-CN/docs/Learn/Performance/Multimedia)
+  - : 最容易提升 Web 性能的方式通常是媒体优化。根据每个用户代理的能力、尺寸和像素密度提供不同的媒体文件是可能的。在这篇文章中，我们讨论了图像对性能的影响，以及减少每个图像发送的字节数的方法。
 - [多媒体：视频](/zh-CN/docs/Learn/Performance/video)
-  - : 最容易提升网络性能的方式往往是媒体优化。在这篇文章中，我们讨论了视频内容对性能的影响，并涵盖了从背景视频中删除音轨等技巧，可以提高性能。
-- [JavaScript 性能最佳实践](/zh-CN/docs/Learn/Performance/JavaScript)
-  - : 如果使用得当，JavaScript 可以实现交互式和沉浸式的网络体验——反之则可能显著增加下载时间、渲染时间并损害应用性能、电池寿命和用户体验。本文概述了一些应该考虑的 JavaScript 最佳实践，以确保即使是复杂的内容也能尽可能地执行。
-- [HTML 性能特性](/zh-CN/docs/Learn/Performance/HTML)
-  - : 一些属性和你的标记的源顺序会影响你的网站的性能。通过尽量减少 DOM 节点的数量，确保使用最佳的顺序和属性来包括样式、脚本、媒体和第三方脚本等内容，你可以大幅提高用户体验。这篇文章详细研究了如何使用 HTML 来确保最大的性能。
-- [CSS 性能特性](/zh-CN/docs/Learn/Performance/CSS)
-  - : 在提高性能方面，CSS 可能是一个不太重要的优化重点，但有一些 CSS 特性对性能的影响比其他的更大。在这篇文章中，我们看看一些影响性能的 CSS 属性，以及处理样式的建议方法，以确保性能不受负面影响。
-- [字体与性能](/zh-CN/docs/Learn/Performance/Fonts)
-  - : 看看你是否需要引入外部字体，如果需要，如何以对网站性能影响最小的方式引入你的设计所需的字体。
+  - : 最容易提升 Web 性能的方式通常是媒体优化。在这篇文章中，我们讨论了视频内容对性能的影响，并提供了一些技巧，如从背景视频中删除音轨可以提高性能。
+- [JavaScript 性能优化](/zh-CN/docs/Learn/Performance/JavaScript)
+  - : JavaScript，如果使用得当，可以实现交互式和沉浸式的 Web 体验——反之则可能会显著损害下载时间、渲染时间、应用程序性能、电池寿命和用户体验。这篇文章概述了一些应考虑的 JavaScript 最佳实践，以确保即使复杂的内容也能尽可能高效。
+- [HTML 性能优化](/zh-CN/docs/Learn/Performance/HTML)
+  - : 某些属性和标记的源顺序可能会影响你网站的性能。通过最小化 DOM 节点的数量，确保为包含的内容（如样式、脚本、媒体和第三方脚本）使用最佳顺序和属性，你可以显著改善用户体验。这篇文章详细介绍了如何使用 HTML 来确保最佳性能。
+- [CSS 性能优化](/zh-CN/docs/Learn/Performance/CSS)
+  - : CSS 可能不是改进性能的重要优化关注点，但有些 CSS 特性对性能的影响比其他的更大。在这篇文章中，我们介绍了一些影响性能的 CSS 属性，并提出了一些有关处理样式的方法的建议，以确保性能不受负面影响。
+- [字体和性能](/zh-CN/docs/Learn/Performance/Fonts)
+  - : 这篇文章探讨了你是否需要包含外部字体，如果需要，如何以对网站性能影响最小的方式包含设计所需的字体。
 - [移动端性能](/zh-CN/docs/Learn/Performance/Mobile)
-  - : 随着移动设备上的网络访问普及，所有的移动平台都有成熟的网络浏览器，但可能存在带宽、CPU 和电池寿命受限等问题，因此必须考虑在这些平台上提供的 Web 内容的性能。本文探讨了针对移动设备的性能考虑。
-- [web 性能的商业案例](/zh-CN/docs/Learn/Performance/business_case_for_performance)
-  - : 开发人员可以采取许多措施来提高系统的性能，但是什么样的速度才算快？如何说服管理层重视这些努力？一旦优化完成，如何确保系统不会再次出现性能问题？本文将探讨如何说服管理层、如何培养性能文化和制定性能预算，并介绍确保系统不会出现性能回退的方法。
+  - : 由于在移动设备上访问 Web 非常流行，并且所有移动平台都有功能齐全的 Web 浏览器，但可能存在带宽、CPU 和电池寿命的限制，因此考虑这些平台上 Web 内容的性能非常重要。这篇文章探讨了移动设备特有的性能考虑因素。
+- [Web 性能的商业案例](/zh-CN/docs/Learn/Performance/business_case_for_performance)
+  - : 开发人员可以采取许多措施来提高系统的性能，但是什么样的速度才算快？如何说服管理层重视这些努力？一旦优化完成，如何确保系统不会再次出现性能问题？这篇文章将探讨如何说服管理层、如何培养性能文化和制定性能预算，并介绍确保系统不会出现性能回退的方法。
 
 ## 参见
 
 - [Web 性能资源](/zh-CN/docs/Learn/Performance/Web_Performance_Basics)
-  - : 除了 HTML、CSS、JavaScript 和媒体文件等前端组件外，还有一些可以使应用程序变慢的功能和可以使应用程序在主观和客观上变快的功能。有许多与网络性能有关的 API、开发者工具、最佳实践和不良实践。在这里，我们将介绍许多这些功能的基本水平，并提供更深入的链接，以提高每个主题的性能。
-- [响应式图片](/zh-CN/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images)
-  - : 在这篇文章中，我们将了解响应式图像的概念，并看看 HTML 提供了哪些工具来帮助实现它们。响应式图像是在屏幕尺寸、分辨率和其他类似特征差别很大的设备上能很好地工作的图像。这有助于提高不同设备的性能。响应式图像只是[响应式设计](/zh-CN/docs/Learn/CSS/CSS_layout/Responsive_Design)的一部分，这是你未来要学习的一个 CSS 主题。
-- [MDN 上主要的 web 性能页面](/zh-CN/docs/Web/Performance)
-  - : 我们主要的网络性能部分。在这里你会发现更多关于网络性能的细节，包括性能 API 的概述，测试和分析工具，以及性能瓶颈的问题。
+  - : 除了 HTML、CSS、JavaScript 和媒体文件的前端组件外，还有可以使应用程序变慢的特性和可以使应用程序在主观和客观上都变快的特性。有许多与 Web 性能相关的 API、开发者工具、最佳实践和不良实践。在这里，我们将介绍这些特性的基本知识，并针对每个主题都提供了更深入地提升性能的链接。
+- [响应式图像](/zh-CN/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images)
+  - : 在这篇文章中，我们将学习响应式图像的概念——在屏幕尺寸、分辨率和其他特征差异很大的设备上表现良好的图像——并了解 HTML 提供的帮助实现它们的工具。这有助于提高不同设备的性能。响应式图像只是[响应式设计](/zh-CN/docs/Learn/CSS/CSS_layout/Responsive_Design)的一部分，这是你未来要学习的 CSS 主题。
+- [MDN 上主要的 Web 性能部分](/zh-CN/docs/Web/Performance)
+  - : 我们主要的 Web 性能部分——在这里，你将找到更多关于 Web 性能的详细信息，包括性能 API 的概述、测试和分析工具，以及性能瓶颈的陷阱。

From f39fb15f02e12dda5aba835c9aab1d4980cd6567 Mon Sep 17 00:00:00 2001
From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Date: Wed, 18 Sep 2024 15:49:45 +0800
Subject: [PATCH 114/115] [zh-CN]: sync translation for Web Locks API and
 Barcode Detection API (#23628)

Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com>
---
 .../getsupportedformats_static/index.md                |  4 ++--
 files/zh-cn/web/api/lockmanager/request/index.md       | 10 +++++-----
 files/zh-cn/web/api/workernavigator/locks/index.md     |  4 ++--
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/files/zh-cn/web/api/barcodedetector/getsupportedformats_static/index.md b/files/zh-cn/web/api/barcodedetector/getsupportedformats_static/index.md
index 7f0828ee16cc8b..33806d42334180 100644
--- a/files/zh-cn/web/api/barcodedetector/getsupportedformats_static/index.md
+++ b/files/zh-cn/web/api/barcodedetector/getsupportedformats_static/index.md
@@ -2,7 +2,7 @@
 title: BarcodeDetector：getSupportedFormats() 静态方法
 slug: Web/API/BarcodeDetector/getSupportedFormats_static
 l10n:
-  sourceCommit: 37299890c7fe7e4d92c1a86a5fa264afc13467e8
+  sourceCommit: 20c51db7895b1b6f41d4fa90e71830f4b6678eea
 ---
 
 {{securecontext_header}}{{APIRef("Barcode Detector API")}}{{AvailableInWorkers}}{{SeeCompatTable}}
@@ -17,7 +17,7 @@ BarcodeDetector.getSupportedFormats()
 
 ### 参数
 
-该方法不接收任何参数。
+无。
 
 ### 返回值
 
diff --git a/files/zh-cn/web/api/lockmanager/request/index.md b/files/zh-cn/web/api/lockmanager/request/index.md
index c2ab67130b111e..d913f26cb9dd0f 100644
--- a/files/zh-cn/web/api/lockmanager/request/index.md
+++ b/files/zh-cn/web/api/lockmanager/request/index.md
@@ -2,7 +2,7 @@
 title: LockManager：request() 方法
 slug: Web/API/LockManager/request
 l10n:
-  sourceCommit: e4c0939929e1b3e1fa3fd3da82b827fca3ed4c79
+  sourceCommit: cfb7587e3e3122630ad6cbd94d834ecadbe0a746
 ---
 
 {{APIRef("Web Locks API")}}{{securecontext_header}} {{AvailableInWorkers}}
@@ -36,7 +36,7 @@ request(name, options, callback)
 
     - `mode` {{optional_inline}}
 
-      - : `"exclusive"` 或 `"shared"` 之一。默认值是· `"exclusive"`。
+      - : `"exclusive"` 或 `"shared"` 之一。默认值是 `"exclusive"`。
 
     - `ifAvailable` {{optional_inline}}
 
@@ -57,7 +57,7 @@ request(name, options, callback)
 
 ### 返回值
 
-一个 {{jsxref('Promise')}}，在锁释放后解析（或拒绝）回调结果，或者拒绝若请求中止。
+一个 {{jsxref('Promise')}}，在锁释放后兑现（或拒绝）回调结果，或者在请求中止时拒绝。
 
 ### 异常
 
@@ -68,9 +68,9 @@ request(name, options, callback)
 - `SecurityError` {{domxref("DOMException")}}
   - : 如果无法获取当前环境的锁管理器，则抛出该异常。
 - `NotSupportedError` {{domxref("DOMException")}}
-  - : 如果 `name` 以连字符（`-`）开头，或选项 `steal` 和 `ifAvailable` 均为 `true`，或者选项 `signal` 存在且选项 `steal` 或 `ifAvailable` 为 `true`。
+  - : 如果 `name` 以连字符（`-`）开头且 `steal` 和 `ifAvailable` 选项均为 `true`，或选项 `signal` 存在且 `steal` 或 `ifAvailable` 选项为 `true` 时，则抛出该异常。
 - `AbortError` {{domxref("DOMException")}}
-  - : 如果选项 `signal` 存在并且被中止，则抛出该异常。
+  - : 如果 `signal` 选项存在并且被中止，则抛出该异常。
 
 ## 示例
 
diff --git a/files/zh-cn/web/api/workernavigator/locks/index.md b/files/zh-cn/web/api/workernavigator/locks/index.md
index 5a90e2275406c7..8e5b7c207e5bff 100644
--- a/files/zh-cn/web/api/workernavigator/locks/index.md
+++ b/files/zh-cn/web/api/workernavigator/locks/index.md
@@ -2,10 +2,10 @@
 title: WorkerNavigator：locks 属性
 slug: Web/API/WorkerNavigator/locks
 l10n:
-  sourceCommit: 955d8d3b31be8c89efea86265b0e26a401186dbc
+  sourceCommit: e8fe043f7d2ad7cd9804d1bf96e0310949f1dac7
 ---
 
-{{APIRef("Web Locks API")}}{{securecontext_header}}
+{{APIRef("Web Locks API")}}{{securecontext_header}}{{AvailableInWorkers("worker")}}
 
 {{domxref("WorkerNavigator")}} 接口的 **`locks`** 只读属性返回一个 {{domxref("LockManager")}} 对象，该对象提供了请求新的 {{domxref('Lock')}} 对象和查询现有的 `Lock` 对象的方法。
 

From d7c288299a0b1f6bf822559d3a90c35438a50472 Mon Sep 17 00:00:00 2001
From: familyboat <84062528+familyboat@users.noreply.github.com>
Date: Wed, 18 Sep 2024 15:54:59 +0800
Subject: [PATCH 115/115] zh-cn: update the translation of the 'server side'
 (#23519)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com>
Co-authored-by: A1lo <yin199909@aliyun.com>
---
 files/zh-cn/learn/server-side/index.md | 47 ++++++++++++++++----------
 1 file changed, 29 insertions(+), 18 deletions(-)

diff --git a/files/zh-cn/learn/server-side/index.md b/files/zh-cn/learn/server-side/index.md
index b323dac1a86c0d..7b9cc76050f87f 100644
--- a/files/zh-cn/learn/server-side/index.md
+++ b/files/zh-cn/learn/server-side/index.md
@@ -1,37 +1,48 @@
 ---
-title: 服务器端网页编程
+title: 服务器端网站编程
 slug: Learn/Server-side
+l10n:
+  sourceCommit: 8184fa218341dbb193ce6adaa1240c89fae045ec
 ---
 
 {{LearnSidebar}}
 
-**_动态网页——服务器端编程_**这主题是一系列的模块来演示如何创建动态的网页；可以交付自定义的信息来回应 HTTP 请求的网页。这些模块为服务器端编程提供了一个通用的介绍，以及如何使用 Django (Python) 和 Express (Node.js/JavaScript) 去创建基础应用的具体的入门指导。
+**_动态网站_**——**服务器端编程**主题的一系列模块展示了如何创建动态网站；这些网站能够根据 HTTP 请求提供定制化的信息。这些模块提供了服务器端编程的总体介绍，以及如何使用 Django（Python）和 Express（Node.js/JavaScript）Web 框架创建基本应用程序的特定入门指南。
 
-大多数的主流网页使用一类服务器端的技术去动态地显示所要求的不同数据。举个例子，想象一下 Amazon 上有多少可购买的产品，以及 FaceBook 上有多少帖子？用完全不同的静态页面去显示所有的这些内容会彻底地低效，所以取而代之的是这些网站展示的是静态的模板（用 [HTML](/zh-CN/docs/Learn/HTML), [CSS](/zh-CN/docs/Learn/CSS), 和 [JavaScript](/zh-CN/docs/Learn/JavaScript) 构建），然后在有需要时动态地在这些模板中更新数据展示，比如说当你想要在 Amazon 上浏览一个不同的产品。
+大多数主要网站都使用某种服务器端技术来根据需要动态显示数据。例如，想象一下亚马逊上有多少产品，以及 Facebook 上发布了多少帖子。使用不同的静态页面显示所有这些内容将非常低效，因此，这些网站显示静态模板（使用 [HTML](/zh-CN/docs/Learn/HTML)、[CSS](/zh-CN/docs/Learn/CSS) 和 [JavaScript](/zh-CN/docs/Learn/JavaScript) 构建），然后在需要时动态更新这些模板内的数据，例如当你想在亚马逊上查看不同的产品时。
 
-在现代的网页开发世界里，学习服务器端开发是高度推荐的。
+在现代 Web 开发世界中，学习服务器端开发是非常推荐的。
 
 ## 学习路径
 
-开始服务器端编程通常比客户端编程要简单，因为动态的页面倾向于执行非常类似的操作（从数据库中获取数据然后显示到一个页面中，确认用户输入的数据以及保存到一个数据库中，检查用户的权限和登陆用户，以及更多），并且它是用能使这些和其他的常见网页服务端操作变简单的网页框架来构建的。
+开始服务器端编程通常比客户端开发更容易，因为动态网站往往执行许多非常相似的操作（从数据库检索数据并在页面中显示、验证用户输入的数据并将其保存到数据库、检查用户权限并记录用户登录等），并且使用使这些和其他常见 Web 服务器操作变得容易的 Web 框架构建。
 
-知道一些关于编程概念（或者关于一个特定的编程语言）的基础知识会很实用，但不是必要的。类似的，精通客户端编程也不是必修的，但一些基本知识会帮助你和创建你的客户端的“前端”开发者更融洽地工作。
+编程概念（或特定编程语言）的基础知识是有用的，但不是必需的。同样，客户端编码的专业知识也不是必需的，但基础知识将帮助你更好地与创建你的客户端 Web“前端”的开发人员合作。
 
-你会需要去理解“网页是如何工作的”。我们推荐你先去阅读以下主题：
+你需要了解“Web 是如何工作的”。我们建议你首先阅读以下主题：
 
-- 什么是一个网页服务器 \[[What is a web server](/zh-CN/docs/Learn/Common_questions/What_is_a_web_server)]
-- 我需要什么软件去构建一个网页？ \[[What software do I need to build a website?](/zh-CN/docs/Learn/Common_questions/What_software_do_I_need)]
-- 你怎样上传文件到一个网页服务器？ \[[How do you upload files to a web server?](/zh-CN/docs/Learn/Common_questions/Upload_files_to_a_web_server)]
+- [什么是 Web 服务器](/zh-CN/docs/Learn/Common_questions/Web_mechanics/What_is_a_web_server)
+- [我需要什么软件来构建一个网站](/zh-CN/docs/Learn/Common_questions/Tools_and_setup/What_software_do_I_need)
+- [如何将文件上传到 Web 服务器？](/zh-CN/docs/Learn/Common_questions/Tools_and_setup/Upload_files_to_a_web_server)
 
-拥有这些基础理解，你会做好完成在这节中的模块的准备。
+有了这些基本的了解，你就可以开始学习本节中的模块了。
 
 ## 模块
 
-这个主题包含了以下的模块。你应该从第一个模块开始，然后接着到后面的任一模块，后面的模块演示了如何使用两个应用了合适的网页框架的非常流行的服务器端语言。
+本主题包含以下模块。你应该从第一个模块开始，然后继续学习后面任一模块，这些模块展示了如何使用两个非常流行的服务器端语言及其相应的 Web 框架。
 
-- 服务器端编程的第一步 \[[Server-side website programming first steps](/zh-CN/docs/Learn/Server-side/First_steps)]
-  - : 这个模块提供了关于服务器端网页编程的服务器技术无关的信息 \[server-technology-agnostic information]，包括了关于服务器端编程的根本问题的答案——”它是什么“，”它跟客户端编程的区别“，和”为什么它很实用“——以及关于一些流行的服务器端框架的概述和如何为你的网站选择最合适的框架的指南。最后我们提供了一个关于网页服务器安全的介绍性部分。
-- Django 网页框架 \[[Django Web Framework (Python)](/zh-CN/docs/Learn/Server-side/Django)]
-  - : Django 是一个非常流行以及功能齐全的服务器端网页框架，它是用 Python 编写的。这个模块讲解了为什么 Django 是一个这么好的网页服务器框架，如何设立一个开发环境以及如何使用它来执行常见的任务。
-- Express 网页框架 \[[Express Web Framework (Node.js/JavaScript)](/zh-CN/docs/Learn/Server-side/Express_Nodejs)]
-  - : Express 是用 JavaScript 编写并在 node.js 运行时环境中托管的一个流行的网页框架。这个模块讲解了这个框架的一些主要优点，如何设立你的开发环境以及如何执行常见的网页开发和部署的任务。
+- [服务器端网站编程第一步](/zh-CN/docs/Learn/Server-side/First_steps)
+  - : 这个模块提供了与技术无关的服务器端网站编程信息，例如“它是什么？”、“它与客户端编程有何不同？”，以及“它为什么有用？”。这个模块还概述了一些更流行的服务器端 Web 框架，并提供了如何为你的网站选择最佳框架的指导。最后，提供了 Web 服务器安全性的介绍。
+- [Django Web 框架（Python）](/zh-CN/docs/Learn/Server-side/Django)
+  - : Django 是一个用 Python 编写的，非常流行且功能齐全的服务器端 Web 框架。这个模块解释了为什么 Django 是一个如此优秀的 Web 服务器框架、如何设置开发环境，以及如何使用它执行常见任务。
+- [Express Web 框架（Node.js/JavaScript）](/zh-CN/docs/Learn/Server-side/Express_Nodejs)
+  - : Express 是用 JavaScript 编写并在 Node.js 运行时环境中托管的一个流行的 Web 框架。这个模块解释了该框架的一些关键优势、如何设置开发环境，以及如何执行常见的 Web 开发和部署任务。
+
+## 参见
+
+- [无框架的 Node 服务器](/zh-CN/docs/Learn/Server-side/Node_server_without_framework)
+  - : 这篇文章提供了一个使用纯 Node.js 构建的简单静态文件服务器，适合那些不想使用框架的人。
+- [正确配置服务器 MIME 类型](/zh-CN/docs/Learn/Server-side/Configuring_server_MIME_types)
+  - : 配置服务器以向浏览器发送正确的 {{Glossary("MIME type", "MIME 类型")}}（也称为媒体类型或内容类型）对于浏览器能够正确处理和显示内容非常重要。对于防止恶意内容伪装成良性内容也很重要。
+- [Apache 配置：.htaccess](/zh-CN/docs/Learn/Server-side/Apache_Configuration_htaccess)
+  - : Apache 的 .htaccess 文件允许用户在不修改主配置文件的情况下配置他们控制的 Web 服务器目录。