설명
chrome.tabGroups API를 사용하여 브라우저의 탭 그룹화 시스템과 상호작용합니다. 이 API를 사용하여 브라우저에서 탭 그룹을 수정하고 재정렬할 수 있습니다. 탭을 그룹화 및 그룹화 해제하거나 그룹에 어떤 탭이 있는지 쿼리하려면 chrome.tabs API를 사용하세요.
권한
tabGroups가용성
유형
Color
그룹의 색상입니다.
열거형
'회색'
'파란색'
"빨간색"
"노란색"
"녹색"
'분홍색'
"자주색"
"녹청색"
"주황색"
TabGroup
속성
-
접힘
부울
그룹 축소 여부입니다. 접힌 그룹은 탭이 숨겨진 그룹입니다.
-
색상
그룹의 색상입니다.
-
id
숫자
그룹의 ID입니다. 그룹 ID는 브라우저 세션 내에서 고유합니다.
-
제목
문자열(선택사항)
그룹의 제목입니다.
-
windowId
숫자
그룹이 포함된 창의 ID입니다.
속성
TAB_GROUP_ID_NONE
그룹의 부재를 나타내는 ID입니다.
값
-1
메서드
get()
chrome.tabGroups.get(
groupId: number,
callback?: function,
)
지정된 그룹에 대한 세부정보를 검색합니다.
반환 값
-
프로미스 <TabGroup>
Chrome 90 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
move()
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()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
지정된 속성이 있는 모든 그룹을 가져오거나 속성이 지정되지 않은 경우 모든 그룹을 가져옵니다.
매개변수
-
queryInfo
객체
-
접힘
불리언 선택사항
그룹을 접을지 여부입니다.
-
색상
색상 선택사항
그룹의 색상입니다.
-
제목
문자열(선택사항)
그룹 제목을 패턴과 일치시킵니다.
-
windowId
숫자 선택사항
상위 창의 ID 또는 현재 창의 경우
windows.WINDOW_ID_CURRENT입니다.
-
-
콜백
함수 선택사항
callback매개변수는 다음과 같습니다.(result: TabGroup[]) => void
-
결과
TabGroup[]
-
반환 값
-
프로미스<TabGroup[]>
Chrome 90 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
callback?: function,
)
그룹의 속성을 수정합니다. updateProperties에 지정되지 않은 속성은 수정되지 않습니다.
매개변수
반환 값
-
프로미스 <TabGroup | 정의되지 않음>
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,
)
그룹이 업데이트되면 실행됩니다.