browser.tabGroups

설명

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

권한

tabGroups

가용성

Chrome 89 이상 Chrome 148 이후 browser.* MV3 이상

유형

Color

그룹의 색상입니다.

열거형

"grey"

"blue"

"red"

'yellow'

"green"

'pink'

'purple'

"cyan"

'orange'

TabGroup

속성

• 접힘

  부울

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

• 색상

  색상

  그룹의 색상입니다.

• id

  숫자

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

• 공유

  부울

  Chrome 137 이상 Chrome 148 이후 browser.*

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

• 제목

  문자열 선택사항

  그룹의 제목입니다.

• windowId

  숫자

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

속성

TAB_GROUP_ID_NONE

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

값

-1

메서드

get()

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

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

매개변수

• groupId

  숫자

반환 값

• Promise<TabGroup>

  Chrome 90 이상 브라우저.*(Chrome 148부터)

move()

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

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

매개변수

• groupId

  숫자

  이동할 그룹의 ID입니다.

• moveProperties

  객체

  • 색인

    숫자

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

  • windowId

    number 선택사항

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

반환 값

• Promise<TabGroup | undefined>

  Chrome 90 이상 브라우저.*(Chrome 148부터)

query()

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

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

매개변수

• queryInfo

  객체

  • 접힘

    불리언 선택사항

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

  • 색상

    색상 선택사항

    그룹의 색상입니다.

  • 공유

    불리언 선택사항

    Chrome 137 이상 Chrome 148 이후 browser.*

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

  • 제목

    문자열 선택사항

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

  • windowId

    number 선택사항

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

반환 값

• Promise<TabGroup[]>

  Chrome 90 이상 브라우저.*(Chrome 148부터)

update()

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

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

매개변수

• groupId

  숫자

  수정할 그룹의 ID입니다.

• updateProperties

  객체

  • 접힘

    불리언 선택사항

    그룹을 접어야 하는지 여부입니다.

  • 색상

    색상 선택사항

    그룹의 색상입니다.

  • 제목

    문자열 선택사항

    그룹의 제목입니다.

반환 값

• Promise<TabGroup | undefined>

  Chrome 90 이상 브라우저.*(Chrome 148부터)

이벤트

onCreated

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

그룹이 생성될 때 실행됩니다.

매개변수

• callback

  함수

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

  (group: TabGroup) => void

  • 그룹

    TabGroup

onMoved

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

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

매개변수

• callback

  함수

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

  (group: TabGroup) => void

  • 그룹

    TabGroup

onRemoved

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

사용자가 직접 그룹을 닫거나 탭이 없어 자동으로 그룹이 닫힐 때 실행됩니다.

매개변수

• callback

  함수

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

  (group: TabGroup) => void

  • 그룹

    TabGroup

onUpdated

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

그룹이 업데이트될 때 실행됩니다.

매개변수

• callback

  함수

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

  (group: TabGroup) => void

  • 그룹

    TabGroup