chrome.extensionTypes

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 veya daha yeni bir sürüm

Yerleştirilen 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ği ayarlanmalıdır ancak ikisi 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 değerine ayarlanır (en üst düzey çerçeve).

  • 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'dır.

DocumentLifecycle

Chrome 106 ve sonraki sürümler

Çerçevenin belge 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 içinde 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 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 ve sonraki sürümler

Ç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 (ör. 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 yoksayı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 veya daha yeni bir sürüm

Resmin biçimi.

Enum

"jpeg"

"png"

InjectDetails

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

Özellikler

  • allFrames

    boolean isteğe bağlı

    allFrames true ise JavaScript veya CSS'nin geçerli 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 veya daha yeni bir sürüm

    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 değerine ayarlanır (en üst düzey çerçeve).

  • 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:-çerçevelerine eklenemez. Varsayılan olarak false'dır.

  • 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ğerine ayarlanır.

RunAt

Chrome 44 veya daha yeni bir sürüm

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

Enum

"document_start"
Komut dosyası, CSS'den gelen tüm 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 etkinleştirildikten hemen sonraki bir zamanda yerleştirmeyi 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.