chrome.management

설명

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

권한

management

매니페스트

관리 API를 사용하려면 확장 프로그램 매니페스트에서 'management' 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.

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

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

유형

ExtensionDisabledReason

Chrome 44 이상

상품이 사용 중지된 이유입니다.

열거형

"unknown"

"permissions_increase"

ExtensionInfo

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

속성

  • appLaunchUrl

    문자열 선택사항

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

  • availableLaunchTypes

    LaunchType[] 선택사항

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

  • 설명

    문자열

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

  • disabledReason

    ExtensionDisabledReason 선택사항

    상품이 사용 중지된 이유입니다.

  • 사용 설정됨

    부울

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

  • homepageUrl

    문자열 선택사항

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

  • hostPermissions

    문자열[]

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

  • 아이콘

    IconInfo[] 선택사항

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

  • id

    문자열

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

  • installType

    ExtensionInstallType

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

  • isApp

    부울

    지원 중단됨

    management.ExtensionInfo.type를 사용하세요.

    앱인 경우 true입니다.

  • launchType

    LaunchType 선택사항

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

  • mayDisable

    부울

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

  • mayEnable

    불리언 선택사항

    Chrome 62 이상

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

  • 이름

    문자열

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

  • offlineEnabled

    부울

    확장 프로그램, 앱 또는 테마가 오프라인을 지원한다고 선언하는지 여부입니다.

  • optionsUrl

    문자열

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

  • 권한

    문자열[]

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

  • shortName

    문자열

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

  • 유형

    ExtensionType

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

  • updateUrl

    문자열 선택사항

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

  • version

    문자열

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

  • versionName

    문자열 선택사항

    Chrome 50 이상

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

ExtensionInstallType

Chrome 44 이상

확장 프로그램이 설치된 방법입니다. admin: 관리 정책으로 인해 확장 프로그램이 설치되었습니다. development: 개발자 모드에서 확장 프로그램이 압축 해제된 상태로 로드되었습니다. normal: .crx 파일을 통해 확장 프로그램이 정상적으로 설치되었습니다. sideload: 머신에 있는 다른 소프트웨어에 의해 확장 프로그램이 설치되었습니다. other: 다른 수단으로 확장 프로그램이 설치되었습니다.

열거형

"admin"

"development"

"normal"

'sideload'

'other'

ExtensionType

Chrome 44 이상

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

열거형

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

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

속성

  • 크기

    숫자

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

  • URL

    문자열

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

LaunchType

가능한 모든 앱 실행 유형입니다.

열거형

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 이상

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

속성

  • showConfirmDialog

    불리언 선택사항

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

메서드

createAppShortcut()

Promise 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

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

매개변수

  • id

    문자열

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

Promise 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

URL의 앱을 생성합니다. 생성된 북마크 앱을 반환합니다.

매개변수

  • URL

    문자열

    웹페이지의 URL입니다. URL의 스키마는 'http' 또는 'https'만 가능합니다.

  • 제목

    문자열

    생성된 앱의 제목입니다.

  • callback

    함수 선택사항

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

    (result: ExtensionInfo) => void

반환 값

  • Promise<ExtensionInfo>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

get()

Promise 
chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

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

매개변수

반환 값

  • Promise<ExtensionInfo>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getAll()

Promise 
chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

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

매개변수

  • callback

    함수 선택사항

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

    (result: ExtensionInfo[]) => void

반환 값

  • Promise<ExtensionInfo[]>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getPermissionWarningsById()

Promise 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

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

매개변수

  • id

    문자열

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

  • callback

    함수 선택사항

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      문자열[]

반환 값

  • Promise<string[]>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getPermissionWarningsByManifest()

Promise 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

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

매개변수

  • manifestStr

    문자열

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

  • callback

    함수 선택사항

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      문자열[]

반환 값

  • Promise<string[]>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getSelf()

Promise 
chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

호출 확장 프로그램, 앱 또는 테마에 관한 정보를 반환합니다. 참고: 이 함수는 매니페스트에서 '관리' 권한을 요청하지 않고도 사용할 수 있습니다.

매개변수

  • callback

    함수 선택사항

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

    (result: ExtensionInfo) => void

반환 값

  • Promise<ExtensionInfo>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

installReplacementWebApp()

Promise Chrome 77 이상 
chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

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

매개변수

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

launchApp()

Promise 
chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

애플리케이션을 실행합니다.

매개변수

  • id

    문자열

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setEnabled()

Promise 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

앱 또는 확장 프로그램을 사용 설정하거나 사용 중지합니다. 대부분의 경우 이 함수는 사용자 동작 (예: 버튼의 onclick 핸들러)의 컨텍스트에서 호출해야 하며, 악용을 방지하는 방법으로 사용자에게 네이티브 확인 UI를 표시할 수 있습니다.

매개변수

  • id

    문자열

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

  • 사용 설정됨

    부울

    이 항목을 사용 설정해야 하는지 사용 중지해야 하는지 여부입니다.

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setLaunchType()

Promise 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

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

매개변수

  • id

    문자열

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

  • launchType

    LaunchType

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

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

uninstall()

Promise 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

매개변수

반환 값

  • Promise<void>

    Chrome 88 이상

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

uninstallSelf()

Promise 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

매개변수

  • 옵션

    UninstallOptions 선택사항

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 88 이상

    Promise는 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

    함수

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

    (id: string) => void

    • id

      문자열