chrome.tabGroups

Nội dung 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 các thẻ có 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 MV3

Loại

Color

Màu của nhóm.

Liệt kê

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à một nhóm có các thẻ bị ẩn.

  • màu

    Màu

    Màu của nhóm.

  • id

    number

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

  • title

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

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

  • windowId

    number

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

Thuộc tính

TAB_GROUP_ID_NONE

Mã nhận dạng đại diện cho trường hợp không có một nhóm.

Giá trị

-1

Phương thức

get()

Cam kết 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

Tham số

  • groupId

    number

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

  • Promise<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 để có 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ẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

move()

Cam kết 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

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

Tham số

  • groupId

    number

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

  • moveProperties

    đối tượng

    • index

      number

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

    • windowId

      số không bắt buộc

      Cửa sổ để chuyển nhóm sang. Giá trị mặc định là cửa sổ mà nhóm hiện đang truy cập. Xin lưu ý rằng bạn chỉ có thể di chuyển nhóm đến và từ cửa sổ thuộc loại windows.WindowType "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ề

  • Hứa hẹn<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 để có 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ẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

query()

Cam kết 
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.

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.

    • title

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

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

    • windowId

      số không bắt buộc

      Mã của cửa sổ mẹ hoặc biểu tượng 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ề

  • Promise<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 để có 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ẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

update()

Cam kết 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

Sửa đổi các thuộc tính của 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

    number

    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 có nên thu gọn nhóm hay không.

    • màu

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

      Màu của nhóm.

    • title

      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ề

  • Hứa hẹn<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 để có 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ẽ được 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 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 một nhóm được di chuyển trong một cửa sổ. Sự kiện di chuyển vẫn được kích hoạt 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 đó, nhóm 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, do người dùng trực tiếp hoặc tự động vì nhóm đó không chứa thẻ nào.

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