Açıklama
chrome.types
API, Chrome için tür bildirimleri içerir.
Chrome ayarları
ChromeSetting
türü, Chrome tarayıcının ayarları için bir etkinlik yayıncısının (onChange
) yanı sıra ortak bir işlev grubu (get()
, set()
ve clear()
) sağlar. Proxy ayarı örnekleri, bu işlevlerin nasıl kullanılacağını gösterir.
Kapsam ve yaşam döngüsü
Chrome, üç farklı tarayıcı ayarı kapsamını birbirinden ayırt eder:
regular
regular
kapsamında ayarlanan ayarlar normal tarayıcı pencerelerine uygulanır ve üzerine yazılmadığı takdirde gizli pencereler tarafından devralınır. Bu ayarlar diskte depolanır ve geçerli uzantı tarafından temizlenene veya geçerli uzantı devre dışı bırakılana ya da yüklemesi kaldırılana kadar yerinde kalır.incognito_persistent
incognito_persistent
kapsamında yapılan ayarlar yalnızca gizli pencerelerde geçerlidir. Bunlar içinregular
ayarlarını geçersiz kılarlar. Bu ayarlar diskte depolanır ve geçerli uzantı tarafından temizlenene veya geçerli uzantı devre dışı bırakılana ya da kaldırılana kadar yerinde kalır.incognito_session_only
incognito_session_only
kapsamında yapılan ayarlar yalnızca gizli pencerelerde geçerlidir. Bunlar içinregular
veincognito_persistent
ayarlarını geçersiz kılarlar. Bu ayarlar diskte depolanmaz ve son gizli pencere kapatıldığında silinir. Bunlar yalnızca en az bir gizli pencere açıkken ayarlanabilir.
Öncelik
Chrome, ayarları farklı katmanlarda yönetir. Aşağıdaki listede, etkili ayarları etkileyebilecek katmanlar, öncelik sırasına göre düzenlenmiş olarak açıklanmaktadır.
- İşletim sistemi tarafından sağlanan sistem ayarları
- Komut satırı parametreleri
- Uzantılar tarafından sağlanan ayarlar
- Politikalar
Listenin de gösterdiği gibi, politikalar uzantınızla birlikte 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 belirtildiği gibi Chrome, normal pencereler ve gizli pencereler için farklı ayarların 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 pencere ayarları (I) için ayarları yapabildiğ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 sadece gizli pencereler için geçerli olur. Normal pencereler, alt katmanlar tarafından belirlenen ayarları kullanır (komut satırı seçenekleri ve sistem ayarları).
- 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 effective değeri, öncelik kurallarının dikkate alınmasıyla elde edilen değerdir. Chrome tarafından kullanılır.
Türler
ChromeSetting
Chrome tarayıcı ayarına erişim sağlayan arayüz. Örnek için bkz. accessibilityFeatures
.
Özellikler
-
onChange
Etkinlik<functionvoidvoid>
Ayar değiştikten sonra tetiklenir.
onChange.addListener
işlevi şu şekilde görünür:(callback: function) => {...}
-
geri çağırma
işlev
callback
parametresi ş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 özel olup olmadığı. Bu özellik yalnızca kullanıcı, uzantıyı gizli modda etkinleştirdiyse gösterilir.
-
levelOfControl
Ayarın kontrol düzeyi.
-
value
T
Ayarın değişiklikten sonraki değeri.
-
-
-
-
clear
void
SözAyarı temizleyerek varsayılan değerleri geri yükler.
clear
işlevi şu şekilde görünür:(details: object, callback?: function) => {...}
-
ayrıntılar
nesne
Hangi ayarın temizleneceği.
-
kapsam
ChromeSettingScope isteğe bağlı
Ayarın temizleneceği yer (varsayılan: normal).
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
-
returns
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
-
-
get
void
SözBir ayarın değerini alır.
get
işlevi şu şekilde görünür:(details: object, callback?: function) => {...}
-
ayrıntılar
nesne
Göz önünde bulundurulması gereken ayar.
-
gizli
boole isteğe bağlı
Gizli oturuma uygulanan değerin döndürülüp döndürülmeyeceğini belirtir (varsayılan değer false).
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
Geçerli olarak geçerli değerin ayrıntıları.
-
incognitoSpecific
boole isteğe bağlı
Etkili değerin gizli oturuma özel olup olmadığı. Bu özellik yalnızca
get()
öğesinindetails
parametresindekiincognito
özelliği doğru olduğunda mevcut olur. -
levelOfControl
Ayarın kontrol düzeyi.
-
value
T
Ayarın değeri.
-
-
-
returns
Promise<object>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
-
-
ayarla
void
SözBir ayarın değerini belirler.
set
işlevi şu şekilde görünür:(details: object, callback?: function) => {...}
-
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. Bir uzantı, farklı türde bir değer ayarlamamalıdır.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
-
returns
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
-
ChromeSettingScope
ChromeSetting kapsamı. Şunlardan biri:
regular
: normal profil için ayar (başka bir yerde geçersiz kılınmadığı takdirde 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ıktan sonra hayatta kalan 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ıdır (normal ve secret_persistent tercihlerini geçersiz kılar).
Enum
"regular" (normal)
"regular_only"
LevelOfControl
Şunlardan biri:
not\_controllable
: Herhangi 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"