chrome.webviewTag

Açıklama

Ağ üzerinden web'den canlı içerikleri 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şim kurabilir, yerleştirilmiş bir web sayfasında gezinme başlatabilir, sayfadaki hata etkinliklerine tepki verebilir ve daha fazlasını yapabilir (Kullanım bölümüne bakın).

İzinler

webview

Türler

ClearDataOptions

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

Özellikler

  • şu tarihten beri:

    number isteğe bağlı

    Bu tarihte veya sonrasında toplanan verileri temizleyin. Bu veriler, başlangıç tarihinden itibaren milisaniye cinsinden gösterilir (JavaScript Date nesnesinin getTime yöntemi aracılığıyla erişilebilir). Bu parametre yoksa varsayılan olarak 0 olur (tüm tarama verileri kaldırılır).

ClearDataTypeSet

Bir veri türü grubu. Eksik mülkler false olarak yorumlanır.

Özellikler

  • appcache

    boole isteğe bağlı

    Web sitelerinin uygulama önbellekleri.

  • önbellek

    boole isteğe bağlı

    Chrome 44 ve sonraki sürümler

    Chrome 43 sürümünden beri Tarayıcının önbelleği. Not: Veriler kaldırıldığında önbelleğin tamamı temizlenir. Bu işlem, belirttiğiniz aralıkla sınırlı değildir.

  • Cloud Console dışındaki Google Cloud sitelerindeki

    boole isteğe bağlı

    Bölümün çerezleri.

  • fileSystems

    boole isteğe bağlı

    Web sitelerinin dosya sistemleri.

  • indexedDB

    boole isteğe bağlı

    Web sitelerinin IndexedDB verileri.

  • localStorage

    boole isteğe bağlı

    Web sitelerinin yerel depolama alanı verileri.

  • persistentCookies

    boole isteğe bağlı

    Chrome 58 ve sonraki sürümler

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

  • sessionCookies

    boole isteğe bağlı

    Chrome 58 ve sonraki sürümler

    Bölümün oturum çerezleri.

  • webSQL

    boole isteğe bağlı

    Web sitelerinin WebSQL verileri.

ContentScriptDetails

Chrome 44 ve sonraki sürümler

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

Özellikler

  • all_frames

    boole isteğe bağlı

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

  • css

    InjectionItems isteğe bağlı

    Eşleşen sayfalara eklenecek CSS kodu veya CSS dosyalarının listesi. Bunlar, sayfa için herhangi bir DOM oluşturulmadan veya gösterilmeden önce göründükleri sırada eklenir.

  • exclude_globs

    string[] isteğe bağlı

    Bu genel ifadeyle eşleşen URL'leri hariç tutmak için eşleşmelerden sonra uygulanır. @exclude Greasemonkey anahtar kelimesini taklit etmek için tasarlanmıştır.

  • exclude_matches

    string[] isteğe bağlı

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

  • include_globs

    string[] isteğe bağlı

    Eşleşmelerden sonra uygulanır ve yalnızca bu genel ifadeyle eşleşen URL'leri içerir. @include Greasemonkey anahtar kelimesini taklit etmek için tasarlanmıştır.

  • js

    InjectionItems isteğe bağlı

    Eşleşen sayfalara eklenecek JavaScript kodu veya JavaScript dosyalarının listesi. Bunlar göründükleri sırada eklenir.

  • match_about_blank

    boole isteğe bağlı

    İçerik komut dosyasının about:blank ve about:srcdoc adreslerine eklenip eklenmeyeceği. İçerik komut dosyaları yalnızca devralınan URL'leri, eşleşmeler alanında tanımlanan kalıplardan biriyle eşleştiğinde sayfalara eklenir. 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 erken eklenme zamanı. Varsayılan olarak "document_idle" değerine ayarlanır.

ContentWindow

Davetli penceresine mesajlaşma herkese açık kullanıcı adı.

Özellikler

  • postMessage

    geçersiz

    Yerleşik içerik, hedef kaynaktan bir sayfa görüntülediği sürece yerleşik web içeriğine bir mesaj gönderir. Bu yöntem, sayfanın yüklenmesi tamamlandıktan sonra kullanılabilir. contentload etkinliğini dinleyin ve ardından yöntemi çağırın.

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

    Bu API, web sayfaları arasındaki iletişim için kullanılan HTML5 postMessage API ile aynıdır. Yerleştiren, kendi çerçevesine bir message etkinlik işleyici ekleyerek yanıtları dinleyebilir.

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

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

    • mesaj

      herhangi

      Davetliye gönderilecek mesaj nesnesi.

    • targetOrigin

      dize

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

ContextMenuCreateProperties

Chrome 44 ve sonraki sürümler

Özellikler

  • işaretli

    boole isteğe bağlı

    Bir onay kutusunun veya radyo öğesinin ilk durumu: Seçili için doğru, seçilmemiş için yanlış. Belirli bir radyo öğesi 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ı

    Öğeyi yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlar için geçerli olacak şekilde 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

    boole isteğe bağlı

    Bu içerik menüsü öğesinin etkin veya devre dışı olup olmadığını 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ı

    Ü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 ana sayfa etiketlerinin href özelliğine göre filtreleme yapmanıza olanak tanır.

  • title

    dize isteğe bağlı

    Öğede gösterilecek metin. type "ayraç" 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 Pig Latin'e çevir" ise ve kullanıcı "cool" kelimesini seçerse seçimin bağlam menüsü öğesi "'cool'u Pig Latin'e çevir" olur.

  • tür

    ItemType isteğe bağlı

    Menü öğesinin türü. Belirtilmezse varsayılan olarak "normal" olur.

  • onclick

    void isteğe bağlı

    Menü öğesi tıklandığında geri çağrılacak 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 bilgi.

ContextMenus

Chrome 44 ve sonraki sürümler

Özellikler

  • onShow

    Etkinlik<functionvoidvoid>

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

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

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

    • geri çağırma

      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 içerik menüsü öğesi oluşturur. Oluşturma sırasında bir hata meydana gelirse bunu, oluşturma geri çağırma işlevi tetiklenene kadar fark edemeyeceğinizi unutmayın (ayrıntılar runtime.lastError içinde olacaktır).

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

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

    • createProperties

      nesne

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

    • geri çağırma

      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

    Bir iç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.

    • geri çağırma

      işlev isteğe bağlı

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

      () => void

  • removeAll

    geçersiz

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

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

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

    • geri çağırma

      işlev isteğe bağlı

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

      () => void

  • update

    geçersiz

    Daha önce oluşturulmuş bir içerik 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 tesisler. create işleviyle aynı değerleri kabul eder.

    • geri çağırma

      işlev isteğe bağlı

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

      () => void

ContextMenuUpdateProperties

Chrome 44 ve sonraki sürümler

Özellikler

  • işaretli

    boole isteğe bağlı

    Bir onay kutusunun veya radyo öğesinin durumu: Seçili için doğru, seçilmemiş için yanlış. Belirli bir radyo öğesi 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ı

    Öğeyi yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlar için geçerli olacak şekilde 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

    boole isteğe bağlı

    Bu içerik menüsü öğesinin etkin veya devre dışı olup olmadığını belirtir.

  • parentId

    dize | sayı isteğe bağlı

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

  • targetUrlPatterns

    string[] isteğe bağlı

    documentUrlPatterns'e benzer ancak img/audio/video etiketlerinin src özelliğine ve ana sayfa 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ı

    Menü öğesinin türü.

  • onclick

    void isteğe bağlı

    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 bilgi.

ContextType

Chrome 44 ve sonraki sürümler

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

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

dialog DOM etkinliklerine bağlı arayüz.

Ö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.

DownloadPermissionRequest

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

Özellikler

  • requestMethod

    dize

    İndirme isteğiyle ilişkili HTTP istek 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: 

    () => {...}

FileSystemPermissionRequest

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

Özellikler

  • url

    dize

    Yerel dosya sistemine 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.

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

    () => {...}

FindCallbackResults

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

Özellikler

  • activeMatchOrdinal

    sayı

    Geçerli eşleşmenin sıra numarası.

  • iptal edildi

    boolean

    Bu bulma isteğinin iptal edilip edilmediğini belirtir.

  • numberOfMatches

    sayı

    Sayfada searchText değerinin 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

    boole isteğe bağlı

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

  • matchCase

    boole isteğe bağlı

    Büyük/küçük harfe duyarlı eşleme için işaret. Varsayılan değer: false.

FullscreenPermissionRequest

Chrome 43 ve sonraki sürümler

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

Özellikler

  • kaynak

    dize

    Tam ekran isteğini başlatan webview içindeki karenin 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 nesnesi 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 nesnesi türü.

Özellikler

  • url

    dize

    HID API'ye 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ının veya CSS'nin ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her 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ı siteler arası komut dosyası çalıştırma saldırılarına açık hale getirebilir.

  • dosya

    dize isteğe bağlı

    Eklenecek JavaScript veya CSS dosyası.

InjectionItems

Chrome 44 ve sonraki sürümler

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

Özellikler

  • kod

    dize isteğe bağlı

    Eşleşen sayfalara eklenecek JavaScript kodu veya CSS.

  • dosyalar

    string[] isteğe bağlı

    Eşleşen sayfalara eklenecek JavaScript veya CSS dosyalarının listesi. Bunlar, bu dizgede göründükleri sırayla eklenir.

LoadPluginPermissionRequest

loadplugin permissionrequest DOM etkinliğine eşlik eden request nesnesi 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 nesnesi türü.

Özellikler

  • url

    dize

    Kullanıcı medyasına 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: 

    () => {...}

NewWindow

newwindow DOM etkinliklerine bağlı arayüz.

Ö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 eklenmesi gereken webview öğesi.

  • sil

    geçersiz

    Yeni pencere isteğini iptal edin.

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

    () => {...}

PointerLockPermissionRequest

pointerLock permissionrequest DOM etkinliğine eşlik eden request nesnesi 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

    Kullanıcı girişi hareketi sonucunda işaretçi kilidinin 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.

Kapsayıcılık semantiği dizi benzeridir. Yani (left, top) koordinatının dikdörtgen tarafından kapsandığı, (left + width, top) koordinatının ise kapsanmadığından bahsedilir.

Özellikler

  • yükseklik

    sayı

    Dikdörtgenin yüksekliği.

  • sol

    sayı

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

  • üst

    sayı

    Ekranın üst kenarından dikdörtgenin üst kenarına olan mesafe.

  • genişlik

    sayı

    Dikdörtgenin genişliği.

WebRequestEventInterface

Chrome 44 ve sonraki sürümler

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ı API'sine bakın. Not: chrome.webRequest.onActionIgnored etkinliği web görünümlerinde desteklenmez.

Kullanımın, uzantılar 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 açıklayıcı webRequest kurallarını destekler. API ayrıntıları için declarativeWebRequest bölümüne bakın.

Beyan dilinde web görünümü webRequest'leri için koşulların ve işlemlerin, chrome.webViewRequest.* eşdeğerlerinden oluşturulması gerektiğini unutmayın. Aşağıdaki örnek kod, myWebview web görünümünde "example.com" adresine yapılan tüm istekleri açık bir şekilde engeller:

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

ZoomMode

Chrome 43 ve sonraki sürümler

Yakınlaştırma işleminin webview'te nasıl işleneceğini tanımlar.

Enum

"per-origin"
Yakınlaştırma değişiklikleri, yakınlaştırılmış sayfanın kaynağında kalır. Yani aynı bölümde bulunan ve aynı kaynağa yönlendirilen diğer tüm web görünümleri de yakınlaştırılır. Ayrıca, per-originyakınlaştırma değişiklikleri kaynakla birlikte kaydedilir. Bu, aynı kaynaktaki diğer sayfalara giderken bunların hepsinin aynı yakınlaştırma faktörüne yakınlaştırılacağı anlamına gelir.

"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ırma özelliğini etkilemez. Ayrıca, per-view yakınlaştırma değişiklikleri gezinme sırasında 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ırma işlemlerini devre dışı bırakır. İçerik varsayılan yakınlaştırma seviyesine geri döner ve tüm yakınlaştırma değişiklikleri yoksayılır.

Özellikler

contentWindow

Misafir sayfasına mesaj yayınlamak için kullanılabilecek nesne referansı.

Tür

ContentWindow

contextMenus

Chrome 44 ve sonraki sürümler

Chrome'un ContextMenus API'sine benzer ancak tarayıcı yerine webview için geçerlidir. webview'un içerik menüsüne öğe eklemek için webview.contextMenus API'yi kullanın. İçerik menüsü eklemelerinizin resim, köprü ve sayfa gibi nesne türleri için geçerli olup olmayacağını 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 ve sonraki sürümler 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)

webview dosyasına içerik komut dosyası yerleştirme kuralları ekler. webview bir veya daha fazla kuralla eşleşen bir sayfaya gittiğinde ilişkili komut dosyaları eklenir. Kuralları programatik olarak ekleyebilir veya mevcut kuralları güncelleyebilirsiniz.

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

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';

addContentScripts çağrısını, komut dosyası eklemeniz gerekene kadar erteleyin.

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) yönlendirildiyse ve "myRule"u eklemek için webview.addContentScripts'ı çağırıyorsa komut dosyalarının eklenmesini sağlamak için bir sonraki gezinmeyi beklemeniz gerekir. Hemen para yatırmak istiyorsanız executeScript doğru olanı yapar.

Misafir işlemi kilitlense veya sonlandırılsa ya da webview yeniden üst öğe olarak atandığında bile kurallar korunur.

Daha fazla bilgi için içerik komut dosyaları belgelerini inceleyin.

Parametreler

back()

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

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    Chrome 44 ve sonraki sürümler

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

    (success: boolean) => void

    • başarılı

      boolean

      Gezinmenin başarılı olup olmadığını belirtir.

canGoBack()

chrome.webviewTag.canGoBack()

Geçmişte geriye dönük gezinmenin mümkün olup olmadığını belirtir. Bu işlevin durumu önbelleğe alınır ve her loadcommit işleminden önce güncellenir. Bu nedenle, işlevi çağırmanın en iyi yeri loadcommit işlevidir.

İadeler

  • boolean

canGoForward()

chrome.webviewTag.canGoForward()

Geçmişte ileri doğru gezinmenin mümkün olup olmadığını belirtir. Bu işlevin durumu önbelleğe alınır ve her loadcommit işleminden önce güncellenir. Bu nedenle, işlevi çağırmanın en iyi yeri loadcommit işlevidir.

İadeler

  • boolean

captureVisibleRegion()

Chrome 50 ve üzeri sürümler 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)

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

Parametreler

  • seçenekler

    ImageDetails isteğe bağlı

  • geri çağırma

    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ülemek için bir HTML resim öğesinin "src" özelliğine atanabilir.

clearData()

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

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

Parametreler

  • seçenekler

    ClearDataOptions

    Hangi verilerin temizleneceğini belirleyen seçenekler.

  • Temizlenecek veri türleri.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

executeScript()

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

Konuk sayfasına JavaScript kodu ekler.

Aşağıdaki örnek kodda, konuk sayfasının arka plan rengini kırmızı olarak ayarlamak için komut dosyası ekleme kullanılmaktadı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ı.

  • geri çağırma

    işlev isteğe bağlı

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

    (result?: any[]) => void

    • sonuç

      any[] isteğe bağlı

      Her enjekte edilen karede komut dosyasının sonucu.

find()

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

Sayfada arama isteği başlatır.

Parametreler

  • searchText

    dize

    Sayfada bulunacak dize.

  • seçenekler

    FindOptions isteğe bağlı

    Bulma isteği seçenekleri.

  • geri çağırma

    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. results, geri çağırma işlevi gövdesinde kullanılmazsa atlanabilir. Örneğin, geri çağırma yalnızca bulma isteğinin ne zaman tamamlandığını belirlemek için kullanılıyorsa.

forward()

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

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    Chrome 44 ve sonraki sürümler

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

    (success: boolean) => void

    • başarılı

      boolean

      Gezinmenin başarılı olup olmadığını belirtir.

getAudioState()

Chrome 62 ve üzeri sürümler 
chrome.webviewTag.getAudioState(
  callback: function,
)

Ses durumunu sorgulayan bir işlevdir.

Parametreler

  • geri çağırma

    işlev

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

    (audible: boolean) => void

    • audible

      boolean

getProcessId()

chrome.webviewTag.getProcessId()

Misafir web sayfasının mevcut işlemi için Chrome'un dahili işlem kimliğini döndürür. Böylece, yerleşimcilerin işlemin sonlandırılmasından kaç misafirin etkileneceğini bilmesi sağlanır. İki konuk yalnızca aynı uygulamaya aitse ve aynı depolama bölümü kimliğine sahipse bir işlemi paylaşır. Çağırma türü senkronizedir ve yerleştirenin mevcut işlem kimliğiyle ilgili önbelleğe alınmış bilgisini döndürür. İşlem kimliği, işletim sisteminin işlem kimliğiyle aynı değildir.

İadeler

  • sayı

getUserAgent()

chrome.webviewTag.getUserAgent()

Misafir 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,
)

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

Parametreler

  • geri çağırma

    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 ve sonraki sürümler 
chrome.webviewTag.getZoomMode(
  callback: function,
)

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

Parametreler

  • geri çağırma

    işlev

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

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      ZoomMode

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

go()

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

Geçerli gezinmeyle ilgili bir geçmiş dizini kullanarak geçmiş girişine gider. İstenen gezinme mümkün değilse bu yöntemin hiçbir 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, -3 değeri ise 3 giriş geri gider.

  • geri çağırma

    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ı belirtir.

insertCSS()

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

Misafir sayfasına CSS ekler.

Parametreler

  • ayrıntılar

    InjectDetails

    Eklenecek CSS'nin ayrıntıları.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

isAudioMuted()

Chrome 62 ve üzeri sürümler 
chrome.webviewTag.isAudioMuted(
  callback: function,
)

Sesin kapalı olup olmadığını sorar.

Parametreler

  • geri çağırma

    işlev

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

    (muted: boolean) => void

    • ses kapatıldı

      boolean

isSpatialNavigationEnabled()

Chrome 71 ve üzeri sürümler 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

Web görünümü için mekansal navigasyonun etkin olup olmadığını sorgulayın.

Parametreler

  • geri çağırma

    işlev

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

    (enabled: boolean) => void

    • etkin

      boolean

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

webview'ün kullanıcı aracısı dizenin webviewTag.setUserAgentOverride tarafından geçersiz kılınıp kılınmadığını belirtir.

loadDataWithBaseUrl()

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

Göreli bağlantılar için kullanılan belirli bir ana URL içeren bir veri URL'si yükler. İsteğe bağlı olarak, veri URL'si yerine kullanıcıya gösterilecek sanal bir 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 gösterilecek URL (adres çubuğunda).

print()

chrome.webviewTag.print()

webview öğesinin içeriğini yazdırır. Bu, webview'ten komut dosyası yazdırma işlevini çağırmaya eşdeğerdir.

reload()

chrome.webviewTag.reload()

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

removeContentScripts()

Chrome 44 ve sonraki sürümler 
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)

webview'ten içerik komut dosyalarını kaldırır.

Aşağıdaki örnekte, daha önce eklenen "kuralim" kaldırılmaktadır.

webview.removeContentScripts(['myRule']);

Aşağıdakileri ç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 alanına eklenen tüm içerik komut dosyaları kaldırılır.

setAudioMuted()

Chrome 62 ve üzeri sürümler 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

Web görünümünün sessiz durumunu ayarlar.

Parametreler

  • sesi kapat

    boolean

    Sesi kapatma değeri

setSpatialNavigationEnabled()

Chrome 71 ve üzeri sürümler 
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

Web görünümünün mekansal gezinme durumunu ayarlar.

Parametreler

  • etkin

    boolean

    Mekansal gezinme durumu değeri.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

Misafir 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ılma işleminin uygulandığı konuk sayfası isteklerinde User-Agent Client Hint 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,
)

Sayfanın yakınlaştırma faktörünü değiştirir. Bu değişikliğin kapsamı ve devamlı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ü.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

setZoomMode()

Chrome 43 ve sonraki sürümler 
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

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

Parametreler

  • ZoomMode

    ZoomMode

    Yakınlaştırma işleminin webview'te nasıl işleneceğini tanımlar.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

stop()

chrome.webviewTag.stop()

Devam eden mevcut webview navigasyonunu yüklemeyi durdurur.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: "clear" 
  | "keep" 
  | "activate" 
 ,
)

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

Parametreler

  • işlem

    "clear"
     | "keep"
     | "activate"
     isteğe bağlı

    Bulma oturumu sona erdikten sonra etkin eşlemeyle ne yapılacağını belirler. clear, etkin eşleşmenin vurgusunu temizler; keep, etkin eşleşmenin vurgusunu korur; activate, etkin eşleşmenin vurgusunu korur ve kullanıcının bu eşleşmeyi tıklamasını simüle eder. Varsayılan işlem keep'tir.

terminate()

chrome.webviewTag.terminate()

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

Etkinlikler

close

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

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

Aşağıdaki örnek kod, konuk kendini kapatmaya çalıştığında webview'ten about:blank'a gider.

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

Parametreler

  • geri çağırma

    işlev

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

    () => void

consolemessage

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

Misafir penceresi bir konsol mesajı günlüğe 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ştirenin konsoluna yönlendirir.

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

Parametreler

  • geri çağırma

    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,
)

Davetli penceresi bir load etkinliği tetiklediğinde (ör. yeni bir doküman yüklendiğinde) tetiklenir. Mevcut belgedeki sayfa gezinme işlemleri veya eşzamansız kaynak yüklemeleri bu süreye dahil değildir.

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

  • geri çağırma

    işlev

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

    () => void

dialog

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

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

Bu etkinliğin işlenmesi, her etkinlik işleyicisi geri dönene veya dialog nesnesi erişilemez hale gelene (preventDefault() çağrıldıysa) kadar konuk sürecini engeller.

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

Parametreler

  • geri çağırma

    işlev

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

    (messageType: "alert" 
      | "confirm" 
      | "prompt" 
     , messageText: string, dialog: DialogController) => void

    • messageType

      "alert"
       | "confirm"
       | "prompt"

    • messageText

      dize

    • iletişim

      DialogController

exit

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

Misafir web içeriğini oluşturan işlem sona erdiğinde tetiklenir.

Aşağıdaki örnek kod, konuk sayfası her kilitlendiğinde bir veda mesajı gösterir:

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

Parametreler

  • geri çağırma

    işlev

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

    (processID: number, reason: "normal" 
      | "abnormal" 
      | "crash" 
      | "kill" 
     ) => void

    • processID

      sayı

    • neden

      "normal"
       | "abnormal"
       | "crash"
       | "kill"

findupdate

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

Etkin bir bulma isteği için yeni bulma sonuçları mevcut olduğunda tetiklenir. Eşleşmeler bulunduğunda bu durum tek bir bulma isteği için birden çok kez gerçekleşebilir.

Parametreler

  • geri çağırma

    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, taahhüt edilmeden iptal edildiğinde tetiklenir. Etkinlik varsayılan olarak engellenmemişse konsola bir hata mesajı yazdırılır.

Not: Bir kaynak yüklemesi iptal edildiğinde, son loadstop etkinliğinden (varsa) sonraki tüm taahhüt edilen yüklemeler iptal edilmiş olsa bile loadabort etkinliğini bir loadstop etkinliği takip eder.

Not: Bir about URL'sinin veya JavaScript URL'sinin yüklenmesi iptal edildiğinde loadabort tetiklenir ve ardından webview "about:blank" adresine yönlendirilir.

Parametreler

  • geri çağırma

    işlev

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

    (url: string, isTopLevel: boolean, code: number, reason: "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" 
     ) => void

    • url

      dize

    • isTopLevel

      boolean

    • kod

      sayı

    • neden

      "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"

loadcommit

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

Bir yükleme taahhüt edildiğinde tetiklenir. Bu, mevcut doküman içinde gezinmenin yanı sıra alt çerçeve doküman düzeyinde yüklemeleri içerir ancak asenkron kaynak yüklemelerini içermez.

Parametreler

  • geri çağırma

    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önlendirdiğinde tetiklenir.

Parametreler

  • geri çağırma

    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 işlemi başladığında tetiklenir.

Parametreler

  • geri çağırma

    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üzeyindeki yüklemeler (tüm alt çerçeveleri dahil) tamamlandığında tetiklenir. Bu, mevcut doküman içinde gezinmenin yanı sıra alt çerçeve doküman düzeyinde yüklemeleri içerir ancak asenkron kaynak yüklemelerini içermez. Bu etkinlik, belge düzeyinde yükleme sayısı bir (veya daha fazla) değerinden sıfır değerine her geçtiğinde tetiklenir. Örneğin, yüklenmesi tamamlanmış bir sayfa (ör. loadstop bir kez tetiklendiyse) bir sayfa yükleyen yeni bir iframe oluşturur. Ardından, iframe sayfası yüklemesi tamamlandığında ikinci bir loadstop tetiklenir. Bu kalıp, genellikle reklam yükleyen sayfalarda görülür.

Not: Taahhüt edilen bir yükleme iptal edildiğinde, son loadstop etkinliğinden (varsa) sonraki tüm taahhüt edilen yüklemeler iptal edilmiş olsa bile bir loadabort etkinliğini bir loadstop etkinliği takip eder.

Parametreler

  • geri çağırma

    işlev

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

    () => void

newwindow

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

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

Aşağıdaki örnek kod, istenen her yeni pencere için yerleştiricide yeni bir webview oluşturur ve bu webview'ye yönlendirir:

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

Parametreler

  • geri çağırma

    işlev

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

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: "ignore" 
      | "save_to_disk" 
      | "current_tab" 
      | "new_background_tab" 
      | "new_foreground_tab" 
      | "new_window" 
      | "new_popup" 
     ) => void

    • pencere

      NewWindow

    • targetUrl

      dize

    • initialWidth

      sayı

    • initialHeight

      sayı

    • ad

      dize

    • windowOpenDisposition

      "ignore"
       | "save_to_disk"
       | "current_tab"
       | "new_background_tab"
       | "new_foreground_tab"
       | "new_window"
       | "new_popup"

permissionrequest

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

Misafir sayfanın, yerleştirenden ö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

  • geri çağırma

    işlev

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

    (permission: "media" 
      | "geolocation" 
      | "pointerLock" 
      | "download" 
      | "loadplugin" 
      | "filesystem" 
      | "fullscreen" 
      | "hid" 
     , request: object) => void

    • izin

      "media"
       | "geolocation"
       | "pointerLock"
       | "download"
       | "loadplugin"
       | "filesystem"
       | "fullscreen"
       | "hid"

    • istek

      nesne

responsive

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

Davetli web içeriğini oluşturan işlem, yanıt vermeyi bıraktıktan sonra tekrar yanıt vermeye başladığında tetiklenir.

Aşağıdaki örnek kodda, webview öğesi duyarlı hale geldiğinde veya duyarlılığını kaybettiğinde yavaşça görünür veya görünmez hale gelir:

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

Parametreler

  • geri çağırma

    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

  • geri çağırma

    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,
)

Misafir web içeriğini oluşturan işlem yanıt vermediğinde tetiklenir. Davetli tekrar yanıt vermeye başlarsa bu etkinlik, eşleşen bir duyarlı etkinlikle birlikte bir kez oluşturulur.

Parametreler

  • geri çağırma

    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 ayarı değiştiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

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

    • oldZoomFactor

      sayı

    • newZoomFactor

      sayı