chrome.extension

설명

chrome.extension API에는 모든 확장 프로그램 페이지에서 사용할 수 있는 유틸리티가 있습니다. 메시지 전달에 자세히 설명된 대로 확장 프로그램과 콘텐츠 스크립트 간에 또는 확장 프로그램 간에 메시지를 교환하는 지원이 포함됩니다.

유형

ViewType

Chrome 44 이상

확장 프로그램 뷰 유형입니다.

열거형

'탭'

"팝업"

속성

inIncognitoContext

시크릿 탭 내에서 실행되는 콘텐츠 스크립트와 시크릿 프로세스 내에서 실행되는 확장 프로그램 페이지에 true입니다. 후자는 incognito_behavior가 'split'인 확장 프로그램에만 적용됩니다.

유형

부울

메서드

getBackgroundPage()

포그라운드 전용 
chrome.extension.getBackgroundPage()

현재 확장 프로그램 내에서 실행 중인 백그라운드 페이지의 JavaScript 'window' 객체를 반환합니다. 확장 프로그램에 백그라운드 페이지가 없는 경우 null을 반환합니다.

반환 값

  • Window | undefined

getViews()

포그라운드 전용 
chrome.extension.getViews(
  fetchProperties?: object,
)

현재 확장 프로그램 내에서 실행 중인 각 페이지의 JavaScript 'window' 객체 배열을 반환합니다.

매개변수

  • fetchProperties

    객체 선택사항

    • tabId

      번호 선택사항

      Chrome 54 이상

      탭 ID에 따라 뷰를 찾습니다. 이 필드를 생략하면 모든 뷰가 반환됩니다.

    • 유형

      ViewType 선택사항

      가져올 뷰 유형입니다. 생략하면 배경 페이지 및 탭을 포함한 모든 뷰를 반환합니다.

    • windowId

      번호 선택사항

      검색을 제한할 기간입니다. 생략하면 모든 뷰가 반환됩니다.

반환 값

  • Window[]

    전역 객체 배열

isAllowedFileSchemeAccess()

Promise 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

'file://' 스키마에 대한 확장 프로그램의 액세스 상태를 검색합니다. 이는 chrome://extensions 페이지를 통해 액세스할 수 있는 사용자 제어 확장 프로그램별 '파일 URL에 대한 액세스 허용' 설정에 해당합니다.

매개변수

  • 콜백

    함수 선택사항

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      부울

      확장 프로그램이 'file://' 스키마에 액세스할 수 있으면 true이고, 그렇지 않으면 false입니다.

반환 값

  • Promise<boolean>

    Chrome 99 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

isAllowedIncognitoAccess()

Promise 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

시크릿 모드에 대한 확장 프로그램 액세스의 상태를 검색합니다. 이는 chrome://extensions 페이지를 통해 액세스할 수 있는 사용자 제어 확장 프로그램별 '시크릿 모드에서 허용됨' 설정에 해당합니다.

매개변수

  • 콜백

    함수 선택사항

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      부울

      확장 프로그램이 시크릿 모드에 액세스할 수 있는 경우 true, 그렇지 않은 경우 false입니다.

반환 값

  • Promise<boolean>

    Chrome 99 이상

    Promise는 매니페스트 V3 이상에서 지원되지만 이전 버전과의 호환성을 위해 콜백이 제공됩니다. 동일한 함수 호출에서 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

확장 프로그램의 업데이트 URL에 사용되는 ap CGI 매개변수의 값을 설정합니다. Chrome 확장 프로그램 갤러리에 호스팅된 확장 프로그램의 경우 이 값이 무시됩니다.

매개변수

  • 데이터

    문자열

이벤트