Açıklama
chrome.types API'si, Chrome için tür bildirimleri içerir.
Chrome ayarları
ChromeSetting türü, Chrome Tarayıcı ayarları için ortak bir işlev grubu (get(), set() ve clear()) ve bir etkinlik yayıncısı (onChange) sağlar. Proxy ayarları örnekleri, bu işlevlerin nasıl kullanılacağını gösterir.
Kapsam ve yaşam döngüsü
Chrome, tarayıcı ayarlarının üç farklı kapsamını ayırt eder:
regularregularkapsamında belirlenen ayarlar normal tarayıcı pencereleri için geçerlidir ve üzerine yazılmadığı takdirde gizli pencereler tarafından devralınır. Bu ayarlar diske kaydedilir ve yönetici uzantı tarafından temizlenene veya yönetici uzantı devre dışı bırakılana ya da kaldırılana kadar yerinde kalır.incognito_persistentincognito_persistentkapsamında belirlenen ayarlar yalnızca gizli pencereler için geçerlidir. Bu durumlardaregularayarlarını geçersiz kılarlar. Bu ayarlar diske kaydedilir ve yönetici uzantı tarafından temizlenene veya yönetici uzantı devre dışı bırakılana ya da kaldırılana kadar yerinde kalır.incognito_session_onlyincognito_session_onlykapsamında belirlenen ayarlar yalnızca gizli pencereler için geçerlidir. Bu durumlardaregularveincognito_persistentayarlarını geçersiz kılarlar. Bu ayarlar diske kaydedilmez ve son gizli pencere kapatıldığında temizlenir. Yalnızca en az bir gizli pencere açıkken ayarlanabilir.
Öncelik
Chrome, ayarları farklı katmanlarda yönetir. Aşağıdaki listede, geçerli ayarları etkileyebilecek katmanlar, öncelik sırasına göre açıklanmıştır.
- İşletim sistemi tarafından sağlanan sistem ayarları
- Komut satırı parametreleri
- Uzantılar tarafından sağlanan ayarlar
- Politikalar
Listeden de anlaşılacağı üzere politikalar, uzantınızla belirttiğiniz tüm değişiklikleri geçersiz kılabilir. Uzantınızın bir ayar sağlayıp sağlayamayacağını veya bu ayarın geçersiz kılınıp kılınmayacağını belirlemek için get() işlevini kullanabilirsiniz.
Daha önce de belirtildiği gibi Chrome, normal pencereler ve gizli pencereler için farklı ayarlar kullanılmasına izin verir. Aşağıdaki örnekte bu davranış gösterilmektedir. Hiçbir politikanın ayarları geçersiz kılmadığını ve bir uzantının normal pencereler (R) ve gizli pencereler (I) için ayarları belirleyebildiğini varsayalım.
- Yalnızca (R) ayarlanırsa bu ayarlar hem normal hem de gizli pencereler için geçerli olur.
- Yalnızca (I) ayarlanırsa bu ayarlar yalnızca gizli pencereler için geçerli olur. Normal pencereler, alt katmanlar tarafından belirlenen ayarları (komut satırı seçenekleri ve sistem ayarları) kullanır.
- Hem (R) hem de (I) ayarlanırsa normal ve gizli pencereler için ilgili ayarlar kullanılır.
İki veya daha fazla uzantı aynı ayarı farklı değerlere ayarlamak isterse en son yüklenen uzantı diğer uzantılara göre öncelikli olur. En son yüklenen uzantı yalnızca (I) değerini ayarlıyorsa normal pencerelerin ayarları daha önce yüklenen uzantılar tarafından tanımlanabilir.
Bir ayarın geçerli değeri, öncelik kuralları dikkate alınarak belirlenen değerdir. Chrome tarafından kullanılır.
Türler
ChromeSetting
Chrome Tarayıcı ayarına erişim sağlayan bir arayüz. Örnek için accessibilityFeatures sayfasına bakın.
Özellikler
-
onChange
Event<functionvoidvoid>
Ayar değiştikten sonra tetiklenir.
onChange.addListenerişlevi şu şekildedir:(callback: function) => {...}
-
callback
işlev
callbackparametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
incognitoSpecific
boole isteğe bağlı
Değişen değerin gizli oturuma özgü olup olmadığı. Bu özellik yalnızca kullanıcı uzantıyı gizli modda etkinleştirdiyse mevcut olur.
-
levelOfControl
Ayarın kontrol seviyesi.
-
value
T
Değişiklikten sonra ayarın değeri.
-
-
-
-
temizle
geçersiz
Ayarı temizler ve varsayılan değeri geri yükler.
clearişlevi şu şekildedir:(details: object) => {...}
-
ayrıntılar
nesne
Temizlenecek ayar.
-
kapsam
ChromeSettingScope isteğe bağlı
Ayarın temizleneceği yer (varsayılan: normal).
-
-
returns
Promise<void>
Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*Temizleme işlemi tamamlandığında çağrılır.
-
-
get
geçersiz
Bir ayarın değerini alır.
getişlevi şu şekildedir:(details: object) => {...}
-
ayrıntılar
nesne
Hangi ayarı dikkate almalısınız?
-
gizli mod
boole isteğe bağlı
Gizli oturum için geçerli olan değerin döndürülüp döndürülmeyeceğini belirler (varsayılan değer: false).
-
-
returns
Promise<object>
Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*
-
-
grup
geçersiz
Bir ayarın değerini belirler.
setişlevi şu şekildedir:(details: object) => {...}
-
ayrıntılar
nesne
Hangi ayarın değiştirileceği
-
kapsam
ChromeSettingScope isteğe bağlı
Ayarın yapılacağı yer (varsayılan: normal).
-
value
T
Ayarın değeri. Her ayarın, ayarla birlikte açıklanan belirli bir değer türü olduğunu unutmayın. Uzantılar farklı türde bir değer ayarlamamalıdır.
-
-
returns
Promise<void>
Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*Ayar işlemi tamamlandığında çağrılır.
-
ChromeSettingScope
ChromeSetting'in kapsamı. Şunlardan biri:
regular: Normal profil ayarı (başka bir yerde geçersiz kılınmazsa gizli profil tarafından devralınır),regular\_only: yalnızca normal profil için ayar (gizli profil tarafından devralınmaz),incognito\_persistent: Tarayıcı yeniden başlatıldığında geçerliliğini koruyan gizli profil ayarı (normal tercihleri geçersiz kılar),incognito\_session\_only: Yalnızca gizli oturum sırasında ayarlanabilen ve gizli oturum sona erdiğinde silinen gizli profil ayarı (normal ve incognito_persistent tercihlerini geçersiz kılar).
Enum
"normal"
"regular_only"
"incognito_persistent"
"incognito_session_only"
LevelOfControl
Şunlardan biri:
not\_controllable: Hiçbir uzantı tarafından kontrol edilemezcontrolled\_by\_other\_extensions: Daha yüksek önceliğe sahip uzantılar tarafından kontrol edilircontrollable\_by\_this\_extension: Bu uzantı tarafından kontrol edilebilircontrolled\_by\_this\_extension: bu uzantı tarafından kontrol ediliyor
Enum
"not_controllable"
"controlled_by_other_extensions"
"controllable_by_this_extension"
"controlled_by_this_extension"