chrome.management

설명

chrome.management API는 설치된 앱과 확장 프로그램을 관리하는 방법을 제공합니다.

권한

management

'관리' 관리를 사용하기 위한 확장 프로그램 매니페스트의 권한 API에 액세스할 수 있습니다. 예를 들면 다음과 같습니다.

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

management.getPermissionWarningsByManifest(), management.uninstallSelf(), management.getSelf()에는 관리 권한이 필요하지 않습니다.

유형

ExtensionDisabledReason

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

항목이 사용 중지된 이유입니다.

열거형

"알 수 없음"

"permissions_increase"

ExtensionInfo

설치된 확장 프로그램, 앱 또는 테마에 관한 정보입니다.

속성

  • appLaunchUrl

    문자열(선택사항)

    실행 URL입니다 (앱에만 표시됨).

  • availableLaunchTypes

    LaunchType[] 선택사항

    현재 사용 가능한 실행 유형입니다 (앱에만 있음).

  • 설명

    문자열

    이 확장 프로그램, 앱 또는 테마에 대한 설명입니다.

  • disabledReason

    ExtensionDisabledReason을 선택사항

    항목이 사용 중지된 이유입니다.

  • 사용 설정됨

    부울

    현재 사용 또는 사용 중지 여부

  • homepageUrl

    문자열(선택사항)

    이 확장 프로그램, 앱 또는 테마의 홈페이지 URL입니다.

  • hostPermissions

    문자열[]

    호스트 기반 권한 목록을 반환합니다.

  • 아이콘

    IconInfo[] 선택사항

    아이콘 정보의 목록입니다. 이는 매니페스트에 선언된 내용을 반영할 뿐이며 해당 URL의 실제 이미지는 선언된 이미지보다 크거나 작을 수 있으므로 이러한 이미지를 참조하는 img 태그에 명시적인 너비 및 높이 속성을 사용하는 것을 고려할 수 있습니다. 자세한 내용은 아이콘에 관한 매니페스트 문서를 참고하세요.

  • id

    문자열

    확장 프로그램의 고유 식별자입니다.

  • installType

    ExtensionInstallType

    확장 프로그램이 설치된 방법입니다.

  • isApp

    부울

    <ph type="x-smartling-placeholder"></ph> 지원 중단됨

    management.ExtensionInfo.type을(를) 사용하세요.

    앱인 경우 true입니다.

  • launchType

    LaunchType 선택사항

    앱 실행 유형입니다 (앱에만 있음).

  • mayDisable

    부울

    사용자가 이 확장 프로그램을 사용 중지하거나 제거할 수 있는지 여부입니다.

  • mayEnable

    불리언 선택사항

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

    사용자가 이 확장 프로그램을 사용 설정할 수 있는지 여부입니다. 사용 설정되지 않은 확장 프로그램에 대해서만 반환됩니다.

  • 이름

    문자열

    이 확장 프로그램, 앱 또는 테마의 이름입니다.

  • offlineEnabled

    부울

    확장 프로그램, 앱 또는 테마에서 오프라인 지원을 선언하는지 여부

  • optionsUrl

    문자열

    항목의 옵션 페이지 URL입니다(있는 경우).

  • 권한

    문자열[]

    API 기반 권한 목록을 반환합니다.

  • 닉네임

    문자열

    이 확장 프로그램, 앱 또는 테마의 짧은 버전입니다.

  • 유형

    ExtensionType

    이 확장 프로그램, 앱 또는 테마의 유형입니다.

  • updateUrl

    문자열(선택사항)

    이 확장 프로그램, 앱 또는 테마의 업데이트 URL입니다.

  • version

    문자열

    이 확장 프로그램, 앱 또는 테마의 버전입니다.

  • versionName

    문자열(선택사항)

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

    매니페스트에 지정된 경우 이 확장 프로그램, 앱 또는 테마의 버전 이름입니다.

ExtensionInstallType

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

확장 프로그램이 설치된 방법입니다. 다음 중 하나 admin: 관리 정책으로 인해 확장 프로그램이 설치되었습니다. development: 확장 프로그램이 개발자 모드에서 압축해제되어 로드되었습니다. normal: 확장 프로그램이 .crx 파일을 통해 정상적으로 설치되었습니다. sideload: 컴퓨터의 다른 소프트웨어에 의해 확장 프로그램이 설치되었습니다. other: 확장 프로그램이 다른 방법으로 설치되었습니다.

열거형

"관리자"

"개발"

"normal"

"sideload"

'기타'

ExtensionType

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

이 확장 프로그램, 앱 또는 테마의 유형입니다.

열거형

"확장 프로그램"

'Host_app'

&quot;packaged_app&quot;

&quot;legacy_packaged_app&quot;

"테마"

&quot;login_screen_extension&quot;

IconInfo

확장 프로그램, 앱, 테마에 속한 아이콘에 관한 정보입니다.

속성

  • 크기

    숫자

    아이콘의 너비와 높이를 나타내는 숫자입니다. 가능한 값에는 128, 48, 24, 16이 포함되며 이에 국한되지 않습니다.

  • URL

    문자열

    이 아이콘 이미지의 URL입니다. 아이콘을 그레이 스케일 버전으로 표시하려면 (예: 확장 프로그램이 사용 중지되었음을 나타냄) URL에 ?grayscale=true를 추가합니다.

LaunchType

이는 모두 가능한 앱 실행 유형입니다.

열거형

&quot;OPEN_AS_REGULAR_TAB&quot;

&quot;OPEN_AS_PINNED_TAB&quot;

'OPEN_AS_WINDOW'

'OPEN_FULL_SCREEN'

UninstallOptions

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

확장 프로그램 제거를 처리하는 방법에 대한 옵션입니다.

속성

  • showConfirmDialog

    불리언 선택사항

    제거 확인 대화상자에 사용자에게 메시지를 표시할지 여부입니다. 직접 제거할 경우 기본값은 false입니다. 확장 프로그램이 다른 확장 프로그램을 제거하는 경우 이 매개변수는 무시되고 대화상자가 항상 표시됩니다.

메서드

createAppShortcut()

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

앱 바로가기를 만드는 옵션을 표시합니다. Mac에서는 패키지 앱 바로가기만 만들 수 있습니다.

매개변수

  • id

    문자열

    management.ExtensionInfo 앱 항목의 ID여야 합니다.

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

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

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

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

URL에 대한 앱을 생성합니다. 생성된 북마크 앱을 반환합니다.

매개변수

  • URL

    문자열

    웹페이지의 URL입니다. URL 스키마는 'http'여야 합니다. 또는 'https'로 구성됩니다.

  • 제목

    문자열

    생성된 앱의 제목입니다.

  • 콜백

    함수 선택사항

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

    (result: ExtensionInfo) => void

반환 값

  • Promise&lt;ExtensionInfo&gt;

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

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

get()

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

지정된 ID의 설치된 확장 프로그램, 앱 또는 테마에 관한 정보를 반환합니다.

매개변수

반환 값

  • Promise&lt;ExtensionInfo&gt;

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

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

getAll()

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

설치된 확장 프로그램 및 앱에 관한 정보 목록을 반환합니다.

매개변수

  • 콜백

    함수 선택사항

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

    (result: ExtensionInfo[]) => void

반환 값

  • Promise&lt;ExtensionInfo[]&gt;

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

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

getPermissionWarningsById()

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

지정된 확장 프로그램 ID의 권한 경고 목록을 반환합니다.

매개변수

  • id

    문자열

    이미 설치된 확장 프로그램의 ID입니다.

  • 콜백

    함수 선택사항

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      문자열[]

반환 값

  • Promise&lt;string[]&gt;

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

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

getPermissionWarningsByManifest()

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

지정된 확장 프로그램 매니페스트 문자열의 권한 경고 목록을 반환합니다. 참고: 이 함수는 'management'를 요청하지 않고도 사용할 수 있습니다. 권한을 부여해야 합니다.

매개변수

  • manifestStr

    문자열

    확장 프로그램 매니페스트 JSON 문자열입니다.

  • 콜백

    함수 선택사항

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      문자열[]

반환 값

  • Promise&lt;string[]&gt;

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

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

getSelf()

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

통화 확장 프로그램, 앱 또는 테마에 관한 정보를 반환합니다. 참고: 이 함수는 'management'를 요청하지 않고도 사용할 수 있습니다. 권한을 부여해야 합니다.

매개변수

  • 콜백

    함수 선택사항

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

    (result: ExtensionInfo) => void

반환 값

  • Promise&lt;ExtensionInfo&gt;

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

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

installReplacementWebApp()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 77 이상 
chrome.management.installReplacementWebApp(
  callback?: function,
)

매니페스트에 지정된 replace_web_app을 실행합니다. 아직 설치하지 않은 경우 설치하라는 메시지를 사용자에게 표시합니다.

매개변수

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

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

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

launchApp()

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

애플리케이션을 시작합니다.

매개변수

  • id

    문자열

    애플리케이션의 확장 프로그램 ID입니다.

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

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

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

setEnabled()

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

앱 또는 확장 프로그램을 사용 또는 사용 중지합니다. 대부분의 경우 이 함수는 사용자 동작 (예: 버튼의 온클릭 핸들러)의 컨텍스트에서 호출해야 하며 악용을 방지하기 위해 사용자에게 기본 확인 UI를 표시할 수 있습니다.

매개변수

  • id

    문자열

    management.ExtensionInfo의 항목 ID여야 합니다.

  • 사용 설정됨

    부울

    이 항목의 사용 설정 또는 사용 중지 여부입니다.

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

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

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

setLaunchType()

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

앱의 실행 유형을 설정합니다.

매개변수

  • id

    문자열

    management.ExtensionInfo 앱 항목의 ID여야 합니다.

  • launchType

    LaunchType

    목표 실행 유형입니다. 사용 가능한 실행 유형은 플랫폼과 구성에 따라 다르므로 이 실행 유형이 ExtensionInfo.availableLaunchTypes에 있는지 항상 확인하고 확인하세요.

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

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

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

uninstall()

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

현재 설치된 앱 또는 확장 프로그램을 제거합니다. 참고: 사용자가 지정된 확장 프로그램/앱을 제거할 수 없는 경우 관리형 환경에서 이 함수가 작동하지 않습니다. 제거에 실패하면 (예: 사용자가 대화상자를 취소) 프로미스가 거부되거나 콜백이 runtime.lastError가 설정된 상태로 호출됩니다.

매개변수

반환 값

  • 프로미스<void>

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

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

uninstallSelf()

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

통화 확장 프로그램을 제거합니다. 참고: 이 함수는 'management'를 요청하지 않고도 사용할 수 있습니다. 권한을 부여해야 합니다. 사용자가 지정된 확장 프로그램/앱을 제거할 수 없는 경우 관리형 환경에서 이 함수가 작동하지 않습니다.

매개변수

  • 옵션

    UninstallOptions(선택사항)

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • 프로미스<void>

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

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

이벤트

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

앱 또는 확장 프로그램이 사용 중지되면 실행됩니다.

매개변수

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

앱 또는 확장 프로그램이 사용 설정되었을 때 실행됩니다.

매개변수

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

앱 또는 확장 프로그램이 설치되면 실행됩니다.

매개변수

onUninstalled

chrome.management.onUninstalled.addListener(
  callback: function,
)

앱 또는 확장 프로그램이 제거되면 실행됩니다.

매개변수

  • 콜백

    함수

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

    (id: string) => void

    • id

      문자열