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ẻ có trong nhóm, hãy sử dụng API chrome.tabs.
Quyền
tabGroupsPhạm vi cung cấp
Loại
Color
Màu của nhóm.
Enum
"grey"
"blue"
"red"
"yellow"
"green"
"pink"
"tím"
"cyan"
"orange"
TabGroup
Thuộc tính
-
đã thu gọn
boolean
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 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.
-
boolean
Chrome 137 trở lên browser.* kể từ Chrome 148Nhó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ã nhận dạng cho biết không có nhóm.
Giá trị
-1
Phương thức
get()
browser.tabGroups.get(
groupId: number,
): Promise<TabGroup>
Truy xuất thông tin chi tiết về nhóm được chỉ định.
Thông số
-
groupId
số
Giá trị trả về
-
Promise<TabGroup>
Trình duyệt Chrome 90 trở lên .* kể từ Chrome 148
move()
browser.tabGroups.move(
groupId: number,
moveProperties: object,
): Promise<TabGroup | undefined>
Di chuyển nhóm và tất cả các thẻ trong nhóm đó 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 đến. Sử dụng
-1để đặt nhóm ở cuối cửa sổ. -
windowId
number không bắt buộc
Cửa sổ để di chuyển nhóm đến. Mặc định là cửa sổ mà nhóm hiện đang ở trong đó. Xin lưu ý rằng bạn chỉ có thể di chuyển các nhóm đến và đi từ cửa sổ có
windows.WindowTypeloại"normal".
-
Giá trị trả về
-
Promise<TabGroup | undefined>
Trình duyệt Chrome 90 trở lên .* kể từ Chrome 148
query()
browser.tabGroups.query(
queryInfo: object,
): Promise<TabGroup[]>
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 sắc không bắt buộc
Màu của các nhóm.
-
boolean không bắt buộc
Chrome 137 trở lên browser.* kể từ Chrome 148Nhó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
number không bắt buộc
Mã nhận dạng của cửa sổ mẹ hoặc
windows.WINDOW_ID_CURRENTcho cửa sổ hiện tại.
-
Giá trị trả về
-
Promise<TabGroup[]>
Trình duyệt Chrome 90 trở lên .* kể từ Chrome 148
update()
browser.tabGroups.update(
groupId: number,
updateProperties: object,
): Promise<TabGroup | undefined>
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 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.
-
tiêu đề
chuỗi không bắt buộc
Tiêu đề của nhóm.
-
Giá trị trả về
-
Promise<TabGroup | undefined>
Trình duyệt Chrome 90 trở lên .* kể từ Chrome 148
Sự kiện
onCreated
browser.tabGroups.onCreated.addListener(
callback: function,
)
Được kích hoạt khi một nhóm được tạo.
onMoved
browser.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 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 này sẽ bị xoá khỏi một cửa sổ và được tạo trong một cửa sổ khác.
onRemoved
browser.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ẻ nào.
onUpdated
browser.tabGroups.onUpdated.addListener(
callback: function,
)
Được kích hoạt khi một nhóm được cập nhật.