browser.extensionTypes

설명

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

유형

ColorArray

Chrome 139 이상 Chrome 148 이후 browser.*

유형

[숫자, 숫자, 숫자, 숫자]

CSSOrigin

Chrome 66 이상 브라우저.* Chrome 148부터

삽입된 CSS의 출처입니다.

열거형

"author"

"user"

DeleteInjectionDetails

Chrome 87 이상 browser.*(Chrome 148부터)

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

속성

  • allFrames

    불리언 선택사항

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

  • 코드

    문자열 선택사항

    삭제할 CSS 코드입니다.

  • cssOrigin

    CSSOrigin 선택사항

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

  • 파일

    문자열 선택사항

    삭제할 CSS 파일입니다.

  • frameId

    number 선택사항

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

  • matchAboutBlank

    불리언 선택사항

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

DocumentLifecycle

Chrome 106 이상 Chrome 148 이후의 browser.*

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

열거형

"prerender"

'active'

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 이상 Chrome 148 이후 browser.*

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

열거형

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 이상 Chrome 148 이후의 browser.*

프레임 유형입니다.

열거형

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 이상 Chrome 148 이후 browser.*

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

유형

ImageData

ImageDetails

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

속성

  • 형식

    ImageFormat 선택사항

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

  • 품질

    number 선택사항

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

ImageFormat

Chrome 44 이상 브라우저.*(Chrome 148부터)

이미지 형식입니다.

열거형

"jpeg"

"png"

InjectDetails

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

속성

  • allFrames

    불리언 선택사항

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

  • 코드

    문자열 선택사항

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

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

  • cssOrigin

    CSSOrigin 선택사항

    Chrome 66 이상 브라우저.* Chrome 148부터

    삽입할 CSS의 출처입니다. 이는 JavaScript가 아닌 CSS에만 지정할 수 있습니다. 기본값은 "author"입니다.

  • 파일

    문자열 선택사항

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

  • frameId

    number 선택사항

    Chrome 50 이상 브라우저.*(Chrome 148부터)

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

  • matchAboutBlank

    불리언 선택사항

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

  • runAt

    RunAt 선택사항

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

RunAt

Chrome 44 이상 브라우저.*(Chrome 148부터)

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가 이미 실행되었는지 확인할 수 있습니다.