chrome.tabs

설명

chrome.tabs API를 사용하여 브라우저의 탭 시스템과 상호작용합니다. 이 API를 사용하여 브라우저에서 탭을 만들고, 수정하고, 재정렬할 수 있습니다.

Tabs API는 탭을 조작하고 관리하는 기능을 제공할 뿐만 아니라 탭의 언어를 감지하고, 스크린샷을 찍고, 탭의 콘텐츠 스크립트와 통신할 수도 있습니다.

권한

대부분의 기능은 사용에 권한이 필요하지 않습니다. 예를 들어 새 탭 만들기, 탭 새로고침, 다른 URL로 이동 등이 있습니다.

Tabs API를 사용할 때 개발자가 알아야 하는 권한은 세 가지입니다.

'탭' 권한

이 권한은 chrome.tabs 네임스페이스에 대한 액세스 권한을 부여하지 않습니다. 대신 확장 프로그램에 tabs.Tab 인스턴스의 민감한 속성 4개(url, pendingUrl, title, favIconUrl)에 대해 tabs.query()을 호출할 수 있는 권한을 부여합니다.

{   "name": "My extension",   ...   "permissions": [     "tabs"   ],   ... }
호스트 권한

호스트 권한을 사용하면 확장 프로그램이 일치하는 탭의 민감한 tabs.Tab 속성 4개를 읽고 쿼리할 수 있습니다. tabs.captureVisibleTab(), scripting.executeScript(), scripting.insertCSS(), scripting.removeCSS() 등의 메서드를 사용하여 일치하는 탭과 직접 상호작용할 수도 있습니다.

{   "name": "My extension",   ...   "host_permissions": [     "http://*/*",     "https://*/*"   ],   ... }
'activeTab' 권한

activeTab는 사용자 호출에 대한 응답으로 현재 탭에 확장 프로그램 임시 호스트 권한을 부여합니다. 호스트 권한과 달리 activeTab는 경고를 트리거하지 않습니다.

{   "name": "My extension",   ...   "permissions": [     "activeTab"   ],   ... }

사용 사례

다음 섹션에서는 몇 가지 일반적인 사용 사례를 보여줍니다.

새 탭에서 확장 프로그램 페이지 열기

확장 프로그램의 일반적인 패턴은 확장 프로그램이 설치될 때 새 탭에서 온보딩 페이지를 여는 것입니다. 다음 예에서는 그 방법을 보여줍니다.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {   if (reason === 'install') {     chrome.tabs.create({       url: "onboarding.html"     });   } });

현재 탭 가져오기

이 예시에서는 확장 프로그램의 서비스 워커가 현재 포커스가 있는 창 (또는 Chrome 창에 포커스가 없는 경우 가장 최근에 포커스가 있었던 창)에서 활성 탭을 가져오는 방법을 보여줍니다. 일반적으로 사용자의 현재 탭으로 생각할 수 있습니다.

  async function getCurrentTab() {     let queryOptions = { active: true, lastFocusedWindow: true };     // `tab` will either be a `tabs.Tab` instance or `undefined`.     let [tab] = await chrome.tabs.query(queryOptions);     return tab;   } 

  function getCurrentTab(callback) {     let queryOptions = { active: true, lastFocusedWindow: true };     chrome.tabs.query(queryOptions, ([tab]) => {       if (chrome.runtime.lastError)       console.error(chrome.runtime.lastError);       // `tab` will either be a `tabs.Tab` instance or `undefined`.       callback(tab);     });   }

지정된 탭 음소거

이 예에서는 확장 프로그램이 지정된 탭의 음소거 상태를 전환하는 방법을 보여줍니다.

  async function toggleMuteState(tabId) {     const tab = await chrome.tabs.get(tabId);     const muted = !tab.mutedInfo.muted;     await chrome.tabs.update(tabId, {muted});     console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);   } 

  function toggleMuteState(tabId) {     chrome.tabs.get(tabId, async (tab) => {       let muted = !tab.mutedInfo.muted;       await chrome.tabs.update(tabId, { muted });       console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);     });   }

클릭하면 현재 탭을 첫 번째 위치로 이동

이 예에서는 드래그가 진행 중일 수도 있고 아닐 수도 있는 동안 탭을 이동하는 방법을 보여줍니다. 이 예에서는 chrome.tabs.move를 사용하지만 드래그가 진행되는 동안 탭을 수정하는 다른 호출에도 동일한 대기 패턴을 사용할 수 있습니다.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);    async function moveToFirstPosition(activeInfo) {     try {       await chrome.tabs.move(activeInfo.tabId, {index: 0});       console.log("Success.");     } catch (error) {       if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {         setTimeout(() => moveToFirstPosition(activeInfo), 50);       } else {         console.error(error);       }     }   } 

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);    function moveToFirstPositionMV2(activeInfo) {     chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {       if (chrome.runtime.lastError) {         const error = chrome.runtime.lastError;         if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {           setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);         } else {           console.error(error);         }       } else {         console.log("Success.");       }     });   }

선택한 탭의 콘텐츠 스크립트에 메시지 전달

이 예에서는 확장 프로그램의 서비스 워커가 tabs.sendMessage()를 사용하여 특정 브라우저 탭의 콘텐츠 스크립트와 통신하는 방법을 보여줍니다.

function sendMessageToActiveTab(message) {   const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });   const response = await chrome.tabs.sendMessage(tab.id, message);   // TODO: Do something with the response. }

확장 프로그램 예

더 많은 탭 API 확장 프로그램 데모는 다음을 참고하세요.

유형

MutedInfo

Chrome 46 이상

탭의 음소거 상태와 마지막 상태 변경 이유입니다.

속성

  • extensionId

    문자열 선택사항

    숨김 상태를 변경한 확장 프로그램의 ID입니다. 확장 프로그램이 마지막으로 음소거 상태가 변경된 이유가 아닌 경우 설정되지 않습니다.

  • 음소거

    부울

    탭이 음소거되었는지 (사운드 재생이 방지됨) 여부입니다. 탭에서 사운드를 재생하지 않았거나 현재 재생 중이 아니더라도 탭이 음소거되어 있을 수 있습니다. '음소거됨' 오디오 표시기가 표시되는지 여부와 동일합니다.

  • reason

    MutedInfoReason 선택사항

    탭이 음소거 또는 음소거 해제된 이유입니다. 탭의 음소거 상태가 변경된 적이 없는 경우 설정되지 않습니다.

MutedInfoReason

Chrome 46 이상

음소거 상태 변경을 일으킨 이벤트입니다.

열거형

'user'
사용자 입력 작업으로 음소거 상태가 설정되었습니다.

'capture'
탭 캡처가 시작되어 음소거 상태 변경이 강제되었습니다.

'extension'
extensionId 필드로 식별되는 확장 프로그램이 음소거 상태를 설정했습니다.

Tab

속성

  • 운영중

    부울

    탭이 창에서 활성 상태인지 여부입니다. 창에 포커스가 설정되어 있다는 의미는 아닙니다.

  • 오더블

    불리언 선택사항

    Chrome 45 이상

    탭에서 지난 몇 초 동안 소리가 재생되었는지 여부입니다 (음소거된 경우 들리지 않을 수 있음). '스피커 오디오' 표시기가 표시되는지 여부와 동일합니다.

  • autoDiscardable

    부울

    Chrome 54 이상

    리소스가 부족할 때 브라우저에서 탭을 자동으로 삭제할 수 있는지 여부입니다.

  • 삭제됨

    부울

    Chrome 54 이상

    탭이 삭제되었는지 여부입니다. 탭이 닫히면 콘텐츠가 메모리에서 언로드되지만 탭 스트립에는 계속 표시됩니다. 다음에 활성화되면 콘텐츠가 다시 로드됩니다.

  • favIconUrl

    문자열 선택사항

    탭의 파비콘 URL입니다. 이 속성은 확장 프로그램에 "tabs" 권한이 있거나 페이지에 대한 호스트 권한이 있는 경우에만 존재합니다. 탭이 로드 중인 경우 빈 문자열일 수도 있습니다.

  • 겨울왕국

    부울

    Chrome 132 이상

    탭이 고정되었는지 여부입니다. 고정된 탭은 이벤트 핸들러나 타이머를 비롯한 작업을 실행할 수 없습니다. 탭 스트립에 표시되고 콘텐츠가 메모리에 로드됩니다. 활성화되면 고정이 해제됩니다.

  • groupId

    숫자

    Chrome 88 이상

    탭이 속한 그룹의 ID입니다.

  • 높이

    번호 선택사항

    탭의 높이(픽셀)입니다.

  • 눈에 띄는 채팅 메시지

    부울

    탭이 강조 표시되는지 여부입니다.

  • id

    번호 선택사항

    탭의 ID입니다. 탭 ID는 브라우저 세션 내에서 고유합니다. sessions API를 사용하여 외부 탭을 쿼리하는 경우와 같이 탭에 ID가 할당되지 않는 경우도 있습니다. 이 경우 세션 ID가 있을 수 있습니다. 탭 ID는 앱 및 개발자 도구 창의 경우 chrome.tabs.TAB_ID_NONE로 설정할 수도 있습니다.

  • 시크릿 모드

    부울

    탭이 시크릿 창에 있는지 여부입니다.

  • 색인

    숫자

    창 내 탭의 0부터 시작하는 색인입니다.

  • lastAccessed

    숫자

    Chrome 121 이상

    탭이 창에서 활성화된 마지막 시간입니다(에포크 이후 경과된 시간(밀리초)).

  • mutedInfo

    MutedInfo 선택사항

    Chrome 46 이상

    탭의 음소거 상태와 마지막 상태 변경 이유입니다.

  • openerTabId

    번호 선택사항

    이 탭을 연 탭의 ID입니다(있는 경우). 이 속성은 오프너 탭이 아직 있는 경우에만 표시됩니다.

  • pendingUrl

    문자열 선택사항

    Chrome 79 이상

    탭이 커밋되기 전에 탭이 탐색하는 URL입니다. 이 속성은 확장 프로그램에 "tabs" 권한이 있거나 페이지에 대한 호스트 권한이 있고 대기 중인 탐색이 있는 경우에만 표시됩니다.

  • 고정됨

    부울

    탭이 고정되었는지 여부입니다.

  • 선택됨

    부울

    지원 중단됨

    tabs.Tab.highlighted를 사용하세요.

    탭이 선택되었는지 여부입니다.

  • sessionId

    문자열 선택사항

    sessions API에서 가져온 탭을 고유하게 식별하는 데 사용되는 세션 ID입니다.

  • 상태

    TabStatus 선택사항

    탭의 로드 상태입니다.

  • 제목

    문자열 선택사항

    탭의 제목입니다. 이 속성은 확장 프로그램에 "tabs" 권한이 있거나 페이지에 대한 호스트 권한이 있는 경우에만 존재합니다.

  • URL

    문자열 선택사항

    탭의 기본 프레임에서 마지막으로 커밋된 URL입니다. 이 속성은 확장 프로그램에 "tabs" 권한이 있거나 페이지에 대한 호스트 권한이 있는 경우에만 존재합니다. 탭이 아직 커밋되지 않은 경우 빈 문자열일 수 있습니다. Tab.pendingUrl도 참고하세요.

  • 너비

    번호 선택사항

    탭의 너비(픽셀)입니다.

  • windowId

    숫자

    탭이 포함된 창의 ID입니다.

TabStatus

Chrome 44 이상

탭의 로드 상태입니다.

열거형

'unloaded'

'loading'

'complete'

WindowType

Chrome 44 이상

창 유형입니다.

열거형

"normal"

"popup"

'panel'

"app"

'devtools'

ZoomSettings

탭의 확대/축소 변경사항이 처리되는 방식과 범위를 정의합니다.

속성

  • defaultZoomFactor

    번호 선택사항

    Chrome 43 이상

    tabs.getZoomSettings 호출에서 현재 탭의 기본 확대/축소 수준을 반환하는 데 사용됩니다.

  • 모드

    ZoomSettingsMode 선택사항

    확대/축소 변경사항이 처리되는 방식을 정의합니다.즉, 페이지의 실제 크기 조정을 담당하는 항목입니다. 기본값은 automatic입니다.

  • 범위

    ZoomSettingsScope 선택사항

    확대/축소 변경사항이 페이지의 출처에 유지되는지 아니면 이 탭에서만 적용되는지 정의합니다. automatic 모드에서는 기본값이 per-origin이고, 그 외의 경우에는 per-tab입니다.

ZoomSettingsMode

Chrome 44 이상

확대/축소 변경사항이 처리되는 방식을 정의합니다.즉, 페이지의 실제 크기 조정을 담당하는 항목입니다. 기본값은 automatic입니다.

열거형

'automatic'
브라우저에서 확대/축소 변경사항을 자동으로 처리합니다.

'manual'
확대/축소 변경사항의 자동 처리를 재정의합니다. onZoomChange 이벤트는 계속 디스패치되며 이 이벤트를 수신하고 페이지를 수동으로 확장하는 것은 확장 프로그램의 책임입니다. 이 모드는 per-origin 확대/축소를 지원하지 않으므로 scope 확대/축소 설정을 무시하고 per-tab를 가정합니다.

'disabled'
탭의 모든 확대/축소를 사용 중지합니다. 탭이 기본 확대/축소 수준으로 되돌아가고 시도된 모든 확대/축소 변경사항이 무시됩니다.

ZoomSettingsScope

Chrome 44 이상

확대/축소 변경사항이 페이지의 출처에 유지되는지 아니면 이 탭에서만 적용되는지 정의합니다. automatic 모드에서는 기본값이 per-origin이고, 그 외의 경우에는 per-tab입니다.

열거형

'출처별'
확대/축소된 페이지의 출처에 확대/축소 변경사항이 유지됩니다. 즉, 동일한 출처로 이동한 다른 모든 탭도 확대/축소됩니다. 또한 per-origin 확대/축소 변경사항은 출처와 함께 저장되므로 동일한 출처의 다른 페이지로 이동할 때 모두 동일한 확대/축소 비율로 확대됩니다. per-origin 범위는 automatic 모드에서만 사용할 수 있습니다.

'탭별'
확대/축소 변경사항은 이 탭에만 적용되며 다른 탭의 확대/축소 변경사항은 이 탭의 확대/축소에 영향을 주지 않습니다. 또한 탐색 시 per-tab 확대/축소 변경사항이 재설정됩니다. 탭을 탐색하면 항상 per-origin 확대/축소 요소가 있는 페이지가 로드됩니다.

속성

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 이상

초당 captureVisibleTab를 호출할 수 있는 최대 횟수입니다. captureVisibleTab는 비용이 많이 들므로 너무 자주 호출해서는 안 됩니다.

값

2

TAB_ID_NONE

Chrome 46 이상

브라우저 탭이 없음을 나타내는 ID입니다.

값

-1

TAB_INDEX_NONE

Chrome 123 이상

tab_strip에 탭 색인이 없음을 나타내는 색인입니다.

값

-1

메서드

captureVisibleTab()

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
): Promise<string>

지정된 창에서 현재 활성 탭의 표시 영역을 캡처합니다. 이 메서드를 호출하려면 확장 프로그램에 <all_urls> 권한 또는 activeTab 권한이 있어야 합니다. 이 메서드를 사용하면 확장 프로그램이 일반적으로 액세스할 수 있는 사이트 외에도 chrome:-scheme 페이지, 다른 확장 프로그램의 페이지, data: URL 등 제한된 민감한 사이트를 캡처할 수 있습니다. 이러한 민감한 사이트는 activeTab 권한으로만 캡처할 수 있습니다. 확장 프로그램에 파일 액세스 권한이 부여된 경우에만 파일 URL을 캡처할 수 있습니다.

매개변수

  • windowId

    번호 선택사항

    타겟 창입니다. 기본값은 현재 창입니다.

  • 옵션

    ImageDetails 선택사항

반환 값

  • Promise<string>

    Chrome 88 이상

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
): runtime.Port

지정된 탭의 콘텐츠 스크립트에 연결합니다. runtime.onConnect 이벤트는 현재 확장 프로그램의 지정된 탭에서 실행되는 각 콘텐츠 스크립트에서 발생합니다. 자세한 내용은 콘텐츠 스크립트 메시지를 참고하세요.

매개변수

  • tabId

    숫자

  • connectInfo

    객체 선택사항

    • documentId

      문자열 선택사항

      Chrome 106 이상

      탭의 모든 프레임이 아닌 documentId로 식별되는 특정 문서에 포트를 엽니다.

    • frameId

      번호 선택사항

      탭의 모든 프레임이 아닌 frameId로 식별되는 특정 프레임에 포트를 엽니다.

    • 이름

      문자열 선택사항

      연결 이벤트를 수신 대기하는 콘텐츠 스크립트의 onConnect에 전달됩니다.

반환 값

  • 지정된 탭에서 실행되는 콘텐츠 스크립트와 통신하는 데 사용할 수 있는 포트입니다. 탭이 닫히거나 존재하지 않으면 포트의 runtime.Port 이벤트가 발생합니다.

create()

chrome.tabs.create(
  createProperties: object,
): Promise<Tab>

새 탭을 만듭니다.

매개변수

  • createProperties

    객체

    • 운영중

      불리언 선택사항

      탭이 창에서 활성 탭이 되어야 하는지 여부입니다. 창에 포커스가 있는지 여부에는 영향을 미치지 않습니다 (windows.update 참고). 기본값은 true입니다.

    • 색인

      번호 선택사항

      탭이 창에서 차지해야 하는 위치입니다. 제공된 값은 0과 창의 탭 수 사이로 제한됩니다.

    • openerTabId

      번호 선택사항

      이 탭을 연 탭의 ID입니다. 지정된 경우 오프너 탭은 새로 생성된 탭과 동일한 창에 있어야 합니다.

    • 고정됨

      불리언 선택사항

      탭을 고정해야 하는지 여부입니다. 기본값은 false입니다.

    • 선택됨

      불리언 선택사항

      지원 중단됨

      active를 사용하세요.

      탭이 창에서 선택된 탭이 되어야 하는지 여부입니다. 기본값은 true입니다.

    • URL

      문자열 선택사항

      탭을 처음 탐색할 URL입니다. 정규화된 URL에는 스킴 (예: 'www.google.com'이 아닌 'http://www.google.com'). 상대 URL은 확장 프로그램 내의 현재 페이지를 기준으로 합니다. 기본값은 새 탭 페이지입니다.

    • windowId

      번호 선택사항

      새 탭을 만들 창입니다. 기본값은 현재 창입니다.

반환 값

  • Promise<Tab>

    Chrome 88 이상

detectLanguage()

chrome.tabs.detectLanguage(
  tabId?: number,
): Promise<string>

탭에 있는 콘텐츠의 기본 언어를 감지합니다.

매개변수

  • tabId

    번호 선택사항

    기본값은 현재 창의 활성 탭입니다.

반환 값

  • Promise<string>

    Chrome 88 이상

discard()

Chrome 54 이상 
chrome.tabs.discard(
  tabId?: number,
): Promise<Tab | undefined>

메모리에서 탭을 삭제합니다. 탭 표시줄에 닫은 탭이 계속 표시되며 활성화되면 다시 로드됩니다.

매개변수

  • tabId

    번호 선택사항

    삭제할 탭의 ID입니다. 지정된 경우 탭이 활성 상태이거나 이미 닫혀 있지 않으면 탭이 닫힙니다. 생략하면 브라우저에서 중요도가 가장 낮은 탭을 삭제합니다. 삭제 가능한 탭이 없으면 실패할 수 있습니다.

반환 값

  • Promise<Tab | undefined>

    Chrome 88 이상

duplicate()

chrome.tabs.duplicate(
  tabId: number,
): Promise<Tab | undefined>

탭을 복제합니다.

매개변수

  • tabId

    숫자

    복제할 탭의 ID입니다.

반환 값

  • Promise<Tab | undefined>

    Chrome 88 이상

get()

chrome.tabs.get(
  tabId: number,
): Promise<Tab>

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

매개변수

  • tabId

    숫자

반환 값

  • Promise<Tab>

    Chrome 88 이상

getCurrent()

chrome.tabs.getCurrent(): Promise<Tab | undefined>

이 스크립트 호출이 이루어지는 탭을 가져옵니다. 탭이 아닌 컨텍스트 (예: 백그라운드 페이지 또는 팝업 뷰)에서 호출된 경우 undefined를 반환합니다.

반환 값

  • Promise<Tab | undefined>

    Chrome 88 이상

getZoom()

chrome.tabs.getZoom(
  tabId?: number,
): Promise<number>

지정된 탭의 현재 확대/축소 비율을 가져옵니다.

매개변수

  • tabId

    번호 선택사항

    현재 확대/축소 비율을 가져올 탭의 ID입니다. 기본값은 현재 창의 활성 탭입니다.

반환 값

  • Promise<number>

    Chrome 88 이상

getZoomSettings()

chrome.tabs.getZoomSettings(
  tabId?: number,
): Promise<ZoomSettings>

지정된 탭의 현재 확대/축소 설정을 가져옵니다.

매개변수

  • tabId

    번호 선택사항

    현재 확대/축소 설정을 가져올 탭의 ID입니다. 기본값은 현재 창의 활성 탭입니다.

반환 값

goBack()

Chrome 72 이상 
chrome.tabs.goBack(
  tabId?: number,
): Promise<void>

이전 페이지가 있는 경우 이전 페이지로 돌아갑니다.

매개변수

  • tabId

    번호 선택사항

    뒤로 이동할 탭의 ID입니다. 기본값은 현재 창의 선택된 탭입니다.

반환 값

  • Promise<void>

    Chrome 88 이상

goForward()

Chrome 72 이상 
chrome.tabs.goForward(
  tabId?: number,
): Promise<void>

다음 페이지로 이동합니다(있는 경우).

매개변수

  • tabId

    번호 선택사항

    앞으로 이동할 탭의 ID입니다. 기본값은 현재 창의 선택된 탭입니다.

반환 값

  • Promise<void>

    Chrome 88 이상

group()

Chrome 88 이상 
chrome.tabs.group(
  options: object,
): Promise<number>

지정된 그룹에 하나 이상의 탭을 추가합니다. 그룹이 지정되지 않은 경우 새로 생성된 그룹에 지정된 탭을 추가합니다.

매개변수

  • 옵션

    객체

    • createProperties

      객체 선택사항

      그룹 생성 구성입니다. groupId가 이미 지정된 경우에는 사용할 수 없습니다.

      • windowId

        번호 선택사항

        새 그룹의 창입니다. 기본값은 현재 창입니다.

    • groupId

      번호 선택사항

      탭을 추가할 그룹의 ID입니다. 지정하지 않으면 새 그룹이 생성됩니다.

    • tabIds

      number | [number, ...number[]]

      지정된 그룹에 추가할 탭 ID 또는 탭 ID 목록입니다.

반환 값

  • Promise<number>

highlight()

chrome.tabs.highlight(
  highlightInfo: object,
): Promise<windows.Window>

지정된 탭을 강조 표시하고 그룹의 첫 번째 탭에 포커스를 맞춥니다. 지정된 탭이 현재 활성 상태인 경우 아무것도 하지 않는 것처럼 보입니다.

매개변수

  • highlightInfo

    객체

    • 탭

      number | number[]

      강조할 탭 색인 하나 이상입니다.

    • windowId

      번호 선택사항

      탭이 포함된 창입니다.

반환 값

move()

chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
): Promise<Tab | Tab[]>

하나 이상의 탭을 창 내의 새 위치 또는 새 창으로 이동합니다. 탭은 일반 (window.type === 'normal') 창으로만 이동할 수 있습니다.

매개변수

  • tabIds

    number | number[]

    이동할 탭 ID 또는 탭 ID 목록입니다.

  • moveProperties

    객체

    • 색인

      숫자

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

    • windowId

      번호 선택사항

      기본값은 탭이 현재 있는 창입니다.

반환 값

  • Promise<Tab | Tab[]>

    Chrome 88 이상

query()

chrome.tabs.query(
  queryInfo: object,
): Promise<Tab[]>

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

매개변수

  • queryInfo

    객체

    • 운영중

      불리언 선택사항

      탭이 창에서 활성 상태인지 여부입니다.

    • 오더블

      불리언 선택사항

      Chrome 45 이상

      탭이 들리는지 여부입니다.

    • autoDiscardable

      불리언 선택사항

      Chrome 54 이상

      리소스가 부족할 때 브라우저에서 탭을 자동으로 삭제할 수 있는지 여부입니다.

    • currentWindow

      불리언 선택사항

      탭이 현재 창에 있는지 여부입니다.

    • 삭제됨

      불리언 선택사항

      Chrome 54 이상

      탭이 삭제되었는지 여부입니다. 탭이 닫히면 콘텐츠가 메모리에서 언로드되지만 탭 스트립에는 계속 표시됩니다. 다음에 활성화되면 콘텐츠가 다시 로드됩니다.

    • 겨울왕국

      불리언 선택사항

      Chrome 132 이상

      탭이 정지되었는지 여부입니다. 고정된 탭은 이벤트 핸들러나 타이머를 비롯한 작업을 실행할 수 없습니다. 탭 스트립에 표시되고 콘텐츠가 메모리에 로드됩니다. 활성화되면 고정이 해제됩니다.

    • groupId

      번호 선택사항

      Chrome 88 이상

      탭이 속한 그룹의 ID입니다. 그룹화되지 않은 탭의 경우 tabGroups.TAB_GROUP_ID_NONE입니다.

    • 눈에 띄는 채팅 메시지

      불리언 선택사항

      탭이 강조 표시되는지 여부입니다.

    • 색인

      번호 선택사항

      창 내 탭의 위치입니다.

    • lastFocusedWindow

      불리언 선택사항

      탭이 마지막으로 포커스가 맞춰진 창에 있는지 여부입니다.

    • 음소거

      불리언 선택사항

      Chrome 45 이상

      탭이 음소거되었는지 여부입니다.

    • 고정됨

      불리언 선택사항

      탭이 고정되었는지 여부입니다.

    • splitViewId

      번호 선택사항

      대기 중

      탭이 있는 분할 보기의 ID입니다. 분할 보기에 없는 탭의 경우 tabs.SPLIT_VIEW_ID_NONE입니다.

    • 상태

      TabStatus 선택사항

      탭 로드 상태입니다.

    • 제목

      문자열 선택사항

      페이지 제목을 패턴과 일치시킵니다. 확장 프로그램에 "tabs" 권한이나 페이지의 호스트 권한이 없으면 이 속성은 무시됩니다.

    • URL

      문자열 | 문자열[] 선택사항

      하나 이상의 URL 패턴과 탭을 일치시킵니다. 프래그먼트 식별자는 일치하지 않습니다. 확장 프로그램에 "tabs" 권한이나 페이지의 호스트 권한이 없으면 이 속성은 무시됩니다.

    • windowId

      번호 선택사항

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

    • windowType

      WindowType 선택사항

      탭이 있는 창의 유형입니다.

반환 값

  • Promise<Tab[]>

    Chrome 88 이상

reload()

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
): Promise<void>

탭을 새로고침합니다.

매개변수

  • tabId

    번호 선택사항

    새로고침할 탭의 ID입니다. 기본값은 현재 창의 선택된 탭입니다.

  • reloadProperties

    객체 선택사항

    • bypassCache

      불리언 선택사항

      로컬 캐싱을 우회할지 여부입니다. 기본값은 false입니다.

반환 값

  • Promise<void>

    Chrome 88 이상

remove()

chrome.tabs.remove(
  tabIds: number | number[],
): Promise<void>

하나 이상의 탭을 닫습니다.

매개변수

  • tabIds

    number | number[]

    닫을 탭 ID 또는 탭 ID 목록입니다.

반환 값

  • Promise<void>

    Chrome 88 이상

sendMessage()

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
): Promise<any>

지정된 탭의 콘텐츠 스크립트에 단일 메시지를 전송합니다. 응답이 다시 전송될 때 실행할 선택적 콜백이 있습니다. runtime.onMessage 이벤트는 현재 확장 프로그램의 지정된 탭에서 실행되는 각 콘텐츠 스크립트에서 발생합니다.

매개변수

  • tabId

    숫자

  • 메시지

    모두

    전송할 메시지입니다. 이 메시지는 JSON으로 변환 가능한 객체여야 합니다.

  • 옵션

    객체 선택사항

    • documentId

      문자열 선택사항

      Chrome 106 이상

      탭의 모든 프레임 대신 documentId로 식별되는 특정 문서에 메시지를 보냅니다.

    • frameId

      번호 선택사항

      탭의 모든 프레임이 아닌 frameId로 식별된 특정 프레임에 메시지를 보냅니다.

반환 값

  • Promise<any>

    Chrome 99 이상

setZoom()

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
): Promise<void>

지정된 탭을 확대합니다.

매개변수

  • tabId

    번호 선택사항

    확대할 탭의 ID입니다. 기본값은 현재 창의 활성 탭입니다.

  • zoomFactor

    숫자

    새 확대/축소 비율입니다. 0 값은 탭을 현재 기본 확대/축소 비율로 설정합니다. 0보다 큰 값은 탭의 (기본값이 아닐 수 있는) 확대/축소 비율을 지정합니다.

반환 값

  • Promise<void>

    Chrome 88 이상

setZoomSettings()

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
): Promise<void>

지정된 탭의 확대/축소 설정을 설정합니다. 이 설정은 확대/축소 변경사항이 처리되는 방식을 정의합니다. 이러한 설정은 탭을 탐색하면 기본값으로 재설정됩니다.

매개변수

  • tabId

    번호 선택사항

    확대/축소 설정을 변경할 탭의 ID입니다. 기본값은 현재 창의 활성 탭입니다.

  • zoomSettings

    ZoomSettings

    확대/축소 변경사항이 처리되는 방식과 범위를 정의합니다.

반환 값

  • Promise<void>

    Chrome 88 이상

ungroup()

Chrome 88 이상 
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
): Promise<void>

각 그룹에서 하나 이상의 탭을 삭제합니다. 비어 있는 그룹은 삭제됩니다.

매개변수

  • tabIds

    number | [number, ...number[]]

    각 그룹에서 삭제할 탭 ID 또는 탭 ID 목록입니다.

반환 값

  • Promise<void>

update()

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
): Promise<Tab | undefined>

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

매개변수

  • tabId

    번호 선택사항

    기본값은 현재 창의 선택된 탭입니다.

  • updateProperties

    객체

    • 운영중

      불리언 선택사항

      탭이 활성 상태여야 하는지 여부입니다. 창에 포커스가 있는지 여부에는 영향을 미치지 않습니다 (windows.update 참고).

    • autoDiscardable

      불리언 선택사항

      Chrome 54 이상

      리소스가 부족할 때 브라우저에서 탭을 자동으로 삭제해야 하는지 여부입니다.

    • 눈에 띄는 채팅 메시지

      불리언 선택사항

      현재 선택 항목에서 탭을 추가하거나 삭제합니다.

    • 음소거

      불리언 선택사항

      Chrome 45 이상

      탭의 음소거 여부입니다.

    • openerTabId

      번호 선택사항

      이 탭을 연 탭의 ID입니다. 지정된 경우 오프너 탭은 이 탭과 동일한 창에 있어야 합니다.

    • 고정됨

      불리언 선택사항

      탭을 고정해야 하는지 여부입니다.

    • 선택됨

      불리언 선택사항

      지원 중단됨

      강조 표시를 사용하세요.

      탭을 선택해야 하는지 여부입니다.

    • URL

      문자열 선택사항

      탭을 탐색할 URL입니다. JavaScript URL은 지원되지 않습니다. 대신 scripting.executeScript을 사용하세요.

반환 값

  • Promise<Tab | undefined>

    Chrome 88 이상

이벤트

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

창의 활성 탭이 변경될 때 발생합니다. 이 이벤트가 발생할 때 탭의 URL이 설정되지 않을 수 있지만 URL이 설정될 때 알림을 받도록 onUpdated 이벤트를 수신할 수 있습니다.

매개변수

  • callback

    함수

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

    (activeInfo: object) => void

    • activeInfo

      객체

      • tabId

        숫자

        활성화된 탭의 ID입니다.

      • windowId

        숫자

        활성 탭이 변경된 창의 ID입니다.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

탭이 창에 연결될 때 발생합니다. 예를 들어 창 간에 이동되었기 때문입니다.

매개변수

  • callback

    함수

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

    (tabId: number, attachInfo: object) => void

    • tabId

      숫자

    • attachInfo

      객체

      • newPosition

        숫자

      • newWindowId

        숫자

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

탭이 생성될 때 발생합니다. 이 이벤트가 발생할 때 탭의 URL과 탭 그룹 멤버십이 설정되지 않을 수 있지만 URL이 설정되거나 탭이 탭 그룹에 추가될 때 알림을 받도록 onUpdated 이벤트를 수신할 수 있습니다.

매개변수

  • callback

    함수

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

    (tab: Tab) => void

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

탭이 창에서 분리될 때 발생합니다. 예를 들어 창 간에 이동되었기 때문입니다.

매개변수

  • callback

    함수

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

    (tabId: number, detachInfo: object) => void

    • tabId

      숫자

    • detachInfo

      객체

      • oldPosition

        숫자

      • oldWindowId

        숫자

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

창에서 강조 표시되거나 선택된 탭이 변경될 때 발생합니다.

매개변수

  • callback

    함수

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

    (highlightInfo: object) => void

    • highlightInfo

      객체

      • tabIds

        number[]

        창에서 강조 표시된 모든 탭

      • windowId

        숫자

        탭이 변경된 창입니다.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

탭이 창 내에서 이동될 때 발생합니다. 사용자가 직접 이동한 탭을 나타내는 이동 이벤트가 하나만 발생합니다. 수동으로 이동한 탭에 따라 이동해야 하는 다른 탭에는 이동 이벤트가 발생하지 않습니다. 이 이벤트는 탭이 창 간에 이동될 때는 발생하지 않습니다. 자세한 내용은 tabs.onDetached을 참고하세요.

매개변수

  • callback

    함수

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

    (tabId: number, moveInfo: object) => void

    • tabId

      숫자

    • moveInfo

      객체

      • fromIndex

        숫자

      • toIndex

        숫자

      • windowId

        숫자

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

탭이 닫힐 때 발생합니다.

매개변수

  • callback

    함수

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

    (tabId: number, removeInfo: object) => void

    • tabId

      숫자

    • removeInfo

      객체

      • isWindowClosing

        부울

        상위 창이 닫혀 탭이 닫힌 경우 true입니다.

      • windowId

        숫자

        탭이 닫힌 창입니다.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

사전 렌더링 또는 인스턴트로 인해 탭이 다른 탭으로 대체될 때 발생합니다.

매개변수

  • callback

    함수

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

    (addedTabId: number, removedTabId: number) => void

    • addedTabId

      숫자

    • removedTabId

      숫자

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

탭이 업데이트될 때 발생합니다.

매개변수

  • callback

    함수

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

    (tabId: number, changeInfo: object, tab: Tab) => void

    • tabId

      숫자

    • changeInfo

      객체

      • 오더블

        불리언 선택사항

        Chrome 45 이상

        탭의 새로운 오디오 상태입니다.

      • autoDiscardable

        불리언 선택사항

        Chrome 54 이상

        탭의 새로운 자동 폐기 가능 상태입니다.

      • 삭제됨

        불리언 선택사항

        Chrome 54 이상

        탭의 새로운 폐기 상태입니다.

      • favIconUrl

        문자열 선택사항

        탭의 새 파비콘 URL입니다.

      • 겨울왕국

        불리언 선택사항

        Chrome 132 이상

        탭의 새로운 고정 상태입니다.

      • groupId

        번호 선택사항

        Chrome 88 이상

        탭의 새 그룹입니다.

      • mutedInfo

        MutedInfo 선택사항

        Chrome 46 이상

        탭의 새로운 음소거 상태와 변경 이유입니다.

      • 고정됨

        불리언 선택사항

        탭의 새로운 고정 상태입니다.

      • splitViewId

        번호 선택사항

        대기 중

        탭의 새 분할 보기입니다.

      • 상태

        TabStatus 선택사항

        탭의 로드 상태입니다.

      • 제목

        문자열 선택사항

        Chrome 48 이상

        탭의 새 제목입니다.

      • URL

        문자열 선택사항

        탭의 URL(변경된 경우)

    • 탭

      Tab

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

탭이 확대될 때 발생합니다.

매개변수

  • callback

    함수

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

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      객체

      • newZoomFactor

        숫자

      • oldZoomFactor

        숫자

      • tabId

        숫자

      • zoomSettings

        ZoomSettings