chrome.extensionTypes

Açıklama

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

Türler

CSSOrigin

Chrome 66 ve sonraki sürümler

Yerleştirilen CSS'nin origin öğesi.

Enum

"author"

DeleteInjectionDetails

Chrome 87 ve sonraki sürümler

Kaldırılacak CSS ile ilgili ayrıntılar. Kod veya dosya özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.

Özellikler

  • allFrames

    boole isteğe bağlı

    allFrames öğesinin true olması, CSS'nin geçerli sayfanın tüm çerçevelerinden kaldırılması gerektiği anlamına gelir. Varsayılan olarak false şeklindedir ve yalnızca üst kareden kaldırılır. true ve frameId ayarlanırsa kod, seçili çerçeveden ve tüm alt karelerinden 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 origin öğesi. Varsayılan olarak "author" değerine ayarlanır.

  • file

    string isteğe bağlı

    Kaldırılacak CSS dosyası.

  • frameId

    numara isteğe bağlı

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

  • matchAboutBlank

    boole isteğe bağlı

    matchAboutBlank öğesi true (doğru) değerine ayarlanırsa, uzantınızın üst dokümanına erişimi varsa kod about:blank ve about:srcdoc çerçevelerinden de kaldırılır. Varsayılan değer false şeklindedir.

DocumentLifecycle

Chrome 106 ve sonraki sürümler

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

Enum

"prerender" (önceden oluşturma)

ExecutionWorld

Chrome 111 ve sonraki sürümler

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

Enum

"ISOLATED":

"USER_SCRIPT"

FrameType

Chrome 106 ve sonraki sürümler

Karenin türü.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

Resmin biçimi ve kalitesiyle ilgili ayrıntılar.

Özellikler

  • biçim

    ImageFormat isteğe bağlı

    Üretilen resmin biçimi. "jpeg" varsayılandır.

  • kalite

    numara isteğe bağlı

    Biçim "jpeg" olduğunda elde edilecek resmin kalitesini kontrol eder. Bu değer, PNG resimleri için yoksayılır. Kalite düştükçe, sonuçta ortaya çıkan görselin daha fazla görsel yapısı olur ve resmi depolamak için gereken bayt sayısı azalır.

ImageFormat

Chrome 44 ve sonraki sürümler

Bir resmin biçimi.

Enum

"jpeg"

"png"

InjectDetails

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

Özellikler

  • allFrames

    boole isteğe bağlı

    allFrames öğesinin true olması, JavaScript veya CSS'nin geçerli sayfanın tüm çerçevelerine eklenmesi gerektiği anlamına gelir. Varsayılan olarak, false öğesidir ve yalnızca üst kareye yerleştirilir. true ve frameId ayarlanırsa kod, seçilen çerçeveye ve onun tüm alt karelerine eklenir.

  • kod

    string isteğe bağlı

    Yerleştirilecek JavaScript veya CSS kodu.

    Uyarı: code parametresini kullanırken dikkatli olun. Bu parametrenin yanlış kullanılması, 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 origin öğesi. Bu, yalnızca CSS için belirtilebilir, JavaScript için belirtilemez. Varsayılan olarak "author" değerine ayarlanır.

  • file

    string isteğe bağlı

    Eklenecek JavaScript veya CSS dosyası.

  • frameId

    numara isteğe bağlı

    Chrome 50 ve sonraki sürümler

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

  • matchAboutBlank

    boole isteğe bağlı

    matchAboutBlank öğesi true ise ve uzantınızın üst dokümanına erişimi varsa, kod about:blank ve about:srcdoc çerçevelerine de eklenir. Kod, üst düzey about:-frames bölümüne eklenemez. Varsayılan değer false şeklindedir.

  • runAt

    RunAt isteğe bağlı

    JavaScript veya CSS'nin sekmeye yerleştirileceği en erken. Varsayılan olarak "document_idle" değerine ayarlanır.

RunAt

Chrome 44 ve sonraki sürümler

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

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 resim ve çerçeve gibi alt kaynaklar yüklenmeden önce yerleştirilir.

"document_idle"
Tarayıcı, komut dosyasının "document_end" arasına yerleştirileceği ve window.onload etkinliğinin tetiklenmesinden hemen sonraki zamanı seçer. Ekleme işleminin tam zamanı, dokümanın ne kadar karmaşık olduğuna, 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; DOM tamamlandıktan sonra çalışacakları garanti edilir. Bir komut dosyasının window.onload tarihinden sonra kesinlikle çalışması gerekiyorsa uzantı, document.readyState özelliğini kullanarak onload önceden tetiklenip tetiklenmediğini kontrol edebilir.