chrome.tabGroups

설명

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

권한

tabGroups

가용성

Chrome 89 이상 MV3 이상

유형

Color

그룹의 색상입니다.

열거형

'회색'

'파란색'

"빨간색"

"노란색"

"녹색"

'분홍색'

"자주색"

"녹청색"

"주황색"

TabGroup

속성

  • 접힘

    부울

    그룹 축소 여부입니다. 접힌 그룹은 탭이 숨겨진 그룹입니다.

  • 색상

    색상

    그룹의 색상입니다.

  • id

    숫자

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

  • 제목

    문자열(선택사항)

    그룹의 제목입니다.

  • windowId

    숫자

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

속성

TAB_GROUP_ID_NONE

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

값

-1

메서드

get()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

매개변수

  • groupId

    숫자

  • 콜백

    함수 선택사항

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

    (group: TabGroup) => void

반환 값

  • 프로미스 <TabGroup>

    Chrome 90 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

move()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

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

매개변수

  • groupId

    숫자

    이동할 그룹의 ID입니다.

  • moveProperties

    객체

    • 색인

      숫자

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

    • windowId

      숫자 선택사항

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

  • 콜백

    함수 선택사항

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

    (group?: TabGroup) => void

    • 그룹

      TabGroup 선택사항

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

반환 값

  • 프로미스 <TabGroup | 정의되지 않음>

    Chrome 90 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

query()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

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

매개변수

  • queryInfo

    객체

    • 접힘

      불리언 선택사항

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

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • 제목

      문자열(선택사항)

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

    • windowId

      숫자 선택사항

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

  • 콜백

    함수 선택사항

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

    (result: TabGroup[]) => void

반환 값

  • 프로미스<TabGroup[]>

    Chrome 90 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

update()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

매개변수

  • groupId

    숫자

    수정할 그룹의 ID입니다.

  • updateProperties

    객체

    • 접힘

      불리언 선택사항

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

    • 색상

      색상 선택사항

      그룹의 색상입니다.

    • 제목

      문자열(선택사항)

      그룹의 제목입니다.

  • 콜백

    함수 선택사항

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

    (group?: TabGroup) => void

    • 그룹

      TabGroup 선택사항

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

반환 값

  • 프로미스 <TabGroup | 정의되지 않음>

    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