chrome.extensionTypes

설명

chrome.extensionTypes API에는 Chrome 확장 프로그램의 유형 선언이 포함되어 있습니다.

유형

ColorArray

Chrome 139 이상

유형

[number, number, number, number]

CSSOrigin

Chrome 66 이상

삽입된 CSS의 출처입니다.

열거형

"author"

'user'

DeleteInjectionDetails

Chrome 87 이상

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

속성

  • allFrames

    불리언 선택사항

    allFrames가 true이면 CSS가 현재 페이지의 모든 프레임에서 삭제되어야 함을 의미합니다. 기본적으로 false이며 최상위 프레임에서만 삭제됩니다. true 및 frameId가 설정된 경우 선택한 프레임과 모든 하위 프레임에서 코드가 삭제됩니다.

  • 코드

    문자열 선택사항

    삭제할 CSS 코드입니다.

  • cssOrigin

    CSSOrigin 선택사항

    삭제할 CSS의 출처입니다. 기본값은 "author"입니다.

  • 파일

    문자열 선택사항

    삭제할 CSS 파일입니다.

  • frameId

    번호 선택사항

    CSS를 삭제해야 하는 프레임입니다. 기본값은 0 (최상위 프레임)입니다.

  • matchAboutBlank

    불리언 선택사항

    matchAboutBlank가 true이면 확장 프로그램이 상위 문서에 액세스할 수 있는 경우 about:blank 및 about:srcdoc 프레임에서도 코드가 삭제됩니다. 기본값은 false입니다.

DocumentLifecycle

Chrome 106 이상

프레임의 문서 수명 주기입니다.

열거형

'prerender'

'active'

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 이상

스크립트가 실행될 JavaScript 세계입니다. 이 확장 프로그램에 고유한 격리된 세계, 페이지의 JavaScript와 공유되는 DOM의 기본 세계, 사용자 스크립트 API에 등록된 스크립트에만 사용할 수 있는 사용자 스크립트 세계 중 하나일 수 있습니다.

열거형

"ISOLATED"

'MAIN'

"USER_SCRIPT"

FrameType

Chrome 106 이상

프레임 유형입니다.

열거형

"outermost_frame"

'fenced_frame'

"sub_frame"

ImageDataType

Chrome 139 이상

이미지의 픽셀 데이터입니다. ImageData 객체여야 합니다(예: canvas 요소에서 가져옴).

유형

ImageData

ImageDetails

이미지의 형식, 품질, 영역에 관한 세부정보입니다.

속성

  • 형식

    ImageFormat 선택사항

    결과 이미지의 형식입니다. 기본값은 "jpeg"입니다.

  • 품질

    번호 선택사항

    형식이 "jpeg"인 경우 결과 이미지의 품질을 제어합니다. PNG 이미지의 경우 이 값은 무시됩니다. 품질이 낮아지면 결과 이미지에 시각적 아티팩트가 더 많이 표시되고 저장하는 데 필요한 바이트 수가 줄어듭니다.

ImageFormat

Chrome 44 이상

이미지의 형식입니다.

열거형

"jpeg"

"png"

InjectDetails

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

속성

  • allFrames

    불리언 선택사항

    allFrames가 true이면 JavaScript 또는 CSS가 현재 페이지의 모든 프레임에 삽입되어야 함을 의미합니다. 기본적으로 false이며 최상위 프레임에만 삽입됩니다. true 및 frameId이 설정된 경우 코드는 선택한 프레임과 모든 하위 프레임에 삽입됩니다.

  • 코드

    문자열 선택사항

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

    경고: code 매개변수를 사용할 때는 주의해야 합니다. 잘못 사용하면 확장 프로그램이 교차 사이트 스크립팅 공격에 노출될 수 있습니다.

  • cssOrigin

    CSSOrigin 선택사항

    Chrome 66 이상

    삽입할 CSS의 출처입니다. CSS에만 지정할 수 있으며 JavaScript에는 지정할 수 없습니다. 기본값은 "author"입니다.

  • 파일

    문자열 선택사항

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

  • frameId

    번호 선택사항

    Chrome 50 이상

    스크립트 또는 CSS를 삽입해야 하는 프레임입니다. 기본값은 0 (최상위 프레임)입니다.

  • matchAboutBlank

    불리언 선택사항

    matchAboutBlank가 true이면 확장 프로그램이 상위 문서에 액세스할 수 있는 경우 about:blank 및 about:srcdoc 프레임에도 코드가 삽입됩니다. 코드는 최상위 about:-프레임에 삽입할 수 없습니다. 기본값은 false입니다.

  • runAt

    RunAt 선택사항

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

RunAt

Chrome 44 이상

JavaScript 또는 CSS가 탭에 삽입되는 가장 빠른 시간입니다.

열거형

'document_start'
스크립트는 CSS의 파일 뒤에 삽입되지만 다른 DOM이 생성되거나 다른 스크립트가 실행되기 전에 삽입됩니다.

'document_end'
스크립트는 DOM이 완료된 직후에 삽입되지만 이미지 및 프레임과 같은 하위 리소스가 로드되기 전입니다.

'document_idle'
브라우저가 'document_end'와 window.onload 이벤트가 발생한 직후 사이에 스크립트를 삽입할 시간을 선택합니다. 정확한 삽입 시점은 문서의 복잡성과 로드하는 데 걸리는 시간에 따라 다르며 페이지 로드 속도에 맞게 최적화됩니다. 'document_idle'에서 실행되는 콘텐츠 스크립트는 window.onload 이벤트를 수신 대기할 필요가 없습니다. DOM이 완료된 후에 실행되도록 보장되기 때문입니다. 스크립트가 window.onload 후에 실행되어야 하는 경우 확장 프로그램은 document.readyState 속성을 사용하여 onload이 이미 실행되었는지 확인할 수 있습니다.