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ể sử 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 language của thẻ, chụp ảnh chụp màn hình và giao tiếp bằng 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 nào để sử dụng. Ví dụ: tạo một thẻ mới, tải lại một thẻ, chuyển hướng đế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 API Thẻ.

"Thẻ" quyền: 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 đó, cấp cho tiện ích khả năng gọi tabs.query() với 4 thuộc tính nhạy cảm trên thực thể tabs.Tab: url, pendingUrl, title và favIconUrl.
Quyền của máy chủ: Quyền của máy chủ lưu trữ cho phép tiện ích đọc và truy vấn bốn dữ liệu nhạy cảm của một thẻ trùng khớp Tài sản tabs.Tab. Chúng cũng có thể tương tác trực tiếp với các thẻ trùng khớp bằng các phương thức như dưới tên tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() và tabs.removeCSS().
Thẻ "activeTab" quyền: activeTab cấp quyền lưu trữ tạm thời cho tiện ích cho thẻ hiện tại trong phản hồi lệnh gọi của người dùng. Không giống như quyền của máy chủ, activeTab không kích hoạt cảnh bá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ô hình phổ biến cho tiện ích là mở trang giới thiệu trong thẻ mới khi tiện ích đang . Ví dụ sau đây trình bà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"
    });
  }
});

Tải 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ổ được lấy tiêu điểm hiện tại (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). Chiến dịch này thường có thể được coi 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 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 được nhấp vào

Ví dụ này cho biết cách di chuyển thẻ 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, bạn có thể sử dụng cùng một mẫu chờ cho các cuộc gọi khác có sửa đổi thẻ trong khi đang kéo.

  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.");
      }
    });
  }

Chuyển thư đế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 một tiện ích có thể giao tiếp với tập lệnh nội dung trong các thẻ trình duyệt cụ thể bằ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ề phần mở rộng

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

Loại

MutedInfo

Chrome 46 trở lên

Trạng thái bị tắt tiếng của thẻ và lý do 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ã của tiện ích đã thay đổi trạng thái tắt tiếng. Không được đặt nếu một tiện ích 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

Liệu thẻ có bị tắt tiếng (ngăn phát âm thanh) hay không. Thẻ này 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 thuộc tính "tắt tiếng" chỉ báo âm thanh đang hiển thị.
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 từng thay đổi.

MutedInfoReason

Chrome 46 trở lên

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

Enum

"người dùng"
Thao tác nhập của người dùng đặt trạng thái tắt tiếng.

"capture"
Bắt đầu chụp thẻ, buộc thay đổi trạng thái tắt tiếng.

"extension"
Một tiện ích, được xác định trong trường extensionsId, đặt trạng thái tắt tiếng.

Tab

Thuộc tính

hoạt động

boolean

Liệu 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ổ được lấy làm tâm điểm.
audible

boolean không bắt buộc

Chrome 45 trở lên

Thẻ có tạo ra âm thanh trong vài giây qua hay không (nhưng có thể không nghe thấy nếu cũng tắt tiếng). Tương đương với việc "âm thanh của loa" đang hiển thị.
autoDiscardable

boolean

Chrome 54 trở lên

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

boolean

Chrome 54 trở lên

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

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

URL biểu tượng trang web của thẻ. Thuộc tính này chỉ xuất hiện nếu tệp kê khai của tiện ích bao gồm quyền "tabs". Đó cũng có thể là một chuỗi trống nếu thẻ đang tải.
groupId

số

Chrome 88 trở lên

Mã của nhóm chứa thẻ.
độ cao

số 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

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

số 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, một 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, mã phiên có thể sẽ xuất hiện. Bạn cũng có thể đặt mã thẻ thành chrome.tabs.TAB_ID_NONE đối với cửa sổ ứng dụng và cửa sổ công cụ cho nhà phát triển.
ẩn danh

boolean

Liệu thẻ có ở trong cửa sổ ẩn danh hay không.
index

số

Chỉ mục gốc 0 của thẻ trong cửa sổ của thẻ.
lastAccessed

số

Chrome 121 trở lên

Lần gần đây nhất thẻ được truy cập vào thẻ này dưới dạ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 bị tắt tiếng của thẻ và lý do thay đổi trạng thái gần đây nhất.
openerTabId

số 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ẻ trình 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 xác nhận. Thuộc tính này chỉ xuất hiện nếu tệp kê khai của tiện ích bao gồm quyền "tabs" và có một nội dung điều hướng đang chờ xử lý.
được ghim

boolean

Liệu 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.
Liệu thẻ có được chọn hay không.
sessionId

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

Mã phiên được dùng để xác định riêng biệt một thẻ lấy 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 tệp kê khai của tiện ích bao gồm quyền "tabs".
url

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

URL được cam kết cuối cùng trong khung chính của thẻ. Thuộc tính này chỉ xuất hiện nếu tệp kê khai của tiện ích bao gồm quyền "tabs" và 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

số 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

"unload"

"đang tải"

"hoàn tất"

WindowType

Chrome 44 trở lên

Loại cửa sổ.

Enum

"normal" (bình thường)

"bật lên"

"bảng điều khiển"

"ứng dụng"

"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

số không bắt buộc

Chrome 43 trở lên

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 tab.getZoomSettings.
chế độ

ZoomSettingsMode optional

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 vẫn tồn tại đối với nguồn gốc của trang hay chỉ có hiệu lực trong thẻ này; giá trị mặc định là per-origin khi ở chế độ automatic và per-tab nếu không được bật.

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

"tự động"
Các thay đổi đối với mức thu phóng được trình duyệt xử lý tự động.

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

"disabled"
Tắt tất cả tính năng thu phóng trong thẻ. Thẻ này sẽ chuyển về mức thu phóng mặc định và mọi thay đổi đã thử thu phóng sẽ bị bỏ qua.

ZoomSettingsScope

Chrome 44 trở lên

Xác định xem các thay đổi về mức thu phóng vẫn tồn tại đối với nguồn gốc của trang hay chỉ có hiệu lực trong thẻ này; giá trị mặc định là per-origin khi ở chế độ automatic và per-tab nếu không được bật.

Enum

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

"trên mỗi thẻ"
Các thay đổi đối với chế độ thu phóng chỉ có hiệu lực trong thẻ này và các thay đổi đối với tính năng thu phóng trên các thẻ khác không ảnh hưởng đến việc thu phóng thẻ này. Ngoài ra, những thay đổi về mức thu phóng của per-tab sẽ được đặt lại trong quá trình điều hướng; thao tác điều hướng một thẻ sẽ luôn tải trang theo 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 có thể gọi captureVisibleTab mỗi giây. captureVisibleTab rất tốn kém và không nên được gọi quá thường xuyên.

Giá trị

TAB_ID_NONE

Chrome 46 trở lên

Mã nhận dạng thể hiện việc không có thẻ trình duyệt.

Giá trị

-1

TAB_INDEX_NONE

Chrome 123 trở lên

Chỉ mục biểu thị việc không có chỉ mục thẻ trong dải_thẻ.

Giá trị

-1

Phương thức

captureVisibleTab()

Lời hứa

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

Chụp khu vực hiển thị của thẻ hiện đang hoạt động trong cửa sổ được 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 các trang web mà tiện ích có thể truy cập bình thường, phương pháp này cho phép tiện ích ghi lại các trang web nhạy cảm bị hạn chế theo cách khác, bao gồm các trang chrome:-giaothuc, các tiện ích khác" và dữ liệu: URL. Chỉ có thể thu thập các trang web nhạy cảm này khi có quyền ActiveTab. URL tệp chỉ có thể được ghi lại nếu đuôi tệp đã được cấp quyền truy cập vào tệp.

Tham số

windowId

số không bắt buộc

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

ImageDetails không bắt buộc
số gọi lại

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

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

Giá trị trả về

Cam kết<string>

Chrome 88 trở lên

Lời hứa 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,
)

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 được kích hoạt trong mỗi tập lệnh nội dung chạy trong thẻ được 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 Thông báo tập lệnh nội dung.

Tham 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ở cổng đến một tài liệu cụ thể do documentId xác định thay vì tất cả các khung trong thẻ.
- frameId
  
  số không bắt buộc
  
  Mở một cổng đến một khung cụ thể do frameId xác định 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 đối với 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

Cổng có thể dùng để giao tiếp với 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()

Lời hứa

chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

Tạo thẻ mới.

Tham số

createProperties

đối tượng
- hoạt động
  
  boolean không bắt buộc
  
  Thẻ có trở thành thẻ 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 làm tâm điểm hay không (xem windows.update). Giá trị mặc định là true.
- index
  
  số không bắt buộc
  
  Vị trí mà thẻ sẽ chọn trong cửa sổ. Giá trị bạn cung cấp được giới hạn trong khoảng từ 0 đến số lượng thẻ trong cửa sổ.
- openerTabId
  
  số 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 có nên ghim thẻ 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 hộp đánh dấu đang hoạt động.
  Liệu 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 để chuyển thẻ sang lúc ban đầu. Các URL đủ điều kiện phải chứa một lược đồ (nghĩa là "http://www.google.com", không phải "www.google.com"). URL tương đối tương đối so với trang hiện tại trong phần mở rộng. Giá trị mặc định là trang Thẻ mới.
- windowId
  
  số không bắt buộc
  
  Cửa sổ để tạo thẻ mới. Giá trị mặc định là cửa sổ hiện tại.
số gọi lại

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

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

Giá trị trả về

Cam kết<Tab>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

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

Tham số

tabId

số không bắt buộc

Giá trị mặc định là thẻ đang hoạt động của cửa sổ hiện tại.
số gọi lại

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

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

Giá trị trả về

Cam kết<string>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa Chrome 54 trở lên

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

Loại bỏ một thẻ khỏi kỷ niệm. Các thẻ đã bị hủy vẫn hiển thị trên dải thẻ và sẽ được tải lại khi kích hoạt.

Tham số

tabId

số không bắt buộc

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

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

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

Giá trị trả về

Cam kết<Tab | không xác định>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

Sao chép một thẻ.

Tham số

tabId

số

Mã của thẻ cần sao chép.
số gọi lại

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

Tham số callback sẽ 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ẻ bị trùng lặp. Đối tượng tabs.Tab không chứa url, pendingUrl, title và favIconUrl nếu chưa yêu cầu quyền "tabs".

Giá trị trả về

Cam kết<Tab | không xác định>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa &leq; MV2 Không được dùng nữa kể từ Chrome 91

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

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 chèn có lập trình trong tài liệu tập lệnh nội dung.

Tham số

tabId

số 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; đặt mặc định thành 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 mã cùng một lúc.
số gọi lại

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

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

Giá trị trả về

Promise<any[] | không xác định>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.get(
  tabId: number,
  callback?: function,
)

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

Tham số

tabId

số
số gọi lại

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

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

Giá trị trả về

Cam kết<Tab>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa &leq; MV2 Không dùng nữa

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

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ổ được chỉ định.

Tham số

windowId

số không bắt buộc

Giá trị mặc định là cửa sổ hiện tại.
số gọi lại

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

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

Giá trị trả về

Cam kết<Tab[]>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.getCurrent(
  callback?: function,
)

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

Tham số

số gọi lại

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

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

Giá trị trả về

Cam kết<Tab | không xác định>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa &leq; MV2 Không dùng nữa

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

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

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

Tham số

windowId

số không bắt buộc

Giá trị mặc định là cửa sổ hiện tại.
số gọi lại

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

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

Giá trị trả về

Cam kết<Tab>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

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

Lấy hệ số thu phóng hiện tại của một thẻ đã chỉ định.

Tham số

tabId

số không bắt buộc

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

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

Tham số callback sẽ 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

Lời hứa 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()

Lời hứa

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

Xem chế độ cài đặt thu phóng hiện tại của một thẻ đã chỉ định.

Tham số

tabId

số 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; đặt mặc định thành thẻ đang hoạt động của cửa sổ hiện tại.
số gọi lại

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

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

Giá trị trả về

Promise<ZoomSettings>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa Chrome 72 trở lên

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

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

Tham số

tabId

số không bắt buộc

Mã nhận dạng của thẻ để điều hướng trở lại; đặt mặc định là thẻ đã chọn của cửa sổ hiện tại.
số gọi lại

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa Chrome 72 trở lên

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Hãy chuyển sang trang tiếp theo, nếu có.

Tham số

tabId

số không bắt buộc

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

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa Chrome 88 trở lên

chrome.tabs.group(
  options: object,
  callback?: function,
)

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

Tham số

tùy chọn

đối tượng
- createProperties
  
  đối tượng không bắt buộc
  
  Cấu hình để tạo một nhóm. Không thể sử dụng nếu groupId đã được chỉ định.
  - windowId
    
    số 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
  
  số không bắt buộc
  
  Mã của nhóm mà bạn sẽ thêm thẻ vào. Nếu bạn không chỉ định, một nhóm mới sẽ được tạo.
- tabIds
  
  số | [số, ...số[]]
  
  Mã thẻ hoặc danh sách mã thẻ cần thêm vào nhóm được chỉ định.
số gọi lại

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

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

Giá trị trả về

Promise<number>

Lời hứa 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()

Lời hứa

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

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

Tham số

highlightInfo

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

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

Tham số callback sẽ 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 đánh dấu.

Giá trị trả về

Promise<windows.Window>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa &leq; MV2 Không được dùng nữa kể từ Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

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 chèn có lập trình trong tài liệu tập lệnh nội dung.

Tham số

tabId

số không bắt buộc

Mã của thẻ cần chèn CSS; đặt mặc định thành 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 mã cùng một lúc.
số gọi lại

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

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

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

Tham số

tabIds

số | số[]

Mã thẻ hoặc danh sách mã thẻ cần di chuyển.
moveProperties

đối tượng
- index
  
  số
  
  Vị trí để di chuyển cửa sổ đến. Dùng -1 để đặt thẻ ở cuối cửa sổ.
- windowId
  
  số không bắt buộc
  
  Giá trị mặc định là cửa sổ mà thẻ hiện đang truy cập.
số gọi lại

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

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

Giá trị trả về

Cam kết<Tab | Thẻ[]>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

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

Tham 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ó bật âm thanh hay không.
- autoDiscardable
  
  boolean không bắt buộc
  
  Chrome 54 trở lên
  
  Liệu trình duyệt có thể tự động huỷ các thẻ khi tài nguyên sắp hết hay không.
- currentWindow
  
  boolean không bắt buộc
  
  Liệu 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ị huỷ hay không. Thẻ bị huỷ là thẻ có nội dung đã bị huỷ tải khỏi bộ nhớ nhưng vẫn hiển thị trong dải thẻ. Nội dung của thẻ này sẽ được tải lại vào lần kích hoạt tiếp theo.
- groupId
  
  số không bắt buộc
  
  Chrome 88 trở lên
  
  Mã của nhóm chứa các thẻ đó hoặc tabGroups.TAB_GROUP_ID_NONE đối với các thẻ chưa được nhóm.
- được làm nổi bật
  
  boolean không bắt buộc
  
  Liệu các thẻ có được làm nổi bật hay không.
- index
  
  số không bắt buộc
  
  Vị trí của các thẻ trong cửa sổ của chúng.
- lastFocusedWindow
  
  boolean không bắt buộc
  
  Liệu các thẻ có nằm trong cửa sổ được lấy tiêu điểm gần đây nhất hay không.
- đã tắt tiếng
  
  boolean không bắt buộc
  
  Chrome 45 trở lên
  
  Liệu các thẻ có bị tắt tiếng hay không.
- được ghim
  
  boolean không bắt buộc
  
  Liệu các thẻ có được ghim hay không.
- trạng thái
  
  TabStatus không bắt buộc
  
  Trạng thái tải thẻ.
- tiêu đề
  
  chuỗi không bắt buộc
  
  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".
- url
  
  string | string[] không bắt buộc
  
  Khớp thẻ với một hoặc nhiều mẫu URL. Giá trị nhận dạng của mảnh 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".
- windowId
  
  số không bắt buộc
  
  Mã của cửa sổ chính hoặc windows.WINDOW_ID_CURRENT của cửa sổ hiện tại.
- windowType
  
  WindowType không bắt buộc
  
  Loại cửa sổ chứa các thẻ.
số gọi lại

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

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

Giá trị trả về

Cam kết<Tab[]>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Tải lại một thẻ.

Tham số

tabId

số không bắt buộc

Mã của thẻ cần tải lại; đặt 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
  
  Liệu có bỏ qua lưu vào bộ nhớ đệm cục bộ hay không. Giá trị mặc định là false.
số gọi lại

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

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

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

Tham số

tabIds

số | số[]

Mã thẻ hoặc danh sách mã thẻ cần đóng.
số gọi lại

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa Chrome 87 trở lên &leq; MV2 Không được dùng nữa kể từ Chrome 91

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Thay thế bằng scripting.removeCSS trong Manifest V3.

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

Tham số

tabId

số không bắt buộc

Mã của thẻ mà bạn cần xoá CSS; đặt mặc định thành 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 mã cùng một lúc.
số gọi lại

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

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

Gửi một thông báo đến(các) tập lệnh nội dung trong thẻ được chỉ định, kèm theo 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 được kích hoạt trong mỗi tập lệnh nội dung chạy trong thẻ được chỉ định cho tiện ích hiện tại.

Tham 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à đối tượng có thể định dạng 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ư đến một tài liệu cụ thể do documentId xác định thay vì tất cả các khung trong thẻ.
- frameId
  
  số không bắt buộc
  
  Gửi thông báo đến một khung cụ thể do frameId xác định thay vì tất cả các khung trong thẻ.
số gọi lại

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

Chrome 99 trở lên

Tham số callback sẽ 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ý thông báo gửi. Nếu xảy ra lỗi trong khi kết nối với thẻ đã chỉ định, thì 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ề

Cam kết<bất kỳ>

Chrome 99 trở lên

Lời hứa 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()

Lời hứa &leq; MV2 Không dùng nữa

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

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

Gửi một yêu cầu đến(các) tập lệnh nội dung trong thẻ được chỉ định, kèm theo 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 được kích hoạt trong mỗi tập lệnh nội dung chạy trong thẻ được chỉ định cho tiện ích hiện tại.

Tham số

tabId

số
request

bất kỳ
số gọi lại

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

Chrome 99 trở lên

Tham số callback sẽ 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ẻ đã chỉ định, thì 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ề

Cam kết<bất kỳ>

Chrome 99 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Thu phóng một thẻ đã chỉ định.

Tham số

tabId

số không bắt buộc

Mã nhận dạng thẻ cần thu phóng; đặt mặc định thành 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ị của 0 đặt thẻ thành hệ số thu phóng mặc định hiện tại. Giá trị lớn hơn 0 chỉ định hệ số thu phóng (có thể không phải là mặc định) cho thẻ.
số gọi lại

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

Đặt chế độ cài đặt thu phóng cho một thẻ đã chỉ định, thẻ này sẽ 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 được đặt lại về mặc định trong khi di chuyển đến thẻ.

Tham số

tabId

số không bắt buộc

Mã của thẻ để thay đổi chế độ cài đặt thu phóng; đặt mặc định thành 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 xử lý.
số gọi lại

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Chrome 88 trở lên

Lời hứa 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()

Lời hứa Chrome 88 trở lên

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

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

Tham số

tabIds

số | [số, ...số[]]

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

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

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

Giá trị trả về

Lời hứa<vô hiệu>

Lời hứa 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()

Lời hứa

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

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

Tham số

tabId

số không bắt buộc

Giá trị mặc định là thẻ đã 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
  
  Liệu thẻ có đang hoạt động hay không. Không ảnh hưởng đến việc cửa sổ có được lấy làm tâm đ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 sắp hết 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 lựa chọn hiện tại.
- đã tắt tiếng
  
  boolean không bắt buộc
  
  Chrome 45 trở lên
  
  Liệu có nên tắt tiếng thẻ hay không.
- openerTabId
  
  số 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 có nên ghim thẻ hay không.
- đã chọn
  
  boolean không bắt buộc
  
  Không dùng nữa
  
  Vui lòng sử dụng thuộc tính được làm nổi bật.
  Liệu có nên chọn thẻ hay không.
- url
  
  chuỗi không bắt buộc
  
  URL để điều hướng thẻ đến. URL JavaScript không được hỗ trợ; hãy sử dụng scripting.executeScript.
số gọi lại

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

Tham số callback sẽ 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. Đối tượng tabs.Tab không chứa url, pendingUrl, title và favIconUrl nếu chưa yêu cầu quyền "tabs".

Giá trị trả về

Cam kết<Tab | không xác định>

Chrome 88 trở lên

Lời hứa 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,
)

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

Tham số

số gọi lại

hàm

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

onActiveChanged

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

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

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

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

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(tabId: number, selectInfo: object) => void
```
- tabId
  
  số
- selectInfo
  
  đối tượng
  - windowId
    
    số
    
    Mã của cửa sổ mà thẻ được 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ụ: do mục đó đã được di chuyển giữa các cửa sổ.

Tham số

số gọi lại

hàm

Tham số callback sẽ 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 bạn có thể không thiết lập URL của thẻ và tư cách thành viên trong nhóm thẻ tại thời điểm kích hoạt sự kiện này, nhưng bạn có thể nghe sự kiện onUpdated để nhận được thông báo khi đặt URL hoặc khi thẻ được thêm vào nhóm thẻ.

Tham số

số gọi lại

hàm

Tham số callback sẽ 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 thẻ bị tách khỏi cửa sổ; ví dụ: do mục đó đã được di chuyển giữa các cửa sổ.

Tham số

số gọi lại

hàm

Tham số callback sẽ 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.

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

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(selectInfo: object) => void
```
- selectInfo
  
  đối tượng
  - tabIds
    
    số[]
    
    Tất 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,
)

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

Tham số

số gọi lại

hàm

Tham số callback sẽ có dạng như sau:
```
(highlightInfo: object) => void
```
- highlightInfo
  
  đối tượng
  - tabIds
    
    số[]
    
    Tất 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 di chuyển một thẻ bên trong cửa sổ. Chỉ 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 mà 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.

Tham số

số gọi lại

hàm

Tham số callback sẽ 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 đóng một thẻ.

Tham số

số gọi lại

hàm

Tham số callback sẽ 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ẻ đã đóng.
  - windowId
    
    số
    
    Cửa sổ có thẻ đang đóng.

onReplaced

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

Được kích hoạt khi một thẻ được thay thế bằng một thẻ khác do quá trình kết xuất trước hoặc tức thì.

Tham số

số gọi lại

hàm

Tham số callback sẽ 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.

Kích hoạt khi thẻ đã chọn trong một cửa sổ thay đổi.

Tham số

số gọi lại

hàm

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

onUpdated

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

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

Tham số

số gọi lại

hàm

Tham số callback sẽ 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 tự động loại bỏ mới của thẻ.
  - đã hủy
    
    boolean không bắt buộc
    
    Chrome 54 trở lên
    
    Trạng thái bị loại bỏ mới của thẻ.
  - favIconUrl
    
    chuỗi không bắt buộc
    
    URL biểu tượng trang web mới của thẻ.
  - groupId
    
    số 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ẻ.
  - 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 có thay đổi.
- phím tab
  
  Thẻ

onZoomChange

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

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

Tham số

số gọi lại

hàm

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