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ể 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ằm trong nhóm, hãy 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ó bị 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ã nhận dạng 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ênNhó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ã nhận dạng 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 việc không có nhóm.
Giá trị
-1
Phương thức
get()
chrome.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>
Chrome 90 trở lên
move()
chrome.tabGroups.move(
groupId: number,
moveProperties: object,
): Promise<TabGroup | undefined>
Di chuyển nhóm và tất cả các thẻ của nhóm đó trong cửa sổ 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ổ mà bạn muốn di chuyển nhóm sang. 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ác cửa sổ có loại
windows.WindowType"normal".
-
Giá trị trả về
-
Promise<TabGroup | undefined>
Chrome 90 trở lên
query()
chrome.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
Các nhóm có bị thu gọn hay không.
- màu
Màu 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ênNhó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[]>
Chrome 90 trở lên
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
): Promise<TabGroup | undefined>
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.
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ó nên đượ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.
-
Giá trị trả về
-
Promise<TabGroup | undefined>
Chrome 90 trở lên
Sự kiện
onCreated
chrome.tabGroups.onCreated.addListener(
callback: function,
)
Được kích hoạt khi một nhóm được tạo.
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ổ. 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.
onRemoved
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
Được kích hoạt khi một nhóm bị đóng, có thể là do người dùng đóng trực tiếp hoặc do nhóm không chứa thẻ nào nên tự động đóng.
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Được kích hoạt khi một nhóm được cập nhật.