Skip to content

Commit

Permalink
[zh-cn]: update the translation of tabs.query() method (mdn#21804)
Browse files Browse the repository at this point in the history
Co-authored-by: Jason Ren <[email protected]>
  • Loading branch information
tianyeeT and jasonren0403 authored Jul 7, 2024
1 parent 243abb3 commit 241aad6
Showing 1 changed file with 15 additions and 11 deletions.
26 changes: 15 additions & 11 deletions files/zh-cn/mozilla/add-ons/webextensions/api/tabs/query/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: tabs.query()
slug: Mozilla/Add-ons/WebExtensions/API/tabs/query
l10n:
sourceCommit: a6313e45a6ae4c356325f06d0e7e8919bab251a8
---

{{AddonSidebar}}
Expand All @@ -12,25 +14,27 @@ slug: Mozilla/Add-ons/WebExtensions/API/tabs/query
## 语法

```js-nolint
let querying = browser.tabs.query(queryObj)
let querying = browser.tabs.query(queryInfo)
```

### 参数

- `queryObj`
- `queryInfo`

- : `object``query()` 函数将仅获取其属性与此处包含的属性相匹配的标签页。

请参阅 {{WebExtAPIRef("tabs.Tab")}} 文档以了解有关这些属性的详细信息。

- `active` {{optional_inline}}
- : `boolean`。标签页是否在窗口中处于活动状态。
- `attention` {{optional_inline}}
- : `boolean`。指示标签页是否正在吸引注意力。
- `audible` {{optional_inline}}
- : `boolean`。标签页是否在播放声音。
- `autoDiscardable` {{optional_inline}}
- : `boolean`。浏览器是否可以自动丢弃该标签页。默认值为 `true`。若设置为 `false`,则浏览器将不会自动丢弃该标签页。但是,标签页仍可使用 {{WebExtAPIRef("tabs.discard")}} 来丢弃。
- `cookieStoreId` {{optional_inline}}
- : `string``string` 数组。使用它来返回 `tab.cookieStoreId` 与指定的任何 `cookieStoreId` 字符串相匹配的标签页。此选项仅在附加组件具有 `"cookies"` [权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)时才可用。
- : `string``string` 数组。使用它来返回 `tab.cookieStoreId` 与指定的任何 `cookieStoreId` 字符串相匹配的标签页。此选项仅在附加组件具有 `"cookies"` [权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions)时才可用。有关详细信息,请参见[使用场景身份](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Work_with_contextual_identities)
- `currentWindow` {{optional_inline}}
- : `boolean`。标签页是否在当前窗口中。
- `discarded` {{optional_inline}}
Expand All @@ -44,7 +48,7 @@ let querying = browser.tabs.query(queryObj)
- `muted` {{optional_inline}}
- : `boolean`。标签页是否静音。
- `lastFocusedWindow` {{optional_inline}}
- : `boolean`标签页是否在最近聚焦的(last focused)窗口中
- : `boolean`标签页是否在最近聚焦的窗口中
- `pinned` {{optional_inline}}
- : `boolean`。标签页是否固定。
- `status` {{optional_inline}}
Expand All @@ -54,15 +58,15 @@ let querying = browser.tabs.query(queryObj)
- `url` {{optional_inline}}
- : `string``string` 数组。将标签页与一个或多个[匹配模式](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Match_patterns)进行匹配。请注意,不会匹配片段标识符。需要“tabs”权限或匹配标签的[主机权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#主机权限)
- `windowId` {{optional_inline}}
- : `integer`。父窗口的 ID,或 {{WebExtAPIRef('windows.WINDOW_ID_CURRENT')}}(用于当前窗口)。
- : `integer`。父窗口的 `id`,或 {{WebExtAPIRef('windows.WINDOW_ID_CURRENT')}}(用于当前窗口)。
- `windowType` {{optional_inline}}
- : {{WebExtAPIRef('tabs.WindowType')}}。标签页所在窗口的类型。

### 返回值

一个将兑现为包含 {{WebExtAPIRef('tabs.Tab')}} 对象(其中包含有关每个匹配的标签页的信息)的数组的 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 对象
一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise),其会兑现为包含 {{WebExtAPIRef('tabs.Tab')}} 对象(其中包含有关每个匹配的标签页的信息)的数组

如果发生任何错误,promise 将以一条错误消息被拒绝
如果发生任何错误,promise 将以错误消息拒绝

## 示例

Expand All @@ -71,13 +75,13 @@ let querying = browser.tabs.query(queryObj)
```js
function logTabs(tabs) {
for (const tab of tabs) {
// tab.url 需要 `tabs` 权限或匹配的主机(host)权限
// tab.url 需要 `tabs` 权限或匹配的主机权限
console.log(tab.url);
}
}

function onError(error) {
console.error(`错误${error}`);
console.error(`发生错误${error}`);
}

browser.tabs.query({}).then(logTabs, onError);
Expand All @@ -94,7 +98,7 @@ function logTabs(tabs) {
}

function onError(error) {
console.log(`错误${error}`);
console.log(`发生错误${error}`);
}

browser.tabs.query({ currentWindow: true }).then(logTabs, onError);
Expand Down Expand Up @@ -128,7 +132,7 @@ function logTabs(tabs) {
}

function onError(error) {
console.error(`错误${error}`);
console.error(`发生错误${error}`);
}

browser.tabs.query({ url: "*://*.mozilla.org/*" }).then(logTabs, onError);
Expand Down

0 comments on commit 241aad6

Please sign in to comment.