chrome.extensionTypes

설명

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

유형

CSSOrigin

Chrome 66 이상

삽입된 CSS의 출처입니다.

enum

DeleteInjectionDetails

Chrome 87 이상

삭제할 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 이상

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

enum

"pending_deletion"

ExecutionWorld

Chrome 111 이상

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

enum

FrameType

Chrome 106 이상

프레임 유형입니다.

enum

"outermost_frame"

"sub_frame"

ImageDetails

이미지의 형식 및 품질에 관한 세부정보

속성

  • format

    ImageFormat 선택사항

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

  • quality

    number 선택사항

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

ImageFormat

Chrome 44 이상

이미지의 형식입니다.

enum

"jpeg"

"png"

InjectDetails

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

속성

  • allFrames

    부울 선택사항

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

  • 코드

    문자열 선택사항

    삽입할 자바스크립트 또는 CSS 코드.

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

  • cssOrigin

    CSSOrigin 선택사항

    Chrome 66 이상

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

  • 파일

    문자열 선택사항

    삽입할 자바스크립트 또는 CSS 파일입니다.

  • frameId

    number 선택사항

    Chrome 50 이상

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

  • matchAboutBlank

    부울 선택사항

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

  • runAt

    RunAt 선택사항

    자바스크립트 또는 CSS가 탭에 삽입되는 가장 빠른 시점입니다. 기본값은 'document_idle'입니다.

RunAt

Chrome 44 이상

자바스크립트 또는 CSS가 탭에 삽입되는 가장 빠른 시점입니다.

enum

"document_start"
스크립트가 css의 모든 파일 다음에 삽입되지만, 다른 DOM이 구성되거나 다른 스크립트가 실행되기 전에 삽입됩니다.

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

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