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 edebilir ve web içeriğiyle etkileşim kurabilir, yerleştirilmiş bir web sayfasında gezinme başlatabilir, bu sayfada gerçekleşen 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 temizleneceğini belirleyen seçenekler.

Özellikler

  • şu tarihten beri:

    numara isteğe bağlı

    Bu tarihte veya daha sonra biriken verileri temizleyin (epoch'tan itibaren milisaniye cinsinden gösterilir) (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 dizi veri türü. Eksik özellikler false olarak yorumlanır.

Özellikler

  • uygulama önbelleği

    boole isteğe bağlı

    Web sitelerinin appcache'leri.

  • önbellek

    boole isteğe bağlı

    Chrome 44 ve sonraki sürümler

    Chrome 43'ten beri. Tarayıcının önbelleği. Not: Bu işlem verileri kaldırırken önbelleğin tamamını temizler; 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

    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

Eklenecek içerik komut dosyasının ayrıntıları. Daha fazla ayrıntı 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 eklenmesi gerektiği anlamına gelir. Varsayılan olarak, all_frames değeri false değeridir ve JavaScript veya CSS yalnızca üst çerçeveye yerleştirilmiştir.

  • 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 glob ile eşleşen URL'leri hariç tutmak için eşleşmelerden sonra uygulanır. Amaç, @excluded Greasemonkey anahtar kelimesine öykünmektir.

  • exclude_matches

    string[] isteğe bağlı

    Bu içerik komut dosyasının başka bir şekilde yerleştirileceği sayfaları hariç tutar.

  • include_globs

    string[] isteğe bağlı

    Eşleşmelerden sonra, yalnızca bu glob ile eşleşen URL'leri içerecek şekilde uygulanır. @include Greasemonkey anahtar kelimesine benzemesi amaçlanmış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ırayla eklenir.

  • match_about_blank

    boole isteğe bağlı

    İçerik komut dosyasının about:blank ve about:srcdoc üzerine eklenip eklenmeyeceği. İçerik komut dosyaları yalnızca devralma URL'leri, eşleşmeler alanında 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. İçerik komut dosyaları korumalı alana alınmış çerçevelere 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'nin sekmeye yerleştirileceği en erken. Varsayılan olarak "document_idle" değerine ayarlanır.

ContentWindow

Misafir penceresine yönelik mesajlaşma tanıtıcısı.

Özellikler

  • postMessage

    void

    Yerleştirilmiş içerik hedef kaynaktan bir sayfa görüntülediği sürece, yerleştirilmiş web içeriğinde bir ileti 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 kullanılan HTML5 postMessage API'si 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

      Tümü

      Konuğa gönderilecek mesaj nesnesi.

    • targetOrigin

      dize

      Etkinliğin dağıtılabilmesi için misafir 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 kutusu veya radyo öğesinin başlangıç durumu: Seçilenler için doğru, seçili olmayanlar için false (yanlış). Belirli bir radyo öğeleri grubunda aynı anda yalnızca bir radyo öğesi seçilebilir.

  • bağlam

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

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

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğeyi yalnızca URL'si belirtilen modellerden biriyle eşleşen dokümanlara uygulanacak şekilde kısıtlamanızı sağlar. (Bu, çerçeveler için de geçerlidir.) Kalıp biçimiyle ilgili ayrıntılar için Eşleşme Kalıpları 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

    string isteğe bağlı

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

  • parentId

    string|number isteğe bağlı

    Üst menü öğesinin kimliği. Bu kimlik, öğeyi önceden eklenmiş 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 özelliğine göre filtreleme yapmanıza olanak tanır.

  • title

    string isteğe bağlı

    Öğede gösterilecek metin. type "ayırıcı" değilse 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' kelimesini Pig Latince'ye çevir" ise ve kullanıcı "güzel" kelimesini seçerse, seçime ilişkin içerik menüsü öğesi "'cool'u Pig Latince'ye çevir" olur.

  • tür

    ItemType isteğe bağlı

    Menü öğesinin türü. Belirtilmezse varsayılan olarak "normal" değerine ayarlanı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ğlamla ilgili bilgiler.

ContextMenus

Chrome 44 ve sonraki sürümler

Özellikler

  • onShow

    Etkinlik<functionvoidvoid>

    Bu webview ile ilgili içerik menüsü gösterilmeden önce tetiklendi. event.preventDefault() yöntemini çağırarak 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

      • event

        nesne

        • preventDefault

          void

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

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

          ()=> {...}

  • create

    void

    Yeni bir içerik menüsü öğesi oluşturur. Oluşturma sırasında bir hata oluşursa oluşturma geri çağırması tetiklenene kadar sorunu çözemeyeceğinizi unutmayın (ayrıntılar runtime.lastError içindedir).

    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

      Functions (isteğe bağlı)

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

      ()=>void

    • returns

      string|number

      Yeni oluşturulan öğenin kimliği.

  • remove

    void

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

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

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

    • menuItemId

      string|number

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

    • geri çağırma

      Functions (isteğe bağlı)

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

      ()=>void

  • removeAll

    void

    Bu webview içine 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

      Functions (isteğe bağlı)

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

      ()=>void

  • update

    void

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

      string|number

      Güncellenecek öğenin kimliği.

    • updateProperties

      nesne

      Güncellenecek özellikler. Create işleviyle aynı değerleri kabul eder.

    • geri çağırma

      Functions (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ı

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

  • bağlam

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

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

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğeyi yalnızca URL'si belirtilen modellerden biriyle eşleşen dokümanlara uygulanacak şekilde kısıtlamanızı sağlar. (Bu, çerçeveler için de geçerlidir.) Kalıp biçimiyle ilgili ayrıntılar için Eşleşme Kalıpları 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|number isteğe bağlı

    Üst menü öğesinin kimliği. Bu kimlik, öğeyi önceden eklenmiş 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 özelliğine göre filtreleme yapmanıza olanak tanır.

  • title

    string 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ğlamla ilgili bilgiler.

ContextType

Chrome 44 ve sonraki sürümler

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

Enum

"all" (tümü)

"frame"

"selection"

"editable"

"image"

"video"

"audio"

DialogController

Arayüz dialog DOM etkinliğine bağlı.

Özellikler

  • cancel

    void

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

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

    ()=> {...}

  • tamam

    void

    İletişim kutusunu kabul edin. alert, confirm veya prompt iletişim kutusunda Tamam'ın tıklanmasıyla aynı etkiye sahiptir.

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

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

    • yanıt

      string isteğe bağlı

      prompt iletişim kutusunu kabul ettiğinde misafire 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şkili HTTP istek türü (ör. GET).

  • url

    dize

    İstenen indirme URL'si.

  • izin ver

    void

    İzin isteğine izin verin.

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

    ()=> {...}

  • deny

    void

    İzin isteğini reddeder. 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 nesnesinin türü.

Özellikler

  • url

    dize

    Yerel dosya sistemine erişim isteyen çerçevenin URL'si.

  • izin ver

    void

    İzin isteğine izin verin.

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

    ()=> {...}

  • deny

    void

    İzin isteğini reddeder.

    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ı

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

  • selectionRect

    SelectionRect

    Ekran koordinatlarında etkin eşleşmenin çevresinde bir dikdörtgen tanımlar.

FindOptions

Bulma isteğiyle ilgili seçenekler.

Özellikler

  • geriye doğru

    boole isteğe bağlı

    İşaretle'yi tıklayın. Varsayılan değer: false.

  • matchCase

    boole isteğe bağlı

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

FullscreenPermissionRequest

Chrome 43 ve sonraki sürümler

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

    void

    İzin isteğine izin verin.

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

    ()=> {...}

  • deny

    void

    İzin isteğini reddeder.

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

    ()=> {...}

GeolocationPermissionRequest

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

Özellikler

  • url

    dize

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

  • izin ver

    void

    İzin isteğine izin verin.

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

    ()=> {...}

  • deny

    void

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

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

    ()=> {...}

HidPermissionRequest

Beklemede

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

    void

    İzin isteğine izin verin.

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

    ()=> {...}

  • deny

    void

    İzin isteğini reddeder. 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 özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.

Özellikler

  • kod

    string isteğe bağlı

    Yerleştirilecek JavaScript veya CSS kodu.

    Uyarı: code parametresini kullanırken dikkatli olun. Bu parametrenin yanlış kullanılması, uygulamanızı siteler arası komut dosyası çalıştırma saldırılarına açık hale getirebilir.

  • file

    string isteğe bağlı

    Eklenecek JavaScript veya CSS dosyası.

InjectionItems

Chrome 44 ve sonraki sürümler

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

Özellikler

  • kod

    string isteğe bağlı

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

  • dosyalar

    string[] isteğe bağlı

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

LoadPluginPermissionRequest

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

Özellikler

  • tanımlayıcı

    dize

    Eklentinin tanımlayıcı dizesi.

  • ad

    dize

    Eklentinin görünen adı.

  • izin ver

    void

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

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

    ()=> {...}

  • deny

    void

    İzin isteğini reddeder.

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

    ()=> {...}

MediaPermissionRequest

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

Özellikler

  • url

    dize

    Kullanıcı medyasına erişim isteyen çerçevenin URL'si.

  • izin ver

    void

    İzin isteğine izin verin.

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

    ()=> {...}

  • deny

    void

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

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

    ()=> {...}

NewWindow

Arayüz newwindow DOM etkinliğine bağlı.

Özellikler

  • eklemek

    void

    İ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

    void

    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 nesnesinin türü.

Özellikler

  • lastUnlockedBySelf

    boolean

    İstekte bulunan karenin, işaretçi kilidini tutacak en son istemci olup olmadığı.

  • url

    dize

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

  • userGesture

    boolean

    Kullanıcı giriş hareketinin bir sonucu olarak işaretçi kilidinin istenip istenmediği.

  • izin ver

    void

    İzin isteğine izin verin.

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

    ()=> {...}

  • deny

    void

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

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

    ()=> {...}

SelectionRect

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

Kapsama semantiği dizi benzeridir. Yani, (left, top) koordinatının dikdörtgen içinde bulunduğu kabul edilir, ancak (left + width, top) koordinatı buna dahil değildir.

Özellikler

  • yükseklik

    sayı

    Dikdörtgenin yüksekliği.

  • sol

    sayı

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

  • ilk yarı

    sayı

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

  • 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ılar 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 uzantılarından nasıl farklı olduğunu göstermek için *://www.evil.com/* ile eşleşen URL'ler için misafir isteklerini engelleyen aşağıdaki örnek kodu göz önünde bulundurun:

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

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

Bildirim temelli web görünümü web istekleriyle ilgili koşul ve işlemlerin chrome.webViewRequest.* eşdeğerlerinden örnek alınması gerektiğini unutmayın. Aşağıdaki örnek kod, myWebview web görünümünde tüm "example.com" isteklerini bildirimli ş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ırmanın webview içinde nasıl kullanılacağını tanımlar.

Enum

"kaynak başına"
Yakınlaştırma değişiklikleri, yakınlaştırılan sayfanın kaynağında kalır. Yani, aynı bölümde bulunan ve söz konusu kaynağa gidilen 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 kaynak olarak kaydedilir. Yani aynı kaynaktaki diğer sayfalara gidildiğinde tümü 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. Diğer web görünümlerindeki yakınlaştırma değişiklikleri, bu web görünümünün yakınlaştırmasını etkilemez. Ayrıca, per-view yakınlaştırma değişiklikleri gezinme sırasında sıfırlanır. Web görünümünde gezinirken sayfalar her zaman kaynak başına yakınlaştırma faktörleriyle (bölüm kapsamı dahilinde) yüklenir.

"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 döner ve denenen tüm yakınlaştırma değişiklikleri yok sayılır.

Özellikler

contentWindow

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

Tür

ContentWindow

contextMenus

Chrome 44 ve sonraki sürümler

Chrome'un ContextMenüs API'sine benzer, ancak tarayıcı yerine webview için geçerlidir. webview öğesinin içerik menüsüne öğe eklemek için webview.contextMenus API'sini kullanın. İçerik menüsü eklemelerinizin ne tür nesnelere (ör. resimler, köprüler ve sayfalar) uygulanacağı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 öğ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ı eklenir. Programatik olarak kurallar ekleyebilir veya mevcut kuralları güncelleyebilirsiniz.

Aşağıdaki örnek, webview öğesine iki kural ekler: "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';

Komut dosyalarını yerleştirmeniz gerekene kadar addContentScripts çağrısını 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) gittiyse ve "myRule"ı eklemek için webview.addContentScripts yöntemini çağırırsa komut dosyalarının yerleştirilmesi için sonraki gezinmeyi beklemeniz gerekir. Hemen enjekte etmek istiyorsanız executeScript doğru olanı yapar.

Konuk işlemi kilitlense, sonlandırılsa veya webview tekrar üst öğe getirilse bile kurallar korunur.

Daha fazla ayrıntı 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şi geri gider. go(-1) etiketine eş değer.

Parametreler

  • geri çağırma

    Functions (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ı gösterir.

canGoBack()

chrome.webviewTag.canGoBack()

Geçmişte geri gitmenin mümkün olup olmadığını belirtir. Bu işlevin durumu önbelleğe alınır ve her loadcommit öncesinde güncellenir. Bu nedenle işlevi çağırmak için en iyi yer loadcommit adresindedir.

İlerlemeler

  • boolean

canGoForward()

chrome.webviewTag.canGoForward()

Geçmişte gezinmenin mümkün olup olmadığını gösterir. Bu işlevin durumu önbelleğe alınır ve her loadcommit öncesinde güncellenir. Bu nedenle işlevi çağırmak için en iyi yer loadcommit adresindedir.

İlerlemeler

  • boolean

captureVisibleRegion()

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

Web görünümünün görünür alanını 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 görüntüsünü kodlayan bir veri URL'si. Görüntülenecek HTML Resim öğesinin "src" özelliğine atanabilir.

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

    Functions (isteğe bağlı)

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

    ()=>void

executeScript()

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

Misafir sayfasına JavaScript kodu ekler.

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

    Functions (isteğe bağlı)

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

    (result?: any[])=>void

    • sonuç

      any[] isteğe bağlı

      Eklenen her çerçevedeki 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ğiyle ilgili seçenekler.

  • geri çağırma

    Functions (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şlevinin gövdesinde kullanılmıyorsa (örneğin, geri çağırma yalnızca bulma isteği tamamlandığında ayırt etmek için kullanılıyorsa) atlanabilir.

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

    Functions (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ı gösterir.

getAudioState()

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

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

Konuk web sayfasının mevcut işlemi için Chrome'un dahili işlem kimliğini döndürür; böylece yerleştirenlerin, işlemin sonlandırılmasından kaç konuk etkileneceğini bilmesini sağlar. İki konuk yalnızca aynı uygulamaya ait oldukları ve aynı depolama bölümü kimliğine sahip oldukları bir işlemi paylaşır. Çağrı eşzamanlıdır ve yerleştirenin önbelleğe alınmış mevcut işlem kimliğini döndürür. İşlem kimliği, işletim sisteminin işlem kimliğiyle aynı değildir.

İlerlemeler

  • sayı

getUserAgent()

chrome.webviewTag.getUserAgent()

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

İlerlemeler

  • 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 cihazının geçerli yakınlaştırma modu.

go()

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

Mevcut gezinmeyle göreli bir geçmiş dizinini kullanarak geçmiş girişine gider. İstenen gezinme imkansızsa bu yöntemin hiç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şi ileri, -3 değeri ise 3 giriş geri götürür.

  • geri çağırma

    Functions (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 misafir sayfasına ekler.

Parametreler

  • ayrıntılar

    InjectDetails

    Eklenecek CSS'nin ayrıntıları.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

isAudioMuted()

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

Sesin kapatılıp kapatılmadığı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 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

Web görünümü için uzamsal 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 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 bir temel URL'ye sahip veri URL'sini yükler. İsteğe bağlı olarak, kullanıcıya veri URL'si yerine 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

    string 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 içinden komut dosyası tabanlı yazdırma işlevini çağırmaya eş değerdir.

reload()

chrome.webviewTag.reload()

Mevcut üst düzey sayfayı yeniden yükler.

removeContentScripts()

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

Bir webview öğesindeki içerik komut dosyalarını kaldırır.

Aşağıdaki örnek, daha önce eklenen "myRule" kuralını kaldırı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 bir 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 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

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

Parametreler

  • sesi kapat

    boolean

    Sesi kapatma değeri

setSpatialNavigationEnabled()

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

Web görünümünün üç boyutlu gezinme durumunu ayarlar.

Parametreler

  • etkin

    boolean

    Üç boyutlu gezinme durum değeri.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

webview tarafından misafir sayfası istekleri için kullanılan kullanıcı aracısı dizesi geçersiz kılınır. Geçersiz kılma, bu geçersiz kılmanın uygulandığı misafir sayfası istekleri için Kullanıcı Aracısı İstemci İpucu üst bilgi 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 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

    Functions (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 öğesinin yakınlaştırma modunu ayarlar.

Parametreler

  • ZoomMode

    ZoomMode

    Yakınlaştırmanın webview içinde nasıl kullanılacağını tanımlar.

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

stop()

chrome.webviewTag.stop()

Devam ediyorsa mevcut webview gezinme menüsünü 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

     isteğe bağlı

    Bulma oturumu sona erdikten sonra etkin eşleşmeyle ilgili ne yapılacağını belirler. clear, etkin eşleşmenin üzerindeki vurguyu temizler; keep etkin eşleşmeyi vurgulu olarak tutar; activate ise etkin eşleşmeyi vurgulu olarak tutar ve kullanıcının eşleşmeyi 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, 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 kendini kapatmaya çalıştığında tetiklenir.

Aşağıdaki örnek kod, konuk kendini kapatmaya çalıştığında webview ile about:blank hedefine yönlendirilir.

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 penceresinde bir konsol mesajı kaydedildiğinde tetiklenir.

Aşağıdaki örnek kod, tüm günlük mesajlarını, günlük düzeyini veya diğer özellikleri dikkate almadan, yerleştirilen kullanıcının 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üman içinde sayfada gezinme veya eşzamansız kaynak yüklemeleri buna dahil değildir.

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

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

Varsayılan davranış, iletişim kutusunun iptal edilmesidir.

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

    • messageText

      dize

    • iletişim

      DialogController

exit

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

Konuk web içeriğini oluşturma işleminden çıkıldığında tetiklenir.

Aşağıdaki örnek kod, misafir sayfası 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"
      |"anormal"
      |"kilitlenme"
      |"öldür"

findupdate

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

Etkin bir bulma isteği için yeni bulma sonuçları olduğunda tetiklenir. Eşleşmeler bulunduğundan 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 engellenmezse konsola bir hata mesajı yazdırılır.

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

Not: Hakkında URL'si veya JavaScript URL'si yüklemesi iptal edildiğinde loadabort etkinleşir 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"
      |"ERR_INVALID_URL"
      |"ERR_DISALLOWED_URL_SCHEME"
      |"ERR_BLOCKED_BY_CLIENT"
      |"ERR_ADDRESS_UNREACHABLE"
      |"ERR_EMPTY_RESPONSE"
      |"ERR_EMPTY_RESPONSE"
      |"ERR_FOKAL_URL"

loadcommit

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

Bir yükleme yapıldığında tetiklenir. Buna, geçerli dokümanda gezinmenin yanı sıra alt çerçeve doküman düzeyinde yüklemeler dahildir, ancak eşzamansız 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 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,
)

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 misafir sayfasındaki tüm çerçeve düzeyinde yüklemeler (tüm alt çerçeveleri dahil) tamamlandığında tetiklenir. Buna, geçerli doküman içinde gezinmenin yanı sıra alt çerçeve doküman düzeyinde yüklemeler de dahildir, ancak eşzamansız kaynak yüklemelerini içermez. Bu etkinlik, doküman düzeyindeki yükleme sayısı bir (veya daha çok) değerinden sıfıra her geçişte tetiklenir. Örneğin, yüklenmesi zaten tamamlanmış bir sayfa (ör. loadstop zaten bir kez tetiklendi) o sayfayı yükleyen yeni bir iframe oluşturur ve ardından iframe sayfasının yüklenmesi tamamlandığında ikinci bir loadstop tetiklenir. Bu düzen, reklam yükleyen sayfalarda yaygın olarak görülür.

Not: Kaydedilen bir yükleme iptal edildiğinde, son loadstop etkinliğinden (varsa) bu yana kaydedilen tüm yüklemeler iptal edilmiş olsa bile loadstop etkinliği loadabort etkinliğini 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 yeni bir webview oluşturur ve yerleştirme aracında bu tür bir webview öğesine 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"
      |"disk_kaydet"
      |"current_tab"
      |"new_background_tab"
      |"new_foreground_tab"
      |"new_window"
      |"new_popup"

permissionrequest

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

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

Aşağıdaki örnek kod, webkitGetUserMedia API'ye misafir sayfası erişimi verir. Bu örnek kodu kullanan bir uygulamanın kendisinin 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

    • istek

      nesne

responsive

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

Konuk 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ı olduğunda veya yanıt vermediğinde karartılır veya kaybolur:

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

Konuk web içeriğini oluşturma işlemi yanıt vermediğinde tetiklenir. Davetli 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ı