跳到主要内容

tabGroups 选项卡组

官方文档

允许用户创建、获取、更新、移除选项卡组

权限设置​

"permissions": [
  "tabGroups"
]

方法​

get() 检索组的详细信息​

type TabGroup = {
  // 组的ID。组ID在浏览器会话中是唯一的。
  id: number;
  // 组的标题。
  title: string;
  // 组的颜色。
  color: Color;
  // 组是否已折叠。
  collapsed: boolean;
  // 组的窗口ID。
  windowId: number;
}
chrome.tabGroups.get(
  groupId: number,
  callback?: (group: TabGroup) => void,
)

query() 获取组​

获取具有指定属性的所有组，如果未指定任何属性，则获取所有组

chrome.tabGroups.query(
  queryInfo: {
    // 组的标题。
    title: string;
    // 组的颜色。
    color: Color;
    // 组是否已折叠。
    collapsed: boolean;
    // 组的窗口ID。
    windowId: number;
  },
  callback?: (result: TabGroup[]) => void,
)

move() 移动选择卡组​

将组及其所有选项卡 移动到 其窗口内或新窗口

chrome.tabGroups.move(
  groupId: number,
  moveProperties: {
    // 要将组移动到的位置。用于 -1 将组放置在窗口的末尾。
    index: number,
    // 要将组移动到的窗口。默认为组当前所在的窗口
    windowId: number,
  },
  callback?: (group: TabGroup) => void,
)

update() 修改组的属性​

chrome.tabGroups.update(
  groupId: number,
  updateProperties: {
    // 组的标题。
    title: string;
    // 组的颜色。
    color: Color;
    // 组是否已折叠。
    collapsed: boolean;
  },
  callback?: (group: TabGroup) => void,
)

事件​

onCreated 创建事件​

当组被创建时触发

// background.js
chrome.tabGroups.onCreated.addListener((group: TabGroup) => {
  console.log('🍄  background: >>>>>>>>>>>>>>>>>> 监听创建事件', Date.now(), group);
});

onMoved 移动事件​

// background.js
chrome.tabGroups.onMoved.addListener((group: TabGroup) => {
  console.log('🍄  background: >>>>>>>>>>>>>>>>>> 监听移动事件', Date.now(), group);
});

onRemoved 移除事件​

// background.js
chrome.tabGroups.onRemoved.addListener((group: TabGroup) => {
  console.log('🍄  background: >>>>>>>>>>>>>>>>>> 监听移除事件', Date.now(), group);
});

onUpdated 更新事件​

// background.js
chrome.tabGroups.onUpdated.addListener((group: TabGroup) => {
  console.log('🍄  background: >>>>>>>>>>>>>>>>>> 监听更新事件', Date.now(), group);
});