chrome.tabGroups

설명

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

권한

tabGroups

가용성

Chrome 89 이상 MV3 이상

유형

Color

그룹의 색상입니다.

열거형

'grey'

'blue'

"red"

'노란색'

'녹색'

'pink'

'purple'

"cyan"

"orange"

TabGroup

속성

  • 접힘

    부울

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

  • 색상

    색상

    그룹의 색상입니다.

  • id

    숫자

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

  • 공유

    부울

    대기 중

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

  • 제목

    문자열 선택사항

    그룹의 제목입니다.

  • windowId

    숫자

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

속성

TAB_GROUP_ID_NONE

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

값

-1

메서드

get()

Promise 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

매개변수

  • groupId

    숫자

  • callback

    함수 선택사항

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

    (group: TabGroup) => void

반환 값

  • Promise<TabGroup>

    Chrome 90 이상

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

move()

Promise 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

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

매개변수

  • groupId

    숫자

    이동할 그룹의 ID입니다.

  • moveProperties

    객체

    • 색인

      숫자

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

    • windowId

      번호 선택사항

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

  • callback

    함수 선택사항

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

    (group?: TabGroup) => void

    • 그룹

      TabGroup 선택사항

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

반환 값

  • Promise<TabGroup | undefined>

    Chrome 90 이상

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

query()

Promise 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

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

매개변수

  • queryInfo

    객체

    • 접힘

      불리언 선택사항

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

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • 공유

      불리언 선택사항

      대기 중

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

    • 제목

      문자열 선택사항

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

    • windowId

      번호 선택사항

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

  • callback

    함수 선택사항

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

    (result: TabGroup[]) => void

반환 값

  • Promise<TabGroup[]>

    Chrome 90 이상

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

update()

Promise 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

매개변수

  • groupId

    숫자

    수정할 그룹의 ID입니다.

  • updateProperties

    객체

    • 접힘

      불리언 선택사항

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

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • 제목

      문자열 선택사항

      그룹의 제목입니다.

  • callback

    함수 선택사항

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

    (group?: TabGroup) => void

    • 그룹

      TabGroup 선택사항

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

반환 값

  • Promise<TabGroup | undefined>

    Chrome 90 이상

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

이벤트

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