chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

설명

chrome.mimeHandler API를 사용하여 서드 파티 확장 프로그램에서 MIME 유형 스트림을 처리합니다.

가용성

Chrome 151 이상

유형

MimeHandlerOptions

속성

  • canEmbed

    불리언 선택사항

    Chrome 157 이상

    이 핸들러를 삽입된 로드 (iframe, 삽입, 객체)에 사용할 수 있는지 여부입니다. 기본값은 매니페스트 항목의 can_embed 값입니다. enabled가 false인 동안에는 영향을 주지 않습니다.

  • 운영중

    불리언 선택사항

    이 핸들러가 사용 설정되었는지 여부입니다. 기본값은 매니페스트 항목의 enabled 값입니다.

StreamInfo

속성

  • 삽입됨

    부울

    삽입된 컨텍스트 (iframe/삽입/객체)에 로드된 경우 true입니다.

  • mimeType

    문자열

    가로챈 콘텐츠의 MIME 유형입니다.

  • originalUrl

    문자열

    사용자가 이동한 원래 URL입니다.

  • responseHeaders

    객체

    키-값 쌍인 HTTP 응답 헤더입니다.

  • streamUrl

    문자열

    스트림 데이터를 가져올 URL입니다.

  • tabId

    숫자

    문서가 포함된 탭 ID입니다.

메서드

abortAndFallbackToNativeHandler()

Promise 
chrome.mimeHandler.abortAndFallbackToNativeHandler(
  callback?: function,
): Promise<void>

현재 스트림 처리를 중단하고 콘텐츠를 사용자 에이전트의 네이티브 핸들러에 전달합니다. 이 호출 후 확장 프로그램 프레임이 해제됩니다. 호출자는 추가 실행을 기대해서는 안 됩니다.

매개변수

  • callback

    함수 선택사항

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

    () => void

반환 값

  • 약속<void>

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getMimeHandlerOptions()

Promise 
chrome.mimeHandler.getMimeHandlerOptions(
  mimeType: string,
  callback?: function,
): Promise<MimeHandlerOptions>

MIME 유형의 옵션을 읽습니다. 각 구성원은 확장 프로그램에서 설정한 값이거나 확장 프로그램에서 설정하지 않은 경우 매니페스트 항목의 값입니다.

매개변수

  • mimeType

    문자열

    옵션을 읽을 MIME 유형입니다. 확장 프로그램이 mime_types_handler를 통해 처리하는 MIME 유형이어야 합니다.

  • callback

    함수 선택사항

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

    (options: MimeHandlerOptions) => void

반환 값

  • MIME 유형의 옵션으로 확인된 프로미스입니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getStreamInfo()

Promise 
chrome.mimeHandler.getStreamInfo(
  callback?: function,
): Promise<StreamInfo>

현재 MIME 핸들러 컨텍스트의 스트림 정보를 가져옵니다. MIME 핸들러 확장 프로그램 페이지 내에서 호출해야 합니다.

매개변수

  • callback

    함수 선택사항

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

    (info: StreamInfo) => void

반환 값

  • Promise<StreamInfo>

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

setMimeHandlerOptions()

Promise 
chrome.mimeHandler.setMimeHandlerOptions(
  mimeType: string,
  options: MimeHandlerOptions,
  callback?: function,
): Promise<void>

지정된 MIME 유형의 구성 옵션을 설정합니다. 확장 프로그램이 분할 시크릿 모드에서 실행되는 경우 시크릿 모드에서 설정된 옵션은 시크릿 모드에만 적용되며 시크릿 세션이 종료될 때까지 지속됩니다. 시크릿 모드에서 설정되지 않은 옵션은 시크릿 모드 외부에서 설정된 값을 따릅니다.

매개변수

  • mimeType

    문자열

    구성할 MIME 유형입니다. 확장 프로그램이 mime_types_handler를 통해 처리하는 MIME 유형이어야 합니다.

  • 변경할 옵션입니다.

  • callback

    함수 선택사항

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

    () => void

반환 값

  • 약속<void>

    구성이 설정되면 프로미스가 확인됩니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.