Trang này được dịch bởi Cloud Translation API.

chrome.tabs

Mô tả

Sử dụng API chrome.tabs để tương tác với hệ thống thẻ của trình duyệt. Bạn có thể dùng API này để tạo, sửa đổi và sắp xếp lại các thẻ trong trình duyệt.

Tổng quan

API Thẻ không chỉ cung cấp các tính năng để thao tác và quản lý thẻ mà còn có thể phát hiện ngôn ngữ của thẻ, chụp ảnh chụp màn hình và giao tiếp với các tập lệnh nội dung của thẻ.

Quyền

Hầu hết các tính năng đều không yêu cầu quyền sử dụng. Ví dụ: tạo một thẻ mới, tải lại một thẻ, chuyển đến một URL khác, v.v.

Có 3 quyền mà nhà phát triển cần lưu ý khi làm việc với Tabs API.

Quyền "tabs": Quyền này không cấp quyền truy cập vào không gian tên chrome.tabs. Thay vào đó, thao tác này cấp cho một tiện ích khả năng gọi tabs.query() đối với 4 thuộc tính nhạy cảm trên các thực thể tabs.Tab: url, pendingUrl, title và favIconUrl.
Quyền từ phía máy chủ: Quyền từ phía máy chủ cho phép một tiện ích đọc và truy vấn 4 thuộc tính nhạy cảm tabs.Tab của một thẻ khớp. Chúng cũng có thể tương tác trực tiếp với các thẻ khớp bằng cách sử dụng các phương thức như tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() và tabs.removeCSS().
Quyền "activeTab": activeTab cấp cho tiện ích quyền truy cập tạm thời vào máy chủ lưu trữ cho thẻ hiện tại để phản hồi một lệnh gọi của người dùng. Không giống như quyền truy cập vào máy chủ lưu trữ, activeTab không kích hoạt bất kỳ cảnh báo nào.

Tệp kê khai

Sau đây là ví dụ về cách khai báo từng quyền trong tệp kê khai:

  {
    "name": "My extension",
    ...
    "permissions": [
      "tabs"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "host_permissions": [
      "http://*/*",
      "https://*/*"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "permissions": [
      "activeTab"
    ],
    ...
  }

Trường hợp sử dụng

Các phần sau đây minh hoạ một số trường hợp sử dụng phổ biến.

Mở trang tiện ích trong thẻ mới

Một mẫu phổ biến cho các tiện ích là mở trang giới thiệu trong một thẻ mới khi tiện ích được cài đặt. Ví dụ sau đây cho thấy cách thực hiện việc này.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

Lấy thẻ hiện tại

Ví dụ này minh hoạ cách trình chạy dịch vụ của tiện ích có thể truy xuất thẻ đang hoạt động từ cửa sổ hiện đang được lấy tiêu điểm (hoặc cửa sổ được lấy tiêu điểm gần đây nhất, nếu không có cửa sổ Chrome nào được lấy tiêu điểm). Bạn thường có thể coi đây là thẻ hiện tại của người dùng.

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }

  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

Tắt tiếng thẻ được chỉ định

Ví dụ này cho thấy cách một tiện ích có thể bật/tắt trạng thái tắt tiếng cho một thẻ nhất định.

  async function toggleMuteState(tabId) {
    const tab = await chrome.tabs.get(tabId);
    const muted = !tab.mutedInfo.muted;
    await chrome.tabs.update(tabId, {muted});
    console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
  }

  function toggleMuteState(tabId) {
    chrome.tabs.get(tabId, async (tab) => {
      let muted = !tab.mutedInfo.muted;
      await chrome.tabs.update(tabId, { muted });
      console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
    });
  }

Di chuyển thẻ hiện tại đến vị trí đầu tiên khi nhấp vào

Ví dụ này cho thấy cách di chuyển một thẻ trong khi thao tác kéo có thể đang diễn ra hoặc không. Mặc dù ví dụ này sử dụng chrome.tabs.move, nhưng bạn có thể sử dụng cùng một mẫu chờ cho các lệnh gọi khác sửa đổi các thẻ trong khi thao tác kéo đang diễn ra.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

Truyền thông báo đến tập lệnh nội dung của thẻ đã chọn

Ví dụ này minh hoạ cách trình chạy dịch vụ của tiện ích có thể giao tiếp với các tập lệnh nội dung trong các thẻ trình duyệt cụ thể bằng cách sử dụng tabs.sendMessage().

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

Ví dụ về tiện ích

Để xem thêm các bản minh hoạ về tiện ích API Tabs, hãy khám phá bất kỳ tiện ích nào sau đây:

Loại

MutedInfo

Chrome 46 trở lên

Trạng thái tắt tiếng của thẻ và lý do cho lần thay đổi trạng thái gần đây nhất.

Thuộc tính

extensionId

chuỗi không bắt buộc

Mã nhận dạng của tiện ích đã thay đổi trạng thái tắt tiếng. Không được đặt nếu phần mở rộng không phải là lý do khiến trạng thái tắt tiếng thay đổi lần gần đây nhất.
đã tắt tiếng

boolean

Thẻ có bị tắt tiếng hay không (không phát âm thanh). Thẻ có thể bị tắt tiếng ngay cả khi chưa phát hoặc hiện không phát âm thanh. Tương đương với việc chỉ báo âm thanh "đã tắt tiếng" có xuất hiện hay không.
lý do

MutedInfoReason không bắt buộc

Lý do thẻ bị tắt tiếng hoặc bật tiếng. Không được đặt nếu trạng thái tắt tiếng của thẻ chưa bao giờ thay đổi.

MutedInfoReason

Chrome 46 trở lên

Một sự kiện gây ra thay đổi trạng thái tắt tiếng.

Enum

"user"
Một hành động đầu vào của người dùng đã đặt trạng thái tắt tiếng.

"capture"
Tính năng ghi lại thẻ đã bắt đầu, buộc thay đổi trạng thái tắt tiếng.

"extension"
Một tiện ích (được xác định bằng trường extensionId) đã đặt trạng thái tắt tiếng.

Tab

Thuộc tính

hoạt động

boolean

Thẻ có đang hoạt động trong cửa sổ của thẻ hay không. Không nhất thiết có nghĩa là cửa sổ đang được lấy tiêu điểm.
audible

boolean không bắt buộc

Chrome 45 trở lên

Liệu thẻ có phát ra âm thanh trong vài giây qua hay không (nhưng có thể không nghe thấy nếu thẻ cũng bị tắt tiếng). Tương đương với việc chỉ báo "âm thanh của người nói" có xuất hiện hay không.
autoDiscardable

boolean

Chrome 54 trở lên

Trình duyệt có thể tự động loại bỏ thẻ này khi tài nguyên thấp hay không.
đã hủy

boolean

Chrome 54 trở lên

Thẻ có bị loại bỏ hay không. Thẻ bị loại bỏ là thẻ có nội dung đã được gỡ tải khỏi bộ nhớ nhưng vẫn xuất hiện trong dải thẻ. Nội dung của thành phần này sẽ được tải lại vào lần tiếp theo thành phần được kích hoạt.
favIconUrl

chuỗi không bắt buộc

URL của biểu tượng trang web của thẻ. Thuộc tính này chỉ xuất hiện nếu tiện ích có quyền "tabs" hoặc có quyền của máy chủ lưu trữ cho trang. Đây cũng có thể là một chuỗi trống nếu thẻ đang tải.
đóng băng

boolean

Chrome 132 trở lên

Thẻ có bị treo hay không. Thẻ bị đóng băng không thể thực hiện các tác vụ, bao gồm cả trình xử lý sự kiện hoặc bộ hẹn giờ. Thẻ này xuất hiện trong dải thẻ và nội dung của thẻ được tải vào bộ nhớ. Thiết bị sẽ được mở khoá khi bạn kích hoạt.
groupId

số

Chrome 88 trở lên

Mã nhận dạng của nhóm chứa thẻ.
độ cao

number không bắt buộc

Chiều cao của thẻ tính bằng pixel.
được làm nổi bật

boolean

Thẻ có được làm nổi bật hay không.
id

number không bắt buộc

Mã nhận dạng của thẻ. Mã thẻ là duy nhất trong một phiên trình duyệt. Trong một số trường hợp, thẻ có thể không được chỉ định mã nhận dạng; ví dụ: khi truy vấn các thẻ bên ngoài bằng API sessions, trong trường hợp này, có thể có mã nhận dạng phiên. Bạn cũng có thể đặt mã nhận dạng thẻ thành chrome.tabs.TAB_ID_NONE cho các cửa sổ ứng dụng và công cụ cho nhà phát triển.
ẩn danh

boolean

Thẻ có đang ở trong cửa sổ ẩn danh hay không.
index

số

Chỉ mục bắt đầu từ 0 của thẻ trong cửa sổ.
lastAccessed

số

Chrome 121 trở lên

Lần gần đây nhất thẻ hoạt động trong cửa sổ của thẻ, tính bằng số mili giây kể từ thời gian bắt đầu của hệ thống.
mutedInfo

MutedInfo không bắt buộc

Chrome 46 trở lên

Trạng thái tắt tiếng của thẻ và lý do cho lần thay đổi trạng thái gần đây nhất.
openerTabId

number không bắt buộc

Mã của thẻ đã mở thẻ này (nếu có). Thuộc tính này chỉ xuất hiện nếu thẻ mở vẫn tồn tại.
pendingUrl

chuỗi không bắt buộc

Chrome 79 trở lên

URL mà thẻ đang chuyển đến, trước khi thẻ đó được xác nhận. Thuộc tính này chỉ xuất hiện nếu tiện ích có quyền "tabs" hoặc có quyền của máy chủ lưu trữ cho trang và có một thao tác điều hướng đang chờ xử lý.
được ghim

boolean

Thẻ có được ghim hay không.
đã chọn

boolean

Không dùng nữa

Vui lòng sử dụng tabs.Tab.highlighted.
Thẻ có được chọn hay không.
sessionId

chuỗi không bắt buộc

Mã phiên dùng để xác định riêng một thẻ nhận được từ API sessions.
trạng thái

TabStatus không bắt buộc

Trạng thái tải của thẻ.
tiêu đề

chuỗi không bắt buộc

Tiêu đề của thẻ. Thuộc tính này chỉ xuất hiện nếu tiện ích có quyền "tabs" hoặc có quyền của máy chủ lưu trữ cho trang.
url

chuỗi không bắt buộc

URL được xác nhận gần đây nhất của khung chính của thẻ. Thuộc tính này chỉ xuất hiện nếu tiện ích có quyền "tabs" hoặc có quyền của máy chủ lưu trữ cho trang. Có thể là một chuỗi trống nếu thẻ chưa được xác nhận. Xem thêm Tab.pendingUrl.
chiều rộng

number không bắt buộc

Chiều rộng của thẻ, tính bằng pixel.
windowId

số

Mã nhận dạng của cửa sổ chứa thẻ.

TabStatus

Chrome 44 trở lên

Trạng thái tải của thẻ.

Enum

"unloaded"

"loading"

"complete"

WindowType

Chrome 44 trở lên

Loại cửa sổ.

Enum

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

Xác định cách xử lý các thay đổi về mức thu phóng trong một thẻ và ở phạm vi nào.

Thuộc tính

defaultZoomFactor

number không bắt buộc

Chrome 43 trở lên

Được dùng để trả về mức thu phóng mặc định cho thẻ hiện tại trong các lệnh gọi đến tabs.getZoomSettings.
chế độ

ZoomSettingsMode không bắt buộc

Xác định cách xử lý các thay đổi về mức thu phóng, tức là thực thể nào chịu trách nhiệm về việc điều chỉnh tỷ lệ thực tế của trang; mặc định là automatic.
phạm vi

ZoomSettingsScope không bắt buộc

Xác định xem các thay đổi về mức thu phóng có duy trì cho nguồn gốc của trang hay chỉ có hiệu lực trong thẻ này; mặc định là per-origin khi ở chế độ automatic và per-tab trong trường hợp khác.

ZoomSettingsMode

Chrome 44 trở lên

Xác định cách xử lý các thay đổi về mức thu phóng, tức là thực thể nào chịu trách nhiệm về việc điều chỉnh tỷ lệ thực tế của trang; mặc định là automatic.

Enum

"automatic"
Trình duyệt sẽ tự động xử lý các thay đổi về tỷ lệ thu phóng.

"manual"
Ghi đè chế độ tự động xử lý các thay đổi về mức thu phóng. Sự kiện onZoomChange vẫn sẽ được gửi đi và tiện ích có trách nhiệm lắng nghe sự kiện này cũng như tự điều chỉnh tỷ lệ trang theo cách thủ công. Chế độ này không hỗ trợ tính năng thu phóng per-origin, do đó, chế độ này sẽ bỏ qua chế độ cài đặt thu phóng scope và giả định per-tab.

"disabled"
Tắt tất cả các chế độ thu phóng trong thẻ. Thẻ này sẽ trở về mức thu phóng mặc định và mọi thay đổi về mức thu phóng đều sẽ bị bỏ qua.

ZoomSettingsScope

Chrome 44 trở lên

Xác định xem các thay đổi về mức thu phóng có duy trì cho nguồn gốc của trang hay chỉ có hiệu lực trong thẻ này; mặc định là per-origin khi ở chế độ automatic và per-tab trong trường hợp khác.

Enum

"per-origin"
Các thay đổi về mức thu phóng vẫn được giữ nguyên trong nguồn gốc của trang được thu phóng, tức là tất cả các thẻ khác chuyển đến cùng một nguồn gốc đó cũng sẽ được thu phóng. Ngoài ra, các thay đổi về per-origin mức thu phóng sẽ được lưu cùng với nguồn gốc, tức là khi bạn chuyển đến các trang khác trong cùng một nguồn gốc, tất cả các trang đó đều được thu phóng theo cùng một hệ số thu phóng. Phạm vi per-origin chỉ có trong chế độ automatic.

"per-tab"
Các thay đổi về mức thu phóng chỉ có hiệu lực trong thẻ này và các thay đổi về mức thu phóng trong các thẻ khác không ảnh hưởng đến mức thu phóng của thẻ này. Ngoài ra, các thay đổi về mức thu phóng per-tab sẽ được đặt lại khi bạn di chuyển; việc di chuyển một thẻ luôn tải các trang có hệ số thu phóng per-origin.

Thuộc tính

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 trở lên

Số lần tối đa mà bạn có thể gọi captureVisibleTab mỗi giây. captureVisibleTab có chi phí cao và bạn không nên gọi quá thường xuyên.

Giá trị

TAB_ID_NONE

Chrome 46 trở lên

Mã nhận dạng đại diện cho việc không có thẻ trình duyệt.

Giá trị

-1

TAB_INDEX_NONE

Chrome 123 trở lên

Một chỉ mục biểu thị việc không có chỉ mục thẻ trong tab_strip.

Giá trị

-1

Phương thức

captureVisibleTab()

Promise

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
): Promise<string>

Chụp khu vực hiển thị của thẻ hiện đang hoạt động trong cửa sổ đã chỉ định. Để gọi phương thức này, tiện ích phải có quyền <all_urls> hoặc quyền activeTab. Ngoài những trang web mà các tiện ích thường có thể truy cập, phương thức này còn cho phép tiện ích ghi lại những trang web nhạy cảm bị hạn chế, bao gồm cả các trang có lược đồ chrome:, trang của các tiện ích khác và URL dữ liệu. Bạn chỉ có thể ghi lại những trang web nhạy cảm này bằng quyền activeTab. Bạn chỉ có thể chụp URL của tệp nếu tiện ích đã được cấp quyền truy cập vào tệp.

Thông số

windowId

number không bắt buộc

Cửa sổ mục tiêu. Mặc định là cửa sổ hiện tại.
tùy chọn

ImageDetails không bắt buộc
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(dataUrl: string) => void
```
- dataUrl
  
  chuỗi
  
  Một URL dữ liệu mã hoá hình ảnh của vùng hiển thị của thẻ được chụp. Có thể được chỉ định cho thuộc tính "src" của phần tử img HTML để hiển thị.

Giá trị trả về

Promise<string>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
): runtime.Port

Kết nối với(các) tập lệnh nội dung trong thẻ được chỉ định. Sự kiện runtime.onConnect sẽ được kích hoạt trong mỗi tập lệnh nội dung đang chạy trong thẻ đã chỉ định cho tiện ích hiện tại. Để biết thêm thông tin chi tiết, hãy xem phần Content Script Messaging (Nhắn tin bằng tập lệnh nội dung).

Thông số

tabId

số
connectInfo

đối tượng không bắt buộc
- documentId
  
  chuỗi không bắt buộc
  
  Chrome 106 trở lên
  
  Mở một cổng đến một tài liệu cụ thể được xác định bằng documentId thay vì tất cả các khung trong thẻ.
- frameId
  
  number không bắt buộc
  
  Mở một cổng đến một khung cụ thể được xác định bằng frameId thay vì tất cả các khung trong thẻ.
- tên
  
  chuỗi không bắt buộc
  
  Được truyền vào onConnect cho các tập lệnh nội dung đang theo dõi sự kiện kết nối.

Giá trị trả về

runtime.Port

Một cổng có thể dùng để giao tiếp với các tập lệnh nội dung đang chạy trong thẻ đã chỉ định. Sự kiện runtime.Port của cổng sẽ được kích hoạt nếu thẻ đóng hoặc không tồn tại.

create()

Promise

chrome.tabs.create(
  createProperties: object,
  callback?: function,
): Promise<Tab>

Tạo một thẻ mới.

Thông số

createProperties

đối tượng
- hoạt động
  
  boolean không bắt buộc
  
  Liệu thẻ có nên trở thành thẻ đang hoạt động trong cửa sổ hay không. Không ảnh hưởng đến việc cửa sổ có được lấy tiêu điểm hay không (xem windows.update). Mặc định là true.
- index
  
  number không bắt buộc
  
  Vị trí mà thẻ sẽ chiếm trong cửa sổ. Giá trị được cung cấp sẽ được giới hạn trong khoảng từ 0 đến số lượng thẻ trong cửa sổ.
- openerTabId
  
  number không bắt buộc
  
  Mã của thẻ đã mở thẻ này. Nếu được chỉ định, thẻ mở phải nằm trong cùng một cửa sổ với thẻ mới tạo.
- được ghim
  
  boolean không bắt buộc
  
  Liệu thẻ có nên được ghim hay không. Mặc định là false.
- đã chọn
  
  boolean không bắt buộc
  
  Không dùng nữa
  
  Vui lòng sử dụng active.
  Thẻ có trở thành thẻ được chọn trong cửa sổ hay không. Mặc định là true.
- url
  
  chuỗi không bắt buộc
  
  URL để điều hướng thẻ đến ban đầu. URL đủ điều kiện phải bao gồm một lược đồ (tức là "http://www.google.com", chứ không phải "www.google.com"). URL tương đối là URL tương ứng với trang hiện tại trong tiện ích. Mặc định là Trang thẻ mới.
- windowId
  
  number không bắt buộc
  
  Cửa sổ để tạo thẻ mới. Mặc định là cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tab: Tab) => void
```
- phím tab
  
  Thẻ
  
  Thẻ đã tạo.

Giá trị trả về

Promise<Tab>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

detectLanguage()

Promise

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
): Promise<string>

Phát hiện ngôn ngữ chính của nội dung trong một thẻ.

Thông số

tabId

number không bắt buộc

Mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(language: string) => void
```
- language
  
  chuỗi
  
  Mã ngôn ngữ theo tiêu chuẩn ISO, chẳng hạn như en hoặc fr. Để xem danh sách đầy đủ các ngôn ngữ được phương thức này hỗ trợ, hãy xem kLanguageInfoTable. Hệ thống sẽ kiểm tra cột thứ hai đến cột thứ tư và trả về giá trị không phải là NULL đầu tiên, ngoại trừ tiếng Trung giản thể sẽ trả về zh-CN. Đối với ngôn ngữ không xác định, und sẽ được trả về.

Giá trị trả về

Promise<string>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

discard()

Promise Chrome 54 trở lên

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
): Promise<Tab | undefined>

Loại bỏ một thẻ khỏi bộ nhớ. Các thẻ bị loại bỏ vẫn xuất hiện trên dải thẻ và được tải lại khi bạn kích hoạt.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ cần loại bỏ. Nếu được chỉ định, thẻ sẽ bị loại bỏ trừ phi thẻ đang hoạt động hoặc đã bị loại bỏ. Nếu bị bỏ qua, trình duyệt sẽ loại bỏ thẻ ít quan trọng nhất. Thao tác này có thể không thành công nếu không có thẻ nào có thể loại bỏ.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tab?: Tab) => void
```
- phím tab
  
  Thẻ không bắt buộc
  
  Thẻ bị loại bỏ (nếu loại bỏ thành công); nếu không thì sẽ là undefined.

Giá trị trả về

Promise<Tab | undefined>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

duplicate()

Promise

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
): Promise<Tab | undefined>

Sao chép một thẻ.

Thông số

tabId

số

Mã của thẻ cần sao chép.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tab?: Tab) => void
```
- phím tab
  
  Thẻ không bắt buộc
  
  Thông tin chi tiết về thẻ trùng lặp. Các thuộc tính url, pendingUrl, title và favIconUrl chỉ được đưa vào đối tượng tabs.Tab nếu tiện ích có quyền "tabs" hoặc có quyền của máy chủ lưu trữ đối với trang.

Giá trị trả về

Promise<Tab | undefined>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

executeScript()

Promise &leq; MV2 Không dùng nữa kể từ Chrome 91

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<any[] | undefined>

Được thay thế bằng scripting.executeScript trong Manifest V3.

Chèn mã JavaScript vào một trang. Để biết thông tin chi tiết, hãy xem phần tiêm theo chương trình trong tài liệu về tập lệnh nội dung.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ mà bạn muốn chạy tập lệnh; mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
chi tiết

InjectDetails

Thông tin chi tiết về tập lệnh cần chạy. Bạn phải đặt mã hoặc thuộc tính tệp, nhưng không được đặt cả hai cùng một lúc.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(result?: any[]) => void
```
- kết quả
  
  any[] không bắt buộc
  
  Kết quả của tập lệnh trong mọi khung hình được chèn.

Giá trị trả về

Promise<any[] | undefined>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

get()

Promise

chrome.tabs.get(
  tabId: number,
  callback?: function,
): Promise<Tab>

Truy xuất thông tin chi tiết về thẻ được chỉ định.

Thông số

tabId

số
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tab: Tab) => void
```
- phím tab
  
  Thẻ

Giá trị trả về

Promise<Tab>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getAllInWindow()

Promise &leq; MV2 Không dùng nữa

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
): Promise<Tab[]>

Vui lòng sử dụng tabs.query {windowId: windowId}.

Lấy thông tin chi tiết về tất cả các thẻ trong cửa sổ đã chỉ định.

Thông số

windowId

number không bắt buộc

Mặc định là cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tabs: Tab[]) => void
```
- thẻ
  
  Tab[]

Giá trị trả về

Promise<Tab[]>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getCurrent()

Promise

chrome.tabs.getCurrent(
  callback?: function,
): Promise<Tab | undefined>

Lấy thẻ mà lệnh gọi tập lệnh này được thực hiện. Trả về undefined nếu được gọi từ một ngữ cảnh không phải thẻ (ví dụ: trang nền hoặc khung hiển thị bật lên).

Thông số

callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tab?: Tab) => void
```
- phím tab
  
  Thẻ không bắt buộc

Giá trị trả về

Promise<Tab | undefined>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getSelected()

Promise &leq; MV2 Không dùng nữa

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
): Promise<Tab>

Vui lòng sử dụng tabs.query {active: true}.

Lấy thẻ được chọn trong cửa sổ đã chỉ định.

Thông số

windowId

number không bắt buộc

Mặc định là cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tab: Tab) => void
```
- phím tab
  
  Thẻ

Giá trị trả về

Promise<Tab>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getZoom()

Promise

chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
): Promise<number>

Lấy hệ số thu phóng hiện tại của một thẻ cụ thể.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ để lấy hệ số thu phóng hiện tại; mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(zoomFactor: number) => void
```
- zoomFactor
  
  số
  
  Hệ số thu phóng hiện tại của thẻ.

Giá trị trả về

Promise<number>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getZoomSettings()

Promise

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
): Promise<ZoomSettings>

Lấy chế độ cài đặt thu phóng hiện tại của một thẻ cụ thể.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ để lấy chế độ cài đặt thu phóng hiện tại; mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(zoomSettings: ZoomSettings) => void
```
- zoomSettings
  
  ZoomSettings
  
  Chế độ cài đặt thu phóng hiện tại của thẻ.

Giá trị trả về

Promise<ZoomSettings>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

goBack()

Promise Chrome 72 trở lên

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
): Promise<void>

Quay lại trang trước (nếu có).

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ mà bạn muốn quay lại; mặc định là thẻ đã chọn của cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

goForward()

Promise Chrome 72 trở lên

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
): Promise<void>

Chuyển tiếp đến trang tiếp theo (nếu có).

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ để chuyển tiếp; mặc định là thẻ đã chọn của cửa sổ hiện tại.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

group()

Promise Chrome 88 trở lên

chrome.tabs.group(
  options: object,
  callback?: function,
): Promise<number>

Thêm một hoặc nhiều thẻ vào một nhóm cụ thể, hoặc nếu không có nhóm nào được chỉ định, hãy thêm các thẻ đã cho vào một nhóm mới tạo.

Thông số

tùy chọn

đối tượng
- createProperties
  
  đối tượng không bắt buộc
  
  Cấu hình để tạo nhóm. Không thể dùng nếu bạn đã chỉ định groupId.
  - windowId
    
    number không bắt buộc
    
    Cửa sổ của nhóm mới. Giá trị mặc định là cửa sổ hiện tại.
- groupId
  
  number không bắt buộc
  
  Mã của nhóm mà bạn muốn thêm thẻ vào. Nếu bạn không chỉ định, hệ thống sẽ tạo một nhóm mới.
- tabIds
  
  number | [number, ...number[]]
  
  Mã nhận dạng thẻ hoặc danh sách mã nhận dạng thẻ cần thêm vào nhóm được chỉ định.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(groupId: number) => void
```
- groupId
  
  số
  
  Mã nhận dạng của nhóm mà các thẻ được thêm vào.

Giá trị trả về

Promise<number>

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

highlight()

Promise

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
): Promise<windows.Window>

Làm nổi bật các thẻ đã cho và tập trung vào thẻ đầu tiên của nhóm. Sẽ không có gì xảy ra nếu thẻ được chỉ định hiện đang hoạt động.

Thông số

highlightInfo

đối tượng
- thẻ
  
  number | number[]
  
  Một hoặc nhiều chỉ mục thẻ cần làm nổi bật.
- windowId
  
  number không bắt buộc
  
  Cửa sổ chứa các thẻ.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(window: Window) => void
```
- cửa sổ
  
  Cửa sổ
  
  Chứa thông tin chi tiết về cửa sổ có các thẻ được làm nổi bật.

Giá trị trả về

Promise<windows.Window>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

insertCSS()

Promise &leq; MV2 Không dùng nữa kể từ Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<void>

Được thay thế bằng scripting.insertCSS trong Manifest V3.

Chèn CSS vào một trang. Bạn có thể xoá các kiểu được chèn bằng phương thức này bằng scripting.removeCSS. Để biết thông tin chi tiết, hãy xem phần tiêm theo chương trình trong tài liệu về tập lệnh nội dung.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ mà bạn muốn chèn CSS vào; mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
chi tiết

InjectDetails

Thông tin chi tiết về văn bản CSS cần chèn. Bạn phải đặt mã hoặc thuộc tính tệp, nhưng không được đặt cả hai cùng một lúc.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

move()

Promise

chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
): Promise<Tab | Tab[]>

Di chuyển một hoặc nhiều thẻ đến vị trí mới trong cửa sổ của thẻ đó hoặc đến một cửa sổ mới. Xin lưu ý rằng bạn chỉ có thể di chuyển các thẻ đến và đi từ các cửa sổ thông thường (window.type === "normal").

Thông số

tabIds

number | number[]

Mã nhận dạng thẻ hoặc danh sách mã nhận dạng thẻ cần di chuyển.
moveProperties

đối tượng
- index
  
  số
  
  Vị trí mà bạn muốn di chuyển cửa sổ đến. Sử dụng -1 để đặt thẻ ở cuối cửa sổ.
- windowId
  
  number không bắt buộc
  
  Mặc định là cửa sổ mà thẻ hiện đang ở trong.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tabs: Tab | Tab[]) => void
```
- thẻ
  
  Tab | Tab[]
  
  Thông tin chi tiết về các thẻ đã di chuyển.

Giá trị trả về

Promise<Tab | Tab[]>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

query()

Promise

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
): Promise<Tab[]>

Lấy tất cả các thẻ có thuộc tính được chỉ định hoặc tất cả các thẻ nếu không có thuộc tính nào được chỉ định.

Thông số

queryInfo

đối tượng
- hoạt động
  
  boolean không bắt buộc
  
  Liệu các thẻ có đang hoạt động trong cửa sổ của chúng hay không.
- audible
  
  boolean không bắt buộc
  
  Chrome 45 trở lên
  
  Liệu các thẻ có phát ra âm thanh hay không.
- autoDiscardable
  
  boolean không bắt buộc
  
  Chrome 54 trở lên
  
  Trình duyệt có thể tự động loại bỏ các thẻ khi tài nguyên thấp hay không.
- currentWindow
  
  boolean không bắt buộc
  
  Các thẻ có nằm trong cửa sổ hiện tại hay không.
- đã hủy
  
  boolean không bắt buộc
  
  Chrome 54 trở lên
  
  Liệu các thẻ có bị loại bỏ hay không. Thẻ bị loại bỏ là thẻ có nội dung đã được gỡ tải khỏi bộ nhớ nhưng vẫn xuất hiện trong dải thẻ. Nội dung của thành phần này sẽ được tải lại vào lần tiếp theo thành phần được kích hoạt.
- đóng băng
  
  boolean không bắt buộc
  
  Chrome 132 trở lên
  
  Các thẻ có bị đóng băng hay không. Thẻ bị đóng băng không thể thực hiện các tác vụ, bao gồm cả trình xử lý sự kiện hoặc bộ hẹn giờ. Thẻ này xuất hiện trong dải thẻ và nội dung của thẻ được tải vào bộ nhớ. Thiết bị sẽ được mở khoá khi bạn kích hoạt.
- groupId
  
  number không bắt buộc
  
  Chrome 88 trở lên
  
  Mã nhận dạng của nhóm chứa các thẻ hoặc tabGroups.TAB_GROUP_ID_NONE cho các thẻ không được nhóm.
- được làm nổi bật
  
  boolean không bắt buộc
  
  Các thẻ có được đánh dấu hay không.
- index
  
  number không bắt buộc
  
  Vị trí của các thẻ trong cửa sổ.
- lastFocusedWindow
  
  boolean không bắt buộc
  
  Các thẻ có nằm trong cửa sổ gần đây nhất mà người dùng đã đặt tiêu điểm hay không.
- đã tắt tiếng
  
  boolean không bắt buộc
  
  Chrome 45 trở lên
  
  Thẻ có bị tắt tiếng hay không.
- được ghim
  
  boolean không bắt buộc
  
  Các thẻ có được ghim hay không.
- splitViewId
  
  number không bắt buộc
  
  Chrome 140 trở lên
  
  Mã nhận dạng của Chế độ xem phân tách mà các thẻ đang ở trong đó hoặc tabs.SPLIT_VIEW_ID_NONE đối với các thẻ không ở trong Chế độ xem phân tách.
- trạng thái
  
  TabStatus không bắt buộc
  
  Trạng thái tải của thẻ.
- tiêu đề
  
  chuỗi không bắt buộc
  
  So khớp tiêu đề trang với một mẫu. Thuộc tính này sẽ bị bỏ qua nếu tiện ích không có quyền "tabs" hoặc quyền truy cập vào máy chủ lưu trữ cho trang.
- url
  
  string | string[] không bắt buộc
  
  So khớp các thẻ với một hoặc nhiều mẫu URL. Giá trị nhận dạng theo đoạn không khớp. Thuộc tính này sẽ bị bỏ qua nếu tiện ích không có quyền "tabs" hoặc quyền truy cập vào máy chủ lưu trữ cho trang.
- windowId
  
  number không bắt buộc
  
  Mã nhận dạng của cửa sổ mẹ hoặc windows.WINDOW_ID_CURRENT cho cửa sổ hiện tại.
- windowType
  
  WindowType không bắt buộc
  
  Loại cửa sổ mà các thẻ nằm trong đó.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(result: Tab[]) => void
```
- kết quả
  
  Tab[]

Giá trị trả về

Promise<Tab[]>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

reload()

Promise

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
): Promise<void>

Tải lại thẻ.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ cần tải lại; mặc định là thẻ đã chọn của cửa sổ hiện tại.
reloadProperties

đối tượng không bắt buộc
- bypassCache
  
  boolean không bắt buộc
  
  Có bỏ qua tính năng lưu vào bộ nhớ đệm cục bộ hay không. Giá trị mặc định là false.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

remove()

Promise

chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
): Promise<void>

Đóng một hoặc nhiều thẻ.

Thông số

tabIds

number | number[]

Mã nhận dạng thẻ hoặc danh sách mã nhận dạng thẻ cần đóng.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

removeCSS()

Promise Chrome 87 trở lên &leq; MV2 Không dùng nữa kể từ Chrome 91

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
): Promise<void>

Được thay thế bằng scripting.removeCSS trong Manifest V3.

Xoá CSS khỏi trang mà trước đó đã được chèn bằng lệnh gọi đến scripting.insertCSS.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ mà bạn muốn xoá CSS; mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
chi tiết

DeleteInjectionDetails

Thông tin chi tiết về văn bản CSS cần xoá. Bạn phải đặt mã hoặc thuộc tính tệp, nhưng không được đặt cả hai cùng một lúc.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

sendMessage()

Promise

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
): Promise<any>

Gửi một tin nhắn duy nhất đến(các) tập lệnh nội dung trong thẻ được chỉ định, kèm theo một lệnh gọi lại không bắt buộc để chạy khi một phản hồi được gửi lại. Sự kiện runtime.onMessage sẽ được kích hoạt trong mỗi tập lệnh nội dung đang chạy trong thẻ đã chỉ định cho tiện ích hiện tại.

Thông số

tabId

số
tin nhắn

bất kỳ

Tin nhắn cần gửi. Thông báo này phải là một đối tượng có thể chuyển đổi thành JSON.
tùy chọn

đối tượng không bắt buộc
- documentId
  
  chuỗi không bắt buộc
  
  Chrome 106 trở lên
  
  Gửi thông báo đến một tài liệu cụ thể được xác định bằng documentId thay vì tất cả các khung trong thẻ.
- frameId
  
  number không bắt buộc
  
  Gửi một thông báo đến một khung cụ thể được xác định bằng frameId thay vì tất cả các khung trong thẻ.
callback

hàm không bắt buộc

Chrome 99 trở lên

Tham số callback có dạng như sau:
```
(response: any) => void
```
- phản hồi
  
  bất kỳ
  
  Đối tượng phản hồi JSON do trình xử lý của thông báo gửi. Nếu xảy ra lỗi trong khi kết nối với thẻ được chỉ định, lệnh gọi lại sẽ được gọi mà không có đối số và runtime.lastError được đặt thành thông báo lỗi.

Giá trị trả về

Promise<any>

Chrome 99 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

sendRequest()

Promise &leq; MV2 Không dùng nữa

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
): Promise<any>

Vui lòng sử dụng runtime.sendMessage.

Gửi một yêu cầu duy nhất đến(các) tập lệnh nội dung trong thẻ được chỉ định, kèm theo một lệnh gọi lại không bắt buộc để chạy khi một phản hồi được gửi lại. Sự kiện extension.onRequest sẽ được kích hoạt trong mỗi tập lệnh nội dung đang chạy trong thẻ đã chỉ định cho tiện ích hiện tại.

Thông số

tabId

số
request

bất kỳ
callback

hàm không bắt buộc

Chrome 99 trở lên

Tham số callback có dạng như sau:
```
(response: any) => void
```
- phản hồi
  
  bất kỳ
  
  Đối tượng phản hồi JSON do trình xử lý yêu cầu gửi. Nếu xảy ra lỗi trong khi kết nối với thẻ được chỉ định, lệnh gọi lại sẽ được gọi mà không có đối số và runtime.lastError được đặt thành thông báo lỗi.

Giá trị trả về

Promise<any>

Chrome 99 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setZoom()

Promise

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
): Promise<void>

Phóng to một thẻ cụ thể.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ cần thu phóng; mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
zoomFactor

số

Hệ số thu phóng mới. Giá trị 0 sẽ đặt thẻ về hệ số thu phóng mặc định hiện tại. Các giá trị lớn hơn 0 chỉ định hệ số thu phóng (có thể không phải là hệ số mặc định) cho thẻ.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setZoomSettings()

Promise

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
): Promise<void>

Đặt chế độ cài đặt thu phóng cho một thẻ cụ thể, xác định cách xử lý các thay đổi về mức thu phóng. Các chế độ cài đặt này sẽ được đặt lại về mặc định khi bạn chuyển đến thẻ này.

Thông số

tabId

number không bắt buộc

Mã nhận dạng của thẻ cần thay đổi chế độ cài đặt thu phóng; mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
zoomSettings

ZoomSettings

Xác định cách xử lý các thay đổi về mức thu phóng và phạm vi áp dụng.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

ungroup()

Promise Chrome 88 trở lên

chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
): Promise<void>

Xoá một hoặc nhiều thẻ khỏi các nhóm tương ứng. Nếu có nhóm nào không có thành viên, nhóm đó sẽ bị xoá.

Thông số

tabIds

number | [number, ...number[]]

Mã thẻ hoặc danh sách mã thẻ cần xoá khỏi các nhóm tương ứng.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
() => void
```

Giá trị trả về

Promise<void>

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

update()

Promise

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
): Promise<Tab | undefined>

Sửa đổi các thuộc tính của một thẻ. Những thuộc tính không được chỉ định trong updateProperties sẽ không được sửa đổi.

Thông số

tabId

number không bắt buộc

Mặc định là thẻ được chọn của cửa sổ hiện tại.
updateProperties

đối tượng
- hoạt động
  
  boolean không bắt buộc
  
  Cho biết thẻ có nên ở trạng thái hoạt động hay không. Không ảnh hưởng đến việc cửa sổ có được lấy tiêu điểm hay không (xem windows.update).
- autoDiscardable
  
  boolean không bắt buộc
  
  Chrome 54 trở lên
  
  Liệu trình duyệt có tự động loại bỏ thẻ khi tài nguyên thấp hay không.
- được làm nổi bật
  
  boolean không bắt buộc
  
  Thêm hoặc xoá thẻ khỏi vùng chọn hiện tại.
- đã tắt tiếng
  
  boolean không bắt buộc
  
  Chrome 45 trở lên
  
  Thẻ có nên bị tắt tiếng hay không.
- openerTabId
  
  number không bắt buộc
  
  Mã của thẻ đã mở thẻ này. Nếu được chỉ định, thẻ mở phải nằm trong cùng một cửa sổ với thẻ này.
- được ghim
  
  boolean không bắt buộc
  
  Liệu thẻ có nên được ghim hay không.
- đã chọn
  
  boolean không bắt buộc
  
  Không dùng nữa
  
  Vui lòng sử dụng phần được đánh dấu.
  Có nên chọn thẻ này hay không.
- url
  
  chuỗi không bắt buộc
  
  URL để điều hướng thẻ đến. Không hỗ trợ URL JavaScript; hãy sử dụng scripting.executeScript.
callback

hàm không bắt buộc

Tham số callback có dạng như sau:
```
(tab?: Tab) => void
```
- phím tab
  
  Thẻ không bắt buộc
  
  Thông tin chi tiết về thẻ mới cập nhật. Các thuộc tính url, pendingUrl, title và favIconUrl chỉ được đưa vào đối tượng tabs.Tab nếu tiện ích có quyền "tabs" hoặc có quyền của máy chủ lưu trữ đối với trang.

Giá trị trả về

Promise<Tab | undefined>

Chrome 88 trở lên

Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

Sự kiện này xảy ra khi thẻ đang hoạt động trong một cửa sổ thay đổi. Xin lưu ý rằng URL của thẻ có thể chưa được đặt tại thời điểm sự kiện này kích hoạt, nhưng bạn có thể theo dõi các sự kiện onUpdated để nhận thông báo khi URL được đặt.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(activeInfo: object) => void
```
- activeInfo
  
  đối tượng
  - tabId
    
    số
    
    Mã của thẻ đã trở thành thẻ đang hoạt động.
  - windowId
    
    số
    
    Mã nhận dạng của cửa sổ mà thẻ đang hoạt động đã thay đổi.

onActiveChanged

&leq; MV2 Không dùng nữa

chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Vui lòng sử dụng tabs.onActivated.

Sự kiện này xảy ra khi thẻ được chọn trong một cửa sổ thay đổi. Xin lưu ý rằng URL của thẻ có thể chưa được đặt tại thời điểm sự kiện này kích hoạt, nhưng bạn có thể theo dõi các sự kiện tabs.onUpdated để nhận được thông báo khi một URL được đặt.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tabId: number, selectInfo: object) => void
```
- tabId
  
  số
- selectInfo
  
  đối tượng
  - windowId
    
    số
    
    Mã nhận dạng của cửa sổ mà thẻ đã chọn thay đổi bên trong.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

Được kích hoạt khi một thẻ được đính kèm vào một cửa sổ; ví dụ: vì thẻ đó đã được di chuyển giữa các cửa sổ.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tabId: number, attachInfo: object) => void
```
- tabId
  
  số
- attachInfo
  
  đối tượng
  - newPosition
    
    số
  - newWindowId
    
    số

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

Được kích hoạt khi một thẻ được tạo. Xin lưu ý rằng URL của thẻ và tư cách thành viên nhóm thẻ có thể chưa được đặt tại thời điểm sự kiện này được kích hoạt, nhưng bạn có thể theo dõi các sự kiện onUpdated để được thông báo khi một URL được đặt hoặc thẻ được thêm vào một nhóm thẻ.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tab: Tab) => void
```
- phím tab
  
  Thẻ

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

Được kích hoạt khi một thẻ bị tách khỏi cửa sổ; ví dụ: vì thẻ đó đã được di chuyển giữa các cửa sổ.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tabId: number, detachInfo: object) => void
```
- tabId
  
  số
- detachInfo
  
  đối tượng
  - oldPosition
    
    số
  - oldWindowId
    
    số

onHighlightChanged

&leq; MV2 Không dùng nữa

chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Vui lòng sử dụng tabs.onHighlighted.

Kích hoạt khi các thẻ được đánh dấu hoặc chọn trong một cửa sổ thay đổi.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(selectInfo: object) => void
```
- selectInfo
  
  đối tượng
  - tabIds
    
    number[]
    
    Tất cả các thẻ được đánh dấu trong cửa sổ.
  - windowId
    
    số
    
    Cửa sổ có các thẻ đã thay đổi.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

Kích hoạt khi các thẻ được đánh dấu hoặc chọn trong một cửa sổ thay đổi.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(highlightInfo: object) => void
```
- highlightInfo
  
  đối tượng
  - tabIds
    
    number[]
    
    Tất cả các thẻ được đánh dấu trong cửa sổ.
  - windowId
    
    số
    
    Cửa sổ có các thẻ đã thay đổi.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

Được kích hoạt khi một thẻ được di chuyển trong một cửa sổ. Chỉ có một sự kiện di chuyển được kích hoạt, đại diện cho thẻ mà người dùng đã di chuyển trực tiếp. Sự kiện di chuyển không được kích hoạt cho các thẻ khác phải di chuyển để phản hồi thẻ được di chuyển theo cách thủ công. Sự kiện này không được kích hoạt khi một thẻ được di chuyển giữa các cửa sổ; để biết thông tin chi tiết, hãy xem tabs.onDetached.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tabId: number, moveInfo: object) => void
```
- tabId
  
  số
- moveInfo
  
  đối tượng
  - fromIndex
    
    số
  - toIndex
    
    số
  - windowId
    
    số

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

Được kích hoạt khi một thẻ bị đóng.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tabId: number, removeInfo: object) => void
```
- tabId
  
  số
- removeInfo
  
  đối tượng
  - isWindowClosing
    
    boolean
    
    Đúng khi thẻ bị đóng do cửa sổ mẹ của thẻ bị đóng.
  - windowId
    
    số
    
    Cửa sổ có thẻ bị đóng.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

Sự kiện này xảy ra khi một thẻ được thay thế bằng một thẻ khác do tính năng kết xuất trước hoặc tính năng tức thì.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(addedTabId: number, removedTabId: number) => void
```
- addedTabId
  
  số
- removedTabId
  
  số

onSelectionChanged

&leq; MV2 Không dùng nữa

chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Vui lòng sử dụng tabs.onActivated.

Sự kiện này xảy ra khi thẻ được chọn trong một cửa sổ thay đổi.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tabId: number, selectInfo: object) => void
```
- tabId
  
  số
- selectInfo
  
  đối tượng
  - windowId
    
    số
    
    Mã nhận dạng của cửa sổ mà thẻ đã chọn thay đổi bên trong.

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

Được kích hoạt khi một thẻ được cập nhật.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(tabId: number, changeInfo: object, tab: Tab) => void
```
- tabId
  
  số
- changeInfo
  
  đối tượng
  - audible
    
    boolean không bắt buộc
    
    Chrome 45 trở lên
    
    Trạng thái âm thanh mới của thẻ.
  - autoDiscardable
    
    boolean không bắt buộc
    
    Chrome 54 trở lên
    
    Trạng thái mới có thể tự động loại bỏ của thẻ.
  - đã hủy
    
    boolean không bắt buộc
    
    Chrome 54 trở lên
    
    Trạng thái mới bị loại bỏ của thẻ.
  - favIconUrl
    
    chuỗi không bắt buộc
    
    URL biểu tượng trang web mới của thẻ.
  - đóng băng
    
    boolean không bắt buộc
    
    Chrome 132 trở lên
    
    Trạng thái đóng băng mới của thẻ.
  - groupId
    
    number không bắt buộc
    
    Chrome 88 trở lên
    
    Nhóm mới của thẻ.
  - mutedInfo
    
    MutedInfo không bắt buộc
    
    Chrome 46 trở lên
    
    Trạng thái tắt tiếng mới của thẻ và lý do thay đổi.
  - được ghim
    
    boolean không bắt buộc
    
    Trạng thái ghim mới của thẻ.
  - splitViewId
    
    number không bắt buộc
    
    Chrome 140 trở lên
    
    Chế độ xem phân tách mới của thẻ.
  - trạng thái
    
    TabStatus không bắt buộc
    
    Trạng thái tải của thẻ.
  - tiêu đề
    
    chuỗi không bắt buộc
    
    Chrome 48 trở lên
    
    Tiêu đề mới của thẻ.
  - url
    
    chuỗi không bắt buộc
    
    URL của thẻ nếu URL đó đã thay đổi.
- phím tab
  
  Thẻ

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

Được kích hoạt khi một thẻ được phóng to.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(ZoomChangeInfo: object) => void
```
- ZoomChangeInfo
  
  đối tượng
  - newZoomFactor
    
    số
  - oldZoomFactor
    
    số
  - tabId
    
    số
  - zoomSettings
    
    ZoomSettings

chrome.tabs Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Mô tả

Tổng quan

Quyền

Tệp kê khai

Trường hợp sử dụng

Mở trang tiện ích trong thẻ mới

Lấy thẻ hiện tại

Tắt tiếng thẻ được chỉ định

Di chuyển thẻ hiện tại đến vị trí đầu tiên khi nhấp vào

Truyền thông báo đến tập lệnh nội dung của thẻ đã chọn

Ví dụ về tiện ích

Loại

MutedInfo

Thuộc tính

MutedInfoReason

Enum

Tab

Thuộc tính

TabStatus

Enum

WindowType

Enum

ZoomSettings

Thuộc tính

ZoomSettingsMode

Enum

ZoomSettingsScope

Enum

Thuộc tính

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Giá trị

TAB_ID_NONE

Giá trị

TAB_INDEX_NONE

Giá trị

Phương thức

captureVisibleTab()

Thông số

Giá trị trả về

connect()

Thông số

Giá trị trả về

create()

Thông số

Giá trị trả về

detectLanguage()

Thông số

Giá trị trả về

discard()

Thông số

Giá trị trả về

duplicate()

Thông số

Giá trị trả về

executeScript()

Thông số

Giá trị trả về

get()

Thông số

Giá trị trả về

getAllInWindow()

Thông số

Giá trị trả về

getCurrent()

Thông số

Giá trị trả về

getSelected()

Thông số

Giá trị trả về

getZoom()

Thông số

Giá trị trả về

getZoomSettings()

Thông số

Giá trị trả về

goBack()

Thông số

Giá trị trả về

goForward()

chrome.tabs