설명
chrome.tabGroups
API를 사용하여 브라우저의 탭 그룹화 시스템과 상호작용합니다. 이 API를 사용하여 브라우저에서 탭 그룹을 수정하고 재정렬할 수 있습니다. 탭을 그룹화 및 그룹화 해제하거나 그룹에 있는 탭을 쿼리하려면 chrome.tabs
API를 사용하세요.
권한
tabGroups
가용성
유형
Color
그룹의 색상입니다.
enum
TabGroup
속성
-
접힘
boolean
그룹을 접을지 여부입니다. 접힌 그룹은 탭이 숨겨지는 그룹입니다.
-
색상
그룹의 색상입니다.
-
id
숫자
그룹의 ID입니다. 그룹 ID는 브라우저 세션 내에서 고유합니다.
-
title
문자열 선택사항
그룹의 제목입니다.
-
windowId
숫자
그룹이 포함된 창의 ID입니다.
속성
TAB_GROUP_ID_NONE
그룹의 부재를 나타내는 ID입니다.
값
-1
메서드
get()
chrome.tabGroups.get(
groupId: number,
callback?: function,
)
지정된 그룹에 대한 세부정보를 검색합니다.
반환 값
-
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
함수 선택사항
callback
매개변수는 다음과 같습니다.(group?: TabGroup) => void
-
그룹
TabGroup 선택사항
이동한 그룹에 대한 세부정보입니다.
-
반환 값
-
Promise<TabGroup | undefined>
Chrome 90 이상프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
query()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
지정된 속성이 있는 모든 그룹을 가져오거나, 속성이 지정되지 않은 경우 모든 그룹을 가져옵니다.
매개변수
-
queryInfo
객체
-
접힘
부울 선택사항
그룹을 접을지 여부입니다.
-
색상
색상 선택사항
그룹의 색상입니다.
-
title
문자열 선택사항
그룹 제목을 패턴과 일치시킵니다.
-
windowId
number 선택사항
상위 창의 ID 또는 현재 창의
windows.WINDOW_ID_CURRENT
입니다.
-
-
callback
함수 선택사항
callback
매개변수는 다음과 같습니다.(result: TabGroup[]) => void
-
결과
TabGroup[]
-
반환 값
-
Promise<TabGroup[]>
Chrome 90 이상프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
callback?: function,
)
그룹의 속성을 수정합니다. updateProperties
에 지정되지 않은 속성은 수정되지 않습니다.
매개변수
반환 값
-
Promise<TabGroup | undefined>
Chrome 90 이상프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
이벤트
onCreated
chrome.tabGroups.onCreated.addListener(
callback: function,
)
그룹이 생성되면 실행됩니다.
onMoved
chrome.tabGroups.onMoved.addListener(
callback: function,
)
그룹을 창 내에서 이동하면 실행됩니다. 이동 이벤트는 그룹 내 개별 탭과 그룹 자체에 대해 계속 실행됩니다. 이 이벤트는 그룹을 창 간에 이동할 때 시작되지 않습니다. 대신 한 창에서 삭제되고 다른 창에서 만들어집니다.
onRemoved
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
사용자가 직접 그룹을 닫거나 그룹이 닫을 때 실행됩니다.
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
그룹이 업데이트되면 실행됩니다.