chrome.tabGroups

Mô tả

Sử dụng API chrome.tabGroups để tương tác với hệ thống nhóm thẻ của trình duyệt. Bạn có thể sử dụng API này để sửa đổi và sắp xếp lại các nhóm thẻ trong trình duyệt. Để nhóm và huỷ nhóm các thẻ hoặc để truy vấn xem có những thẻ nào trong nhóm, hãy sử dụng API chrome.tabs.

Quyền

tabGroups

Phạm vi cung cấp

Chrome 89 trở lên Video nhạc 3 trở lên

Loại

Color

Màu của nhóm.

Enum

"xám"

"xanh dương"

"đỏ"

"vàng"

"xanh lục"

"hồng"

"tím"

"lục lam"

"cam"

TabGroup

Thuộc tính

  • đã thu gọn

    boolean

    Liệu nhóm có được thu gọn hay không. Nhóm thu gọn là nhóm có các thẻ bị ẩn.

  • màu

    Màu

    Màu của nhóm.

  • id

    số

    Mã của nhóm. Mã nhóm là duy nhất trong một phiên trình duyệt.

  • tiêu đề

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

    Tiêu đề của nhóm.

  • windowId

    số

    Mã của cửa sổ chứa nhóm.

Thuộc tính

TAB_GROUP_ID_NONE

Mã nhận dạng thể hiện không có nhóm.

Giá trị

-1

Phương thức

get()

Lời hứa 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

Tham số

  • groupId

    số

  • số gọi lại

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

    Tham số callback sẽ có dạng như sau: 

    (group: TabGroup) => void

Giá trị trả về

  • Cam kết<TabGroup>

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

move()

Lời hứa 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

Di chuyển nhóm và tất cả các thẻ trong cửa sổ đó hoặc sang một cửa sổ mới.

Tham số

  • groupId

    số

    Mã của nhóm cần di chuyển.

  • moveProperties

    đối tượng

    • index

      số

      Vị trí để chuyển nhóm đến. Dùng -1 để đưa nhóm vào cuối cửa sổ.

    • windowId

      số không bắt buộc

      Cửa sổ để di chuyển nhóm đến. Giá trị mặc định là cửa sổ hiện tại của nhóm. Xin lưu ý rằng bạn chỉ có thể di chuyển nhóm đến và từ các cửa sổ có loại windows.WindowType là "normal".

  • số gọi lại

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

    Tham số callback sẽ có dạng như sau: 

    (group?: TabGroup) => void

    • nhóm

      TabGroup không bắt buộc

      Thông tin chi tiết về nhóm đã di chuyển.

Giá trị trả về

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

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

query()

Lời hứa 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

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

Tham số

  • queryInfo

    đối tượng

    • đã thu gọn

      boolean không bắt buộc

      Liệu các nhóm có được thu gọn hay không.

    • màu

      Màu sắc không bắt buộc

      Màu của nhóm.

    • tiêu đề

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

      Khớp tiêu đề nhóm với mẫu.

    • 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.

  • số gọi lại

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

    Tham số callback sẽ có dạng như sau: 

    (result: TabGroup[]) => void

Giá trị trả về

  • Cam kết<TabGroup[]>

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

update()

Lời hứa 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

Tham số

  • groupId

    số

    Mã của nhóm cần sửa đổi.

  • updateProperties

    đối tượng

    • đã thu gọn

      boolean không bắt buộc

      Nhóm có được thu gọn hay không.

    • màu

      Màu sắc không bắt buộc

      Màu của nhóm.

    • tiêu đề

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

      Tiêu đề của nhóm.

  • số gọi lại

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

    Tham số callback sẽ có dạng như sau: 

    (group?: TabGroup) => void

    • nhóm

      TabGroup không bắt buộc

      Thông tin chi tiết về nhóm được cập nhật.

Giá trị trả về

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

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

Sự kiện

onCreated

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

Được kích hoạt khi một nhóm được tạo.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (group: TabGroup) => void

onMoved

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

Được kích hoạt khi di chuyển một nhóm bên trong cửa sổ. Hệ thống vẫn kích hoạt các sự kiện di chuyển cho các thẻ riêng lẻ trong nhóm, cũng như cho chính nhóm đó. Sự kiện này không được kích hoạt khi một nhóm được di chuyển giữa các cửa sổ; thay vào đó, hoạt động đó sẽ bị xoá khỏi một cửa sổ và được tạo trong một cửa sổ khác.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (group: TabGroup) => void

onRemoved

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

Được kích hoạt khi một nhóm bị đóng, trực tiếp bởi người dùng hoặc tự động vì nhóm không chứa thẻ.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (group: TabGroup) => void

onUpdated

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

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

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (group: TabGroup) => void