chrome.app.runtime

설명

chrome.app.runtime API를 사용하여 앱 수명 주기를 관리합니다. 앱 런타임은 앱 설치를 관리하고 이벤트 페이지를 제어하며 언제든지 앱을 종료할 수 있습니다.

유형

ActionData

Chrome 54 이상

속성

  • actionType

    "new_note"

ActionType

Chrome 54 이상

새 메모 작성과 같은 특정 작업을 염두에 두고 앱을 실행할 수 있습니다. 앱이 실행된 작업 유형은 LaunchData 인스턴스의 actionData 필드 내에서 사용할 수 있습니다.

가치

"new_note"

EmbedRequest

속성

  • 데이터

    선택사항

    삽입을 결정할 때 삽입할 앱에서 사용할 수 있는 선택적 개발자 지정 데이터입니다.

  • embedderId

    문자열

  • 허용

    void

    embedderId이(가) <appview> 요소에 이 앱을 삽입하도록 허용합니다. url는 삽입할 콘텐츠를 지정합니다.

    allow 함수는 다음과 같습니다. 

    (url: string) => {...}

    • url

      문자열

  • deny

    void

    embedderId가 <appview> 요소에 이 앱을 삽입하지 못하게 합니다.

    deny 함수는 다음과 같습니다. 

    () => {...}

LaunchData

속성

  • actionData

    ActionData 선택사항

    Chrome 54 이상

    이 앱이 실행된 ActionType를 지정하는 데이터를 포함합니다. 앱이 특정 작업 인텐트로 실행되지 않은 경우 null입니다.

  • id

    문자열(선택사항)

    앱을 호출하는 데 사용되는 파일 또는 URL 핸들러의 ID입니다. 핸들러 ID는 매니페스트의 file_handlers 또는 url_handlers 사전에 있는 최상위 키입니다.

  • isKioskSession

    불리언 선택사항

    앱이 Chrome OS 키오스크 세션에서 실행되는지 여부

  • isPublicSession

    불리언 선택사항

    Chrome 47 이상

    Chrome OS 공개 세션에서 앱이 실행되는지 여부

  • items

    LaunchItem[] 선택사항

    file_handlers 매니페스트 키의 일치하는 파일 핸들러에 의해 트리거되는 onLaunched 이벤트의 파일 항목입니다.

  • referrerUrl

    문자열(선택사항)

    url_handlers 매니페스트 키에서 일치하는 URL 핸들러에 의해 트리거된 onLaunched 이벤트의 리퍼러 URL.

  • source

    LaunchSource 선택사항

    앱이 실행된 위치

  • url

    문자열(선택사항)

    url_handlers 매니페스트 키에서 일치하는 URL 핸들러에 의해 트리거되는 onLaunched 이벤트의 URL입니다.

LaunchItem

속성

  • entry

    항목

    항목의 항목입니다.

  • 유형

    문자열(선택사항)

    파일의 MIME 유형입니다.

LaunchSource

앱 실행 소스의 열거형입니다. component/services/app_service/public/mojom/types.mojom의 AppLaunchSource와 extensions/browser/api/app_runtime/app_runtime_api.cc의 GetLaunchSourceEnum()과 동기화해야 합니다. 열거형은 UMA 히스토그램에 사용되므로 항목을 재정렬하거나 삭제하지 마세요.

enum

"command_line"

"file_handler"

"url_handler"

"system_tray"

"extensions_page"

"management_api"

"test"

"context_menu"

"intent_url"

이벤트

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

삽입 앱에서 이 앱 삽입을 요청하면 실행됩니다. 이 이벤트는 --enable-app-view 플래그가 있는 개발 채널에서만 사용할 수 있습니다.

매개변수

  • callback

    기능

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

    (request: EmbedRequest) => void

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

앱이 런처에서 시작될 때 실행됩니다.

매개변수

  • callback

    기능

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

    (launchData?: LaunchData) => void

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

Chrome 시작 시 Chrome이 마지막으로 종료될 때 실행 중이던 앱에서 실행되거나 다른 이유로 앱이 이전 상태에서 다시 시작되도록 요청된 경우 (예: 사용자가 앱의 보관된 파일에 대한 액세스 권한을 취소하는 경우 런타임에서 앱을 다시 시작함) 실행됩니다. 이러한 상황에서는 앱에 onRestarted 핸들러가 없으면 대신 onLaunched 이벤트가 전송됩니다.

매개변수

  • callback

    기능

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

    () => void