chrome.webviewTag

설명

webview 태그를 사용하여 네트워크를 통해 웹에서 라이브 콘텐츠를 적극적으로 로드하고 Chrome 앱에 삽입합니다. 앱은 webview의 모양을 제어하고 웹 콘텐츠와 상호작용하며, 삽입된 웹페이지에서 탐색을 시작하고, 웹페이지 내에서 발생하는 오류 이벤트에 반응하는 등의 작업을 할 수 있습니다 (사용법 참고).

권한

webview

유형

ClearDataOptions

clearData에 의해 삭제되어야 하는 데이터를 결정하는 옵션입니다.

속성

  • 이후

    번호 선택사항

    이 날짜 이후에 누적된 데이터를 지웁니다. 에포크 이후의 경과 시간(밀리초)으로 표시됩니다(JavaScript Date 객체의 getTime 메서드를 통해 액세스 가능). 없는 경우 기본값은 0입니다 (모든 탐색 데이터가 삭제됨).

ClearDataTypeSet

데이터 유형 집합입니다. 누락된 속성은 false로 해석됩니다.

속성

  • appcache

    불리언 선택사항

    웹사이트의 appcache입니다.

  • 캐시

    불리언 선택사항

    Chrome 44 이상

    Chrome 43부터 브라우저의 캐시 참고: 데이터를 삭제하면 지정한 범위에 국한되지 않고 전체 캐시가 삭제됩니다.

  • 쿠키

    불리언 선택사항

    파티션의 쿠키입니다.

  • fileSystems

    불리언 선택사항

    웹사이트의 파일 시스템입니다.

  • indexedDB

    불리언 선택사항

    웹사이트의 IndexedDB 데이터입니다.

  • localStorage

    불리언 선택사항

    웹사이트의 로컬 스토리지 데이터입니다.

  • persistentCookies

    불리언 선택사항

    Chrome 58 이상

    파티션의 영구 쿠키입니다.

  • sessionCookies

    불리언 선택사항

    Chrome 58 이상

    파티션의 세션 쿠키입니다.

  • webSQL

    불리언 선택사항

    웹사이트의 WebSQL 데이터입니다.

ContentScriptDetails

Chrome 44 이상

삽입할 콘텐츠 스크립트의 세부정보입니다. 자세한 내용은 콘텐츠 스크립트 문서를 참고하세요.

속성

  • all_frames

    불리언 선택사항

    all_framestrue인 경우 JavaScript 또는 CSS가 현재 페이지의 모든 프레임에 삽입되어야 함을 의미합니다. 기본적으로 all_framesfalse이며 JavaScript 또는 CSS는 최상위 프레임에만 삽입됩니다.

  • css

    InjectionItems 선택사항

    일치하는 페이지에 삽입할 CSS 코드 또는 CSS 파일 목록입니다. 이러한 태그는 페이지의 DOM이 구성되거나 표시되기 전에 표시되는 순서대로 삽입됩니다.

  • exclude_globs

    string[] 선택사항

    일치 후 이 glob과 일치하는 URL을 제외하는 데 적용됩니다. @exclude Greasemonkey 키워드를 에뮬레이션하기 위한 것입니다.

  • exclude_matches

    string[] 선택사항

    이 콘텐츠 스크립트가 삽입될 수 있는 페이지를 제외합니다.

  • include_globs

    string[] 선택사항

    일치 후 적용되어 이 glob과도 일치하는 URL만 포함합니다. @include Greasemonkey 키워드를 에뮬레이션하기 위한 것입니다.

  • js

    InjectionItems 선택사항

    일치하는 페이지에 삽입할 JavaScript 코드 또는 JavaScript 파일 목록입니다. 이러한 항목은 표시되는 순서대로 삽입됩니다.

  • match_about_blank

    불리언 선택사항

    about:blank 및 about:srcdoc에 콘텐츠 스크립트를 삽입할지 여부입니다. 콘텐츠 스크립트는 상속된 URL이 matches 필드에 선언된 패턴 중 하나와 일치하는 경우에만 페이지에 삽입됩니다. 상속 URL은 프레임 또는 창을 만든 문서의 URL입니다. 콘텐츠 스크립트는 샌드박스 프레임에 삽입할 수 없습니다.

  • 일치

    문자열[]

    이 콘텐츠 스크립트가 삽입될 페이지를 지정합니다.

  • 이름

    문자열

    삽입할 콘텐츠 스크립트의 이름입니다.

  • run_at

    RunAt 선택사항

    JavaScript 또는 CSS가 탭에 삽입되는 가장 빠른 시간입니다. 기본값은 'document_idle'입니다.

ContentWindow

게스트 창에 대한 메시지 핸들입니다.

속성

  • postMessage

    void

    삽입된 콘텐츠가 타겟 출처의 페이지를 표시하는 한 삽입된 웹 콘텐츠에 메시지를 게시합니다. 이 메서드는 페이지 로드가 완료되면 사용할 수 있습니다. contentload 이벤트를 수신 대기한 다음 메서드를 호출합니다.

    게스트는 수신한 메시지 이벤트에서 event.source에 메시지를 게시하여 삽입자에게 답장을 보낼 수 있습니다.

    이 API는 웹페이지 간 통신을 위한 HTML5 postMessage API와 동일합니다. 삽입기는 자체 프레임에 message 이벤트 리스너를 추가하여 답장을 수신할 수 있습니다.

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

    (message: any, targetOrigin: string) => {...}

    • 메시지

      모두

      게스트에게 전송할 메시지 객체입니다.

    • targetOrigin

      문자열

      이벤트가 디스패치되려면 게스트 창의 출처가 무엇이어야 하는지 지정합니다.

ContextMenuCreateProperties

Chrome 44 이상

속성

  • 선택됨

    불리언 선택사항

    체크박스 또는 라디오 항목의 초기 상태입니다. 선택된 경우 true, 선택되지 않은 경우 false입니다. 라디오 항목 그룹에서는 한 번에 하나의 라디오 항목만 선택할 수 있습니다.

  • contexts

    [ContextType, ...ContextType[]] 선택사항

    이 메뉴 항목이 표시될 컨텍스트 목록입니다. 지정하지 않으면 기본값은 ['page'] 입니다.

  • documentUrlPatterns

    string[] 선택사항

    URL이 지정된 패턴 중 하나와 일치하는 문서에만 항목을 적용하도록 제한할 수 있습니다. (프레임에도 적용됨) 패턴 형식에 대한 자세한 내용은 일치 패턴을 참고하세요.

  • 사용 설정됨

    불리언 선택사항

    이 컨텍스트 메뉴 항목이 사용 설정되었는지 또는 사용 중지되었는지 여부입니다. 기본값은 true입니다.

  • id

    문자열 선택사항

    이 항목에 할당할 고유 ID입니다. 이벤트 페이지에 필수입니다. 이 확장 프로그램의 다른 ID와 동일할 수 없습니다.

  • parentId

    문자열 | 숫자 선택사항

    상위 메뉴 항목의 ID입니다. 이렇게 하면 항목이 이전에 추가된 항목의 하위 항목이 됩니다.

  • targetUrlPatterns

    string[] 선택사항

    documentUrlPatterns와 유사하지만 img/audio/video 태그의 src 속성과 앵커 태그의 href를 기반으로 필터링할 수 있습니다.

  • 제목

    문자열 선택사항

    항목에 표시할 텍스트입니다. type이 'separator'가 아닌 경우 필수입니다. 컨텍스트가 'selection'인 경우 문자열 내에서 %s를 사용하여 선택된 텍스트를 표시할 수 있습니다. 예를 들어 이 매개변수의 값이 '%s'을 돼지 라틴어로 번역'이고 사용자가 'cool'이라는 단어를 선택하면 선택 항목의 컨텍스트 메뉴 항목은 'cool'을 돼지 라틴어로 번역'이 됩니다.

  • 유형

    ItemType 선택사항

    메뉴 항목의 유형입니다. 지정하지 않을 경우 기본값은 'normal'입니다.

  • onclick

    void optional

    메뉴 항목을 클릭할 때 다시 호출되는 함수입니다.

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

    (info: OnClickData) => {...}

    • 정보

      클릭된 항목과 클릭이 발생한 컨텍스트에 관한 정보입니다.

ContextMenus

Chrome 44 이상

속성

  • onShow

    Event<functionvoidvoid>

    webview에 컨텍스트 메뉴를 표시하기 전에 발생합니다. event.preventDefault()를 호출하여 이 컨텍스트 메뉴를 사용 중지하는 데 사용할 수 있습니다.

    onShow.addListener 함수는 다음과 같습니다.

    (callback: function) => {...}

    • callback

      함수

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

      (event: object) => void

      • 이벤트

        객체

        • preventDefault

          void

          컨텍스트 메뉴가 표시되지 않도록 하려면 이 메서드를 호출하세요.

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

          () => {...}

  • create

    void

    새 컨텍스트 메뉴 항목을 만듭니다. 생성 중에 오류가 발생하면 생성 콜백이 실행될 때까지 알 수 없습니다 (세부정보는 runtime.lastError에 있음).

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

    (createProperties: object, callback?: function) => {...}

    • createProperties

      객체

      상품을 만드는 데 사용되는 속성

    • callback

      함수 선택사항

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

      () => void

    • returns

      문자열 | 숫자

      새로 생성된 항목의 ID입니다.

  • 삭제

    void

    컨텍스트 메뉴 항목을 삭제합니다.

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

    (menuItemId: string | number, callback?: function) => {...}

    • menuItemId

      문자열 | 숫자

      삭제할 컨텍스트 메뉴 항목의 ID입니다.

    • callback

      함수 선택사항

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

      () => void

  • removeAll

    void

    webview에 추가된 모든 컨텍스트 메뉴 항목을 삭제합니다.

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

    (callback?: function) => {...}

    • callback

      함수 선택사항

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

      () => void

  • update

    void

    이전에 만든 컨텍스트 메뉴 항목을 업데이트합니다.

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

    (id: string | number, updateProperties: object, callback?: function) => {...}

    • id

      문자열 | 숫자

      업데이트할 상품의 ID입니다.

    • updateProperties

      객체

      업데이트할 속성입니다. create 함수와 동일한 값을 허용합니다.

    • callback

      함수 선택사항

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

      () => void

ContextMenuUpdateProperties

Chrome 44 이상

속성

  • 선택됨

    불리언 선택사항

    체크박스 또는 라디오 항목의 상태입니다. 선택된 경우 true, 선택되지 않은 경우 false입니다. 라디오 항목 그룹에서는 한 번에 하나의 라디오 항목만 선택할 수 있습니다.

  • contexts

    [ContextType, ...ContextType[]] 선택사항

    이 메뉴 항목이 표시될 컨텍스트 목록입니다.

  • documentUrlPatterns

    string[] 선택사항

    URL이 지정된 패턴 중 하나와 일치하는 문서에만 항목을 적용하도록 제한할 수 있습니다. (프레임에도 적용됨) 패턴 형식에 대한 자세한 내용은 일치 패턴을 참고하세요.

  • 사용 설정됨

    불리언 선택사항

    이 컨텍스트 메뉴 항목이 사용 설정되었는지 또는 사용 중지되었는지 여부입니다.

  • parentId

    문자열 | 숫자 선택사항

    상위 메뉴 항목의 ID입니다. 이렇게 하면 항목이 이전에 추가된 항목의 하위 항목이 됩니다. 참고: 항목을 자체 하위 항목의 하위 항목으로 변경할 수는 없습니다.

  • targetUrlPatterns

    string[] 선택사항

    documentUrlPatterns와 유사하지만 img/audio/video 태그의 src 속성과 앵커 태그의 href를 기반으로 필터링할 수 있습니다.

  • 제목

    문자열 선택사항

    항목에 표시할 텍스트

  • 유형

    ItemType 선택사항

    메뉴 항목의 유형입니다.

  • onclick

    void optional

    메뉴 항목을 클릭할 때 다시 호출되는 함수입니다.

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

    (info: OnClickData) => {...}

    • 정보

      클릭된 항목과 클릭이 발생한 컨텍스트에 관한 정보입니다.

ContextType

Chrome 44 이상

메뉴가 표시될 수 있는 다양한 컨텍스트입니다. 'all'을 지정하는 것은 다른 모든 컨텍스트를 조합한 것과 같습니다.

열거형

"all"

'page'

'frame'

'selection'

'link'

'editable'

'image'

"video"

'audio'

DialogController

dialog DOM 이벤트에 연결된 인터페이스

속성

  • 취소

    void

    대화상자를 거부합니다. confirm 또는 prompt 대화상자에서 취소를 클릭하는 것과 같습니다.

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

    () => {...}

  • 확인

    void

    대화상자를 수락합니다. alert, confirm 또는 prompt 대화상자에서 확인을 클릭하는 것과 같습니다.

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

    (response?: string) => {...}

    • 응답

      문자열 선택사항

      prompt 대화상자를 수락할 때 게스트에게 제공할 응답 문자열입니다.

DialogMessageType

대기 중

게스트가 요청한 모달 대화상자의 유형입니다.

열거형

'alert'

'confirm'

'prompt'

DownloadPermissionRequest

download permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • requestMethod

    문자열

    다운로드 요청과 연결된 HTTP 요청 유형 (예: GET)입니다.

  • URL

    문자열

    요청된 다운로드 URL입니다.

  • 허용

    void

    권한 요청을 허용합니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다. allow를 호출하지 않으면 기본 동작입니다.

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

    () => {...}

ExitReason

대기 중

종료 이유를 나타내는 문자열입니다.

열거형

"normal"

'abnormal'

'crashed'

'killed'

'oom killed'

"oom"

'실행 실패'

'무결성 실패'

FileSystemPermissionRequest

filesystem permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • URL

    문자열

    로컬 파일 시스템에 대한 액세스를 요청하는 프레임의 URL입니다.

  • 허용

    void

    권한 요청을 허용합니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다.

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

    () => {...}

FindCallbackResults

찾기 요청의 모든 결과가 포함됩니다.

속성

  • activeMatchOrdinal

    숫자

    현재 경기의 서수입니다.

  • 취소됨

    부울

    이 찾기 요청이 취소되었는지 여부를 나타냅니다.

  • numberOfMatches

    숫자

    페이지에서 searchText가 일치된 횟수입니다.

  • selectionRect

    활성 일치 항목 주변의 직사각형을 화면 좌표로 설명합니다.

FindOptions

찾기 요청 옵션입니다.

속성

  • 뒤로

    불리언 선택사항

    역순으로 일치 항목을 찾는 플래그입니다. 기본값은 false입니다.

  • matchCase

    불리언 선택사항

    대소문자 구분 여부를 지정하는 플래그입니다. 기본값은 false입니다.

FullscreenPermissionRequest

Chrome 43 이상

fullscreen permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • origin

    문자열

    전체 화면 요청을 시작한 webview 내부 프레임의 출처입니다.

  • 허용

    void

    권한 요청을 허용합니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다.

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

    () => {...}

GeolocationPermissionRequest

geolocation permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • URL

    문자열

    위치정보 데이터에 대한 액세스를 요청하는 프레임의 URL입니다.

  • 허용

    void

    권한 요청을 허용합니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다. allow를 호출하지 않으면 기본 동작입니다.

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

    () => {...}

HidPermissionRequest

Chrome 125 이상

hid permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • URL

    문자열

    HID API에 대한 액세스를 요청하는 프레임의 URL입니다.

  • 허용

    void

    권한 요청을 허용합니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다. allow를 호출하지 않으면 기본 동작입니다.

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

    () => {...}

InjectDetails

삽입할 스크립트 또는 CSS의 세부정보입니다. 코드 또는 파일 속성을 설정해야 하지만 둘 다 동시에 설정할 수는 없습니다.

속성

  • 코드

    문자열 선택사항

    삽입할 JavaScript 또는 CSS 코드입니다.

    경고: code 파라미터를 사용할 때는 주의해야 합니다. 잘못 사용하면 앱이 교차 사이트 스크립팅 공격에 노출될 수 있습니다.

  • 파일

    문자열 선택사항

    삽입할 JavaScript 또는 CSS 파일입니다.

InjectionItems

Chrome 44 이상

삽입 항목의 유형입니다(코드 또는 파일 집합).

속성

  • 코드

    문자열 선택사항

    일치하는 페이지에 삽입할 JavaScript 코드 또는 CSS입니다.

  • 파일

    string[] 선택사항

    일치하는 페이지에 삽입할 JavaScript 또는 CSS 파일 목록입니다. 이러한 값은 이 배열에 표시되는 순서대로 삽입됩니다.

LoadAbortReason

대기 중

발생한 중단 유형을 나타내는 문자열입니다. 이 문자열은 출시 간에 이전 버전과의 호환성이 유지되지 않을 수 있습니다. 콘텐츠를 파싱하고 콘텐츠에 따라 조치를 취해서는 안 됩니다. 또한 여기에 나열되지 않은 오류가 보고될 수도 있습니다.

열거형

"ERR_ABORTED"

'ERR_INVALID_URL'

"ERR_DISALLOWED_URL_SCHEME"

"ERR_BLOCKED_BY_CLIENT"

"ERR_ADDRESS_UNREACHABLE"

'ERR_EMPTY_RESPONSE'

"ERR_FILE_NOT_FOUND"

"ERR_UNKNOWN_URL_SCHEME"

LoadPluginPermissionRequest

loadplugin permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • identifier

    문자열

    플러그인의 식별자 문자열입니다.

  • 이름

    문자열

    플러그인의 표시 이름입니다.

  • 허용

    void

    권한 요청을 허용합니다. deny가 호출되지 않은 경우의 기본 동작입니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다.

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

    () => {...}

MediaPermissionRequest

media permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • URL

    문자열

    사용자 미디어에 대한 액세스를 요청하는 프레임의 URL입니다.

  • 허용

    void

    권한 요청을 허용합니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다. allow를 호출하지 않으면 기본 동작입니다.

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

    () => {...}

NewWindow

newwindow DOM 이벤트에 연결된 인터페이스

속성

  • 첨부

    void

    요청된 타겟 페이지를 기존 webview 요소에 연결합니다.

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

    (webview: object) => {...}

    • webview

      객체

      타겟 페이지가 연결되어야 하는 webview 요소입니다.

  • 삭제

    void

    새 창 요청을 취소합니다.

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

    () => {...}

PermissionType

대기 중

요청되는 권한 유형입니다.

열거형

"media"

"geolocation"

'pointerLock'

'download'

"loadplugin"

'filesystem'

'fullscreen'

"hid"

PointerLockPermissionRequest

pointerLock permissionrequest DOM 이벤트와 함께 제공되는 request 객체의 유형입니다.

속성

  • lastUnlockedBySelf

    부울

    요청 프레임이 포인터 잠금을 보유한 가장 최근 클라이언트인지 여부입니다.

  • URL

    문자열

    포인터 잠금을 요청하는 프레임의 URL입니다.

  • userGesture

    부울

    사용자 입력 동작의 결과로 포인터 잠금이 요청되었는지 여부입니다.

  • 허용

    void

    권한 요청을 허용합니다.

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

    () => {...}

  • deny

    void

    권한 요청을 거부합니다. allow를 호출하지 않으면 기본 동작입니다.

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

    () => {...}

SelectionRect

화면 좌표의 직사각형을 설명합니다.

포함 의미는 배열과 유사합니다. 즉, 좌표 (left, top)는 직사각형에 포함된 것으로 간주되지만 좌표 (left + width, top)는 그렇지 않습니다.

속성

  • 높이

    숫자

    사각형의 높이입니다.

  • 왼쪽

    숫자

    화면의 왼쪽 가장자리에서 사각형의 왼쪽 가장자리까지의 거리입니다.

  • 상단

    숫자

    화면 상단 가장자리에서 직사각형 상단 가장자리까지의 거리입니다.

  • 너비

    숫자

    사각형의 너비입니다.

StopFindingAction

대기 중

찾기 세션이 종료된 후 활성 경기에서 수행할 작업을 결정합니다. clear는 활성 일치 항목의 강조 표시를 지우고, keep는 활성 일치 항목을 강조 표시된 상태로 유지하며, activate는 활성 일치 항목을 강조 표시된 상태로 유지하고 해당 일치 항목에 대한 사용자 클릭을 시뮬레이션합니다. 기본 작업은 keep입니다.

열거형

"clear"

'keep'

"activate"

WebRequestEventInterface

Chrome 44 이상

게스트 페이지의 webRequest 이벤트에 대한 액세스를 제공하는 인터페이스입니다. webRequest 수명 주기 및 관련 개념에 관한 자세한 내용은 chrome.webRequest 확장 프로그램 API를 참고하세요. 참고: chrome.webRequest.onActionIgnored 이벤트는 WebView에서 지원되지 않습니다.

사용량이 확장 프로그램 webRequest API와 어떻게 다른지 설명하기 위해 *://www.evil.com/*와 일치하는 URL에 대한 게스트 요청을 차단하는 다음 예시 코드를 살펴보세요.

webview.request.onBeforeRequest.addListener(
  function(details) { return {cancel: true}; },
  {urls: ["*://www.evil.com/*"]},
  ["blocking"]);

또한 이 인터페이스는 onRequestonMessage 이벤트를 통해 선언적 webRequest 규칙을 지원합니다. API 세부정보는 declarativeWebRequest를 참고하세요.

선언적 웹뷰 webRequest의 조건과 작업은 chrome.webViewRequest.* 대응 항목에서 인스턴스화해야 합니다. 다음 예시 코드에서는 웹뷰 myWebview에서 "example.com"에 대한 모든 요청을 선언적으로 차단합니다.

var rule = {
  conditions: [
    new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
  ],
  actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);

WindowOpenDisposition

대기 중

새 창의 요청된 처리입니다.

열거형

'ignore'

'save_to_disk'

"current_tab"

"new_background_tab"

'new_foreground_tab'

"new_window"

"new_popup"

ZoomMode

Chrome 43 이상

webview에서 확대/축소를 처리하는 방법을 정의합니다.

열거형

'출처별'
확대/축소 변경사항은 확대된 페이지의 출처에 유지됩니다. 즉, 동일한 파티션에서 동일한 출처로 이동하는 다른 모든 웹뷰도 확대됩니다. 또한 per-origin 확대/축소 변경사항은 출처와 함께 저장되므로 동일한 출처의 다른 페이지로 이동할 때 모든 페이지가 동일한 확대/축소 비율로 확대/축소됩니다.

'조회당'
확대/축소 변경사항은 이 웹뷰에만 적용되며 다른 웹뷰의 확대/축소 변경사항은 이 웹뷰의 확대/축소에 영향을 미치지 않습니다. 또한 탐색 시 per-view 확대/축소 변경사항이 재설정됩니다. 웹뷰를 탐색하면 항상 파티션 범위 내에서 출처별 확대/축소 요소로 페이지가 로드됩니다.

'disabled'
웹뷰의 모든 확대/축소를 사용 중지합니다. 콘텐츠가 기본 확대/축소 수준으로 되돌아가고 시도된 모든 확대/축소 변경사항이 무시됩니다.

속성

contentWindow

게스트 페이지에 메시지를 게시하는 데 사용할 수 있는 객체 참조입니다.

유형

contextMenus

Chrome 44 이상

Chrome의 ContextMenus API와 유사하지만 브라우저 대신 webview에 적용됩니다. webview.contextMenus API를 사용하여 webview의 컨텍스트 메뉴에 항목을 추가합니다. 컨텍스트 메뉴 추가 항목이 적용되는 객체 유형(예: 이미지, 하이퍼링크, 페이지)을 선택할 수 있습니다.

유형

request

게스트 페이지의 webRequest 이벤트에 대한 액세스를 제공하는 인터페이스입니다.

메서드

addContentScripts()

Chrome 44 이상
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
: void

콘텐츠 스크립트 삽입 규칙을 webview에 추가합니다. webview가 하나 이상의 규칙과 일치하는 페이지로 이동하면 연결된 스크립트가 삽입됩니다. 프로그래매틱 방식으로 규칙을 추가하거나 기존 규칙을 업데이트할 수 있습니다.

다음 예시에서는 webview에 'myRule'과 'anotherRule'이라는 두 개의 규칙을 추가합니다.

webview.addContentScripts([
  {
    name: 'myRule',
    matches: ['http://www.foo.com/*'],
    css: { files: ['mystyles.css'] },
    js: { files: ['jquery.js', 'myscript.js'] },
    run_at: 'document_start'
  },
  {
    name: 'anotherRule',
    matches: ['http://www.bar.com/*'],
    js: { code: "document.body.style.backgroundColor = 'red';" },
    run_at: 'document_end'
  }]);
 ...

// Navigates webview.
webview.src = 'http://www.foo.com';

스크립트를 삽입해야 할 때까지 addContentScripts 호출을 지연할 수 있습니다.

다음 예는 기존 규칙을 덮어쓰는 방법을 보여줍니다.

webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.foo.com/*'],
    js: { files: ['scriptA.js'] },
    run_at: 'document_start'}]);

// Do something.
webview.src = 'http://www.foo.com/*';
 ...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.bar.com/*'],
    js: { files: ['scriptB.js'] },
    run_at: 'document_end'}]);

webview가 출처 (예: foo.com)로 이동하고 webview.addContentScripts을 호출하여 'myRule'을 추가하는 경우 다음 탐색을 기다려 스크립트를 삽입해야 합니다. 즉시 삽입하려면 executeScript가 적합합니다.

게스트 프로세스가 비정상 종료되거나 종료되거나 webview의 상위 요소가 변경되더라도 규칙은 유지됩니다.

자세한 내용은 콘텐츠 스크립트 문서를 참고하세요.

매개변수

back()

chrome.webviewTag.back(
  callback?: function,
)
: void

가능한 경우 이전 기록 항목으로 이동합니다. go(-1)와 같습니다.

매개변수

  • callback

    함수 선택사항

    Chrome 44 이상

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

    (success: boolean) => void

    • 성공

      부울

      탐색이 성공했는지 여부를 나타냅니다.

canGoBack()

chrome.webviewTag.canGoBack(): boolean

방문 기록을 통해 뒤로 탐색할 수 있는지 여부를 나타냅니다. 이 함수의 상태는 캐시되고 각 loadcommit 전에 업데이트되므로 loadcommit에서 호출하는 것이 가장 좋습니다.

반환 값

  • 부울

canGoForward()

chrome.webviewTag.canGoForward(): boolean

방문 기록을 통해 앞으로 이동할 수 있는지 여부를 나타냅니다. 이 함수의 상태는 캐시되고 각 loadcommit 전에 업데이트되므로 loadcommit에서 호출하는 것이 가장 좋습니다.

반환 값

  • 부울

captureVisibleRegion()

Chrome 50 이상
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)
: void

WebView의 표시 영역을 캡처합니다.

매개변수

  • 옵션

    ImageDetails 선택사항

  • callback

    함수

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

    (dataUrl: string) => void

    • dataUrl

      문자열

      캡처된 탭의 표시 영역 이미지를 인코딩하는 데이터 URL입니다. 표시를 위해 HTML 이미지 요소의 'src' 속성에 할당될 수 있습니다.

clearData()

chrome.webviewTag.clearData(
  options: ClearDataOptions,
  types: ClearDataTypeSet,
  callback?: function,
)
: void

webview 파티션의 인터넷 사용 기록을 삭제합니다.

매개변수

  • 삭제할 데이터를 결정하는 옵션입니다.

  • 삭제할 데이터 유형입니다.

  • callback

    함수 선택사항

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

    () => void

executeScript()

chrome.webviewTag.executeScript(
  details: InjectDetails,
  callback?: function,
)
: void

게스트 페이지에 JavaScript 코드를 삽입합니다.

다음 샘플 코드에서는 스크립트 삽입을 사용하여 게스트 페이지의 배경색을 빨간색으로 설정합니다.

webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });

매개변수

  • 세부정보

    실행할 스크립트의 세부정보입니다.

  • callback

    함수 선택사항

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

    (result?: any[]) => void

    • 결과

      any[] 선택사항

      삽입된 모든 프레임의 스크립트 결과입니다.

find()

chrome.webviewTag.find(
  searchText: string,
  options?: FindOptions,
  callback?: function,
)
: void

페이지 내 검색 요청을 시작합니다.

매개변수

  • searchText

    문자열

    페이지에서 찾을 문자열입니다.

  • 옵션

    FindOptions 선택사항

    찾기 요청 옵션입니다.

  • callback

    함수 선택사항

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

    (results?: FindCallbackResults) => void

    • 결과

      FindCallbackResults 선택사항

      찾기 요청의 모든 결과가 포함됩니다. 콜백 함수 본문에서 사용되지 않는 경우 results를 생략할 수 있습니다. 예를 들어 콜백이 찾기 요청이 완료된 시점을 파악하는 데만 사용되는 경우입니다.

forward()

chrome.webviewTag.forward(
  callback?: function,
)
: void

가능한 경우 기록 항목을 하나 앞으로 이동합니다. go(1)와 같습니다.

매개변수

  • callback

    함수 선택사항

    Chrome 44 이상

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

    (success: boolean) => void

    • 성공

      부울

      탐색이 성공했는지 여부를 나타냅니다.

getAudioState()

Chrome 62 이상
chrome.webviewTag.getAudioState(
  callback: function,
)
: void

오디오 상태를 쿼리합니다.

매개변수

  • callback

    함수

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

    (audible: boolean) => void

    • 오더블

      부울

getProcessId()

chrome.webviewTag.getProcessId(): number

게스트 웹페이지의 현재 프로세스에 대한 Chrome의 내부 프로세스 ID를 반환하여 삽입자가 프로세스 종료로 인해 영향을 받는 게스트 수를 알 수 있도록 합니다. 두 게스트는 동일한 앱에 속하고 동일한 스토리지 파티션 ID를 가진 경우에만 프로세스를 공유합니다. 호출은 동기식이며 현재 프로세스 ID에 관한 삽입기의 캐시된 개념을 반환합니다. 프로세스 ID는 운영체제의 프로세스 ID와 다릅니다.

반환 값

  • 숫자

getUserAgent()

chrome.webviewTag.getUserAgent(): string

게스트 페이지 요청에 webview가 사용하는 사용자 에이전트 문자열을 반환합니다.

반환 값

  • 문자열

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)
: void

현재 확대/축소 비율을 가져옵니다.

매개변수

  • callback

    함수

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

    (zoomFactor: number) => void

    • zoomFactor

      숫자

      현재 확대/축소 비율입니다.

getZoomMode()

Chrome 43 이상
chrome.webviewTag.getZoomMode(
  callback: function,
)
: void

현재 확대/축소 모드를 가져옵니다.

매개변수

  • callback

    함수

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

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      webview의 현재 확대/축소 모드입니다.

go()

chrome.webviewTag.go(
  relativeIndex: number,
  callback?: function,
)
: void

현재 탐색과 관련된 기록 색인을 사용하여 기록 항목으로 이동합니다. 요청된 탐색이 불가능하면 이 메서드는 효과가 없습니다.

매개변수

  • relativeIndex

    숫자

    webview가 탐색되어야 하는 상대 기록 색인입니다. 예를 들어 2 값은 가능한 경우 기록 항목 2개를 앞으로 이동하고 -3 값은 항목 3개를 뒤로 이동합니다.

  • callback

    함수 선택사항

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

    (success: boolean) => void

    • 성공

      부울

      탐색이 성공했는지 여부를 나타냅니다.

insertCSS()

chrome.webviewTag.insertCSS(
  details: InjectDetails,
  callback?: function,
)
: void

게스트 페이지에 CSS를 삽입합니다.

매개변수

  • 세부정보

    삽입할 CSS의 세부정보입니다.

  • callback

    함수 선택사항

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

    () => void

isAudioMuted()

Chrome 62 이상
chrome.webviewTag.isAudioMuted(
  callback: function,
)
: void

오디오가 음소거되었는지 쿼리합니다.

매개변수

  • callback

    함수

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

    (muted: boolean) => void

    • 음소거

      부울

isSpatialNavigationEnabled()

Chrome 71 이상
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)
: void

웹뷰에 공간 탐색이 사용 설정되어 있는지 쿼리합니다.

매개변수

  • callback

    함수

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

    (enabled: boolean) => void

    • 사용 설정됨

      부울

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

webview의 사용자 에이전트 문자열이 webviewTag.setUserAgentOverride에 의해 재정의되었는지 여부를 나타냅니다.

loadDataWithBaseUrl()

chrome.webviewTag.loadDataWithBaseUrl(
  dataUrl: string,
  baseUrl: string,
  virtualUrl?: string,
)
: void

상대 링크에 사용되는 지정된 기준 URL로 데이터 URL을 로드합니다. 선택적으로 데이터 URL 대신 사용자에게 표시할 가상 URL을 제공할 수 있습니다.

매개변수

  • dataUrl

    문자열

    로드할 데이터 URL입니다.

  • baseUrl

    문자열

    상대 링크에 사용될 기준 URL입니다.

  • virtualUrl

    문자열 선택사항

    사용자에게 표시될 URL (주소 표시줄)입니다.

print()

chrome.webviewTag.print(): void

webview의 콘텐츠를 출력합니다. 이는 webview 자체에서 스크립트된 print 함수를 호출하는 것과 같습니다.

reload()

chrome.webviewTag.reload(): void

현재 최상위 페이지를 새로고침합니다.

removeContentScripts()

Chrome 44 이상
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)
: void

webview에서 콘텐츠 스크립트를 삭제합니다.

다음 예에서는 이전에 추가된 'myRule'을 삭제합니다.

webview.removeContentScripts(['myRule']);

다음과 같이 호출하여 모든 규칙을 삭제할 수 있습니다.

webview.removeContentScripts();

매개변수

  • scriptNameList

    string[] 선택사항

    삭제할 콘텐츠 스크립트 이름의 목록입니다. 목록이 비어 있으면 webview에 추가된 모든 콘텐츠 스크립트가 삭제됩니다.

setAudioMuted()

Chrome 62 이상
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)
: void

WebView의 오디오 음소거 상태를 설정합니다.

매개변수

  • 음소거

    부울

    오디오 음소거 값

setSpatialNavigationEnabled()

Chrome 71 이상
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)
: void

WebView의 공간 탐색 상태를 설정합니다.

매개변수

  • 사용 설정됨

    부울

    공간 탐색 상태 값입니다.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)
: void

게스트 페이지 요청을 위해 webview에서 사용하는 사용자 에이전트 문자열을 재정의합니다. 재정의하면 이 재정의가 적용된 게스트 페이지 요청의 사용자 에이전트 클라이언트 힌트 헤더 값과 navigator.userAgentData에서 반환된 값이 비게 됩니다.

매개변수

  • userAgent

    문자열

    사용할 사용자 에이전트 문자열입니다.

setZoom()

chrome.webviewTag.setZoom(
  zoomFactor: number,
  callback?: function,
)
: void

페이지의 확대/축소 비율을 변경합니다. 이 변경사항의 범위와 지속성은 웹뷰의 현재 확대/축소 모드에 따라 결정됩니다 (webviewTag.ZoomMode 참고).

매개변수

  • zoomFactor

    숫자

    새 확대/축소 비율입니다.

  • callback

    함수 선택사항

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

    () => void

setZoomMode()

Chrome 43 이상
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)
: void

webview의 확대/축소 모드를 설정합니다.

매개변수

  • ZoomMode

    webview에서 확대/축소를 처리하는 방법을 정의합니다.

  • callback

    함수 선택사항

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

    () => void

stop()

chrome.webviewTag.stop(): void

진행 중인 경우 현재 webview 탐색의 로드를 중지합니다.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: StopFindingAction,
)
: void

현재 찾기 세션을 종료하고 (모든 강조 표시 지우기) 진행 중인 모든 찾기 요청을 취소합니다.

매개변수

  • action

    StopFindingAction 선택사항

    찾기 세션이 종료된 후 활성 경기에서 수행할 작업을 결정합니다. clear는 활성 일치 항목의 강조 표시를 지우고, keep는 활성 일치 항목을 강조 표시된 상태로 유지하며, activate는 활성 일치 항목을 강조 표시된 상태로 유지하고 해당 일치 항목에 대한 사용자 클릭을 시뮬레이션합니다. 기본 작업은 keep입니다.

terminate()

chrome.webviewTag.terminate(): void

게스트 웹페이지의 렌더러 프로세스를 강제로 종료합니다. 이는 동일한 프로세스를 공유하는 현재 앱의 여러 webview 태그에 영향을 미칠 수 있지만 다른 앱의 webview 태그에는 영향을 미치지 않습니다.

이벤트

close

chrome.webviewTag.close.addListener(
  callback: function,
)

게스트 창이 자체적으로 닫히려고 할 때 발생합니다.

다음 코드 예는 게스트가 자체적으로 닫으려고 할 때 webviewabout:blank로 탐색합니다.

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

매개변수

  • callback

    함수

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

    () => void

consolemessage

chrome.webviewTag.consolemessage.addListener(
  callback: function,
)

게스트 창에서 콘솔 메시지를 로깅할 때 발생합니다.

다음 예시 코드는 로그 수준이나 기타 속성과 관계없이 모든 로그 메시지를 삽입기의 콘솔로 전달합니다.

webview.addEventListener('consolemessage', function(e) {
  console.log('Guest page logged a message: ', e.message);
});

매개변수

  • callback

    함수

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

    (level: number, message: string, line: number, sourceId: string) => void

    • 레벨

      숫자

    • 메시지

      문자열

    • 내용

      숫자

    • sourceId

      문자열

contentload

chrome.webviewTag.contentload.addListener(
  callback: function,
)

게스트 창에서 load 이벤트가 발생할 때, 즉 새 문서가 로드될 때 발생합니다. 여기에는 현재 문서 내의 페이지 탐색이나 비동기 리소스 로드가 포함되지 않습니다.

다음 예시 코드는 페이지가 로드된 후 게스트의 body 요소의 기본 글꼴 크기를 수정합니다.

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

매개변수

  • callback

    함수

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

    () => void

dialog

chrome.webviewTag.dialog.addListener(
  callback: function,
)

게스트 창에서 window.alert, window.confirm 또는 window.prompt를 통해 모달 대화상자를 열려고 시도할 때 발생합니다.

이 이벤트를 처리하면 각 이벤트 리스너가 반환되거나 dialog 객체에 도달할 수 없게 될 때까지 게스트 프로세스가 차단됩니다 (preventDefault()가 호출된 경우).

기본 동작은 대화상자를 취소하는 것입니다.

매개변수

exit

chrome.webviewTag.exit.addListener(
  callback: function,
)

게스트 웹 콘텐츠를 렌더링하는 프로세스가 종료될 때 발생합니다.

다음 예시 코드는 게스트 페이지가 비정상 종료될 때마다 작별 메시지를 표시합니다.

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,Goodbye, world!';
  }
});

매개변수

  • callback

    함수

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

    (details: object) => void

    • 세부정보

      객체

      • processID

        숫자

        종료된 프로세스의 Chrome 내부 ID입니다.

      • reason

        종료 이유를 나타내는 문자열입니다.

findupdate

chrome.webviewTag.findupdate.addListener(
  callback: function,
)

활성 찾기 요청에 사용할 수 있는 새 찾기 결과가 있을 때 발생합니다. 일치 항목이 발견되면 단일 찾기 요청에 대해 이 작업이 여러 번 발생할 수 있습니다.

매개변수

  • callback

    함수

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

    (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

    • searchText

      문자열

    • numberOfMatches

      숫자

    • activeMatchOrdinal

      숫자

    • selectionRect
    • 취소됨

      부울

    • finalUpdate

      문자열

loadabort

chrome.webviewTag.loadabort.addListener(
  callback: function,
)

커밋하지 않고 최상위 로드가 중단될 때 발생합니다. 이벤트가 기본적으로 방지되지 않는 한 오류 메시지가 콘솔에 출력됩니다.

참고: 리소스 로드가 중단되면 마지막 loadstop 이벤트 이후 커밋된 모든 로드가 중단되더라도 결국 loadabort 이벤트 다음에 loadstop 이벤트가 발생합니다.

참고: about URL 또는 JavaScript URL의 로드가 중단되면 loadabort이 발생하고 webview이 'about:blank'로 이동합니다.

매개변수

  • callback

    함수

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

    (url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void

loadcommit

chrome.webviewTag.loadcommit.addListener(
  callback: function,
)

로드가 커밋될 때 발생합니다. 여기에는 현재 문서 내 탐색과 하위 프레임 문서 수준 로드가 포함되지만 비동기 리소스 로드는 포함되지 않습니다.

매개변수

  • callback

    함수

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

    (url: string, isTopLevel: boolean) => void

    • URL

      문자열

    • isTopLevel

      부울

loadredirect

chrome.webviewTag.loadredirect.addListener(
  callback: function,
)

최상위 로드 요청이 다른 URL로 리디렉션될 때 발생합니다.

매개변수

  • callback

    함수

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

    (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

    • oldUrl

      문자열

    • newUrl

      문자열

    • isTopLevel

      부울

loadstart

chrome.webviewTag.loadstart.addListener(
  callback: function,
)

로드가 시작되면 발생합니다.

매개변수

  • callback

    함수

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

    (url: string, isTopLevel: boolean) => void

    • URL

      문자열

    • isTopLevel

      부울

loadstop

chrome.webviewTag.loadstop.addListener(
  callback: function,
)

게스트 페이지의 모든 프레임 수준 로드 (모든 하위 프레임 포함)가 완료되면 발생합니다. 여기에는 현재 문서 내 탐색과 하위 프레임 문서 수준 로드가 포함되지만 비동기 리소스 로드는 포함되지 않습니다. 이 이벤트는 문서 수준 로드 수가 1개 이상에서 0개로 전환될 때마다 발생합니다. 예를 들어 이미 로드가 완료된 페이지 (즉, loadstop가 이미 한 번 실행된 경우) 페이지를 로드하는 새 iframe을 만듭니다. iframe 페이지 로드가 완료되면 두 번째 loadstop가 실행됩니다. 이 패턴은 광고를 로드하는 페이지에서 흔히 관찰됩니다.

참고: 커밋된 로드가 중단되면 마지막 loadstop 이벤트 이후의 커밋된 로드가 모두 중단되더라도 결국 loadstop 이벤트가 loadabort 이벤트를 따릅니다.

매개변수

  • callback

    함수

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

    () => void

newwindow

chrome.webviewTag.newwindow.addListener(
  callback: function,
)

게스트 페이지에서 새 브라우저 창을 열려고 시도할 때 발생합니다.

다음 예시 코드는 요청된 각 새 창에 대해 임베더에서 새 webview를 만들고 탐색합니다.

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

매개변수

  • callback

    함수

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

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void

permissionrequest

chrome.webviewTag.permissionrequest.addListener(
  callback: function,
)

게스트 페이지가 삽입자에게 특별 권한을 요청해야 할 때 발생합니다.

다음 예시 코드는 게스트 페이지에 webkitGetUserMedia API 액세스 권한을 부여합니다. 이 예시 코드를 사용하는 앱은 audioCapture 또는 videoCapture 매니페스트 권한을 직접 지정해야 합니다.

webview.addEventListener('permissionrequest', function(e) {
  if (e.permission === 'media') {
    e.request.allow();
  }
});

매개변수

  • callback

    함수

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

    (permission: PermissionType, request: object) => void

responsive

chrome.webviewTag.responsive.addListener(
  callback: function,
)

게스트 웹 콘텐츠를 렌더링하는 프로세스가 응답하지 않은 후 다시 응답하게 되면 발생합니다.

다음 예시 코드는 webview 요소가 반응하거나 반응하지 않을 때 요소를 서서히 표시하거나 서서히 숨깁니다.

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

매개변수

  • callback

    함수

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

    (processID: number) => void

    • processID

      숫자

sizechanged

chrome.webviewTag.sizechanged.addListener(
  callback: function,
)

autosize를 통해 삽입된 웹 콘텐츠의 크기가 조절될 때 발생합니다. autosize이 사용 설정된 경우에만 실행됩니다.

매개변수

  • callback

    함수

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

    (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

    • oldWidth

      숫자

    • oldHeight

      숫자

    • newWidth

      숫자

    • newHeight

      숫자

unresponsive

chrome.webviewTag.unresponsive.addListener(
  callback: function,
)

게스트 웹 콘텐츠를 렌더링하는 프로세스가 응답하지 않게 되면 발생합니다. 게스트가 다시 응답하기 시작하면 이 이벤트는 일치하는 응답 이벤트와 함께 한 번 생성됩니다.

매개변수

  • callback

    함수

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

    (processID: number) => void

    • processID

      숫자

zoomchange

chrome.webviewTag.zoomchange.addListener(
  callback: function,
)

페이지의 확대/축소가 변경될 때 발생합니다.

매개변수

  • callback

    함수

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

    (oldZoomFactor: number, newZoomFactor: number) => void

    • oldZoomFactor

      숫자

    • newZoomFactor

      숫자