chrome.webviewTag

Açıklama

Ağ üzerinden web'deki canlı içeriği etkin bir şekilde yüklemek ve Chrome uygulamanıza yerleştirmek için webview etiketini kullanın. Uygulamanız, webview etiketinin görünümünü kontrol edebilir, web içeriğiyle etkileşimde bulunabilir, yerleştirilmiş bir web sayfasında gezinme başlatabilir, bu sayfada gerçekleşen hata etkinliklerine tepki verebilir ve daha fazlasını yapabilir (bkz. Kullanım).

İzinler

webview

Türler

ClearDataOptions

clearData tarafından hangi verilerin temizleneceğini belirleyen seçenekler.

Özellikler

  • şu tarihten beri:

    number isteğe bağlı

    Bu tarihte veya sonrasında biriken verileri temizleyin. Bu veriler, dönem başlangıcından bu yana geçen milisaniye cinsinden ifade edilir (JavaScript Date nesnesinin getTime yöntemiyle erişilebilir). Yoksa varsayılan olarak 0 (tüm tarama verilerini kaldırır) kullanılır.

ClearDataTypeSet

Bir dizi veri türü. Eksik özellikler false olarak yorumlanır.

Özellikler

  • appcache

    boolean isteğe bağlı

    Web sitelerinin uygulama önbellekleri.

  • önbellek

    boolean isteğe bağlı

    Chrome 44 veya daha yeni bir sürüm

    Chrome 43 sürümünden beri Tarayıcının önbelleği. Not: Veriler kaldırılırken belirtilen aralıkla sınırlı kalmayıp tüm önbellek temizlenir.

  • Cloud Console dışındaki Google Cloud sitelerindeki

    boolean isteğe bağlı

    Bölümün çerezleri.

  • fileSystems

    boolean isteğe bağlı

    Web sitelerinin dosya sistemleri.

  • indexedDB

    boolean isteğe bağlı

    Web sitelerinin IndexedDB verileri.

  • localStorage

    boolean isteğe bağlı

    Web sitelerinin yerel depolama verileri.

  • persistentCookies

    boolean isteğe bağlı

    Chrome 58 veya daha yeni bir sürüm

    Bölümün kalıcı çerezleri.

  • sessionCookies

    boolean isteğe bağlı

    Chrome 58 veya daha yeni bir sürüm

    Bölümün oturum çerezleri.

  • webSQL

    boolean isteğe bağlı

    Web sitelerinin WebSQL verileri.

ContentScriptDetails

Chrome 44 veya daha yeni bir sürüm

Yerleştirilecek içerik komut dosyasının ayrıntıları. Daha fazla bilgi için içerik komut dosyaları belgelerine bakın.

Özellikler

  • all_frames

    boolean isteğe bağlı

    all_frames true ise JavaScript veya CSS'nin mevcut sayfanın tüm çerçevelerine yerleştirilmesi gerektiği anlamına gelir. Varsayılan olarak all_frames false'dir ve JavaScript veya CSS yalnızca üst çerçeveye yerleştirilir.

  • css

    InjectionItems isteğe bağlı

    CSS kodu veya eşleşen sayfalara yerleştirilecek CSS dosyalarının listesi. Bunlar, sayfa için herhangi bir DOM oluşturulmadan veya görüntülenmeden önce göründükleri sırada yerleştirilir.

  • exclude_globs

    string[] isteğe bağlı

    Bu glob ile eşleşen URL'leri hariç tutmak için eşleşmelerden sonra uygulanır. @exclude Greasemonkey anahtar kelimesini taklit etmesi amaçlanmıştır.

  • exclude_matches

    string[] isteğe bağlı

    Bu içerik komut dosyasının aksi takdirde içine yerleştirileceği sayfaları hariç tutar.

  • include_globs

    string[] isteğe bağlı

    Yalnızca bu glob ile de eşleşen URL'leri dahil etmek için eşleşmelerden sonra uygulanır. @include Greasemonkey anahtar kelimesini taklit etmek için tasarlanmıştır.

  • js

    InjectionItems isteğe bağlı

    Eşleşen sayfalara yerleştirilecek JavaScript kodu veya JavaScript dosyaları listesi. Bunlar göründükleri sırada yerleştirilir.

  • match_about_blank

    boolean isteğe bağlı

    İçerik komut dosyasının about:blank ve about:srcdoc'a eklenip eklenmeyeceği. İçerik komut dosyaları yalnızca devraldıkları URL, eşleşmeler alanında belirtilen kalıplardan biriyle eşleştiğinde sayfalara yerleştirilir. Devralınan URL, çerçeveyi veya pencereyi oluşturan belgenin URL'sidir. İçerik komut dosyaları, korumalı alan çerçevelerine eklenemez.

  • eşleşiyor

    dize[]

    Bu içerik komut dosyasının hangi sayfalara ekleneceğini belirtir.

  • ad

    dize

    Eklenecek içerik komut dosyasının adı.

  • run_at

    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.

ContentWindow

Konuk penceresine mesaj gönderme

Özellikler

  • postMessage

    geçersiz

    Yerleştirilmiş içerik, hedef kaynaklı bir sayfayı gösterdiği sürece yerleştirilmiş web içeriğine mesaj gönderir. Bu yöntem, sayfa yüklenmeyi tamamladıktan sonra kullanılabilir. contentload etkinliğini dinleyin ve ardından yöntemi çağırın.

    Konuk, aldığı mesaj etkinliğinde event.source adresine mesaj göndererek yerleştiriciye yanıt gönderebilir.

    Bu API, web sayfaları arasındaki iletişim için HTML5 postMessage API ile aynıdır. Yerleştirici, kendi çerçevesine bir message etkinlik işleyici ekleyerek yanıtlara ilişkin dinleme işlemi yapabilir.

    postMessage işlevi şu şekilde görünür: 

    (message: any, targetOrigin: string) => {...}

    • mesaj

      herhangi

      Konuğa gönderilecek ileti nesnesi.

    • targetOrigin

      dize

      Etkinliğin gönderilmesi için konuk penceresinin kaynağının ne olması gerektiğini belirtir.

ContextMenuCreateProperties

Chrome 44 veya daha yeni bir sürüm

Özellikler

  • işaretli

    boolean isteğe bağlı

    Onay kutusu veya radyo öğesinin ilk durumu: Seçili için doğru, seçili olmayan için yanlış. Belirli bir radyo öğeleri grubunda aynı anda yalnızca bir radyo öğesi seçilebilir.

  • bağlamlar

    [ContextType, ...ContextType[]] isteğe bağlı

    Bu menü öğesinin görüneceği bağlamların listesi. Belirtilmezse varsayılan olarak ['page'] olur.

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğenin yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlar için geçerli olmasını kısıtlamanıza olanak tanır. (Bu durum çerçeveler için de geçerlidir.) Kalıp biçimi hakkında ayrıntılı bilgi için Eşleşme Kalıpları başlıklı makaleyi inceleyin.

  • etkin

    boolean isteğe bağlı

    Bu içerik menüsü öğesinin etkin veya devre dışı olduğunu belirtir. Varsayılan olarak true değerine ayarlanır.

  • id

    dize isteğe bağlı

    Bu öğeye atanacak benzersiz kimlik. Etkinlik sayfaları için zorunludur. Bu uzantı için başka bir kimlikle aynı olamaz.

  • parentId

    dize | sayı isteğe bağlı

    Bir üst menü öğesinin kimliği. Bu, öğeyi daha önce eklenen bir öğenin alt öğesi yapar.

  • targetUrlPatterns

    string[] isteğe bağlı

    documentUrlPatterns'e benzer ancak img/audio/video etiketlerinin src özelliğine ve bağlantı etiketlerinin href özelliğine göre filtreleme yapmanıza olanak tanır.

  • title

    dize isteğe bağlı

    Öğede gösterilecek metin. type "ayırma işareti" olmadığı sürece bu zorunludur. Bağlam "seçim" olduğunda, seçili metni göstermek için dize içinde %s kullanabilirsiniz. Örneğin, bu parametrenin değeri "%s'yi Domuz Latincesi'ne çevir" ise ve kullanıcı "cool" kelimesini seçerse seçim için bağlam menüsü öğesi "cool'u Domuz Latincesi'ne çevir" olur.

  • tür

    ItemType isteğe bağlıdır.

    Menü öğesinin türü. Belirtilmezse varsayılan olarak "normal" değerine ayarlanır.

  • onclick

    void optional

    Menü öğesi tıklandığında geri çağrılacak bir işlev.

    onclick işlevi şu şekilde görünür: 

    (info: OnClickData) => {...}

    • bilgi

      OnClickData

      Tıklanan öğe ve tıklamanın gerçekleştiği bağlam hakkında bilgiler.

ContextMenus

Chrome 44 veya daha yeni bir sürüm

Özellikler

  • onShow

    Event<functionvoidvoid>

    Bu webview üzerinde bir bağlam menüsü gösterilmeden önce tetiklenir. event.preventDefault() çağrılarak bu bağlam menüsünü devre dışı bırakmak için kullanılabilir.

    onShow.addListener işlevi şu şekilde görünür: 

    (callback: function) => {...}

    • callback

      işlev

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

      (event: object) => void

      • etkinlik

        nesne

        • preventDefault

          geçersiz

          İçerik menüsünün gösterilmesini engellemek için bu işlevi çağırın.

          preventDefault işlevi şu şekilde görünür: 

          () => {...}

  • create

    geçersiz

    Yeni bir bağlam menüsü öğesi oluşturur. Oluşturma sırasında bir hata oluşursa oluşturma geri çağırması tetiklenene kadar bunu öğrenemeyebilirsiniz (Ayrıntılar runtime.lastError içinde yer alır).

    create işlevi şu şekilde görünür: 

    (createProperties: object, callback?: function) => {...}

    • createProperties

      nesne

      Öğeyi oluşturmak için kullanılan özellikler

    • callback

      işlev isteğe bağlı

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

      () => void

    • returns

      dize | sayı

      Yeni oluşturulan öğenin kimliği.

  • remove

    geçersiz

    İçerik menüsü öğesini kaldırır.

    remove işlevi şu şekilde görünür: 

    (menuItemId: string | number, callback?: function) => {...}

    • menuItemId

      dize | sayı

      Kaldırılacak içerik menüsü öğesinin kimliği.

    • callback

      işlev isteğe bağlı

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

      () => void

  • removeAll

    geçersiz

    Bu webview öğesine eklenen tüm içerik menüsü öğelerini kaldırır.

    removeAll işlevi şu şekilde görünür: 

    (callback?: function) => {...}

    • callback

      işlev isteğe bağlı

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

      () => void

  • update

    geçersiz

    Daha önce oluşturulmuş bir bağlam menüsü öğesini günceller.

    update işlevi şu şekilde görünür: 

    (id: string | number, updateProperties: object, callback?: function) => {...}

    • id

      dize | sayı

      Güncellenecek öğenin kimliği.

    • updateProperties

      nesne

      Güncellenecek mülkler. create işleviyle aynı değerleri kabul eder.

    • callback

      işlev isteğe bağlı

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

      () => void

ContextMenuUpdateProperties

Chrome 44 veya daha yeni bir sürüm

Özellikler

  • işaretli

    boolean isteğe bağlı

    Onay kutusu veya radyo öğesinin durumu: Seçili için doğru, seçili olmayan için yanlış. Belirli bir radyo öğeleri grubunda aynı anda yalnızca bir radyo öğesi seçilebilir.

  • bağlamlar

    [ContextType, ...ContextType[]] isteğe bağlı

    Bu menü öğesinin görüneceği bağlamların listesi.

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğenin yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlar için geçerli olmasını kısıtlamanıza olanak tanır. (Bu durum çerçeveler için de geçerlidir.) Kalıp biçimi hakkında ayrıntılı bilgi için Eşleşme Kalıpları başlıklı makaleyi inceleyin.

  • etkin

    boolean isteğe bağlı

    Bu içerik menüsü öğesinin etkin veya devre dışı olduğunu belirtir.

  • parentId

    dize | sayı isteğe bağlı

    Bir üst menü öğesinin kimliği. Bu, öğeyi daha önce eklenen bir öğenin alt öğesi yapar. Not: Bir öğeyi, kendi alt öğelerinden birinin alt öğesi olarak değiştiremezsiniz.

  • targetUrlPatterns

    string[] isteğe bağlı

    documentUrlPatterns'e benzer ancak img/audio/video etiketlerinin src özelliğine ve bağlantı etiketlerinin href özelliğine göre filtreleme yapmanıza olanak tanır.

  • title

    dize isteğe bağlı

    Öğede gösterilecek metin

  • tür

    ItemType isteğe bağlıdır.

    Menü öğesinin türü.

  • onclick

    void optional

    Menü öğesi tıklandığında geri çağrılacak bir işlev.

    onclick işlevi şu şekilde görünür: 

    (info: OnClickData) => {...}

    • bilgi

      OnClickData

      Tıklanan öğe ve tıklamanın gerçekleştiği bağlam hakkında bilgiler.

ContextType

Chrome 44 veya daha yeni bir sürüm

Bir menünün görünebileceği farklı bağlamlar. "all" (tümü) belirtmek, diğer tüm bağlamların kombinasyonuna eşdeğerdir.

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

Arayüz, dialog DOM etkinliklerine bağlı.

Özellikler

  • iptal

    geçersiz

    İletişim kutusunu reddedin. confirm veya prompt iletişim kutusunda İptal'i tıklamaya eşdeğerdir.

    cancel işlevi şu şekilde görünür: 

    () => {...}

  • tamam

    geçersiz

    İletişim kutusunu kabul edin. alert, confirm veya prompt iletişim kutusunda Tamam'ı tıklamaya eşdeğerdir.

    ok işlevi şu şekilde görünür: 

    (response?: string) => {...}

    • gönderin

      dize isteğe bağlı

      prompt iletişim kutusu kabul edildiğinde konuğa sağlanacak yanıt dizesi.

DialogMessageType

Beklemede

Misafir tarafından istenen modal iletişim kutusu türü.

Enum

"alert"

"confirm"

"istem"

DownloadPermissionRequest

download permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • requestMethod

    dize

    İndirme isteğiyle ilişkili HTTP isteği türü (ör. GET).

  • url

    dize

    İstenen indirme URL'si.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin. allow çağrılmazsa varsayılan davranış budur.

    deny işlevi şu şekilde görünür: 

    () => {...}

ExitReason

Beklemede

Çıkış nedenini belirten dize.

Enum

"normal"

"abnormal"

"crashed"

"killed"

"oom killed"

"oom"

"başlatılamadı"

"integrity failure"

FileSystemPermissionRequest

filesystem permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • url

    dize

    Yerel dosya sistemine erişim isteğinde bulunan çerçevenin URL'si.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin.

    deny işlevi şu şekilde görünür: 

    () => {...}

FindCallbackResults

Bulma isteğinin tüm sonuçlarını içerir.

Özellikler

  • activeMatchOrdinal

    sayı

    Mevcut maçın sıra numarası.

  • iptal edildi

    boolean

    Bu bulma isteğinin iptal edilip edilmediğini gösterir.

  • numberOfMatches

    sayı

    Sayfada searchText ile eşleşme sayısı.

  • selectionRect

    SelectionRect

    Ekran koordinatlarında etkin eşleşmenin etrafındaki dikdörtgeni tanımlar.

FindOptions

Bulma isteği seçenekleri.

Özellikler

  • geri

    boolean isteğe bağlı

    Eşleşmeleri ters sırada bulmak için işaretleyin. Varsayılan değer: false.

  • matchCase

    boolean isteğe bağlı

    Büyük/küçük harfe duyarlılıkla eşleşecek şekilde işaretleyin. Varsayılan değer: false.

FullscreenPermissionRequest

Chrome 43 veya daha yeni bir sürüm

fullscreen permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • kaynak

    dize

    Tam ekran isteğini başlatan webview içindeki çerçevenin kaynağı.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin.

    deny işlevi şu şekilde görünür: 

    () => {...}

GeolocationPermissionRequest

geolocation permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • url

    dize

    Coğrafi konum verilerine erişim isteyen çerçevenin URL'si.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin. allow çağrılmazsa varsayılan davranış budur.

    deny işlevi şu şekilde görünür: 

    () => {...}

HidPermissionRequest

Chrome 125+

hid permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • url

    dize

    HID API'sine erişim isteyen çerçevenin URL'si.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin. allow çağrılmazsa varsayılan davranış budur.

    deny işlevi şu şekilde görünür: 

    () => {...}

InjectDetails

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

Özellikler

  • kod

    dize isteğe bağlı

    Eklenecek JavaScript veya CSS kodu.

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

  • dosya

    dize isteğe bağlı

    Eklenecek JavaScript veya CSS dosyası.

InjectionItems

Chrome 44 veya daha yeni bir sürüm

Yerleştirme öğesinin türü: kod veya bir dizi dosya.

Özellikler

  • kod

    dize isteğe bağlı

    Eşleşen sayfalara yerleştirilecek JavaScript kodu veya CSS.

  • dosyalar

    string[] isteğe bağlı

    Eşleşen sayfalara yerleştirilecek JavaScript veya CSS dosyalarının listesi. Bunlar, bu dizide göründükleri sırayla yerleştirilir.

LoadAbortReason

Beklemede

Hangi türde iptal işleminin gerçekleştiğini belirten dize. Bu dizenin, sürümler arasında geriye dönük uyumluluğu koruyacağı garanti edilmez. İçeriğini ayrıştırmamalı ve içeriğine göre işlem yapmamalısınız. Bazı durumlarda, burada listelenmeyen bir hata da bildirilebilir.

Enum

"ERR_ABORTED"

"ERR_INVALID_URL"

"ERR_DISALLOWED_URL_SCHEME"

"ERR_BLOCKED_BY_CLIENT"

"ERR_ADDRESS_UNREACHABLE"

"ERR_EMPTY_RESPONSE"

"ERR_FILE_NOT_FOUND"

"ERR_UNKNOWN_URL_SCHEME"

LoadPluginPermissionRequest

loadplugin permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • identifier

    dize

    Eklentinin tanımlayıcı dizesi.

  • ad

    dize

    Eklentinin görünen adı.

  • izin ver

    geçersiz

    İzin isteğine izin verin. deny çağrılmazsa varsayılan davranış budur.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin.

    deny işlevi şu şekilde görünür: 

    () => {...}

MediaPermissionRequest

media permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • url

    dize

    Kullanıcı medyasına erişim isteğinde bulunan çerçevenin URL'si.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin. allow çağrılmazsa varsayılan davranış budur.

    deny işlevi şu şekilde görünür: 

    () => {...}

NewWindow

Arayüz, newwindow DOM etkinliklerine bağlı.

Özellikler

  • eklemek

    geçersiz

    İstenen hedef sayfayı mevcut bir webview öğesine ekleyin.

    attach işlevi şu şekilde görünür: 

    (webview: object) => {...}

    • webview

      nesne

      Hedef sayfanın ekleneceği webview öğesi.

  • sil

    geçersiz

    Yeni pencere isteğini iptal edin.

    discard işlevi şu şekilde görünür: 

    () => {...}

PermissionType

Beklemede

İstenen izin türü.

Enum

"media"

"geolocation"

"pointerLock"

"download"

"loadplugin"

"filesystem"

"fullscreen"

"hid"

PointerLockPermissionRequest

pointerLock permissionrequest DOM etkinliğine eşlik eden request nesnesinin türü.

Özellikler

  • lastUnlockedBySelf

    boolean

    İstekte bulunan çerçevenin, işaretçi kilidini tutan en son istemci olup olmadığı.

  • url

    dize

    İşaretçi kilidi isteyen çerçevenin URL'si.

  • userGesture

    boolean

    İşaretçi kilitleme özelliğinin, kullanıcı girişi hareketi sonucunda istenip istenmediği.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi şu şekilde görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin. allow çağrılmazsa varsayılan davranış budur.

    deny işlevi şu şekilde görünür: 

    () => {...}

SelectionRect

Ekran koordinatlarında bir dikdörtgeni tanımlar.

Kapsama semantiği dizi benzeridir. Yani (left, top) koordinatının dikdörtgen tarafından kapsandığı kabul edilir ancak (left + width, top) koordinatı kapsanmaz.

Özellikler

  • yükseklik

    sayı

    Dikdörtgenin yüksekliği.

  • sol

    sayı

    Ekranın sol kenarından dikdörtgenin sol kenarına olan uzaklık.

  • üst

    sayı

    Ekranın üst kenarı ile dikdörtgenin üst kenarı arasındaki mesafe.

  • genişlik

    sayı

    Dikdörtgenin genişliği.

StopFindingAction

Beklemede

Bulma oturumu sona erdikten sonra etkin eşleşmeyle ne yapılacağını belirler. clear, etkin eşleşmenin üzerindeki vurguyu temizler; keep, etkin eşleşmeyi vurgulanmış olarak tutar; activate, etkin eşleşmeyi vurgulanmış olarak tutar ve bu eşleşmeye kullanıcı tıklaması simülasyonu uygular. Varsayılan işlem keep'dır.

Enum

"clear"

"keep"

"activate"

WebRequestEventInterface

Chrome 44 veya daha yeni bir sürüm

Misafir sayfasındaki webRequest etkinliklerine erişim sağlayan arayüz. webRequest yaşam döngüsü ve ilgili kavramlar hakkında ayrıntılı bilgi için chrome.webRequest uzantıları API'sine bakın. Not: chrome.webRequest.onActionIgnored etkinliği, web görünümleri için desteklenmez.

Kullanımın uzantıların webRequest API'sinden nasıl farklı olduğunu göstermek için *://www.evil.com/* ile eşleşen URL'ler için tüm konuk isteklerini engelleyen aşağıdaki örnek kodu inceleyin:

webview.request.onBeforeRequest.addListener(
  function(details) { return {cancel: true}; },
  {urls: ["*://www.evil.com/*"]},
  ["blocking"]);

Ayrıca bu arayüz, onRequest ve onMessage etkinlikleri aracılığıyla bildirim temelli webRequest kurallarını destekler. API ayrıntıları için declarativeWebRequest bölümüne bakın.

Bildirimli webView webRequest'leri için koşulların ve işlemlerin chrome.webViewRequest.* karşılıklarından başlatılması gerektiğini unutmayın. Aşağıdaki örnek kod, web görünümünde "example.com" adresine yapılan tüm istekleri bildirimli olarak engeller myWebview:

var rule = {
  conditions: [
    new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
  ],
  actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);

WindowOpenDisposition

Beklemede

Yeni pencerenin istenen düzeni.

Enum

"ignore"

"save_to_disk"

"current_tab"

"new_background_tab"

"new_foreground_tab"

"new_window"

"new_popup"

ZoomMode

Chrome 43 veya daha yeni bir sürüm

webview içinde yakınlaştırmanın nasıl işleneceğini tanımlar.

Enum

"per-origin"
Yakınlaştırma değişiklikleri, yakınlaştırılan sayfanın kaynağında kalıcı olur. Yani aynı bölüme ait olup aynı kaynağa yönlendirilen diğer tüm web görünümleri de yakınlaştırılır. Ayrıca, per-origin yakınlaştırma değişiklikleri kaynakla birlikte kaydedilir. Bu nedenle, aynı kaynaktaki diğer sayfalara gidildiğinde tüm sayfalar aynı yakınlaştırma faktörüyle yakınlaştırılır.

"Görüntüleme başına"
Yakınlaştırma değişiklikleri yalnızca bu web görünümünde geçerli olur ve diğer web görünümlerindeki yakınlaştırma değişiklikleri bu web görünümünün yakınlaştırmasını etkilemez. Ayrıca, per-view gezinme sırasında yakınlaştırma değişiklikleri sıfırlanır. Bir web görünümünde gezinirken sayfalar her zaman kaynak başına yakınlaştırma faktörleriyle (bölüm kapsamında) yüklenir.

"disabled"
Web görünümünde tüm yakınlaştırmaları devre dışı bırakır. İçerik, varsayılan yakınlaştırma düzeyine geri döner ve denenmiş tüm yakınlaştırma değişiklikleri yoksayılır.

Özellikler

contentWindow

Konuk sayfasına mesaj göndermek için kullanılabilecek nesne referansı.

Tür

ContentWindow

contextMenus

Chrome 44 veya daha yeni bir sürüm

Chrome'un ContextMenus API'sine benzer ancak tarayıcı yerine webview için geçerlidir. webview'ın bağlam menüsüne öğe eklemek için webview.contextMenus API'sini kullanın. İçerik menüsü eklemelerinizin hangi tür nesneler için geçerli olacağını (ör. resimler, köprüler ve sayfalar) seçebilirsiniz.

Tür

ContextMenus

request

Misafir sayfasındaki webRequest etkinliklerine erişim sağlayan arayüz.

Tür

WebRequestEventInterface

Yöntemler

addContentScripts()

Chrome 44 veya daha yeni bir sürüm 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
): void

webview öğesine içerik komut dosyası yerleştirme kuralları ekler. webview bir veya daha fazla kurala uyan bir sayfaya gittiğinde ilişkili komut dosyaları yerleştirilir. Kuralları programatik olarak ekleyebilir veya mevcut kuralları güncelleyebilirsiniz.

Aşağıdaki örnekte webview öğesine "myRule" ve "anotherRule" olmak üzere iki kural eklenmiştir.

webview.addContentScripts([
  {
    name: 'myRule',
    matches: ['http://www.foo.com/*'],
    css: { files: ['mystyles.css'] },
    js: { files: ['jquery.js', 'myscript.js'] },
    run_at: 'document_start'
  },
  {
    name: 'anotherRule',
    matches: ['http://www.bar.com/*'],
    js: { code: "document.body.style.backgroundColor = 'red';" },
    run_at: 'document_end'
  }]);
 ...

// Navigates webview.
webview.src = 'http://www.foo.com';

Komut dosyaları eklemeniz gerekene kadar addContentScripts çağrısını erteleyebilirsiniz.

Aşağıdaki örnekte, mevcut bir kuralın nasıl üzerine yazılacağı gösterilmektedir.

webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.foo.com/*'],
    js: { files: ['scriptA.js'] },
    run_at: 'document_start'}]);

// Do something.
webview.src = 'http://www.foo.com/*';
 ...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.bar.com/*'],
    js: { files: ['scriptB.js'] },
    run_at: 'document_end'}]);

webview, kaynağa (ör. foo.com) gidip "myRule" eklemek için webview.addContentScripts'u çağırırsa komut dosyalarının eklenmesi için sonraki gezinmeyi beklemeniz gerekir. Hemen enjeksiyon yapmak istiyorsanız executeScript doğru olanı yapacaktır.

Konuk işlemi kilitlense, sonlandırılsa veya webview yeniden üst öğe olarak atanmış olsa bile kurallar korunur.

Daha fazla bilgi için içerik komut dosyaları belgelerine bakın.

Parametreler

back()

chrome.webviewTag.back(
  callback?: function,
): void

Mümkünse bir geçmiş girişi geri gider. go(-1) etiketine eş değer.

Parametreler

  • callback

    işlev isteğe bağlı

    Chrome 44 veya daha yeni bir sürüm

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

    (success: boolean) => void

    • başarılı

      boolean

      Gezinmenin başarılı olup olmadığını gösterir.

canGoBack()

chrome.webviewTag.canGoBack(): boolean

Geçmişte geriye doğru gezinmenin mümkün olup olmadığını gösterir. Bu işlevin durumu önbelleğe alınır ve her loadcommit işleminden önce güncellenir. Bu nedenle, işlevi çağırmak için en uygun yer loadcommit işlemidir.

İadeler

  • boolean

canGoForward()

chrome.webviewTag.canGoForward(): boolean

Geçmişte ileriye doğru gezinmenin mümkün olup olmadığını gösterir. Bu işlevin durumu önbelleğe alınır ve her loadcommit işleminden önce güncellenir. Bu nedenle, işlevi çağırmak için en uygun yer loadcommit işlemidir.

İadeler

  • boolean

captureVisibleRegion()

Chrome 50 veya daha yeni bir sürüm 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
): void

Web görünümünün görünür bölgesini yakalar.

Parametreler

  • seçenekler

    ImageDetails isteğe bağlı

  • callback

    işlev

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

    (dataUrl: string) => void

    • dataUrl

      dize

      Yakalanan sekmenin görünür alanının resmini kodlayan bir veri URL'si. Görüntüleme için bir HTML resim öğesinin "src" özelliğine atanabilir.

clearData()

chrome.webviewTag.clearData(
  options: ClearDataOptions,
  types: ClearDataTypeSet,
  callback?: function,
): void

webview bölümünün tarama verilerini temizler.

Parametreler

  • seçenekler

    ClearDataOptions

    Hangi verilerin temizleneceğini belirleyen seçenekler.

  • Temizlenecek veri türleri.

  • callback

    işlev isteğe bağlı

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

    () => void

executeScript()

chrome.webviewTag.executeScript(
  details: InjectDetails,
  callback?: function,
): void

Konuk sayfasına JavaScript kodu ekler.

Aşağıdaki örnek kod, konuk sayfasının arka plan rengini kırmızı olarak ayarlamak için komut dosyası yerleştirme yöntemini kullanır:

webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });

Parametreler

  • ayrıntılar

    InjectDetails

    Çalıştırılacak komut dosyasının ayrıntıları.

  • callback

    işlev isteğe bağlı

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

    (result?: any[]) => void

    • sonuç

      any[] isteğe bağlı

      Her eklenen karede komut dosyasının sonucu.

find()

chrome.webviewTag.find(
  searchText: string,
  options?: FindOptions,
  callback?: function,
): void

Sayfada bulma isteği başlatır.

Parametreler

  • searchText

    dize

    Sayfada bulunacak dize.

  • seçenekler

    FindOptions isteğe bağlı

    Bulma isteği seçenekleri.

  • callback

    işlev isteğe bağlı

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

    (results?: FindCallbackResults) => void

    • sonuç

      FindCallbackResults isteğe bağlı

      Bulma isteğinin tüm sonuçlarını içerir. Geri çağırma işlevi gövdesinde kullanılmıyorsa results atlanabilir. Örneğin, geri çağırma yalnızca bulma isteğinin ne zaman tamamlandığını anlamak için kullanılıyorsa.

forward()

chrome.webviewTag.forward(
  callback?: function,
): void

Mümkünse bir geçmiş girişi ileri gider. go(1) etiketine eş değer.

Parametreler

  • callback

    işlev isteğe bağlı

    Chrome 44 veya daha yeni bir sürüm

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

    (success: boolean) => void

    • başarılı

      boolean

      Gezinmenin başarılı olup olmadığını gösterir.

getAudioState()

Chrome 62 veya daha yeni bir sürüm 
chrome.webviewTag.getAudioState(
  callback: function,
): void

Ses durumunu sorgular.

Parametreler

  • callback

    işlev

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

    (audible: boolean) => void

    • audible

      boolean

getProcessId()

chrome.webviewTag.getProcessId(): number

Misafir web sayfasının mevcut işlemi için Chrome'un dahili işlem kimliğini döndürür. Böylece yerleştiriciler, işlemi sonlandırmanın kaç misafiri etkileyeceğini bilir. İki konuk, yalnızca aynı uygulamaya aitlerse ve aynı depolama bölümü kimliğine sahiplerse bir işlemi paylaşır. Çağrı eşzamanlıdır ve yerleştiricinin geçerli işlem kimliğinin önbelleğe alınmış kavramını döndürür. İşlem kimliği, işletim sisteminin işlem kimliğiyle aynı değildir.

İadeler

  • sayı

getUserAgent()

chrome.webviewTag.getUserAgent(): string

Konuk sayfası istekleri için webview tarafından kullanılan kullanıcı aracısı dizesini döndürür.

İadeler

  • dize

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
): void

Geçerli yakınlaştırma faktörünü alır.

Parametreler

  • callback

    işlev

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

    (zoomFactor: number) => void

    • zoomFactor

      sayı

      Geçerli yakınlaştırma faktörü.

getZoomMode()

Chrome 43 veya daha yeni bir sürüm 
chrome.webviewTag.getZoomMode(
  callback: function,
): void

Geçerli yakınlaştırma modunu alır.

Parametreler

  • callback

    işlev

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

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      ZoomMode

      webview cihazının mevcut yakınlaştırma modu.

go()

chrome.webviewTag.go(
  relativeIndex: number,
  callback?: function,
): void

Geçerli gezinmeye göre bir geçmiş dizini kullanarak bir geçmiş girişine gider. İstenen gezinme mümkün değilse bu yöntemin etkisi olmaz.

Parametreler

  • relativeIndex

    sayı

    webview öğesinin yönlendirilmesi gereken göreli geçmiş dizini. Örneğin, 2 değeri mümkünse 2 geçmiş girişi ileri giderken -3 değeri 3 giriş geri gider.

  • callback

    işlev isteğe bağlı

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

    (success: boolean) => void

    • başarılı

      boolean

      Gezinmenin başarılı olup olmadığını gösterir.

insertCSS()

chrome.webviewTag.insertCSS(
  details: InjectDetails,
  callback?: function,
): void

Konuk sayfasına CSS ekler.

Parametreler

  • ayrıntılar

    InjectDetails

    Eklenecek CSS'nin ayrıntıları.

  • callback

    işlev isteğe bağlı

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

    () => void

isAudioMuted()

Chrome 62 veya daha yeni bir sürüm 
chrome.webviewTag.isAudioMuted(
  callback: function,
): void

Sesin kapatılıp kapatılmadığını sorgular.

Parametreler

  • callback

    işlev

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

    (muted: boolean) => void

    • ses kapatıldı

      boolean

isSpatialNavigationEnabled()

Chrome 71 veya daha yeni bir sürüm 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
): void

Web görünümü için uzamsal gezinmenin etkin olup olmadığını sorgular.

Parametreler

  • callback

    işlev

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

    (enabled: boolean) => void

    • etkin

      boolean

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

webview kullanıcı aracısı dizesinin webviewTag.setUserAgentOverride tarafından geçersiz kılınıp kılınmadığını gösterir.

loadDataWithBaseUrl()

chrome.webviewTag.loadDataWithBaseUrl(
  dataUrl: string,
  baseUrl: string,
  virtualUrl?: string,
): void

Göreli bağlantılar için kullanılan, belirtilen bir temel URL ile veri URL'si yükler. İsteğe bağlı olarak, veri URL'si yerine kullanıcıya gösterilecek bir sanal URL sağlanabilir.

Parametreler

  • dataUrl

    dize

    Yüklenecek veri URL'si.

  • baseUrl

    dize

    Göreli bağlantılar için kullanılacak temel URL.

  • virtualUrl

    dize isteğe bağlı

    Kullanıcıya (adres çubuğunda) gösterilecek URL.

print()

chrome.webviewTag.print(): void

webview içeriğini yazdırır. Bu, webview içinden komut dosyası oluşturulmuş yazdırma işlevini çağırmaya eş değerdir.

reload()

chrome.webviewTag.reload(): void

Geçerli üst düzey sayfayı yeniden yükler.

removeContentScripts()

Chrome 44 veya daha yeni bir sürüm 
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
): void

webview içindeki içerik komut dosyalarını kaldırır.

Aşağıdaki örnekte, daha önce eklenen "myRule" adlı kural kaldırılıyor.

webview.removeContentScripts(['myRule']);

Aşağıdaki işlevi çağırarak tüm kuralları kaldırabilirsiniz:

webview.removeContentScripts();

Parametreler

  • scriptNameList

    string[] isteğe bağlı

    Kaldırılacak içerik komut dosyalarının adlarının listesi. Liste boşsa webview'ya eklenen tüm içerik komut dosyaları kaldırılır.

setAudioMuted()

Chrome 62 veya daha yeni bir sürüm 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
): void

Web görünümünün sesini kapatma durumunu ayarlar.

Parametreler

  • sesi kapat

    boolean

    Sesi kapatma değeri

setSpatialNavigationEnabled()

Chrome 71 veya daha yeni bir sürüm 
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
): void

WebView'ın uzamsal gezinme durumunu ayarlar.

Parametreler

  • etkin

    boolean

    Uzamsal gezinme durumu değeri.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
): void

Konuk sayfası istekleri için webview tarafından kullanılan kullanıcı aracısı dizesini geçersiz kılın. Geçersiz kılma işlemi, bu geçersiz kılmanın uygulandığı konuk sayfası isteklerinde Kullanıcı Aracısı İstemci İpuçları başlık değerlerinin ve navigator.userAgentData tarafından döndürülen değerlerin boş olmasına neden olur.

Parametreler

  • userAgent

    dize

    Kullanılacak kullanıcı aracısı dizesi.

setZoom()

chrome.webviewTag.setZoom(
  zoomFactor: number,
  callback?: function,
): void

Sayfanın yakınlaştırma faktörünü değiştirir. Bu değişikliğin kapsamı ve kalıcılığı, web görünümünün mevcut yakınlaştırma moduna göre belirlenir (webviewTag.ZoomMode bölümüne bakın).

Parametreler

  • zoomFactor

    sayı

    Yeni yakınlaştırma faktörü.

  • callback

    işlev isteğe bağlı

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

    () => void

setZoomMode()

Chrome 43 veya daha yeni bir sürüm 
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
): void

webview cihazının yakınlaştırma modunu ayarlar.

Parametreler

  • ZoomMode

    ZoomMode

    webview içinde yakınlaştırmanın nasıl işleneceğini tanımlar.

  • callback

    işlev isteğe bağlı

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

    () => void

stop()

chrome.webviewTag.stop(): void

Devam ediyorsa geçerli webview gezinmesinin yüklenmesini durdurur.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: StopFindingAction,
): void

Geçerli bulma oturumunu sonlandırır (tüm vurguları temizler) ve devam eden tüm bulma isteklerini iptal eder.

Parametreler

  • işlem

    StopFindingAction isteğe bağlı

    Bulma oturumu sona erdikten sonra etkin eşleşmeyle ne yapılacağını belirler. clear, etkin eşleşmenin üzerindeki vurguyu temizler; keep, etkin eşleşmeyi vurgulanmış olarak tutar; activate, etkin eşleşmeyi vurgulanmış olarak tutar ve bu eşleşmeye kullanıcı tıklaması simülasyonu uygular. Varsayılan işlem keep'dır.

terminate()

chrome.webviewTag.terminate(): void

Misafir web sayfasının oluşturucu sürecini zorla sonlandırır. Bu durum, aynı işlemi paylaşıyorlarsa mevcut uygulamadaki birden fazla webview etiketini etkileyebilir ancak diğer uygulamalardaki webview etiketlerini etkilemez.

Etkinlikler

close

chrome.webviewTag.close.addListener(
  callback: function,
)

Konuk penceresi kendini kapatmaya çalıştığında tetiklenir.

Aşağıdaki örnek kod, konuk kendini kapatmaya çalıştığında webview öğesini about:blank öğesine yönlendirir.

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

Parametreler

  • callback

    işlev

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

    () => void

consolemessage

chrome.webviewTag.consolemessage.addListener(
  callback: function,
)

Konuk penceresi bir konsol mesajı kaydettiğinde tetiklenir.

Aşağıdaki örnek kod, günlük düzeyine veya diğer özelliklere bakılmaksızın tüm günlük mesajlarını yerleştiricinin konsoluna yönlendirir.

webview.addEventListener('consolemessage', function(e) {
  console.log('Guest page logged a message: ', e.message);
});

Parametreler

  • callback

    işlev

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

    (level: number, message: string, line: number, sourceId: string) => void

    • seviye

      sayı

    • mesaj

      dize

    • satır

      sayı

    • sourceId

      dize

contentload

chrome.webviewTag.contentload.addListener(
  callback: function,
)

Konuk penceresi bir load etkinliğini tetiklediğinde (ör. yeni bir doküman yüklendiğinde) tetiklenir. Bu, mevcut dokümandaki sayfa gezinme veya eşzamansız kaynak yüklemelerini içermez.

Aşağıdaki örnek kod, sayfa yüklendikten sonra konuğun body öğesinin varsayılan yazı tipi boyutunu değiştirir:

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

Parametreler

  • callback

    işlev

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

    () => void

dialog

chrome.webviewTag.dialog.addListener(
  callback: function,
)

Konuk penceresi window.alert, window.confirm veya window.prompt aracılığıyla kalıcı bir iletişim kutusu açmaya çalıştığında tetiklenir.

Bu etkinliğin işlenmesi, her etkinlik işleyici döndürene veya dialog nesnesine ulaşılamayana kadar (preventDefault() çağrıldıysa) konuk sürecini engeller.

Varsayılan davranış, iletişim kutusunu iptal etmektir.

Parametreler

exit

chrome.webviewTag.exit.addListener(
  callback: function,
)

Misafir web içeriğini oluşturma işlemi sonlandırıldığında tetiklenir.

Aşağıdaki örnek kod, konuk sayfası her çöktüğünde bir veda mesajı gösterir:

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,Goodbye, world!';
  }
});

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • processID

        sayı

        Çıkılan işlemin Chrome'daki dahili kimliği.

      • neden

        ExitReason

        Çıkış nedenini belirten dize.

findupdate

chrome.webviewTag.findupdate.addListener(
  callback: function,
)

Etkin bir bulma isteği için yeni bulma sonuçları kullanılabilir olduğunda tetiklenir. Eşleşmeler bulundukça bu durum tek bir bulma isteği için birden fazla kez gerçekleşebilir.

Parametreler

  • callback

    işlev

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

    (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

    • searchText

      dize

    • numberOfMatches

      sayı

    • activeMatchOrdinal

      sayı

    • selectionRect

      SelectionRect

    • iptal edildi

      boolean

    • finalUpdate

      dize

loadabort

chrome.webviewTag.loadabort.addListener(
  callback: function,
)

Üst düzey bir yükleme kaydedilmeden iptal edildiğinde tetiklenir. Etkinliğin varsayılan davranışı engellenmediği sürece konsola bir hata mesajı yazdırılır.

Not: Bir kaynak yükleme işlemi iptal edildiğinde, son loadstop etkinliğinden bu yana gerçekleştirilen tüm yüklemeler (varsa) iptal edilmiş olsa bile loadabort etkinliğini sonunda bir loadstop etkinliği izler.

Not: Bir about URL'sinin veya JavaScript URL'sinin yüklenmesi durdurulduğunda loadabort tetiklenir ve ardından webview, "about:blank"a yönlendirilir.

Parametreler

  • callback

    işlev

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

    (url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void

loadcommit

chrome.webviewTag.loadcommit.addListener(
  callback: function,
)

Yükleme işlemi tamamlandığında tetiklenir. Bu, geçerli dokümandaki gezinmenin yanı sıra alt çerçeve doküman düzeyindeki yüklemeleri de içerir ancak eşzamansız kaynak yüklemelerini içermez.

Parametreler

  • callback

    işlev

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

    (url: string, isTopLevel: boolean) => void

    • url

      dize

    • isTopLevel

      boolean

loadredirect

chrome.webviewTag.loadredirect.addListener(
  callback: function,
)

Üst düzey bir yükleme isteği farklı bir URL'ye yönlendirildiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

    • oldUrl

      dize

    • newUrl

      dize

    • isTopLevel

      boolean

loadstart

chrome.webviewTag.loadstart.addListener(
  callback: function,
)

Yükleme başladığında tetiklenir.

Parametreler

  • callback

    işlev

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

    (url: string, isTopLevel: boolean) => void

    • url

      dize

    • isTopLevel

      boolean

loadstop

chrome.webviewTag.loadstop.addListener(
  callback: function,
)

Bir konuk sayfasındaki tüm çerçeve düzeyinde yüklemeler (tüm alt çerçeveler dahil) tamamlandığında tetiklenir. Bu, geçerli dokümandaki gezinmenin yanı sıra alt çerçeve doküman düzeyindeki yüklemeleri de içerir ancak eşzamansız kaynak yüklemelerini içermez. Bu etkinlik, doküman düzeyindeki yüklerin sayısı birden (veya daha fazlasından) sıfıra her geçiş yaptığında tetiklenir. Örneğin, yüklenmesi tamamlanmış bir sayfada (ör. loadstop zaten bir kez tetiklenmişse) bir sayfa yükleyen yeni bir iframe oluşturur. Ardından, iframe sayfa yüklemesi tamamlandığında ikinci bir loadstop tetiklenir. Bu kalıp genellikle reklam yükleyen sayfalarda görülür.

Not: Bir kesin yükleme iptal edildiğinde, son loadstop etkinliğinden bu yana kesin yüklemelerin tümü (varsa) iptal edilmiş olsa bile sonunda bir loadstop etkinliği bir loadabort etkinliğini takip eder.

Parametreler

  • callback

    işlev

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

    () => void

newwindow

chrome.webviewTag.newwindow.addListener(
  callback: function,
)

Konuk sayfası yeni bir tarayıcı penceresi açmaya çalıştığında tetiklenir.

Aşağıdaki örnek kod, her istenen yeni pencere için yerleştiricide yeni bir webview oluşturup bu pencereye gider:

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

Parametreler

  • callback

    işlev

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

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void

permissionrequest

chrome.webviewTag.permissionrequest.addListener(
  callback: function,
)

Konuk sayfanın yerleştiriciden özel izin istemesi gerektiğinde tetiklenir.

Aşağıdaki örnek kod, konuk sayfasına webkitGetUserMedia API'sine erişim izni verir. Bu örnek kodu kullanan bir uygulamanın audioCapture ve/veya videoCapture manifest izinlerini kendisinin belirtmesi gerektiğini unutmayın:

webview.addEventListener('permissionrequest', function(e) {
  if (e.permission === 'media') {
    e.request.allow();
  }
});

Parametreler

  • callback

    işlev

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

    (permission: PermissionType, request: object) => void

responsive

chrome.webviewTag.responsive.addListener(
  callback: function,
)

Konuk web içeriğini oluşturma işlemi yanıt vermemeye başladıktan sonra tekrar yanıt vermeye başladığında tetiklenir.

Aşağıdaki örnek kod, webview öğesi duyarlı veya duyarsız hale geldikçe öğeyi görünür veya görünmez hale getirir:

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

Parametreler

  • callback

    işlev

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

    (processID: number) => void

    • processID

      sayı

sizechanged

chrome.webviewTag.sizechanged.addListener(
  callback: function,
)

Yerleştirilmiş web içeriği autosize aracılığıyla yeniden boyutlandırıldığında tetiklenir. Yalnızca autosize etkinse tetiklenir.

Parametreler

  • callback

    işlev

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

    (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

    • oldWidth

      sayı

    • oldHeight

      sayı

    • newWidth

      sayı

    • newHeight

      sayı

unresponsive

chrome.webviewTag.unresponsive.addListener(
  callback: function,
)

Konuk web içeriğini oluşturma işlemi yanıt vermemeye başladığında tetiklenir. Konuk tekrar yanıt vermeye başlarsa bu etkinlik, eşleşen bir duyarlı etkinlik ile birlikte bir kez oluşturulur.

Parametreler

  • callback

    işlev

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

    (processID: number) => void

    • processID

      sayı

zoomchange

chrome.webviewTag.zoomchange.addListener(
  callback: function,
)

Sayfanın yakınlaştırma düzeyi değiştiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (oldZoomFactor: number, newZoomFactor: number) => void

    • oldZoomFactor

      sayı

    • newZoomFactor

      sayı