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 những thẻ nào thuộc các nhóm, hãy sử dụng API chrome.tabs.

Quyền

tabGroups

Phạm vi cung cấp

Chrome 89 trở lên MV3 trở lên

Loại

Color

Màu của nhóm.

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

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.

  • đã chia sẻ

    boolean

    Đang chờ xử lý

    Liệu nhóm đó có được chia sẻ hay không.

  • 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ã đại diện cho việc không có nhóm.

Giá trị

-1

Phương thức

get()

Promise 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

Thông số

  • groupId

    số

  • callback

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

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

    (group: TabGroup) => void

Giá trị trả về

  • Promise<TabGroup>

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo 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. Lời hứa sẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

move()

Promise 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

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

Thông số

  • groupId

    số

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

  • moveProperties

    đối tượng

    • index

      số

      Vị trí để di chuyển nhóm. Sử dụng -1 để đặt nhóm ở cuối cửa sổ.

    • windowId

      số không bắt buộc

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

  • callback

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

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

  • Promise<TabGroup | undefined>

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo 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. Lời hứa sẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

query()

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

Lấy tất cả các nhóm có thuộc tính được 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.

Thông 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 không bắt buộc

      Màu của các nhóm.

    • đã chia sẻ

      boolean không bắt buộc

      Đang chờ xử lý

      Liệu nhóm đó có được chia sẻ hay không.

    • tiêu đề

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

      So khớp tiêu đề nhóm với một mẫu.

    • windowId

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

  • callback

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

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

    (result: TabGroup[]) => void

Giá trị trả về

  • Promise<TabGroup[]>

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo 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. Lời hứa sẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

update()

Promise 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

Thông 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

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

    • màu

      Màu 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.

  • callback

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

    Tham số callback 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ập nhật.

Giá trị trả về

  • Promise<TabGroup | undefined>

    Chrome 90 trở lên

    Lời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo 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. Lời hứa sẽ phân giải bằng cùng một 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 tạo một nhóm.

Thông số

  • callback

    hàm

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

    (group: TabGroup) => void

onMoved

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

Được kích hoạt khi một nhóm được di chuyển trong cửa sổ. Các sự kiện di chuyển vẫn được kích hoạt cho từng thẻ 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 đó, nhóm sẽ bị xoá khỏi một cửa sổ và được tạo trong một cửa sổ khác.

Thông số

  • callback

    hàm

    Tham số callback 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, do người dùng đóng trực tiếp hoặc tự động đóng vì nhóm đó không chứa thẻ nào.

Thông số

  • callback

    hàm

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

Thông số

  • callback

    hàm

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

    (group: TabGroup) => void