chrome.webviewTag

Açıklama

Web'deki canlı içeriği ağ üzerinden etkin bir şekilde yüklemek ve Chrome Uygulamanıza yerleştirmek için webview etiketini kullanın. Uygulamanız, webview görünümünü kontrol edip web içeriğiyle etkileşimde bulunabilir, yerleştirilmiş web sayfalarında gezinme başlatabilir, içinde meydana gelen hata olaylarına tepki verebilir ve daha fazlasını yapabilir (Kullanım bölümüne bakın).

İzinler

webview

Türler

ClearDataOptions

clearData tarihine kadar hangi verilerin temizleneceğini belirleyen seçenekler.

Özellikler

  • şu tarihten beri:

    sayı isteğe bağlı

    Dönemden bu yana milisaniye cinsinden temsil edilen, bu tarihte veya daha sonra biriken verileri temizleme (JavaScript Date nesnesinin getTime yöntemiyle erişilebilir). Yoksa varsayılan olarak 0 değerine ayarlanır (bu işlem tüm tarama verilerini kaldırır).

ClearDataTypeSet

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

Özellikler

  • uygulama önbelleği

    boole isteğe bağlı

    Web sitelerinin appcaches.

  • önbellek

    boole isteğe bağlı

    Chrome 44 ve sonraki sürümler 'nı inceleyin.

    Chrome 43 sürümünden itibaren. Tarayıcının önbelleği. Not: Veriler kaldırılırken önbelleğin tamamı temizlenir; 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 verileri.

  • persistentCookies

    boole isteğe bağlı

    Chrome 58 ve sonraki sürümler 'nı inceleyin.

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

  • sessionCookies

    boole isteğe bağlı

    Chrome 58 ve sonraki sürümler 'nı inceleyin.

    Bölümün oturum çerezleri.

  • webSQL

    boole isteğe bağlı

    Web sitelerinin WebSQL verileri.

ContentScriptDetails

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Eklenecek içerik komut dosyasının ayrıntıları. Daha ayrıntılı bilgi için içerik komut dosyaları dokümanlarına bakın.

Özellikler

  • all_frames

    boole isteğe bağlı

    all_frames değeri, true ise bu, 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 değeridir ve JavaScript veya CSS yalnızca üst çerçeveye yerleştirilir.

  • 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örüntülenmeden önce göründükleri sırayla eklenir.

  • exclude_globs

    string[] isteğe bağlı

    Bu küreyle eşleşen URL'leri hariç tutmak için eşleşmelerden sonra uygulanır. @excluded Greasemonkey anahtar kelimesini emüle etmek için oluşturulmuştur.

  • exclude_matches

    string[] isteğe bağlı

    Bu içerik komut dosyasının normalde yerleştirileceği sayfalar hariç tutulur.

  • include_globs

    string[] isteğe bağlı

    Yalnızca bu küreyle eşleşen URL'leri dahil etmek için eşleşmelerden sonra uygulanır. @include Greasemonkey anahtar kelimesini emüle etmek için oluşturulmuştur.

  • 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ırayla eklenir.

  • match_about_blank

    boole isteğe bağlı

    İçerik komut dosyasının about:blank ve about:srcdoc'a eklenip eklenmeyeceğini belirtir. İçerik komut dosyaları, yalnızca devralma URL'leri, eşleşmeler alanındaki bildirilen kalıplardan biriyle eşleştiğinde sayfalara yerleştirilir. Devralma URL'si, çerçeveyi veya pencereyi oluşturan dokümanın URL'sidir. Korumalı alanlı çerçevelere içerik komut dosyaları eklenemez.

  • eşleşiyor

    dize[]

    Bu içerik komut dosyasının hangi sayfalara yerleştirileceğini belirtir.

  • ad

    dize

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

  • run_at

    RunAt isteğe bağlı

    JavaScript veya CSS sekmeye en kısa sürede yerleştirilir. Varsayılan olarak "document_idle" kullanılır.

ContentWindow

Misafir penceresine mesajlaşma tutma yeri

Özellikler

  • postMessage

    geçersiz

    Yerleştirilmiş içerikte, hedef kaynaktaki bir sayfa gösteriliyorsa yerleştirilmiş web içeriğinde mesaj yayınlar. Bu yöntem, sayfanın yüklenmesi tamamlandıktan sonra kullanılabilir. contentload etkinliğini dinleyin ve ardından yöntemi çağırın.

    Misafir, aldığı ileti etkinliğinde event.source adresine ileti yayınlayarak yerleştiren kişiye yanıt gönderebilir.

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

    postMessage işlevi aşağıdaki gibi görünür: 

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

    • mesaj

      herhangi

      Davetliye gönderilecek mesaj nesnesi.

    • targetOrigin

      dize

      Etkinliğin gönderilmesi için misafir penceresinin kaynağını belirtir.

ContextMenuCreateProperties

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • işaretli

    boole isteğe bağlı

    Bir onay kutusu veya radyo öğesinin ilk durumu: Seçili için doğru, seçilmeyen için false. 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ğlam listesi. Belirtilmezse varsayılan olarak ['page'] kullanılır.

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğeyi yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlara uygulanacak şekilde kısıtlamanıza olanak tanır. (Bu, çerçeveler için de geçerlidir.) Kalıpla ilgili ayrıntılar için Kalıpları Eşleştirme bölümüne bakın.

  • etkin

    boole isteğe bağlı

    Bu içerik menüsü öğesinin etkin mi yoksa devre dışı mı olduğu. 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ının başka bir kimliği ile aynı olamaz.

  • parentId

    string | sayı isteğe bağlı

    Bir üst menü öğesinin kimliği; bu işlem öğeyi, önceden eklenen bir öğenin alt öğesi yapar.

  • targetUrlPatterns

    string[] isteğe bağlı

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

  • title

    dize isteğe bağlı

    Öğede görüntülenecek metin; type "ayırıcı" değilse bu gereklidir. Bağlam "seçim" olduğunda, seçili metni göstermek için dizede %s kullanabilirsiniz. Örneğin, bu parametrenin değeri "Çevir '%s' ise Pig Latin" ve kullanıcı "havalı" kelimesini seçerse, seçim için içerik menüsü öğesi "'Havalı'yı çevir" olur. Pig Latin" gibi bir ifade kullanabilirsiniz.

  • tür

    ItemType isteğe bağlı

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

  • onclick

    geçersiz isteğe bağlı

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

    onclick işlevi aşağıdaki gibi görünür: 

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

    • bilgi

      OnClickData

      Tıklanan öğe ve tıklamanın gerçekleştiği bağlamla ilgili bilgiler.

ContextMenus

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • onShow

    Etkinlik<İşlevler geçersiz>

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

    onShow.addListener işlevi aşağıdaki gibi 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 bunu çağırın.

          preventDefault işlevi aşağıdaki gibi 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ı etkinleşene kadar bunu öğrenemeyebilirsiniz (ayrıntılar runtime.lastError üzerindendir).

    create işlevi aşağıdaki gibi 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

      string | numara

      Yeni oluşturulan öğenin kimliği.

  • remove

    geçersiz

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

    remove işlevi aşağıdaki gibi görünür: 

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

    • menuItemId

      string | numara

      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

  • tümünü kaldır

    geçersiz

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

    removeAll işlevi aşağıdaki gibi 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

    Önceden oluşturulan içerik menüsü öğesini günceller.

    update işlevi aşağıdaki gibi görünür: 

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

    • id

      string | numara

      Güncellenecek öğenin kimliği.

    • updateProperties

      nesne

      Güncellenecek özellikler. Oluştur 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 'nı inceleyin.

Özellikler

  • işaretli

    boole isteğe bağlı

    Onay kutusu veya radyo öğesinin durumu: Seçili için doğru, seçilmeyen için false. 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ğlam listesi.

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğeyi yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlara uygulanacak şekilde kısıtlamanıza olanak tanır. (Bu, çerçeveler için de geçerlidir.) Kalıpla ilgili ayrıntılar için Kalıpları Eşleştirme bölümüne bakın.

  • etkin

    boole isteğe bağlı

    Bu içerik menüsü öğesinin etkin mi yoksa devre dışı mı olduğu.

  • parentId

    string | sayı isteğe bağlı

    Bir üst menü öğesinin kimliği; bu işlem öğeyi, önceden 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'a benzer, ancak img/audio/video etiketlerinin src özelliğine ve bağlantı etiketlerinin href değerine göre filtreleme yapmanıza olanak tanır.

  • title

    dize isteğe bağlı

    Öğede görüntülenecek metin

  • tür

    ItemType isteğe bağlı

    Menü öğesinin türü.

  • onclick

    geçersiz isteğe bağlı

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

    onclick işlevi aşağıdaki gibi görünür: 

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

    • bilgi

      OnClickData

      Tıklanan öğe ve tıklamanın gerçekleştiği bağlamla ilgili bilgiler.

ContextType

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Bir menünün gösterilebileceği farklı bağlamlar. "Tümünü" belirleme diğer tüm bağlamların kombinasyonuna eşdeğerdir.

Enum

"all"

"page"

"frame"

"selection"

"link"

"düzenlenebilir"

"image"

"video"

"audio"

DialogController

Arayüz dialog DOM etkinliğine eklendi.

Özellikler

  • iptal

    geçersiz

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

    cancel işlevi aşağıdaki gibi 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 aşağıdaki gibi görünür: 

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

    • yanıt

      dize isteğe bağlı

      prompt iletişim kutusu kabul edilirken davetliye sağlanacak yanıt dizesi.

DownloadPermissionRequest

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

Özellikler

  • requestMethod

    dize

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

  • url

    dize

    İstenen indirme URL'si.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi aşağıdaki gibi görünür: 

    () => {...}

FileSystemPermissionRequest

filesystem permissionrequest DOM etkinliğine eşlik eden request nesnesinin 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 aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin.

    deny işlevi aşağıdaki gibi 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ı

    searchText öğesinin sayfada eşleşme sayısı.

  • selectionRect

    SelectionRect

    Ekran koordinatlarında etkin eşleşmenin çevresindeki bir dikdörtgeni açıklar.

FindOptions

Bulma isteğine ilişkin seçenekler.

Ö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ı olacak şekilde işaretleyin. Varsayılan değer: false.

FullscreenPermissionRequest

Chrome 43 ve sonraki sürümler 'nı inceleyin.

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 aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin.

    deny işlevi aşağıdaki gibi 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 aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi aşağıdaki gibi görünür: 

    () => {...}

HidPermissionRequest

Chrome 125 ve sonraki sürümler 'nı inceleyin.

hid permissionrequest DOM etkinliğine eşlik eden request nesnesinin 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 aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi aşağıdaki gibi görünür: 

    () => {...}

InjectDetails

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

Özellikler

  • kod

    dize isteğe bağlı

    Yerleştirilecek JavaScript veya CSS kodu.

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

  • dosya

    dize isteğe bağlı

    Yerleştirilecek JavaScript veya CSS dosyası.

InjectionItems

Chrome 44 ve sonraki sürümler 'nı inceleyin.

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

Ö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 eklenecek JavaScript veya CSS dosyalarının listesi. Bunlar, bu dizide göründükleri sırayla yerleştirilir.

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 bu varsayılan davranıştır.

    allow işlevi aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddedin.

    deny işlevi aşağıdaki gibi 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 isteyen çerçevenin URL'si.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi aşağıdaki gibi görünür: 

    () => {...}

NewWindow

Arayüz newwindow DOM etkinliğine eklendi.

Özellikler

  • eklemek

    geçersiz

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

    attach işlevi aşağıdaki gibi görünür: 

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

    • web görünümü

      nesne

      Hedef sayfanın eklenmesi gereken webview öğesi.

  • sil

    geçersiz

    Yeni pencere isteğini iptal edin.

    discard işlevi aşağıdaki gibi görünür: 

    () => {...}

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 kilidinin kullanıcı giriş hareketinin sonucu olarak istenip istenmediği.

  • izin ver

    geçersiz

    İzin isteğine izin verin.

    allow işlevi aşağıdaki gibi görünür: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi aşağıdaki gibi görünür: 

    () => {...}

SelectionRect

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

Kapsama anlamları dizi benzeridir; yani (left, top) koordinatının dikdörtgen içinde bulunduğu kabul edilir, ancak (left + width, top) koordinatı bu yönde değildir.

Ö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 'nı inceleyin.

Konuk 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 webRequest API'sinden farkını göstermek için *://www.evil.com/* ile eşleşen URL'ler için tüm davetli 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 üzerinden bildirim temelli webRequest kurallarını destekler. API ayrıntıları için declarativeWebRequest adresine bakın.

Bildirim temelli web görünümü web istekleri için koşul ve işlemlerin, chrome.webViewRequest.* eşdeğerlerinden örneklenmesi gerektiğini unutmayın. Aşağıdaki örnek kod, myWebview web görünümünde tüm "example.com" isteklerini bildirimsel olarak 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 'nı inceleyin.

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ılmış sayfanın kaynağında kalır. Yani, aynı bölümde yer alan 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-origin yakınlaştırma değişiklikleri başlangıç noktasıyla birlikte kaydedilir. Yani aynı kaynaktaki diğer sayfalara giderken tüm değişiklikler aynı yakınlaştırma faktörüne göre 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, gezinme sırasında per-view yakınlaştırma değişikliği sıfırlandı; Bir web görünümünde gezinmek, sayfaları her zaman kaynak başına yakınlaştırma faktörleriyle birlikte (bölümlendirme kapsamında) yükler.

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

Özellikler

contentWindow

Misafir sayfasına ileti göndermek için kullanılabilecek nesne referansı.

Tür

ContentWindow

contextMenus

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Chrome'un ContextMenüs API'sine benzer, ancak tarayıcı yerine webview için geçerlidir. webview tarayıcısının içerik menüsüne öğe eklemek için webview.contextMenus API'sini kullanın. İçerik menüsüne eklediğiniz öğelerin resim, köprü ve sayfa gibi nesne türlerini seçebilirsiniz.

Tür

ContextMenus

request

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

Tür

WebRequestEventInterface

Yöntemler

addContentScripts()

Chrome 44 ve sonraki sürümler 'nı inceleyin.
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)

webview öğesine 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ı yerleştirilir. Programlı bir şekilde kuralları ekleyebilir veya mevcut kuralları güncelleyebilirsiniz.

Aşağıdaki örnekte webview için iki kural eklenmiştir: "myRule" ve "anotherRule" olarak da adlandırılır.

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

Aşağıdaki örnekte, mevcut bir kuralın üzerine nasıl 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" öğesini eklemek için webview.addContentScripts çağrısında bulunuyorsa komut dosyalarının yerleştirilmesi için bir sonraki gezinmeyi beklemeniz gerekir. Hemen yerleştirmeyi istiyorsanız executeScript doğru şeyi yapacaktır.

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

Daha ayrıntılı bilgi için içerik komut dosyaları dokümanlarına bakın.

Parametreler

back()

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

Mümkünse bir geçmiş girişine 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 'nı inceleyin.

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

Geçmişte geriye gitmenin mümkün olup olmadığını gösterir. Bu işlevin durumu önbelleğe alınır ve her loadcommit öncesinde güncellenir. Dolayısıyla, işlevi çağırmak için en iyi yer loadcommit üzerindedir.

İadeler

  • boolean

canGoForward()

chrome.webviewTag.canGoForward()

Geçmişe göz atmanın mümkün olup olmadığını gösterir. Bu işlevin durumu önbelleğe alınır ve her loadcommit öncesinde güncellenir. Dolayısıyla, işlevi çağırmak için en iyi yer loadcommit üzerindedir.

İadeler

  • boolean

captureVisibleRegion()

Chrome 50 ve sonraki sürümler 'nı inceleyin.
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ındaki bir görüntüyü kodlayan veri URL'si. "src" öğesine atanabilir özelliği hakkında daha fazla bilgi edinin.

clearData()

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

webview bölümü için 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,
)

JavaScript kodunu konuk sayfasına ekler.

Aşağıdaki örnek kod, konuk sayfasının arka plan rengini kırmızıya ayarlamak için komut dosyası yerleştirme tekniğini 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ı.

  • geri çağırma

    işlev isteğe bağlı

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

    (result?: any[]) => void

    • sonuç

      herhangi[] isteğe bağlı

      Yerleştirilen her kareye komut dosyasının sonucu.

find()

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

Sayfada bul isteği başlatır.

Parametreler

  • searchText

    dize

    Sayfada bulunacak dize.

  • seçenekler

    FindOptions isteğe bağlı

    Bulma isteğine ilişkin seçenekler.

  • 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 tamamlandığını ayırt etmek için kullanılır.

forward()

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

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    Chrome 44 ve sonraki sürümler 'nı inceleyin.

    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 ve sonraki sürümler 'nı inceleyin.
chrome.webviewTag.getAudioState(
  callback: function,
)

Sorguların ses durumu.

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şlemine ilişkin Chrome'un dahili işlem kimliğini döndürür ve böylece yerleştirenlerin, işlemin sonlandırılmasından kaç konuğun etkileneceğini bilmesini sağlar. Yalnızca aynı uygulamaya ait olan ve aynı depolama bölümü kimliğine sahip iki davetli bir işlemi paylaşır. Çağrı eşzamanlıdır ve yerleştirenin önbellekteki mevcut işlem kimliğini 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 'nı inceleyin.
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 cihazının geçerli yakınlaştırma modu.

go()

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

Mevcut gezinmeyle ilişkili bir geçmiş dizini kullanarak bir geçmiş girişine gider. İstenen gezinme imkânsızsa bu yöntemin bir etkisi olmaz.

Parametreler

  • relativeIndex

    sayı

    webview öğesinin gidilmesi gereken göreli geçmiş dizini. Örneğin, 2 değeri mümkünse 2 geçmiş girişine gider; -3 değeri 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ı gösterir.

insertCSS()

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

CSS'yi konuk sayfasına 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 sonraki sürümler 'nı inceleyin.
chrome.webviewTag.isAudioMuted(
  callback: function,
)

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

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 sonraki sürümler 'nı inceleyin.
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

Web görünümü için mekansal gezinmenin etkinleştirilip etkinleştirilmediğini sorgular.

Parametreler

  • geri çağırma

    işlev

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

    (enabled: boolean) => void

    • etkin

      boolean

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

webview öğesine ait kullanıcı aracısı dizesinin 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, belirtilen temel URL'ye sahip bir veri URL'sini yükler. İsteğe bağlı olarak, kullanıcıya veri URL'si yerine gösterilmesi için 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 içeriğini yazdırır. Bu, webview içinden komut dosyasılı 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 'nı inceleyin.
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)

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

Aşağıdaki örnek "myRule" öğesini kaldırıyor .

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 öğesine eklenen tüm içerik komut dosyaları kaldırılır.

setAudioMuted()

Chrome 62 ve sonraki sürümler 'nı inceleyin.
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

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

Parametreler

  • sesi kapat

    boolean

    Sesi kapat değeri

setSpatialNavigationEnabled()

Chrome 71 ve sonraki sürümler 'nı inceleyin.
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

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

Parametreler

  • etkin

    boolean

    Üç boyutlu 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, Kullanıcı Aracısı İstemci İpucu başlığı değerlerinin ve navigator.userAgentData tarafından döndürülen değerlerin, bu geçersiz kılmanın uygulandığı misafir sayfası istekleri için 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 kalıcılığı, web görünümünün mevcut yakınlaştırma moduna göre belirlenir (bkz. webviewTag.ZoomMode).

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 'nı inceleyin.
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

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.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

stop()

chrome.webviewTag.stop()

Devam ediyorsa geçerli webview navigasyonunu yüklemeyi durdurur.

stopFinding()

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

Mevcut bulma oturumunu sonlandırır (tüm vurgular temizlenir) 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şleşmeyle ne yapılacağını belirler. clear, etkin eşleşmenin üzerindeki vurguyu temizler; keep, etkin eşleşmeyi vurgulayacak; activate, etkin eşleşmeyi vurgular ve kullanıcı tıklamasını simüle eder. Varsayılan işlem: keep.

terminate()

chrome.webviewTag.terminate()

Konuk web sayfasının oluşturucu işlemini zorla sonlandırır. Bu durum, özellikler 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,
)

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

Aşağıdaki örnek kod, davetli kendisini kapatmaya çalıştığında webview öğesini about:blank konumuna yönlendirir.

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ı kaydettiğinde tetiklenir.

Aşağıdaki örnek kod, tüm günlük mesajlarını, günlük düzeyi veya diğer özelliklerden bağımsız olarak, 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,
)

Misafir penceresi bir load etkinliği tetiklediğinde (ör. yeni bir doküman yüklendiğinde) tetiklenir. Geçerli dokümandaki sayfada gezinme veya eşzamansız kaynak yüklemeleri bu kapsamda değildir.

Aşağıdaki örnek kod, sayfa yüklendikten sonra davetlinin 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 kalıcı iletişim kutusu açmaya çalıştığında tetiklenir.

Bu etkinlik gerçekleştirildiğinde, her bir etkinlik işleyici geri dönene veya dialog nesnesi ulaşılamaz hale gelene (preventDefault() çağrıldıysa) misafir işlemini 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"
       | "istem"

    • messageText

      dize

    • iletişim

      DialogController

exit

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

Misafir web içeriğini oluşturma işlemi sona erdiğinde tetiklenir.

Aşağıdaki örnek kod, konuk sayfası çöktüğünde 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"
       | "çökme"
       | "öldür"

findupdate

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

Etkin bir bulma isteği için yeni bulma sonuçları olduğunda tetiklenir. Bu durum, eşleşmeler bulunduğunda 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 işlemi taahhüt edilmeden iptal edildiğinde tetiklenir. Etkinlik varsayılan olarak önlenmediği sürece konsolda bir hata mesajı yazdırılır.

Not: Bir kaynak yükü iptal edildiğinde, son loadstop etkinliğinden (varsa) bu yana kaydedilen tüm yüklemeler iptal edilmiş olsa bile sonunda bir loadabort etkinliğinin ardından bir loadstop etkinliği izlenir.

Not: Hakkında URL'si veya JavaScript URL'sinin yüklenmesi iptal edildiğinde, loadabort tetiklenir ve ardından webview "about:blank" bölümüne 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"
       | &quot;ERR_INVALID_URL&quot;
       | &quot;ERR_DISALLOWED_URL_SCHEME&quot;
       | &quot;ERR_BLOCKED_BY_CLIENT&quot;
       | "ERR_ADDRESS_UNREACHABLE"
       | &quot;ERR_EMPTY_RESPONSE&quot;
       | &quot;ERR_FILE_NOT_FOUND&quot;
       | &quot;ERR_UNKNOWN_URL_SCHEME&quot;

loadcommit

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

Bir yükleme kaydedildiğinde tetiklenir. Buna, geçerli dokümanda gezinme ve doküman düzeyinde alt çerçeve yüklemeleri dahildir. Ancak eşzamansız kaynak yüklemeleri dahil edilmez.

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 yükleme isteği farklı bir URL'ye yönlendirildiğ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,
)

Bir yükleme 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 alt çerçeveleri dahil) tüm kare düzeyindeki yüklemeler tamamlandığında tetiklenir. Buna, geçerli dokümanda gezinme ve doküman düzeyinde alt çerçeve yüklemeleri dahildir. Ancak eşzamansız kaynak yüklemeleri dahil edilmez. Bu etkinlik, doküman düzeyinde yükleme sayısı bir veya daha fazladan sıfıra her geçişinde tetiklenir. Örneğin, yüklenmesi bitmiş bir sayfa (ör. loadstop önceden bir kez tetiklenmiş), bir sayfayı yükleyen yeni bir iframe oluşturur, ardından iframe sayfası yüklemesi tamamlandığında ikinci bir loadstop tetiklenir. Bu model genellikle reklam yüklenen sayfalarda gözlemlenir.

Not: Kaydedilen bir yükleme iptal edildiğinde, son loadstop etkinliğinden (varsa) bu yana kaydedilen tüm yüklemeler iptal edilmiş olsa bile bir loadstop etkinliği sonunda bir loadabort etkinliği izlenir.

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çmayı denediğinde tetiklenir.

Aşağıdaki örnek kod, istenen her yeni pencere için yerleştiricide yeni bir webview oluşturur ve bu ürüne gider:

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"
       | &quot;new_background_tab&quot;
       | "new_foreground_tab"
       | "new_window"
       | "new_popup"

permissionrequest

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

Misafir sayfasının yerleştirenden özel izin istemesi gerektiğinde tetiklenir.

Aşağıdaki örnek kod, davetli sayfasına webkitGetUserMedia API'sine erişim izni verir. Bu örnek kodu kullanan bir uygulamanın, audioCapture ve/veya videoCapture manifest izinlerini 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"
       | "indir"
       | "loadplugin"
       | "filesystem"
       | "tam ekran"
       | "gizlendi"

    • istek

      nesne

responsive

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

Misafir web içeriğini oluşturma işlemi, yanıt vermedikten sonra tekrar duyarlı hale geldiğinde tetiklenir.

Aşağıdaki örnek kod, webview öğesi duyarlı hale geldiğinde veya yanıt vermediğinde yavaşça açılır veya soluklaşır:

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şturma işlemi yanıt vermemeye başladığında tetiklenir. Konuk tekrar yanıt vermeye başlarsa bu etkinlik, eşleşen bir duyarlı etkinlikle 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 düzeyi 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ı