chrome.extension

설명

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

유형

ViewType

Chrome 44 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

열거형

"탭"

"popup"

속성

inIncognitoContext

시크릿 탭 내에서 실행되는 콘텐츠 스크립트와 시크릿 프로세스 내에서 실행되는 확장 프로그램 페이지의 경우 true입니다. 후자는 '분할'이 있는 확장 프로그램에만 적용됩니다. Incognito_behavior입니다.

유형

부울

lastError

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 Chrome 58부터 지원 중단됨

runtime.lastError을(를) 사용하세요.

비동기 확장 API로 인해 오류가 발생한 경우 콜백의 전체 기간으로 설정됩니다. 오류가 발생하지 않은 lastError는 undefined입니다.

유형

객체

속성

  • 메시지

    문자열

    발생한 오류에 대한 설명입니다.

메서드

getBackgroundPage()

<ph type="x-smartling-placeholder"></ph> 포그라운드만 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.extension.getBackgroundPage()

JavaScript 'window'를 반환합니다. 객체를 정의합니다. 확장 프로그램에 백그라운드 페이지가 없는 경우 null을 반환합니다.

반환 값

  • 기간 | 정의되지 않음

getExtensionTabs()

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 포그라운드만 지원 중단됨
chrome.extension.getExtensionTabs(
  windowId?: number,
)

extension.getViews {type: "tab"}을(를) 사용하세요.

JavaScript 'window'의 배열을 반환합니다. 객체를 정의합니다. windowId가 지정되면 'window'만 반환됩니다. 지정된 창에 연결된 탭의 객체입니다.

매개변수

  • windowId

    숫자 선택사항

반환 값

  • 기간[]

    전역 창 객체의 배열

getURL()

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 Chrome 58부터 지원 중단됨
chrome.extension.getURL(
  path: string,
)

runtime.getURL을(를) 사용하세요.

확장 프로그램 설치 디렉터리 내의 상대 경로를 정규화된 URL로 변환합니다.

매개변수

  • 경로

    문자열

    설치 디렉터리를 기준으로 표현된 확장 프로그램 내의 리소스 경로입니다.

반환 값

  • 문자열

    리소스의 정규화된 URL.

getViews()

<ph type="x-smartling-placeholder"></ph> 포그라운드만 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.extension.getViews(
  fetchProperties?: object,
)

JavaScript 'window'의 배열을 반환합니다. 각 페이지에 대한 객체를 정의합니다.

매개변수

  • fetchProperties

    객체(선택사항)

    • tabId

      숫자 선택사항

      Chrome 54 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

    • 유형

      ViewType 선택사항

      가져올 뷰의 유형입니다. 생략하면 모든 보기 (백그라운드 페이지 및 탭 포함)가 반환됩니다.

    • windowId

      숫자 선택사항

      검색을 제한할 창입니다. 생략하면 모든 뷰를 반환합니다.

반환 값

  • 기간[]

    전역 객체의 배열

isAllowedFileSchemeAccess()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

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

매개변수

  • 콜백

    함수 선택사항

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      부울

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

반환 값

  • Promise&lt;boolean&gt;

    Chrome 99 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

isAllowedIncognitoAccess()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

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

매개변수

  • 콜백

    함수 선택사항

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      부울

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

반환 값

  • Promise&lt;boolean&gt;

    Chrome 99 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

sendRequest()

<ph type="x-smartling-placeholder"></ph> 프로미스 에서 확인하세요. &amp;leq; MV2 지원 중단됨
chrome.extension.sendRequest(
  extensionId?: string,
  request: any,
  callback?: function,
)

runtime.sendMessage을(를) 사용하세요.

확장 프로그램 내의 다른 리스너에 단일 요청을 보냅니다. runtime.connect와 비슷하지만 선택적 응답과 함께 단일 요청만 보냅니다. extension.onRequest 이벤트는 확장 프로그램의 각 페이지에서 실행됩니다.

매개변수

  • extensionId

    문자열(선택사항)

    연결하려는 확장 프로그램의 ID입니다. 생략할 경우 기본값은 자체 확장입니다.

  • 요청

    모두

  • 콜백

    함수 선택사항

    Chrome 99 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

    (response: any) => void

    • 응답

      모두

      요청 핸들러에서 전송한 JSON 응답 객체입니다. 확장 프로그램에 연결하는 동안 오류가 발생하면 인수 없이 콜백이 호출되고 runtime.lastError이 오류 메시지로 설정됩니다.

반환 값

  • 약속<any>

    Chrome 99 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

매개변수

  • 데이터

    문자열

이벤트

onRequest

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 지원 중단됨
chrome.extension.onRequest.addListener(
  callback: function,
)

runtime.onMessage을(를) 사용하세요.

확장 프로그램 프로세스 또는 콘텐츠 스크립트에서 요청이 전송될 때 실행됩니다.

매개변수

  • 콜백

    함수

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

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • 요청

      모두

    • sendResponse

      함수

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

      () => void

onRequestExternal

<ph type="x-smartling-placeholder"></ph> &amp;leq; MV2 지원 중단됨
chrome.extension.onRequestExternal.addListener(
  callback: function,
)

runtime.onMessageExternal을(를) 사용하세요.

다른 확장 프로그램에서 요청이 전송될 때 실행됩니다.

매개변수

  • 콜백

    함수

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

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • 요청

      모두

    • sendResponse

      함수

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

      () => void