chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Açıklama

Üçüncü taraf uzantılarında MIME türü akışlarını işlemek için chrome.mimeHandler API'sini kullanın.

Kullanılabilirlik

Chrome 151+

Türler

MimeHandlerOptions

Özellikler

  • canEmbed

    boole isteğe bağlı

    Chrome 157+

    Bu işleyicinin yerleşik yüklemeler (iframe, yerleştirme, nesne) için kullanılıp kullanılamayacağı. Varsayılan olarak manifest girişinin can_embed değerine ayarlanır. enabled politikası yanlış değerine ayarlandığında bu politikanın etkisi olmaz.

  • etkin

    boole isteğe bağlı

    Bu işleyicinin etkin olup olmadığı. Varsayılan olarak manifest girişinin enabled değerine ayarlanır.

StreamInfo

Özellikler

  • yerleşik

    boole

    Yerleştirilmiş bir bağlamda (iframe/yerleştirme/nesne) yüklendiyse doğru değerini döndürür.

  • mimeType

    dize

    Müdahale edilen içeriğin MIME türü.

  • originalUrl

    dize

    Kullanıcının gittiği kaynak URL.

  • responseHeaders

    nesne

    Anahtar/değer çiftleri olarak HTTP yanıt başlıkları.

  • streamUrl

    dize

    Akış verilerinin alınacağı URL.

  • tabId

    sayı

    Dokümanı içeren sekme kimliği.

Yöntemler

abortAndFallbackToNativeHandler()

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

Mevcut akış işlemeyi iptal eder ve içeriği kullanıcı aracısının yerel işleyicisine aktarır. Bu çağrıdan sonra uzantı çerçevesi kaldırılır. Arayanlar başka bir yürütme işlemi beklememelidir.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getMimeHandlerOptions()

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

Bir MIME türünün seçeneklerini okur. Her üye, uzantının ayarladığı değerdir veya uzantı bunu ayarlamadıysa manifest girişinin değeridir.

Parametreler

  • mimeType

    dize

    Seçenekleri okunacak MIME türü. Uzantının mime_types_handler aracılığıyla işlediği bir MIME türü olmalıdır.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (options: MimeHandlerOptions) => void

İadeler

  • Promise, MIME türü seçenekleriyle çözümlendi.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getStreamInfo()

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

Mevcut MIME işleyici bağlamı için akış bilgilerini alır. Bir MIME işleyici uzantısı sayfasından çağrılmalıdır.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (info: StreamInfo) => void

İadeler

  • Promise<StreamInfo>

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setMimeHandlerOptions()

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

Belirtilen bir MIME türü için yapılandırma seçeneklerini ayarlar. Uzantı, bölünmüş gizli modda çalışıyorsa gizli moddan ayarlanan seçenekler yalnızca gizli mod için geçerli olur ve gizli oturum sona erene kadar devam eder. Gizli modda ayarlanmayan seçenekler, gizli mod dışında ayarlanan değerleri takip eder.

Parametreler

  • mimeType

    dize

    Yapılandırılacak MIME türü. Uzantının mime_types_handler aracılığıyla işlediği bir MIME türü olmalıdır.

  • seçenekler

    MimeHandlerOptions

    Değiştirilecek seçenekler.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Yapılandırma ayarlandığında Promise çözümlenir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.