chrome.tabGroups

설명

chrome.tabGroups API를 사용하여 브라우저의 탭 그룹화 시스템과 상호작용합니다. 이 API를 사용하여 브라우저에서 탭 그룹을 수정하고 재정렬할 수 있습니다. 탭을 그룹화 및 그룹화 해제하거나 그룹에 있는 탭을 쿼리하려면 chrome.tabs API를 사용하세요.

권한

tabGroups

지원 대상

Chrome 89 이상 MV3 이상

유형

Color

그룹의 색상입니다.

열거형

TabGroup

속성

  • 접힘

    boolean

    그룹을 접을지 여부입니다. 접힌 그룹은 탭이 숨겨지는 그룹입니다.

  • 색상

    색상

    그룹의 색상입니다.

  • id

    숫자

    그룹의 ID입니다. 그룹 ID는 브라우저 세션 내에서 고유합니다.

  • title

    문자열 선택사항

    그룹의 제목입니다.

  • windowId

    숫자

    그룹이 포함된 창의 ID입니다.

속성

TAB_GROUP_ID_NONE

그룹의 부재를 나타내는 ID입니다.

값


-1

방법

get()

프로미스 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

지정된 그룹에 대한 세부정보를 검색합니다.

매개변수

  • groupId

    숫자

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (group: TabGroup)=>void

반환 값

  • Promise<TabGroup>

    Chrome 90 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

move()

프로미스 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

그룹 및 그룹의 모든 탭을 그룹 창 또는 새 창으로 이동합니다.

매개변수

  • groupId

    숫자

    이동할 그룹의 ID입니다.

  • moveProperties

    객체

    • 색인

      숫자

      그룹을 이동할 위치입니다. -1를 사용하여 그룹을 창의 끝에 배치합니다.

    • windowId

      number 선택사항

      그룹을 이동할 창입니다. 기본값은 그룹이 현재 있는 기간입니다. 그룹은 windows.WindowType 유형이 "normal"인 창 간에만 이동할 수 있습니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (group?: TabGroup)=>void

    • 그룹

      TabGroup 선택사항

      이동한 그룹에 대한 세부정보입니다.

반환 값

  • 프로미스<TabGroup|undefined>

    Chrome 90 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

query()

프로미스 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

지정된 속성이 있는 모든 그룹을 가져오거나, 속성이 지정되지 않은 경우 모든 그룹을 가져옵니다.

매개변수

  • queryInfo

    객체

    • 접힘

      부울 선택사항

      그룹을 접을지 여부입니다.

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • title

      문자열 선택사항

      그룹 제목을 패턴과 일치시킵니다.

    • windowId

      number 선택사항

      상위 창의 ID 또는 현재 창의 windows.WINDOW_ID_CURRENT입니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (result: TabGroup[])=>void

반환 값

  • Promise<TabGroup[]>

    Chrome 90 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

update()

프로미스 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

그룹의 속성을 수정합니다. updateProperties에 지정되지 않은 속성은 수정되지 않습니다.

매개변수

  • groupId

    숫자

    수정할 그룹의 ID입니다.

  • updateProperties

    객체

    • 접힘

      부울 선택사항

      그룹을 축소할지 여부입니다.

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • title

      문자열 선택사항

      그룹의 제목입니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (group?: TabGroup)=>void

    • 그룹

      TabGroup 선택사항

      업데이트된 그룹에 대한 세부정보입니다.

반환 값

  • 프로미스<TabGroup|undefined>

    Chrome 90 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

이벤트

onCreated

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

그룹이 생성되면 실행됩니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (group: TabGroup)=>void

onMoved

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

그룹을 창 내에서 이동하면 실행됩니다. 이동 이벤트는 그룹 내 개별 탭과 그룹 자체에 대해 계속 실행됩니다. 이 이벤트는 그룹을 창 간에 이동할 때 시작되지 않습니다. 대신 한 창에서 삭제되고 다른 창에서 만들어집니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (group: TabGroup)=>void

onRemoved

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

사용자가 직접 그룹을 닫거나 그룹이 닫을 때 실행됩니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (group: TabGroup)=>void

onUpdated

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

그룹이 업데이트되면 실행됩니다.

매개변수

  • 콜백

    기능

    callback 매개변수는 다음과 같습니다. 

    (group: TabGroup)=>void