Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[zh-cn] Update webNavigation.onDOMContentLoaded #16855

Merged
merged 2 commits into from
Nov 7, 2023
Merged

[zh-cn] Update webNavigation.onDOMContentLoaded #16855

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d63e411
[zh-cn] Update webNavigation.onDOMContentLoaded
jasonren0403 Nov 7, 2023
67c4be1
Apply suggestions from code review
jasonren0403 Nov 7, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 28 additions & 28 deletions ...-cn/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,76 +1,78 @@
---
title: webNavigation.onDOMContentLoaded
slug: Mozilla/Add-ons/WebExtensions/API/webNavigation/onDOMContentLoaded
l10n:
sourceCommit: 5ff95690a38837afa6a80d00c31adc3ea0217a6e
---

{{AddonSidebar()}}

在页面中触发[DOMContentLoaded](/zh-CN/docs/Web/Events/DOMContentLoaded) 事件时触发。此时，文档被加载和解析，并且 DOM 被完全构造，但链接的资源（例如图像，样式表和子框架（subframes））可能尚未被加载。
在页面中触发[DOMContentLoaded](/zh-CN/docs/Web/API/Document/DOMContentLoaded_event) 事件时触发。此时，文档被加载和解析，并且 DOM 被完全构造，但链接的资源（例如图像，样式表和子框架）可能尚未被加载。
jasonren0403 marked this conversation as resolved.
Show resolved Hide resolved

## Syntax
## 语法

```js
```js-nolint
browser.webNavigation.onDOMContentLoaded.addListener(
listener, // function
filter, // optional object
);
browser.webNavigation.onDOMContentLoaded.removeListener(listener);
browser.webNavigation.onDOMContentLoaded.hasListener(listener);
listener, // 函数
filter // 可选对象
)
browser.webNavigation.onDOMContentLoaded.removeListener(listener)
browser.webNavigation.onDOMContentLoaded.hasListener(listener)
```

事件有三个方法：

- `addListener(callback)`
- : 为此事件添加监听方法。
- `removeListener(listener)`
- : 停止监听此事件。`listener` 参数为需要移出的监听方法。
- : 停止监听此事件。`listener` 参数为需要移除的监听方法。
jasonren0403 marked this conversation as resolved.
Show resolved Hide resolved
- `hasListener(listener)`
- : 检测是否有 `listener` 被注册在事件上。如果有返回 `true` , 否则返回`false` .
- : 检测是否有 `listener` 被注册在事件上。如果有返回 `true` , 否则返回`false`。
jasonren0403 marked this conversation as resolved.
Show resolved Hide resolved

## addListener syntax
## addListener 语法

### 参数

- `callback`

- : 为当此事件发生是需要被调用的函数。该函数将传递以下参数：
- : 为当此事件发生时需要被调用的函数。该函数将传递以下参数：

- `details`
- : [`object`](#details). 有关导航（navigation）事件的详细信息。
- : `object`。有关导航事件的详细信息。参见[详细](#details)小节以获取更多信息。
jasonren0403 marked this conversation as resolved.
Show resolved Hide resolved

- `filter`{{optional_inline}}
- : `object`. 包含单个属性 `url` 的对象，这是一个 {{WebExtAPIRef("events.UrlFilter")}} 数组对象。如果包含此参数，则该事件将仅触发转换为与数组中至少一个`UrlFilter`匹配的 URL。在数组中。如果你省略此参数，则该事件将触发所有转换。
- : `object`。包含单个属性 `url` 的对象，这是一个 {{WebExtAPIRef("events.UrlFilter")}} {{jsxref("Array")}} 对象。如果包含此参数，则该事件将仅触发转换为与数组中至少一个 `UrlFilter` 匹配的 URL。如果省略此参数，则该事件将触发所有转换。

## Additional objects
## 额外对象

### details

- `tabId`
- : `integer`. The ID of the tab in which the navigation has occurred.
- : `integer`。发生导航事件的标签页 ID。
- `url`
- : `string`. The URL to which the given frame has navigated.
- : `string`。指定框架导航到的 URL。
- `processId`
- : `integer`. The ID of the process in which this tab is being rendered.
- : `integer`。渲染此选项卡的进程的 ID。
- `frameId`
- : `integer`. Frame in which the navigation is occurring. 0 indicates that navigation happens in the tab's top-level browsing context, not in a nested [iframe](/zh-CN/docs/Web/HTML/Element/iframe). A positive value indicates that navigation happens in a nested iframe. Frame IDs are unique for a given tab and process.
- : `integer`。发生导航的框架。0 表示导航发生在标签页的顶级浏览上下文中，而不是嵌套的 [iframe](/zh-CN/docs/Web/HTML/Element/iframe) 中。正值表示导航发生在嵌套的 iframe 中。对于给定的标签页和进程，框架 ID 是唯一的。
- `timeStamp`
- : `number`. The time at which `DOMContentLoaded` was fired, in [milliseconds since the epoch](https://en.wikipedia.org/wiki/Unix_time).
- : `number`。启动 `DOMContentLoaded` 的时间，单位为[自纪元起的毫秒数](https://zh.wikipedia.org/wiki/UNIX时间)。

## Browser compatibility
## 浏览器兼容性

{{Compat}}

## Examples
## 示例

Logs the target URLs for `onDOMContentLoaded`, if the target URL's hostname contains "example.com" or starts with "developer".
如果目标 URL 的主机名包含“example.com”或以“developer”开头，则记录“onDOMContentLoaded”的目标 URL。

```js
var filter = {
const filter = {
url: [{ hostContains: "example.com" }, { hostPrefix: "developer" }],
};

function logOnDOMContentLoaded(details) {
console.log("onDOMContentLoaded: " + details.url);
console.log(`onDOMContentLoaded: ${details.url}`);
}

browser.webNavigation.onDOMContentLoaded.addListener(
Expand All @@ -81,9 +83,7 @@ browser.webNavigation.onDOMContentLoaded.addListener(

{{WebExtExamples}}

> **备注：** This API is based on Chromium's [`chrome.webNavigation`](https://developer.chrome.com/extensions/webNavigation#event-onBeforeNavigate) API. This documentation is derived from [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json) in the Chromium code.
>
> Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
> **备注：** 本 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)。

<!--
// Copyright 2015 The Chromium Authors. All rights reserved.
Expand Down