chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Açıklama

chrome.extensionTypes API, Chrome uzantıları için tür bildirimlerini içerir.

Türler

ColorArray

Chrome 139 veya daha yeni bir sürüm

Tür

[sayı, sayı, sayı, sayı]

CSSOrigin

Chrome 66 ve sonraki sürümler

Yerleştirilen CSS'nin kaynağı.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 veya daha yeni bir sürüm

Kaldırılacak CSS'nin ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır. İkisi aynı anda ayarlanamaz.

Özellikler

  • allFrames

    boolean isteğe bağlı

    allFrames true ise CSS'nin mevcut sayfanın tüm çerçevelerinden kaldırılması gerektiği anlamına gelir. Varsayılan olarak false şeklindedir ve yalnızca üst çerçeveden kaldırılır. true ve frameId ayarlanmışsa kod, seçili çerçeveden ve tüm alt çerçevelerinden kaldırılır.

  • kod

    dize isteğe bağlı

    Kaldırılacak CSS kodu.

  • cssOrigin

    CSSOrigin isteğe bağlı

    Kaldırılacak CSS'nin kaynağı. Varsayılan olarak "author" değerine ayarlanır.

  • dosya

    dize isteğe bağlı

    Kaldırılacak CSS dosyası.

  • frameId

    number isteğe bağlı

    CSS'nin kaldırılması gereken çerçeve. Varsayılan olarak 0 (üst düzey çerçeve) değerine ayarlanır.

  • matchAboutBlank

    boolean isteğe bağlı

    matchAboutBlank doğruysa uzantınızın üst dokümana erişimi varsa kod, about:blank ve about:srcdoc çerçevelerinden de kaldırılır. Varsayılan olarak false değerindedir.

DocumentLifecycle

Chrome 106 veya daha yeni bir sürüm

Çerçevenin doküman yaşam döngüsü.

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 veya daha yeni bir sürüm

Bir komut dosyasının yürütüleceği JavaScript dünyası. Bu uzantıya özgü yalıtılmış bir dünya, sayfanın JavaScript'iyle paylaşılan DOM'un ana dünyası veya yalnızca User Scripts API'ye kaydedilen komut dosyaları için kullanılabilen bir kullanıcı komut dosyaları dünyası olabilir.

Enum

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 veya daha yeni bir sürüm

Çerçevenin türü.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 veya daha yeni bir sürüm

Bir resmin piksel verileri. ImageData nesnesi olmalıdır (örneğin, canvas öğesinden).

Tür

ImageData

ImageDetails

Resmin biçimi, kalitesi ve alanı hakkında ayrıntılar.

Özellikler

  • biçim

    ImageFormat isteğe bağlı

    Elde edilen görüntünün biçimi. "jpeg" varsayılandır.

  • kalite

    number isteğe bağlı

    Biçim "jpeg" olduğunda, ortaya çıkan görüntünün kalitesini kontrol eder. Bu değer, PNG resimlerinde yok sayılır. Kalite düşürüldükçe ortaya çıkan resimde daha fazla görsel bozulma olur ve resmi depolamak için gereken bayt sayısı azalır.

ImageFormat

Chrome 44 ve sonraki sürümler

Resmin biçimi.

Enum

"jpeg"

"png"

InjectDetails

Eklenecek komut dosyası veya CSS'nin ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır. İkisi aynı anda ayarlanamaz.

Özellikler

  • allFrames

    boolean isteğe bağlı

    allFrames true ise JavaScript veya CSS'nin mevcut sayfanın tüm çerçevelerine yerleştirilmesi gerektiği anlamına gelir. Varsayılan olarak false değerindedir ve yalnızca üst çerçeveye yerleştirilir. true ve frameId ayarlanmışsa kod, seçilen çerçeveye ve tüm alt çerçevelerine eklenir.

  • kod

    dize isteğe bağlı

    Eklenecek JavaScript veya CSS kodu.

    Uyarı: code parametresini kullanırken dikkatli olun. Yanlış kullanımı, uzantınızın siteler arası komut dosyası çalıştırma saldırılarına açık olmasına neden olabilir.

  • cssOrigin

    CSSOrigin isteğe bağlı

    Chrome 66 ve sonraki sürümler

    Eklenecek CSS'nin kaynağı. Bu yalnızca CSS için belirtilebilir, JavaScript için belirtilemez. Varsayılan olarak "author" değerine ayarlanır.

  • dosya

    dize isteğe bağlı

    Eklenecek JavaScript veya CSS dosyası.

  • frameId

    number isteğe bağlı

    Chrome 50 veya daha yeni bir sürüm

    Komut dosyasının veya CSS'nin yerleştirileceği çerçeve. Varsayılan olarak 0 (üst düzey çerçeve) değerine ayarlanır.

  • matchAboutBlank

    boolean isteğe bağlı

    matchAboutBlank doğruysa uzantınızın üst dokümanına erişimi varsa kod, about:blank ve about:srcdoc çerçevelerine de yerleştirilir. Kod, üst düzey about:-frame'lere eklenemez. Varsayılan olarak false değerindedir.

  • runAt

    RunAt isteğe bağlı

    JavaScript veya CSS'nin sekmeye en kısa sürede yerleştirileceği zaman. Varsayılan olarak "document_idle" değerini alır.

RunAt

Chrome 44 ve sonraki sürümler

JavaScript veya CSS'nin sekmeye en kısa sürede yerleştirileceği zaman.

Enum

"document_start"
Komut dosyası, CSS'deki dosyalardan sonra ancak başka bir DOM oluşturulmadan veya başka bir komut dosyası çalıştırılmadan önce yerleştirilir.

"document_end"
Komut dosyası, DOM tamamlandıktan hemen sonra ancak resimler ve çerçeveler gibi alt kaynaklar yüklenmeden önce yerleştirilir.

"document_idle"
Tarayıcı, komut dosyasını "document_end" ile window.onload etkinliği tetiklendikten hemen sonraki bir zaman aralığında yerleştirmek için bir zaman seçer. Tam olarak ne zaman yerleştirileceği, belgenin karmaşıklığına ve yüklenmesinin ne kadar sürdüğüne bağlıdır ve sayfa yükleme hızı için optimize edilmiştir. "document_idle" konumunda çalışan içerik komut dosyalarının window.onload etkinliğini dinlemesi gerekmez. Bu komut dosyalarının, DOM tamamlandıktan sonra çalışacağı garanti edilir. Bir komut dosyasının kesinlikle window.onload'dan sonra çalışması gerekiyorsa uzantı, document.readyState özelliğini kullanarak onload'nın zaten tetiklenip tetiklenmediğini kontrol edebilir.