chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Açıklama

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

Türler

ColorArray

Chrome 139 ve sonraki sürümler

Tür

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

CSSOrigin

Chrome 66+

Eklenen CSS'nin kaynağı.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 ve sonraki sürümler

Kaldırılacak CSS'nin ayrıntıları. Kod veya dosya özelliğinden biri ayarlanmalıdır ancak ikisi aynı anda ayarlanamaz.

Özellikler

• allFrames

  boole isteğe bağlı

  allFrames true ise CSS'nin geçerli sayfanın tüm çerçevelerinden kaldırılması gerektiği anlamına gelir. Varsayılan olarak false değerindedir ve yalnızca üst çerçeveden kaldırılır. true ve frameId ayarlanırsa kod, seçilen çerçeveden ve tüm alt çerçevelerinden kaldırılır.

• kod

  string isteğe bağlı

  Kaldırılacak CSS kodu.

• cssOrigin

  CSSOrigin isteğe bağlı

  Kaldırılacak CSS'nin kaynağı. Varsayılan değer: "author".

• dosya

  string 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

  boole isteğe bağlı

  matchAboutBlank doğruysa ve 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+

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

Enum

"prerender"

"etkin"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111+

Komut dosyasının yürütüleceği JavaScript dünyası. Bu uzantıya özgü izole bir dünya, sayfanın JavaScript'iyle paylaşılan DOM'un ana dünyası veya yalnızca Kullanıcı Komut Dosyaları API'si ile kaydedilen komut dosyaları için kullanılabilen bir kullanıcı komut dosyaları dünyası olabilir.

Enum

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106+

Kare türü.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 ve sonraki sürümler

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

Tür

ImageData

ImageDetails

Resmin biçimi, kalitesi ve alanı ile ilgili ayrıntılar.

Özellikler

• biçim

  ImageFormat isteğe bağlı

  Elde edilen resmin biçimi. "jpeg" varsayılandır.

• kalite

  number isteğe bağlı

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

ImageFormat

Chrome 44+

Resmin biçimi.

Enum

"jpeg"

"png"

InjectDetails

Eklenecek komut dosyasının veya CSS'nin ayrıntıları. Kod veya dosya özelliğinden biri ayarlanmalıdır ancak ikisi aynı anda ayarlanamaz.

Özellikler

• allFrames

  boole 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ğerine sahiptir ve yalnızca üst çerçeveye eklenir. true ve frameId ayarlanırsa kod, seçilen çerçeveye ve tüm alt çerçevelerine eklenir.

• kod

  string isteğe bağlı

  Eklenecek JavaScript veya CSS kodu.

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

• cssOrigin

  CSSOrigin isteğe bağlı

  Chrome 66+

  Eklenecek CSS'nin kaynağı. Bu yalnızca CSS için belirtilebilir, JavaScript için belirtilemez. Varsayılan değer: "author".

• dosya

  string isteğe bağlı

  Eklenecek JavaScript veya CSS dosyası.

• frameId

  number isteğe bağlı

  Chrome 50+

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

• matchAboutBlank

  boole isteğe bağlı

  matchAboutBlank doğruysa ve uzantınızın üst dokümana erişimi varsa kod, about:blank ve about:srcdoc çerçevelerine de eklenir. 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 yerleştirileceği en erken zaman. Varsayılan değer "document_idle"dır.

RunAt

Chrome 44+

JavaScript veya CSS'nin sekmeye yerleştirileceği en erken zaman.

Enum

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

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

"document_idle"
Tarayıcı, "document_end" ile window.onload etkinliği tetiklendikten hemen sonraki zaman aralığında komut dosyasını eklemek için bir zaman seçer. Tam ekleme anı, dokümanın ne kadar karmaşık olduğuna 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"da çalışan içerik komut dosyalarının window.onload etkinliğini dinlemesi gerekmez. DOM tamamlandıktan sonra çalıştırılmaları garanti edilir. Bir komut dosyasının kesinlikle window.onload sonrasında çalışması gerekiyorsa uzantı, document.readyState özelliğini kullanarak onload'in zaten tetiklenip tetiklenmediğini kontrol edebilir.