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, içinde gerçekleşen hata etkinliklerine tepki verebilir ve daha fazlasını yapabilir (Kullanım bölümüne bakın).

İzinler

webview

Kullanılabilirlik

Yalnızca ChromeOS

Türler

ClearDataOptions

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

Özellikler

  • şu tarihten beri:

    number isteğe bağlı

    Bu tarihte veya bu tarihten sonra toplanan verileri temizleyin. Bu tarih, epoch'tan bu yana geçen milisaniye cinsinden gösterilir (JavaScript Date nesnesinin getTime yöntemiyle erişilebilir). Belirtilmezse varsayılan olarak 0 kullanılır (bu durumda tüm tarama verileri kaldırılır).

ClearDataTypeSet

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

Özellikler

  • appcache

    boole isteğe bağlı

    Web sitelerinin uygulama önbellekleri.

  • önbellek

    boole isteğe bağlı

    Chrome 44+

    Chrome 43'ten beri. Tarayıcının önbelleği. Not: Veriler kaldırılırken tüm önbellek temizlenir. Bu işlem, belirttiğiniz aralıkla sınırlı değildir.

  • Cloud Console dışındaki Google Cloud sitelerindeki

    boole isteğe bağlı

    Bölümün çerezleri.

  • fileSystems

    boole isteğe bağlı

    Web sitelerinin dosya sistemleri.

  • indexedDB

    boole isteğe bağlı

    Web sitelerinin IndexedDB verileri.

  • localStorage

    boole isteğe bağlı

    Web sitelerinin yerel depolama 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+

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

Özellikler

  • all_frames

    boole isteğe bağlı

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

  • css

    InjectionItems isteğe bağlı

    Eşleşen sayfalara yerleştirilecek CSS kodu veya CSS dosyalarının listesi. Bunlar, sayfa için herhangi bir DOM oluşturulmadan veya gösterilmeden önce göründükleri sı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. @exclude Greasemonkey anahtar kelimesini taklit etmek için tasarlanmıştır.

  • exclude_matches

    string[] isteğe bağlı

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

  • include_globs

    string[] isteğe bağlı

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

  • js

    InjectionItems isteğe bağlı

    Eşleşen sayfalara yerleştirilecek JavaScript kodu veya JavaScript dosyaları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ği. İçerik komut dosyaları, yalnızca devralınan URL'leri matches alanındaki beyan edilen kalıplardan biriyle eşleştiğinde sayfalara yerleştirilir. Devralınan URL, çerçeveyi veya pencereyi oluşturan dokümanın URL'sidir. İçerik komut dosyaları, korumalı alan çerçevelerine eklenemez.

  • eşleşiyor

    string[]

    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 zaman. Varsayılan değer "document_idle"dır.

ContentWindow

Mesajlaşma herkese açık kullanıcı adı, misafir penceresine taşınır.

Özellikler

  • postMessage

    geçersiz

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

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

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

    postMessage işlevi şu şekildedir: 

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

    • mesaj

      herhangi

      Konuğa gönderilecek mesaj nesnesi.

    • targetOrigin

      dize

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

ContextMenuCreateProperties

Chrome 44+

Özellikler

  • işaretli

    boole isteğe bağlı

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

  • bağlamlar

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

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

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğeyi, yalnızca URL'si verilen kalıplardan biriyle eşleşen dokümanlara uygulanacak şekilde kısıtlamanıza olanak tanır. (Bu durum çerçeveler için de geçerlidir.) Kalıp biçimiyle ilgili ayrıntılar için Eşleşme Kalıpları başlıklı makaleyi inceleyin.

  • etkin

    boole isteğe bağlı

    Bu bağlam menüsü öğesinin etkin veya devre dışı olup olmadığı. Varsayılan değer: true.

  • id

    string isteğe bağlı

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

  • parentId

    string | number isteğe bağlı

    Ebeveyn menüsü öğesinin kimliği; bu, öğeyi daha önce eklenen bir öğenin alt öğesi yapar.

  • targetUrlPatterns

    string[] isteğe bağlı

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

  • title

    string isteğe bağlı

    Öğede gösterilecek metin. type, "separator" değilse bu zorunludur. Bağlam "seçim" olduğunda, seçilen metni göstermek için dizede %s kullanabilirsiniz. Örneğin, bu parametrenin değeri "'%s' ifadesini Pig Latin diline çevir" ise ve kullanıcı "cool" kelimesini seçerse seçim için bağlam menüsü öğesi "'cool' ifadesini Pig Latin diline çevir" olur.

  • tür

    ItemType isteğe bağlı

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

  • onclick

    void isteğe bağlı

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

    onclick işlevi şu şekildedir: 

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

    • bilgi

      OnClickData

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

ContextMenus

Chrome 44+

Özellikler

  • onShow

    Event<functionvoidvoid>

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

    onShow.addListener işlevi şu şekildedir: 

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

    • callback

      işlev

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

      (event: object) => void

      • etkinlik

        nesne

        • preventDefault

          geçersiz

          Bağlam menüsünün gösterilmesini engellemek için bu yöntemi çağırın.

          preventDefault işlevi şu şekildedir: 

          () => {...}

  • create

    geçersiz

    Yeni bir bağlam menüsü öğesi oluşturur. Oluşturma sırasında bir hata meydana gelirse oluşturma geri çağırma işlevi tetiklenene kadar bu hatayı fark etmeyebilirsiniz (ayrıntılar runtime.lastError içinde yer alır).

    create işlevi şu şekildedir: 

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

    • createProperties

      nesne

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

    • callback

      function isteğe bağlı

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

      () => void

    • returns

      dize | sayı

      Yeni oluşturulan öğenin kimliği.

  • remove

    geçersiz

    Bağlam menüsü öğesini kaldırır.

    remove işlevi şu şekildedir: 

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

    • menuItemId

      dize | sayı

      Kaldırılacak bağlam menüsü öğesinin kimliği.

    • callback

      function isteğe bağlı

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

      () => void

  • removeAll

    geçersiz

    Bu webview öğesine eklenen tüm bağlam menüsü öğelerini kaldırır.

    removeAll işlevi şu şekildedir: 

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

    • callback

      function isteğe bağlı

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

      () => void

  • update

    geçersiz

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

    update işlevi şu şekildedir: 

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

    • id

      dize | sayı

      Güncellenecek öğenin kimliği.

    • updateProperties

      nesne

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

    • callback

      function isteğe bağlı

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

      () => void

ContextMenuUpdateProperties

Chrome 44+

Özellikler

  • işaretli

    boole isteğe bağlı

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

  • bağlamlar

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

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

  • documentUrlPatterns

    string[] isteğe bağlı

    Öğeyi, yalnızca URL'si verilen kalıplardan biriyle eşleşen dokümanlara uygulanacak şekilde kısıtlamanıza olanak tanır. (Bu durum çerçeveler için de geçerlidir.) Kalıp biçimiyle ilgili ayrıntılar için Eşleşme Kalıpları başlıklı makaleyi inceleyin.

  • etkin

    boole isteğe bağlı

    Bu bağlam menüsü öğesinin etkin veya devre dışı olup olmadığı.

  • parentId

    string | number isteğe bağlı

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

  • targetUrlPatterns

    string[] isteğe bağlı

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

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

    • bilgi

      OnClickData

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

ContextType

Chrome 44+

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

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

Arayüz, dialog DOM etkinliklerine eklendi.

Özellikler

  • iptal

    geçersiz

    İletişim kutusunu reddetme confirm veya prompt iletişim kutusunda İptal'i tıklamakla aynıdır.

    cancel işlevi şu şekildedir: 

    () => {...}

  • tamam

    geçersiz

    İletişim kutusunu kabul edin. alert, confirm veya prompt iletişim kutusunda Tamam'ı tıklamakla aynıdır.

    ok işlevi şu şekildedir: 

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

    • gönderin

      string isteğe bağlı

      prompt iletişim kutusu kabul edilirken davetliye gönderilecek yanıt dizesi.

DialogMessageType

Chrome 141+

Konuk tarafından istenen kalıcı iletişim kutusunun türü.

Enum

"alert"

"onayla"

"prompt"

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

    geçersiz

    İzin isteğini onaylayın.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi şu şekildedir: 

    () => {...}

ExitReason

Chrome 141+

Çıkış nedenini belirten dize.

Enum

"normal"

"abnormal"

"kilitlendi"

"öldürüldü"

"oom killed"

"oom"

"başlatılamadı"

"bütünlük hatası"

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ğini onaylayın.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddetme

    deny işlevi şu şekildedir: 

    () => {...}

FindCallbackResults

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

Özellikler

  • activeMatchOrdinal

    sayı

    Mevcut eşleşmenin sıra numarası.

  • iptal edildi

    boole

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

  • numberOfMatches

    sayı

    searchText ifadesinin sayfada eşleşme sayısı.

  • selectionRect

    SelectionRect

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

FindOptions

Bulma isteğiyle ilgili seçenekler.

Özellikler

  • geri

    boole isteğe bağlı

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

  • matchCase

    boole isteğe bağlı

    Büyük/küçük harfe duyarlı eşleştirme için 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 karenin kaynağı.

  • izin ver

    geçersiz

    İzin isteğini onaylayın.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddetme

    deny işlevi şu şekildedir: 

    () => {...}

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ğini onaylayın.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi şu şekildedir: 

    () => {...}

HidPermissionRequest

Chrome 125 ve sonraki sürümler

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ğini onaylayın.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi şu şekildedir: 

    () => {...}

InjectDetails

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

Özellikler

  • kod

    string isteğe bağlı

    Eklenecek JavaScript veya CSS kodu.

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

  • dosya

    string isteğe bağlı

    Eklenecek JavaScript veya CSS dosyası.

InjectionItems

Chrome 44+

Ekleme öğesinin türü: kod veya bir dosya grubu.

Özellikler

  • kod

    string isteğe bağlı

    Eşleşen sayfalara eklenecek 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.

LoadAbortReason

Chrome 141+

Ne tür bir iptal işleminin gerçekleştiğini gösteren dize. Bu dize, sürümler arasında geriye dönük uyumluluğu garanti etmez. İçeriği ayrıştırmamalı ve içeriğe göre işlem yapmamalısınız. Bazı durumlarda, burada listelenmeyen bir hatanın bildirilmesi de mümkündür.

Enum

"ERR_ABORTED"

"ERR_INVALID_URL"

"ERR_DISALLOWED_URL_SCHEME"

"ERR_BLOCKED_BY_CLIENT"

"ERR_ADDRESS_UNREACHABLE"

"ERR_EMPTY_RESPONSE"

"ERR_FILE_NOT_FOUND"

"ERR_UNKNOWN_URL_SCHEME"

LoadPluginPermissionRequest

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

Özellikler

  • identifier

    dize

    Eklentinin tanımlayıcı dizesi.

  • ad

    dize

    Eklentinin görünen adı.

  • izin ver

    geçersiz

    İzin isteğini onaylayın. deny çağrılmazsa varsayılan davranış budur.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

    İzin isteğini reddetme

    deny işlevi şu şekildedir: 

    () => {...}

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ğini onaylayın.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi şu şekildedir: 

    () => {...}

NewWindow

Arayüz, newwindow DOM etkinliklerine eklendi.

Özellikler

  • eklemek

    geçersiz

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

    attach işlevi şu şekildedir: 

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

    • webview

      nesne

      Hedef sayfanın eklenmesi gereken webview öğesi.

  • sil

    geçersiz

    Yeni pencere isteğini iptal eder.

    discard işlevi şu şekildedir: 

    () => {...}

PermissionType

Chrome 141+

İstenen izin türü.

Enum

"media"

"geolocation"

"pointerLock"

"indir"

"loadplugin"

"filesystem"

"fullscreen"

"hid"

PointerLockPermissionRequest

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

Özellikler

  • lastUnlockedBySelf

    boole

    İstek gönderen çerçevenin, işaretçi kilidini tutan en son istemci olup olmadığı.

  • url

    dize

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

  • userGesture

    boole

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

  • izin ver

    geçersiz

    İzin isteğini onaylayın.

    allow işlevi şu şekildedir: 

    () => {...}

  • deny

    geçersiz

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

    deny işlevi şu şekildedir: 

    () => {...}

SelectionRect

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

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

Özellikler

  • yükseklik

    sayı

    Dikdörtgenin yüksekliği.

  • sol

    sayı

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

  • üst

    sayı

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

  • genişlik

    sayı

    Dikdörtgenin genişliği.

StopFindingAction

Chrome 141+

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

Enum

"clear"

"keep"

"etkinleştir"

WebRequestEventInterface

Chrome 44+

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

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

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

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

Bildirim temelli webview webRequest'leri için koşulların ve işlemlerin, chrome.webViewRequest.* karşılıklarından örneklendirilmesi gerektiğini unutmayın. Aşağıdaki örnek kod, web görünümünde (myWebview) "example.com" adresine gönderilen tüm istekleri bildirimli olarak engeller:

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

WindowOpenDisposition

Chrome 141+

Yeni pencerenin istenen düzeni.

Enum

"ignore"

"save_to_disk"

"current_tab"

"new_background_tab"

"new_foreground_tab"

"new_window"

"new_popup"

ZoomMode

Chrome 43 ve sonraki sürümler

webview uygulamasında yakınlaştırma işleminin nasıl yapılacağını tanımlar.

Enum

"per-origin"
Yakınlaştırma değişiklikleri, yakınlaştırılan sayfanın kaynağında kalır. Diğer bir deyişle, aynı bölümdeki aynı kaynağa giden diğer tüm web görünümleri de yakınlaştırılır. Ayrıca, per-originyakınlaştırma değişiklikleri kaynakla birlikte kaydedilir. Yani aynı kaynaktaki diğer sayfalara gittiğinizde tüm sayfalar aynı yakınlaştırma faktörüne göre yakınlaştırılır.

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

"disabled"
Web görünümünde tüm yakınlaştırma işlemlerini devre dışı bırakır. İçerik, varsayılan yakınlaştırma seviyesine döner ve tüm yakınlaştırma değişiklikleri yok sayılır.

Özellikler

contentWindow

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

Tür

ContentWindow

contextMenus

Chrome 44+

Chrome'un ContextMenus API'sine benzer ancak tarayıcı yerine webview için geçerlidir. webview'ın bağlam menüsüne öğe eklemek için webview.contextMenus API'sini kullanın. Bağlam menüsü eklemelerinizin hangi nesne türleri (ör. resimler, köprüler ve sayfalar) için geçerli olacağı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+ 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
): void

webview uzantısına içerik komut dosyası ekleme kuralları ekler. webview bir veya daha fazla kurala uyan bir sayfaya gittiğinde ilişkili komut dosyaları eklenir. Programatik olarak kural ekleyebilir veya mevcut kuralları güncelleyebilirsiniz.

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

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

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

addContentScripts çağrısını, komut dosyası eklemeniz gerekene kadar 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" eklemek için webview.addContentScripts çağrısı yapıyorsa komut dosyalarının eklenmesi için bir sonraki yönlendirmeyi beklemeniz gerekir. Hemen enjeksiyon istiyorsanız executeScript doğru olanı yapacaktır.

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

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

Parametreler

back()

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

Mümkünse bir geçmiş girişini geriye doğru gezinir. go(-1) etiketine eş değer.

Parametreler

  • callback

    function isteğe bağlı

    Chrome 44+

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

    (success: boolean) => void

    • başarılı

      boole

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

canGoBack()

chrome.webviewTag.canGoBack(): boolean

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

İadeler

  • boole

canGoForward()

chrome.webviewTag.canGoForward(): boolean

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

İadeler

  • boole

captureVisibleRegion()

Chrome 50+ 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
): void

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

Parametreler

  • seçenekler

    ImageDetails isteğe bağlı

  • callback

    işlev

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

    (dataUrl: string) => void

    • dataUrl

      dize

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

clearData()

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

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

Parametreler

  • seçenekler

    ClearDataOptions

    Hangi verilerin temizleneceğini belirleyen seçenekler.

  • Temizlenecek veri türleri.

  • callback

    function isteğe bağlı

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

    () => void

executeScript()

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

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

  • callback

    function isteğe bağlı

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

    (result?: any[]) => void

    • sonuç

      any[] isteğe bağlı

      Her eklenen karede komut dosyasının sonucu.

find()

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

Sayfa içi bulma isteği başlatır.

Parametreler

  • searchText

    dize

    Sayfada bulunacak dize.

  • seçenekler

    FindOptions isteğe bağlı

    Bulma isteğiyle ilgili seçenekler.

  • callback

    function isteğe bağlı

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

    (results?: FindCallbackResults) => void

    • sonuç

      FindCallbackResults isteğe bağlı

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

forward()

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

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

Parametreler

  • callback

    function isteğe bağlı

    Chrome 44+

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

    (success: boolean) => void

    • başarılı

      boole

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

getAudioState()

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

Ses durumunu sorgular.

Parametreler

  • callback

    işlev

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

    (audible: boolean) => void

    • audible

      boole

getProcessId()

chrome.webviewTag.getProcessId(): number

Misafir web sayfasının mevcut işlemi için Chrome'un dahili işlem kimliğini döndürür. Böylece yerleştiriciler, işlemin sonlandırılmasından kaç misafirin etkileneceğini öğrenebilir. İki misafir, yalnızca aynı uygulamaya aitlerse ve aynı depolama alanı bölüm kimliğine sahiplerse bir işlemi paylaşır. Çağrı eşzamanlıdır ve yerleştiricinin mevcut işlem kimliğiyle ilgili önbelleğe alınmış kavramını döndürür. İşlem kimliği, işletim sisteminin işlem kimliğiyle aynı değildir.

İadeler

  • sayı

getUserAgent()

chrome.webviewTag.getUserAgent(): string

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

Mevcut yakınlaştırma faktörünü alır.

Parametreler

  • callback

    işlev

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

    (zoomFactor: number) => void

    • zoomFactor

      sayı

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

getZoomMode()

Chrome 43 ve sonraki sürümler 
chrome.webviewTag.getZoomMode(
  callback: function,
): void

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

Parametreler

  • callback

    işlev

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

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      ZoomMode

      webview için geçerli yakınlaştırma modu.

go()

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

Mevcut gezinmeyle ilgili bir geçmiş dizini kullanarak geçmiş girişine gider. İstenen gezinme mümkün değilse bu yöntemin hiçbir etkisi olmaz.

Parametreler

  • relativeIndex

    sayı

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

  • callback

    function isteğe bağlı

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

    (success: boolean) => void

    • başarılı

      boole

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

insertCSS()

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

Misafir sayfasına CSS ekler.

Parametreler

  • ayrıntılar

    InjectDetails

    Eklenecek CSS'nin ayrıntıları.

  • callback

    function 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,
): void

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

Parametreler

  • callback

    işlev

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

    (muted: boolean) => void

    • ses kapatıldı

      boole

isSpatialNavigationEnabled()

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

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

Parametreler

  • callback

    işlev

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

    (enabled: boolean) => void

    • etkin

      boole

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

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

loadDataWithBaseUrl()

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

Göreceli bağlantılar için kullanılan belirli bir ana URL'ye sahip bir veri URL'si 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 ana URL.

  • virtualUrl

    string isteğe bağlı

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

print()

chrome.webviewTag.print(): void

webview içeriğini yazdırır. Bu, komut dosyasıyla yazdır işlevini webview üzerinden çağırmakla aynıdır.

reload()

chrome.webviewTag.reload(): void

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

removeContentScripts()

Chrome 44+ 
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
): void

İçerik komut dosyalarını bir webview öğesinden kaldırır.

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

webview.removeContentScripts(['myRule']);

Aşağıdaki çağrıyı yaparak 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 uzantısına eklenen tüm içerik komut dosyaları kaldırılır.

setAudioMuted()

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

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

Parametreler

  • sesi kapat

    boole

    Sesi kapatma değeri

setSpatialNavigationEnabled()

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

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

Parametreler

  • etkin

    boole

    Yön tuşlarıyla gezinme durumu değeri.

setUserAgentOverride()

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

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

Parametreler

  • userAgent

    dize

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

setZoom()

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

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

Parametreler

  • zoomFactor

    sayı

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

  • callback

    function 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,
): void

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

Parametreler

  • ZoomMode

    ZoomMode

    webview uygulamasında yakınlaştırmanın nasıl yapılacağını tanımlar.

  • callback

    function isteğe bağlı

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

    () => void

stop()

chrome.webviewTag.stop(): void

Devam ediyorsa mevcut webview gezinme işleminin yüklenmesini durdurur.

stopFinding()

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

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

Parametreler

  • işlem

    StopFindingAction isteğe bağlı

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

terminate()

chrome.webviewTag.terminate(): void

Misafir 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 kendisini kapatmaya çalıştığında tetiklenir.

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

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

Parametreler

  • callback

    işlev

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

    () => void

consolemessage

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

Misafir penceresi bir konsol mesajı kaydettiğinde tetiklenir.

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

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

Parametreler

  • callback

    işlev

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

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

    • seviye

      sayı

    • mesaj

      dize

    • satır

      sayı

    • sourceId

      dize

contentload

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

Misafir penceresi bir load etkinliği tetiklediğinde (ör. yeni bir doküman yüklendiğinde) tetiklenir. Bu, mevcut dokümandaki sayfada gezinme veya asenkron kaynak yüklemelerini içermez.

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

  • callback

    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 kadar (preventDefault() çağrıldıysa) misafir işlemini engeller.

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

Parametreler

exit

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

Misafir web içeriğini oluşturan işlemden çı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

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • processID

        sayı

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

      • neden

        ExitReason

        Çıkış nedenini belirten dize.

findupdate

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

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

Parametreler

  • callback

    işlev

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

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

    • searchText

      dize

    • numberOfMatches

      sayı

    • activeMatchOrdinal

      sayı

    • selectionRect

      SelectionRect

    • iptal edildi

      boole

    • finalUpdate

      dize

loadabort

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

Üst düzey bir yükleme, onaylanmadan iptal edildiğinde tetiklenir. Etkinlik varsayılan olarak engellenmediği sürece konsolda bir hata mesajı gösterilir.

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

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

Parametreler

  • callback

    işlev

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

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

loadcommit

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

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

Parametreler

  • callback

    işlev

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

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

    • url

      dize

    • isTopLevel

      boole

loadredirect

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

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

Parametreler

  • callback

    işlev

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

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

    • oldUrl

      dize

    • newUrl

      dize

    • isTopLevel

      boole

loadstart

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

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

Parametreler

  • callback

    işlev

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

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

    • url

      dize

    • isTopLevel

      boole

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. Mevcut dokümandaki gezinme ve alt çerçeve doküman düzeyindeki yüklemeler buna dahildir ancak asenkron kaynak yüklemeleri dahil değildir. Bu etkinlik, belge düzeyindeki yükleme sayısı bir (veya daha fazla) değerinden sıfıra her geçtiğinde tetiklenir. Örneğin, yükleme işlemi tamamlanmış (yani loadstop zaten bir kez tetiklenmişse) bir sayfa yükleyen yeni bir iframe oluşturur. Ardından, iframe sayfa yüklemesi tamamlandığında ikinci bir loadstop tetiklenir. Bu kalıp, genellikle reklam yükleyen sayfalarda görülür.

Not: Onaylanmış bir yükleme iptal edildiğinde, son loadstop etkinliğinden (varsa) bu yana onaylanmış tüm yüklemeler iptal edilmiş olsa bile loadstop etkinliğinden sonra bir loadabort etkinliği gerçekleşir.

Parametreler

  • callback

    işlev

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

    () => void

newwindow

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

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

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

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

Parametreler

  • callback

    işlev

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

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

permissionrequest

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

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

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

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

Parametreler

  • callback

    işlev

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

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

responsive

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

Misafir web içeriğini oluşturan işlem, yanıt vermemeye başladıktan sonra tekrar yanıt verdiğinde tetiklenir.

Aşağıdaki örnek kod, webview öğesini duyarlı veya duyarsız hale geldikçe karartır veya açar:

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

Parametreler

  • callback

    işlev

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

    (processID: number) => void

    • processID

      sayı

sizechanged

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

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

Parametreler

  • callback

    işlev

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

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

    • oldWidth

      sayı

    • oldHeight

      sayı

    • newWidth

      sayı

    • newHeight

      sayı

unresponsive

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

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

Parametreler

  • callback

    işlev

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

    (processID: number) => void

    • processID

      sayı

zoomchange

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

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

Parametreler

  • callback

    işlev

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

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

    • oldZoomFactor

      sayı

    • newZoomFactor

      sayı