chrome.webviewTag (original) (raw)
chrome.webviewTag
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Açıklama
Ağ üzerinden web'den canlı içerikleri etkin bir şekilde yüklemek ve Chrome uygulamanıza yerleştirmek için webview
etiketini kullanın. Uygulamanız, webview
etiketinin görünümünü kontrol edebilir, web içeriğiyle etkileşim kurabilir, yerleştirilmiş bir web sayfasında gezinme başlatabilir, sayfadaki hata etkinliklerine tepki verebilir ve daha fazlasını yapabilir (Kullanım bölümüne bakın).
İzinler
webview
Türler
ClearDataOptions
clearData
tarafından hangi verilerin silineceğini belirleyen seçenekler.
Özellikler
- şu tarihten beri:
number isteğe bağlı
Bu tarihte veya sonrasında toplanan verileri temizleyin. Bu veriler, başlangıç tarihinden itibaren milisaniye cinsinden gösterilir (JavaScriptDate
nesnesinin getTime yöntemi aracılığıyla erişilebilir). Bu parametre yoksa varsayılan olarak0
olur (tüm tarama verileri kaldırılır).
ClearDataTypeSet
Bir veri türü grubu. Eksik mülkler false
olarak yorumlanır.
Özellikler
- appcache
boole isteğe bağlı
Web sitelerinin uygulama önbellekleri. - önbellek
boole isteğe bağlı
Chrome 44 ve sonraki sürümler
Chrome 43 sürümünden beri Tarayıcının önbelleği. Not: Veriler kaldırıldığında önbelleğin tamamı temizlenir. Bu işlem, belirttiğiniz aralıkla sınırlı değildir. - Cloud Console dışındaki Google Cloud sitelerindeki
boole isteğe bağlı
Bölümün çerezleri. - fileSystems
boole isteğe bağlı
Web sitelerinin dosya sistemleri. - indexedDB
boole isteğe bağlı
Web sitelerinin IndexedDB verileri. - localStorage
boole isteğe bağlı
Web sitelerinin yerel depolama alanı verileri. - persistentCookies
boole isteğe bağlı
Chrome 58 ve sonraki sürümler
Bölümün kalıcı çerezleri. - sessionCookies
boole isteğe bağlı
Chrome 58 ve sonraki sürümler
Bölümün oturum çerezleri. - webSQL
boole isteğe bağlı
Web sitelerinin WebSQL verileri.
ContentScriptDetails
Chrome 44 ve sonraki sürümler
Yerleştirilecek içerik komut dosyasının ayrıntıları. Daha fazla bilgi için içerik komut dosyaları belgelerini inceleyin.
Özellikler
- all_frames
boole isteğe bağlıall_frames
true
ise JavaScript veya CSS'nin geçerli sayfanın tüm çerçevelerine yerleştirilmesi gerektiği anlamına gelir. Varsayılan olarakall_frames
false
olur ve JavaScript veya CSS yalnızca üst çerçeveye eklenir. - css
InjectionItems isteğe bağlı
Eşleşen sayfalara eklenecek CSS kodu veya CSS dosyalarının listesi. Bunlar, sayfa için herhangi bir DOM oluşturulmadan veya gösterilmeden önce göründükleri sırada eklenir. - exclude_globs
string[] isteğe bağlı
Bu genel ifadeyle eşleşen URL'leri hariç tutmak için eşleşmelerden sonra uygulanır. @exclude Greasemonkey anahtar kelimesini taklit etmek için tasarlanmıştır. - exclude_matches
string[] isteğe bağlı
Bu içerik komut dosyasının aksi takdirde yerleştirileceği sayfaları hariç tutar. - include_globs
string[] isteğe bağlı
Eşleşmelerden sonra uygulanır ve yalnızca bu genel ifadeyle eşleşen URL'leri içerir. @include Greasemonkey anahtar kelimesini taklit etmek için tasarlanmıştır. - js
InjectionItems isteğe bağlı
Eşleşen sayfalara eklenecek JavaScript kodu veya JavaScript dosyalarının listesi. Bunlar göründükleri sırada eklenir. - match_about_blank
boole isteğe bağlı
İçerik komut dosyasının about:blank ve about:srcdoc adreslerine eklenip eklenmeyeceği. İçerik komut dosyaları yalnızca devralınan URL'leri, eşleşmeler alanında tanımlanan kalıplardan biriyle eşleştiğinde sayfalara eklenir. Devralınan URL, çerçeveyi veya pencereyi oluşturan belgenin URL'sidir. İçerik komut dosyaları, korumalı alan çerçevelerine eklenemez. - Bu içerik komut dosyasının hangi sayfalara ekleneceğini belirtir.
- Eklenecek içerik komut dosyasının adı.
- JavaScript veya CSS'nin sekmeye en erken eklenme zamanı. Varsayılan olarak "document_idle" değerine ayarlanır.
ContentWindow
Davetli penceresine mesajlaşma herkese açık kullanıcı adı.
Özellikler
- Yerleşik içerik, hedef kaynaktan bir sayfa görüntülediği sürece yerleşik web içeriğine bir mesaj gönderir. Bu yöntem, sayfanın yüklenmesi tamamlandıktan sonra kullanılabilir. contentload etkinliğini dinleyin ve ardından yöntemi çağırın.
Davetli, aldığı mesaj etkinliğindeevent.source
adresine mesaj göndererek yerleştiriciye yanıt verebilir.
Bu API, web sayfaları arasındaki iletişim için kullanılan HTML5 postMessage API ile aynıdır. Yerleştiren, kendi çerçevesine birmessage
etkinlik işleyici ekleyerek yanıtları dinleyebilir.postMessage
işlevi şu şekilde görünür:
(message: any, targetOrigin: string) => {...}- Davetliye gönderilecek mesaj nesnesi.
- Etkinliğin gönderilebilmesi için davetli penceresinin kaynağının ne olması gerektiğini belirtir.
Chrome 44 ve sonraki sürümler
Özellikler
- Bir onay kutusunun veya radyo öğesinin ilk durumu: Seçili için doğru, seçilmemiş için yanlış. Belirli bir radyo öğesi grubunda aynı anda yalnızca bir radyo öğesi seçilebilir.
- [ContextType, ...ContextType[]] isteğe bağlı
Bu menü öğesinin görüneceği bağlamların listesi. Belirtilmezse varsayılan olarak ['page'] olur. - Öğeyi yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlar için geçerli olacak şekilde kısıtlamanıza olanak tanır. (Bu durum çerçeveler için de geçerlidir.) Kalıp biçimi hakkında ayrıntılı bilgi için Eşleşme Kalıpları başlıklı makaleyi inceleyin.
- Bu içerik menüsü öğesinin etkin veya devre dışı olup olmadığını belirtir. Varsayılan olarak
true
değerine ayarlanır. - Bu öğeye atanacak benzersiz kimlik. Etkinlik sayfaları için zorunludur. Bu uzantı için başka bir kimlikle aynı olamaz.
- Üst menü öğesinin kimliği. Bu, öğeyi daha önce eklenen bir öğenin alt öğesi yapar.
- documentUrlPatterns'e benzer ancak img/audio/video etiketlerinin
src
özelliğine ve ana sayfa etiketlerininhref
özelliğine göre filtreleme yapmanıza olanak tanır. - Öğede gösterilecek metin.
type
"ayraç" olmadığı sürece bu zorunludur. Bağlam "seçim" olduğunda, seçili metni göstermek için dize içinde%s
kullanabilirsiniz. Örneğin, bu parametrenin değeri "'%s'yi Pig Latin'e çevir" ise ve kullanıcı "cool" kelimesini seçerse seçimin bağlam menüsü öğesi "'cool'u Pig Latin'e çevir" olur. - Menü öğesinin türü. Belirtilmezse varsayılan olarak "normal" olur.
- Menü öğesi tıklandığında geri çağrılacak işlev.
onclick
işlevi şu şekilde görünür:
(info: OnClickData) => {...}- Tıklanan öğe ve tıklamanın gerçekleştiği bağlam hakkında bilgi.
Chrome 44 ve sonraki sürümler
Özellikler
- Etkinlik
Buwebview
üzerinde bir içerik menüsü gösterilmeden önce tetiklenir.event.preventDefault()
çağrılarak bu içerik menüsünü devre dışı bırakmak için kullanılabilir.onShow.addListener
işlevi şu şekilde görünür:
(callback: function) => {...}callback
parametresi şu şekilde görünür:
(event: object) => void
* * İçerik menüsünün gösterilmesini engellemek için bu işlevi çağırın.
preventDefault
işlevi şu şekilde görünür:
() => {...}
- Yeni bir içerik menüsü öğesi oluşturur. Oluşturma sırasında bir hata meydana gelirse bunu, oluşturma geri çağırma işlevi tetiklenene kadar fark edemeyeceğinizi unutmayın (ayrıntılar runtime.lastError içinde olacaktır).
create
işlevi şu şekilde görünür:
(createProperties: object, callback?: function) => {...}- Öğeyi oluşturmak için kullanılan özellikler
callback
parametresi şu şekilde görünür:
() => void- Yeni oluşturulan öğenin kimliği.
- Bir içerik menüsü öğesini kaldırır.
remove
işlevi şu şekilde görünür:
(menuItemId: string | number, callback?: function) => {...}- Kaldırılacak içerik menüsü öğesinin kimliği.
callback
parametresi şu şekilde görünür:
() => void
- Bu
webview
'ye eklenen tüm içerik menüsü öğelerini kaldırır.removeAll
işlevi şu şekilde görünür:
(callback?: function) => {...}callback
parametresi şu şekilde görünür:
() => void
- Daha önce oluşturulmuş bir içerik menüsü öğesini günceller.
update
işlevi şu şekilde görünür:
(id: string | number, updateProperties: object, callback?: function) => {...}- Güncellenecek öğenin kimliği.
- Güncellenecek tesisler. create işleviyle aynı değerleri kabul eder.
callback
parametresi şu şekilde görünür:
() => void
Chrome 44 ve sonraki sürümler
Özellikler
- Bir onay kutusunun veya radyo öğesinin durumu: Seçili için doğru, seçilmemiş için yanlış. Belirli bir radyo öğesi grubunda aynı anda yalnızca bir radyo öğesi seçilebilir.
- [ContextType, ...ContextType[]] isteğe bağlı
Bu menü öğesinin görüneceği bağlamların listesi. - Öğeyi yalnızca URL'si belirtilen kalıplardan biriyle eşleşen dokümanlar için geçerli olacak şekilde kısıtlamanıza olanak tanır. (Bu durum çerçeveler için de geçerlidir.) Kalıp biçimi hakkında ayrıntılı bilgi için Eşleşme Kalıpları başlıklı makaleyi inceleyin.
- Bu içerik menüsü öğesinin etkin veya devre dışı olup olmadığını belirtir.
- Üst menü öğesinin kimliği. Bu, öğeyi daha önce eklenen bir öğenin alt öğesi yapar. Not: Bir öğeyi kendi alt öğelerinden birinin alt öğesi olacak şekilde değiştiremezsiniz.
- documentUrlPatterns'e benzer ancak img/audio/video etiketlerinin
src
özelliğine ve ana sayfa etiketlerininhref
özelliğine göre filtreleme yapmanıza olanak tanır. - Öğede gösterilecek metin
- Menü öğesinin türü.
- Menü öğesi tıklandığında geri çağrılacak bir işlev.
onclick
işlevi şu şekilde görünür:
(info: OnClickData) => {...}- Tıklanan öğe ve tıklamanın gerçekleştiği bağlam hakkında bilgi.
ContextType
Chrome 44 ve sonraki sürümler
Bir menünün görünebileceği farklı bağlamlar. "all" değerini belirtmek, diğer tüm bağlamların kombinasyonuna eşdeğerdir.
Enum
"all"
"page"
"frame"
"selection"
"link"
"editable"
"image"
"video"
"audio"
DialogController
dialog
DOM etkinliklerine bağlı arayüz.
Özellikler
- İletişim kutusunu reddedin.
confirm
veyaprompt
iletişim kutusunda İptal'i tıklamaya eşdeğerdir.cancel
işlevi şu şekilde görünür:
() => {...} - İletişim kutusunu kabul edin.
alert
,confirm
veyaprompt
iletişim kutusunda Tamam'ı tıklamaya eşdeğerdir.ok
işlevi şu şekilde görünür:
(response?: string) => {...}- gönderin
dize isteğe bağlı
prompt
iletişim kutusu kabul edildiğinde konuğa sağlanacak yanıt dizesi.
- gönderin
DownloadPermissionRequest
download
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- İndirme isteğiyle ilişkili HTTP istek türü (ör.
GET
). - İstenen indirme URL'si.
- İzin isteğine izin verin.
allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
allow
çağrılmazsa varsayılan davranış budur.deny
işlevi şu şekilde görünür:
() => {...}
FileSystemPermissionRequest
filesystem
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- Yerel dosya sistemine erişim isteyen çerçevenin URL'si.
- İzin isteğine izin verin.
allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
deny
işlevi şu şekilde görünür:
() => {...}
FindCallbackResults
Bulma isteğinin tüm sonuçlarını içerir.
Özellikler
- Geçerli eşleşmenin sıra numarası.
- Bu bulma isteğinin iptal edilip edilmediğini belirtir.
- Sayfada
searchText
değerinin eşleşme sayısı. - Ekran koordinatlarında etkin eşleşmenin etrafındaki dikdörtgeni tanımlar.
FindOptions
Bulma isteği seçenekleri.
Özellikler
- Eşleşmeleri ters sırada bulmak için işaretleyin. Varsayılan değer:
false
. - matchCase
boole isteğe bağlı
Büyük/küçük harfe duyarlı eşleme için işaret. Varsayılan değer:false
.
FullscreenPermissionRequest
Chrome 43 ve sonraki sürümler
fullscreen
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- Tam ekran isteğini başlatan
webview
içindeki karenin kaynağı. - İzin isteğine izin verin.
allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
deny
işlevi şu şekilde görünür:
() => {...}
GeolocationPermissionRequest
geolocation
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- Coğrafi konum verilerine erişim isteyen çerçevenin URL'si.
- İzin isteğine izin verin.
allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
allow
çağrılmazsa varsayılan davranış budur.deny
işlevi şu şekilde görünür:
() => {...}
HidPermissionRequest
hid
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- HID API'ye erişim isteyen çerçevenin URL'si.
- İzin isteğine izin verin.
allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
allow
çağrılmazsa varsayılan davranış budur.deny
işlevi şu şekilde görünür:
() => {...}
InjectDetails
Eklenecek komut dosyasının veya CSS'nin ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her ikisi aynı anda ayarlanamaz.
Özellikler
- 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. - Eklenecek JavaScript veya CSS dosyası.
InjectionItems
Chrome 44 ve sonraki sürümler
Yerleştirme öğesinin türü: kod veya bir dosya grubu.
Özellikler
- Eşleşen sayfalara eklenecek JavaScript kodu veya CSS.
- dosyalar
string[] isteğe bağlı
Eşleşen sayfalara eklenecek JavaScript veya CSS dosyalarının listesi. Bunlar, bu dizgede göründükleri sırayla eklenir.
LoadPluginPermissionRequest
loadplugin
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- Eklentinin tanımlayıcı dizesi.
- Eklentinin görünen adı.
- İzin isteğine izin verin.
deny
çağrılmazsa varsayılan davranış budur.allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
deny
işlevi şu şekilde görünür:
() => {...}
MediaPermissionRequest
media
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- Kullanıcı medyasına erişim isteyen çerçevenin URL'si.
- İzin isteğine izin verin.
allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
allow
çağrılmazsa varsayılan davranış budur.deny
işlevi şu şekilde görünür:
() => {...}
NewWindow
newwindow
DOM etkinliklerine bağlı arayüz.
Özellikler
- İstenen hedef sayfayı mevcut bir
webview
öğesine ekleyin.attach
işlevi şu şekilde görünür:
(webview: object) => {...}- Hedef sayfanın eklenmesi gereken
webview
öğesi.
- Hedef sayfanın eklenmesi gereken
- Yeni pencere isteğini iptal edin.
discard
işlevi şu şekilde görünür:
() => {...}
PointerLockPermissionRequest
pointerLock
permissionrequest DOM etkinliğine eşlik eden request
nesnesi türü.
Özellikler
- lastUnlockedBySelf
boolean
İstekte bulunan çerçevenin, işaretçi kilidini tutan en son istemci olup olmadığı. - İşaretçi kilidi isteyen çerçevenin URL'si.
- Kullanıcı girişi hareketi sonucunda işaretçi kilidinin istenip istenmediği.
- İzin isteğine izin verin.
allow
işlevi şu şekilde görünür:
() => {...} - İzin isteğini reddedin.
allow
çağrılmazsa varsayılan davranış budur.deny
işlevi şu şekilde görünür:
() => {...}
SelectionRect
Ekran koordinatlarında bir dikdörtgeni tanımlar.
Kapsayıcılık semantiği dizi benzeridir. Yani (left, top)
koordinatının dikdörtgen tarafından kapsandığı, (left + width, top)
koordinatının ise kapsanmadığından bahsedilir.
Özellikler
- Dikdörtgenin yüksekliği.
- Ekranın sol kenarından dikdörtgenin sol kenarına olan mesafe.
- Ekranın üst kenarından dikdörtgenin üst kenarına olan mesafe.
- Dikdörtgenin genişliği.
WebRequestEventInterface
Chrome 44 ve sonraki sürümler
Misafir sayfasındaki webRequest etkinliklerine erişim sağlayan arayüz. webRequest yaşam döngüsü ve ilgili kavramlar hakkında ayrıntılı bilgi için chrome.webRequest uzantı API'sine bakın. Not: chrome.webRequest.onActionIgnored etkinliği web görünümlerinde desteklenmez.
Kullanımın, uzantılar webRequest API'sinden nasıl farklı olduğunu göstermek için *://www.evil.com/*
ile eşleşen URL'ler için tüm konuk isteklerini engelleyen aşağıdaki örnek kodu inceleyin:
webview.request.onBeforeRequest.addListener(
function(details) { return {cancel: true}; },
{urls: ["*://www.evil.com/*"]},
["blocking"]);
Ayrıca bu arayüz, onRequest
ve onMessage
etkinlikleri aracılığıyla açıklayıcı webRequest kurallarını destekler. API ayrıntıları için declarativeWebRequest bölümüne bakın.
Beyan dilinde web görünümü webRequest'leri için koşulların ve işlemlerin, chrome.webViewRequest.*
eşdeğerlerinden oluşturulması gerektiğini unutmayın. Aşağıdaki örnek kod, myWebview
web görünümünde "example.com"
adresine yapılan tüm istekleri açık bir şekilde engeller:
var rule = {
conditions: [
new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
],
actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);
ZoomMode
Chrome 43 ve sonraki sürümler
Yakınlaştırma işleminin webview
'te nasıl işleneceğini tanımlar.
Enum
"per-origin"
Yakınlaştırma değişiklikleri, yakınlaştırılmış sayfanın kaynağında kalır. Yani aynı bölümde bulunan ve aynı kaynağa yönlendirilen diğer tüm web görünümleri de yakınlaştırılır. Ayrıca, per-origin
yakınlaştırma değişiklikleri kaynakla birlikte kaydedilir. Bu, aynı kaynaktaki diğer sayfalara giderken bunların hepsinin aynı yakınlaştırma faktörüne yakınlaştırılacağı anlamına gelir.
"Görüntüleme başına"
Yakınlaştırma değişiklikleri yalnızca bu web görünümünde geçerli olur ve diğer web görünümlerindeki yakınlaştırma değişiklikleri bu web görünümünün yakınlaştırma özelliğini etkilemez. Ayrıca, per-view
yakınlaştırma değişiklikleri gezinme sırasında sıfırlanır; bir web görünümünde gezinirken sayfalar her zaman kaynak başına yakınlaştırma faktörleriyle (bölüm kapsamında) yüklenir.
"disabled"
Web görünümünde tüm yakınlaştırma işlemlerini devre dışı bırakır. İçerik varsayılan yakınlaştırma seviyesine geri döner ve tüm yakınlaştırma değişiklikleri yoksayılır.
Özellikler
contentWindow
Misafir sayfasına mesaj yayınlamak için kullanılabilecek nesne referansı.
Tür
Chrome 44 ve sonraki sürümler
Chrome'un ContextMenus API'sine benzer ancak tarayıcı yerine webview
için geçerlidir. webview
'un içerik menüsüne öğe eklemek için webview.contextMenus
API'yi kullanın. İçerik menüsü eklemelerinizin resim, köprü ve sayfa gibi nesne türleri için geçerli olup olmayacağını seçebilirsiniz.
Tür
request
Misafir sayfasındaki webRequest etkinliklerine erişim sağlayan arayüz.
Tür
Yöntemler
addContentScripts()
Chrome 44 ve sonraki sürümler
chrome.webviewTag.addContentScripts(
contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
webview
dosyasına içerik komut dosyası yerleştirme kuralları ekler. webview
bir veya daha fazla kuralla eşleşen bir sayfaya gittiğinde ilişkili komut dosyaları eklenir. Kuralları programatik olarak ekleyebilir veya mevcut kuralları güncelleyebilirsiniz.
Aşağıdaki örnekte webview
öğesine iki kural eklenmiştir: "myRule" ve "anotherRule".
webview.addContentScripts([
{
name: 'myRule',
matches: ['http://www.foo.com/*'],
css: { files: ['mystyles.css'] },
js: { files: ['jquery.js', 'myscript.js'] },
run_at: 'document_start'
},
{
name: 'anotherRule',
matches: ['http://www.bar.com/*'],
js: { code: "document.body.style.backgroundColor = 'red';" },
run_at: 'document_end'
}]);
...
// Navigates webview.
webview.src = 'http://www.foo.com';
addContentScripts çağrısını, komut dosyası eklemeniz gerekene kadar erteleyin.
Aşağıdaki örnekte, mevcut bir kuralın nasıl üzerine yazılacağı gösterilmektedir.
webview.addContentScripts([{
name: 'rule',
matches: ['http://www.foo.com/*'],
js: { files: ['scriptA.js'] },
run_at: 'document_start'}]);
// Do something.
webview.src = 'http://www.foo.com/*';
...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
name: 'rule',
matches: ['http://www.bar.com/*'],
js: { files: ['scriptB.js'] },
run_at: 'document_end'}]);
webview
, kaynağa (ör. foo.com) yönlendirildiyse ve "myRule"u eklemek için webview.addContentScripts
'ı çağırıyorsa komut dosyalarının eklenmesini sağlamak için bir sonraki gezinmeyi beklemeniz gerekir. Hemen para yatırmak istiyorsanız executeScript
doğru olanı yapar.
Misafir işlemi kilitlense veya sonlandırılsa ya da webview
yeniden üst öğe olarak atandığında bile kurallar korunur.
Daha fazla bilgi için içerik komut dosyaları belgelerini inceleyin.
Parametreler
- contentScriptList
[ContentScriptDetails, ...ContentScriptDetails[]]
Eklenecek içerik komut dosyalarının ayrıntıları.
back()
chrome.webviewTag.back(
callback?: function,
)
Mümkünse bir geçmiş girişi geri gider. go(-1)
etiketine eş değer.
Parametreler
- geri çağırma
işlev isteğe bağlı
Chrome 44 ve sonraki sürümlercallback
parametresi şu şekilde görünür:
(success: boolean) => void- Gezinmenin başarılı olup olmadığını belirtir.
canGoBack()
chrome.webviewTag.canGoBack()
Geçmişte geriye dönük gezinmenin mümkün olup olmadığını belirtir. Bu işlevin durumu önbelleğe alınır ve her loadcommit
işleminden önce güncellenir. Bu nedenle, işlevi çağırmanın en iyi yeri loadcommit
işlevidir.
İadeler
canGoForward()
chrome.webviewTag.canGoForward()
Geçmişte ileri doğru gezinmenin mümkün olup olmadığını belirtir. Bu işlevin durumu önbelleğe alınır ve her loadcommit
işleminden önce güncellenir. Bu nedenle, işlevi çağırmanın en iyi yeri loadcommit
işlevidir.
İadeler
captureVisibleRegion()
Chrome 50 ve üzeri sürümler
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
Web görünümünün görünür bölgesini yakalar.
Parametreler
callback
parametresi şu şekilde görünür:
(dataUrl: string) => void- Yakalanan sekmenin görünür alanının resmini kodlayan bir veri URL'si. Görüntülemek için bir HTML resim öğesinin "src" özelliğine atanabilir.
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
webview
bölümünün tarama verilerini temizler.
Parametreler
- Hangi verilerin temizleneceğini belirleyen seçenekler.
- Temizlenecek veri türleri.
- geri çağırma
işlev isteğe bağlıcallback
parametresi şu şekilde görünür:
() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
Konuk sayfasına JavaScript kodu ekler.
Aşağıdaki örnek kodda, konuk sayfasının arka plan rengini kırmızı olarak ayarlamak için komut dosyası ekleme kullanılmaktadır:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
Parametreler
- Ç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- Her enjekte edilen karede komut dosyasının sonucu.
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
)
Sayfada arama isteği başlatır.
Parametreler
- Sayfada bulunacak dize.
- seçenekler
FindOptions isteğe bağlı
Bulma isteği seçenekleri. - geri çağırma
işlev isteğe bağlıcallback
parametresi şu şekilde görünür:
(results?: FindCallbackResults) => void- sonuç
FindCallbackResults isteğe bağlı
Bulma isteğinin tüm sonuçlarını içerir.results
, geri çağırma işlevi gövdesinde kullanılmazsa atlanabilir. Örneğin, geri çağırma yalnızca bulma isteğinin ne zaman tamamlandığını belirlemek için kullanılıyorsa.
- sonuç
forward()
chrome.webviewTag.forward(
callback?: function,
)
Mümkünse bir geçmiş girişi ileri gider. go(1)
etiketine eş değer.
Parametreler
- geri çağırma
işlev isteğe bağlı
Chrome 44 ve sonraki sürümlercallback
parametresi şu şekilde görünür:
(success: boolean) => void- Gezinmenin başarılı olup olmadığını belirtir.
getAudioState()
Chrome 62 ve üzeri sürümler
chrome.webviewTag.getAudioState(
callback: function,
)
Ses durumunu sorgulayan bir işlevdir.
Parametreler
callback
parametresi şu şekilde görünür:
(audible: boolean) => void
getProcessId()
chrome.webviewTag.getProcessId()
Misafir web sayfasının mevcut işlemi için Chrome'un dahili işlem kimliğini döndürür. Böylece, yerleşimcilerin işlemin sonlandırılmasından kaç misafirin etkileneceğini bilmesi sağlanır. İki konuk yalnızca aynı uygulamaya aitse ve aynı depolama bölümü kimliğine sahipse bir işlemi paylaşır. Çağırma türü senkronizedir ve yerleştirenin mevcut işlem kimliğiyle ilgili önbelleğe alınmış bilgisini döndürür. İşlem kimliği, işletim sisteminin işlem kimliğiyle aynı değildir.
İadeler
getUserAgent()
chrome.webviewTag.getUserAgent()
Misafir sayfası istekleri için webview
tarafından kullanılan kullanıcı aracısı dizesini döndürür.
İadeler
getZoom()
chrome.webviewTag.getZoom(
callback: function,
)
Geçerli yakınlaştırma faktörünü alır.
Parametreler
callback
parametresi şu şekilde görünür:
(zoomFactor: number) => void- 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
callback
parametresi şu şekilde görünür:
(ZoomMode: ZoomMode) => voidwebview
'ın mevcut yakınlaştırma modu.
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
)
Geçerli gezinmeyle ilgili bir geçmiş dizini kullanarak geçmiş girişine gider. İstenen gezinme mümkün değilse bu yöntemin hiçbir etkisi olmaz.
Parametreler
webview
öğesinin yönlendirilmesi gereken göreli geçmiş dizini. Örneğin,2
değeri mümkünse 2 geçmiş girişi ileri,-3
değeri ise 3 giriş geri gider.- geri çağırma
işlev isteğe bağlıcallback
parametresi şu şekilde görünür:
(success: boolean) => void- Gezinmenin başarılı olup olmadığını belirtir.
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
)
Misafir sayfasına CSS ekler.
Parametreler
- Eklenecek CSS'nin ayrıntıları.
- geri çağırma
işlev isteğe bağlıcallback
parametresi şu şekilde görünür:
() => void
isAudioMuted()
Chrome 62 ve üzeri sürümler
chrome.webviewTag.isAudioMuted(
callback: function,
)
Sesin kapalı olup olmadığını sorar.
Parametreler
callback
parametresi şu şekilde görünür:
(muted: boolean) => void
isSpatialNavigationEnabled()
Chrome 71 ve üzeri sürümler
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
)
Web görünümü için mekansal navigasyonun etkin olup olmadığını sorgulayın.
Parametreler
callback
parametresi şu şekilde görünür:
(enabled: boolean) => void
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden()
webview
'ün kullanıcı aracısı dizenin webviewTag.setUserAgentOverride tarafından geçersiz kılınıp kılınmadığını belirtir.
loadDataWithBaseUrl()
chrome.webviewTag.loadDataWithBaseUrl(
dataUrl: string,
baseUrl: string,
virtualUrl?: string,
)
Göreli bağlantılar için kullanılan belirli bir ana URL içeren bir veri URL'si yükler. İsteğe bağlı olarak, veri URL'si yerine kullanıcıya gösterilecek sanal bir URL sağlanabilir.
Parametreler
- Yüklenecek veri URL'si.
- Göreli bağlantılar için kullanılacak temel URL.
- virtualUrl
dize isteğe bağlı
Kullanıcıya gösterilecek URL (adres çubuğunda).
print()
chrome.webviewTag.print()
webview
öğesinin içeriğini yazdırır. Bu, webview
'ten komut dosyası yazdırma işlevini çağırmaya eşdeğerdir.
reload()
chrome.webviewTag.reload()
Geçerli üst düzey sayfayı yeniden yükler.
removeContentScripts()
Chrome 44 ve sonraki sürümler
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
webview
'ten içerik komut dosyalarını kaldırır.
Aşağıdaki örnekte, daha önce eklenen "kuralim" kaldırılmaktadır.
webview.removeContentScripts(['myRule']);
Aşağıdakileri çağırarak tüm kuralları kaldırabilirsiniz:
webview.removeContentScripts();
Parametreler
- scriptNameList
string[] isteğe bağlı
Kaldırılacak içerik komut dosyalarının adlarının listesi. Liste boşsawebview
alanına eklenen tüm içerik komut dosyaları kaldırılır.
setAudioMuted()
Chrome 62 ve üzeri sürümler
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
Web görünümünün sessiz durumunu ayarlar.
Parametreler
- Sesi kapatma değeri
setSpatialNavigationEnabled()
Chrome 71 ve üzeri sürümler
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
)
Web görünümünün mekansal gezinme durumunu ayarlar.
Parametreler
- Mekansal gezinme durumu değeri.
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
)
Misafir sayfası istekleri için webview
tarafından kullanılan kullanıcı aracısı dizesini geçersiz kılın. Geçersiz kılma işlemi, bu geçersiz kılma işleminin uygulandığı konuk sayfası isteklerinde User-Agent Client Hint başlık değerlerinin ve navigator.userAgentData
tarafından döndürülen değerlerin boş olmasına neden olur.
Parametreler
- Kullanılacak kullanıcı aracısı dizesi.
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
)
Sayfanın yakınlaştırma faktörünü değiştirir. Bu değişikliğin kapsamı ve devamlılığı, web görünümünün mevcut yakınlaştırma moduna göre belirlenir (webviewTag.ZoomMode bölümüne bakın).
Parametreler
- Yeni yakınlaştırma faktörü.
- geri çağırma
işlev isteğe bağlıcallback
parametresi şu şekilde görünür:
() => void
setZoomMode()
Chrome 43 ve sonraki sürümler
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
)
webview
cihazının yakınlaştırma modunu ayarlar.
Parametreler
- Yakınlaştırma işleminin
webview
'te nasıl işleneceğini tanımlar. - geri çağırma
işlev isteğe bağlıcallback
parametresi şu şekilde görünür:
() => void
stop()
chrome.webviewTag.stop()
Devam eden mevcut webview
navigasyonunu yüklemeyi durdurur.
stopFinding()
chrome.webviewTag.stopFinding(
action?: "clear"
| "keep"
| "activate"
,
)
Geçerli bulma oturumunu sonlandırır (tüm vurgulamaları temizler) ve devam eden tüm bulma isteklerini iptal eder.
Parametreler
- işlem
"clear"
| "keep"
| "activate"
isteğe bağlı
Bulma oturumu sona erdikten sonra etkin eşlemeyle ne yapılacağını belirler.clear
, etkin eşleşmenin vurgusunu temizler;keep
, etkin eşleşmenin vurgusunu korur;activate
, etkin eşleşmenin vurgusunu korur ve kullanıcının bu eşleşmeyi tıklamasını simüle eder. Varsayılan işlemkeep
'tir.
terminate()
chrome.webviewTag.terminate()
Misafir web sayfasının oluşturucu sürecini zorla sonlandırır. Bu işlem, aynı işlemi paylaşıyorsa mevcut uygulamadaki birden fazla webview
etiketini etkileyebilir ancak diğer uygulamalardaki webview
etiketlerini etkilemez.
Etkinlikler
close
chrome.webviewTag.close.addListener(
callback: function,
)
Misafir penceresi kendini kapatmaya çalıştığında tetiklenir.
Aşağıdaki örnek kod, konuk kendini kapatmaya çalıştığında webview
'ten about:blank
'a gider.
webview.addEventListener('close', function() {
webview.src = 'about:blank';
});
Parametreler
callback
parametresi şu şekilde görünür:
() => void
consolemessage
chrome.webviewTag.consolemessage.addListener(
callback: function,
)
Misafir penceresi bir konsol mesajı günlüğe kaydettiğinde tetiklenir.
Aşağıdaki örnek kod, günlük düzeyine veya diğer özelliklere bakılmaksızın tüm günlük mesajlarını yerleştirenin konsoluna yönlendirir.
webview.addEventListener('consolemessage', function(e) {
console.log('Guest page logged a message: ', e.message);
});
Parametreler
callback
parametresi şu şekilde görünür:
(level: number, message: string, line: number, sourceId: string) => void
contentload
chrome.webviewTag.contentload.addListener(
callback: function,
)
Davetli penceresi bir load
etkinliği tetiklediğinde (ör. yeni bir doküman yüklendiğinde) tetiklenir. Mevcut belgedeki sayfa gezinme işlemleri veya eşzamansız kaynak yüklemeleri bu süreye dahil değildir.
Aşağıdaki örnek kod, sayfa yüklendikten sonra konuğun body
öğesinin varsayılan yazı tipi boyutunu değiştirir:
webview.addEventListener('contentload', function() {
webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});
Parametreler
callback
parametresi şu şekilde görünür:
() => void
dialog
chrome.webviewTag.dialog.addListener(
callback: function,
)
Misafir penceresi window.alert
, window.confirm
veya window.prompt
aracılığıyla modal iletişim kutusu açmaya çalıştığında tetiklenir.
Bu etkinliğin işlenmesi, her etkinlik işleyicisi geri dönene veya dialog
nesnesi erişilemez hale gelene (preventDefault()
çağrıldıysa) kadar konuk sürecini engeller.
Varsayılan davranış, iletişim kutusunu iptal etmektir.
Parametreler
callback
parametresi şu şekilde görünür:
(messageType: "alert"
| "confirm"
| "prompt"
, messageText: string, dialog: DialogController) => void- messageType
"alert"
| "confirm"
| "prompt"
- messageType
exit
chrome.webviewTag.exit.addListener(
callback: function,
)
Misafir web içeriğini oluşturan işlem sona erdiğinde tetiklenir.
Aşağıdaki örnek kod, konuk sayfası her kilitlendiğinde bir veda mesajı gösterir:
webview.addEventListener('exit', function(e) {
if (e.reason === 'crash') {
webview.src = 'data:text/plain,Goodbye, world!';
}
});
Parametreler
callback
parametresi şu şekilde görünür:
(processID: number, reason: "normal"
| "abnormal"
| "crash"
| "kill"
) => void- neden
"normal"
| "abnormal"
| "crash"
| "kill"
- neden
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
Etkin bir bulma isteği için yeni bulma sonuçları mevcut olduğunda tetiklenir. Eşleşmeler bulunduğunda bu durum tek bir bulma isteği için birden çok kez gerçekleşebilir.
Parametreler
callback
parametresi şu şekilde görünür:
(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
Üst düzey bir yükleme, taahhüt edilmeden iptal edildiğinde tetiklenir. Etkinlik varsayılan olarak engellenmemişse konsola bir hata mesajı yazdırılır.
Not: Bir kaynak yüklemesi iptal edildiğinde, son loadstop
etkinliğinden (varsa) sonraki tüm taahhüt edilen yüklemeler iptal edilmiş olsa bile loadabort
etkinliğini bir loadstop
etkinliği takip eder.
Not: Bir about URL'sinin veya JavaScript URL'sinin yüklenmesi iptal edildiğinde loadabort
tetiklenir ve ardından webview
"about:blank" adresine yönlendirilir.
Parametreler
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- neden
"ERR_ABORTED"
| "ERR_INVALID_URL"
| "ERR_DISALLOWED_URL_SCHEME"
| "ERR_BLOCKED_BY_CLIENT"
| "ERR_ADDRESS_UNREACHABLE"
| "ERR_EMPTY_RESPONSE"
| "ERR_FILE_NOT_FOUND"
| "ERR_UNKNOWN_URL_SCHEME"
- neden
loadcommit
chrome.webviewTag.loadcommit.addListener(
callback: function,
)
Bir yükleme taahhüt edildiğinde tetiklenir. Bu, mevcut doküman içinde gezinmenin yanı sıra alt çerçeve doküman düzeyinde yüklemeleri içerir ancak asenkron kaynak yüklemelerini içermez.
Parametreler
callback
parametresi şu şekilde görünür:
(url: string, isTopLevel: boolean) => void
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
Üst düzey bir yükleme isteği farklı bir URL'ye yönlendirdiğinde tetiklenir.
Parametreler
callback
parametresi şu şekilde görünür:
(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
Yükleme işlemi başladığında tetiklenir.
Parametreler
callback
parametresi şu şekilde görünür:
(url: string, isTopLevel: boolean) => void
loadstop
chrome.webviewTag.loadstop.addListener(
callback: function,
)
Bir konuk sayfasındaki tüm çerçeve düzeyindeki yüklemeler (tüm alt çerçeveleri dahil) tamamlandığında tetiklenir. Bu, mevcut doküman içinde gezinmenin yanı sıra alt çerçeve doküman düzeyinde yüklemeleri içerir ancak asenkron kaynak yüklemelerini içermez. Bu etkinlik, belge düzeyinde yükleme sayısı bir (veya daha fazla) değerinden sıfır değerine her geçtiğinde tetiklenir. Örneğin, yüklenmesi tamamlanmış bir sayfa (ör. loadstop
bir kez tetiklendiyse) bir sayfa yükleyen yeni bir iframe oluşturur. Ardından, iframe sayfası yüklemesi tamamlandığında ikinci bir loadstop
tetiklenir. Bu kalıp, genellikle reklam yükleyen sayfalarda görülür.
Not: Taahhüt edilen bir yükleme iptal edildiğinde, son loadstop
etkinliğinden (varsa) sonraki tüm taahhüt edilen yüklemeler iptal edilmiş olsa bile bir loadabort
etkinliğini bir loadstop
etkinliği takip eder.
Parametreler
callback
parametresi şu şekilde görünür:
() => void
newwindow
chrome.webviewTag.newwindow.addListener(
callback: function,
)
Misafir sayfası yeni bir tarayıcı penceresi açmaya çalıştığında tetiklenir.
Aşağıdaki örnek kod, istenen her yeni pencere için yerleştiricide yeni bir webview
oluşturur ve bu webview
'ye yönlendirir:
webview.addEventListener('newwindow', function(e) {
var newWebview = document.createElement('webview');
document.body.appendChild(newWebview);
e.window.attach(newWebview);
});
Parametreler
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- windowOpenDisposition
"ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
- windowOpenDisposition
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
Misafir sayfanın, yerleştirenden özel izin istemesi gerektiğinde tetiklenir.
Aşağıdaki örnek kod, konuk sayfasına webkitGetUserMedia
API'sine erişim izni verir. Bu örnek kodu kullanan bir uygulamanın, audioCapture
ve/veya videoCapture
manifest izinlerini kendisinin belirtmesi gerektiğini unutmayın:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
Parametreler
callback
parametresi şu şekilde görünür:
(permission: "media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
, request: object) => void- izin
"media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
- izin
responsive
chrome.webviewTag.responsive.addListener(
callback: function,
)
Davetli web içeriğini oluşturan işlem, yanıt vermeyi bıraktıktan sonra tekrar yanıt vermeye başladığında tetiklenir.
Aşağıdaki örnek kodda, webview
öğesi duyarlı hale geldiğinde veya duyarlılığını kaybettiğinde yavaşça görünür veya görünmez hale gelir:
webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
webview.style.opacity = '1';
});
Parametreler
callback
parametresi şu şekilde görünür:
(processID: number) => void
sizechanged
chrome.webviewTag.sizechanged.addListener(
callback: function,
)
Yerleştirilmiş web içeriği autosize
aracılığıyla yeniden boyutlandırıldığında tetiklenir. Yalnızca autosize
etkinse tetiklenir.
Parametreler
callback
parametresi şu şekilde görünür:
(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
Misafir web içeriğini oluşturan işlem yanıt vermediğinde tetiklenir. Davetli tekrar yanıt vermeye başlarsa bu etkinlik, eşleşen bir duyarlı etkinlikle birlikte bir kez oluşturulur.
Parametreler
callback
parametresi şu şekilde görünür:
(processID: number) => void
zoomchange
chrome.webviewTag.zoomchange.addListener(
callback: function,
)
Sayfanın yakınlaştırma ayarı değiştiğinde tetiklenir.
Parametreler
callback
parametresi şu şekilde görünür:
(oldZoomFactor: number, newZoomFactor: number) => void
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-11-30 UTC.