chrome.tabGroups

설명

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

권한

tabGroups

가용성

Chrome 89 이상 MV3 이상

유형

Color

그룹의 색상입니다.

열거형

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

'purple'

"cyan"

"orange"

TabGroup

속성

  • 접힘

    부울

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

  • 색상

    색상

    그룹의 색상입니다.

  • id

    숫자

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

  • 공유

    부울

    Chrome 137 이상

    그룹이 공유되었는지 여부입니다.

  • 제목

    문자열 선택사항

    그룹의 제목입니다.

  • windowId

    숫자

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

속성

TAB_GROUP_ID_NONE

그룹이 없음을 나타내는 ID입니다.

값

-1

메서드

get()

chrome.tabGroups.get(
  groupId: number,
): Promise<TabGroup>

지정된 그룹에 대한 세부정보를 가져옵니다.

매개변수

  • groupId

    숫자

반환 값

move()

chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
): Promise<TabGroup | undefined>

그룹과 그룹 내의 모든 탭을 창 내에서 또는 새 창으로 이동합니다.

매개변수

  • groupId

    숫자

    이동할 그룹의 ID입니다.

  • moveProperties

    객체

    • 색인

      숫자

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

    • windowId

      번호 선택사항

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

반환 값

  • Promise<TabGroup | undefined>

    Chrome 90 이상

query()

chrome.tabGroups.query(
  queryInfo: object,
): Promise<TabGroup[]>

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

매개변수

  • queryInfo

    객체

    • 접힘

      불리언 선택사항

      그룹이 접혀 있는지 여부입니다.

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • 공유

      불리언 선택사항

      Chrome 137 이상

      그룹이 공유되었는지 여부입니다.

    • 제목

      문자열 선택사항

      패턴에 대해 그룹 제목을 일치시킵니다.

    • windowId

      번호 선택사항

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

반환 값

update()

chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
): Promise<TabGroup | undefined>

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

매개변수

  • groupId

    숫자

    수정할 그룹의 ID입니다.

  • updateProperties

    객체

    • 접힘

      불리언 선택사항

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

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • 제목

      문자열 선택사항

      그룹의 제목입니다.

반환 값

  • Promise<TabGroup | undefined>

    Chrome 90 이상

이벤트

onCreated

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

그룹이 생성될 때 발생합니다.

매개변수

  • callback

    함수

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

    (group: TabGroup) => void

onMoved

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

그룹이 창 내에서 이동될 때 발생합니다. 그룹 자체뿐만 아니라 그룹 내 개별 탭에 대해서도 이동 이벤트가 계속 발생합니다. 이 이벤트는 그룹이 창 간에 이동될 때 발생하지 않습니다. 대신 한 창에서 삭제되고 다른 창에서 생성됩니다.

매개변수

  • callback

    함수

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

    (group: TabGroup) => void

onRemoved

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

사용자가 직접 그룹을 닫거나 탭이 0개이므로 자동으로 그룹이 닫힐 때 발생합니다.

매개변수

  • callback

    함수

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

    (group: TabGroup) => void

onUpdated

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

그룹이 업데이트될 때 발생합니다.

매개변수

  • callback

    함수

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

    (group: TabGroup) => void