Bu sayfa, Cloud Translation API ile çevrilmiştir.

chrome.types

Açıklama

chrome.types API, Chrome için tür bildirimleri içerir.

Chrome ayarları

ChromeSetting türü, ortak bir işlev grubu (get(), set() ve clear()) sağlar ve Chrome tarayıcı ayarları için bir etkinlik yayıncısı (onChange) oluşturun. Proxy ayarları örnekler 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ı birbirinden ayırır:

regular: regular kapsamında belirlenen ayarlar normal tarayıcı pencereleri için geçerli olur ve gizli modda devralınır pencerelerini kapatabilirsiniz. Bu ayarlar diskte saklanır ve geçerli uzantı tarafından temizlenmeleri veya geçerli uzantı devre dışı bırakılması ya da kaldırılması durumunda.
incognito_persistent: incognito_persistent kapsamında belirlenen ayarlar yalnızca gizli pencereler için geçerlidir. Bunlar için regular ayarlarını geçersiz kıl. Bu ayarlar diskte depolanır ve gerekli işlemler yapılana kadar geçerli uzantı tarafından kaldırıldı veya geçerli uzantı devre dışı bırakılmış ya da kaldırılmış.
incognito_session_only: incognito_session_only kapsamında belirlenen ayarlar yalnızca gizli pencereler için geçerlidir. Bunlar için regular ve incognito_persistent ayarlarını geçersiz kıl. Bu ayarlar diskte depolanmaz ve son gizli pencere kapatıldığında temizlenir. Yalnızca en az bir gizli pencere açık.

Öncelik

Chrome, farklı katmanlardaki ayarları yönetir. Aşağıdaki listede, karşılaşabileceğiniz katmanlar etkili ayarları, artan öncelik sırasına göre etkiler.

İşletim sistemi tarafından sağlanan sistem ayarları
Komut satırı parametreleri
Uzantılar tarafından sağlanan ayarlar
Politikalar

Listede anlaşılacağı gibi, politikalar, uzantınızla ilgili olarak yaptığınız tüm değişiklikleri geçersiz kılabilir. Siz uzantınızın bir ayar sağlayıp sağlayamayacağını belirlemek için get() işlevini kullanabilir geçersiz kılınıp kılınmayacağını belirler.

Daha önce belirtildiği gibi Chrome, normal pencereler ve gizli mod için farklı ayarların kullanılmasına izin verir. pencereler. Aşağıdaki örnekte bu davranış gösterilmektedir. Hiçbir politikanın ayarlarını yapabilir ve bir uzantının normal pencereler (R) ile ilgili ayarları belirleyebilir. gizli pencereler (I).

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ı) kullanabilir.
Hem (R) hem de (I) ayarlanırsa normal ve gizli mod için ilgili ayarlar kullanılır. pencereler.

İki veya daha fazla uzantı aynı ayarı farklı değerlere ayarlamak isterse uzantı en son diğer uzantılara göre öncelikli olur. En son yüklenen uzantı yalnızca (I) değerini ayarlarsa normal pencerelerin ayarları daha önce yüklenmiş uzantılar.

Bir ayarın etkili değeri, öncelik kurallarının dikkate alınmasından kaynaklanan değerdir. Google Chrome tarafından kullanılır.

Türler

ChromeSetting

Chrome tarayıcı ayarına erişim sağlayan bir arayüz. Örnek için bkz. accessibilityFeatures.

Özellikler

onChange

Etkinlik<İşlevler geçersiz>

Ayar değişikliklerinden sonra tetiklenir.

onChange.addListener işlevi aşağıdaki gibi 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örünür.
    
    levelOfControl
    
    LevelOfControl
    
    Ayarın kontrol düzeyi.
    
    value
    
    S
    
    Ayarın değişiklikten sonraki değeri.
temizle

geçersiz

Söz 'nı inceleyin.

Ayarı temizleyerek tüm varsayılan değerleri geri yükler.

clear işlevi aşağıdaki gibi görünür:
```
(details: object, callback?: function) => {...}
```
- ayrıntılar
  
  nesne
  
  Temizlenecek ayar.
  - kapsam
    
    ChromeSettingScope (isteğe bağlı)
    
    Ayarın temizleneceği yer (varsayılan: normal).
- geri çağırma
  
  işlev isteğe bağlı
  
  callback parametresi şu şekilde görünür:
```
() => void
```
- returns
  Taahhüt<void>
  
  Chrome 96 ve sonraki sürümler 'nı inceleyin.
  
  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
get

geçersiz

Söz 'nı inceleyin.

Bir ayarın değerini alır.

get işlevi aşağıdaki gibi görünür:
```
(details: object, callback?: function) => {...}
```
- ayrıntılar
  
  nesne
  
  Hangi ayara dikkat etmelisiniz?
  - gizli
    
    boole isteğe bağlı
    
    Gizli oturum için geçerli olan değerin döndürülüp döndürülmeyeceği (varsayılan olarak yanlış).
- geri çağırma
  
  işlev isteğe bağlı
  
  callback parametresi şu şekilde görünür:
```
(details: object) => void
```
  - ayrıntılar
    
    nesne
    
    Şu anda geçerli olan değerin ayrıntıları.
    
    incognitoSpecific
    
    boole isteğe bağlı
    
    Etkili değerin gizli oturuma özel olup olmadığı. Bu özellik yalnızca get() öğesinin details parametresindeki incognito özelliği doğru olduğunda bulunur.
    
    levelOfControl
    
    LevelOfControl
    
    Ayarın kontrol düzeyi.
    
    value
    
    S
    
    Ayarın değeri.
- returns
  Promise<object>
  
  Chrome 96 ve sonraki sürümler 'nı inceleyin.
  
  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
grup

geçersiz

Söz 'nı inceleyin.

Bir ayarın değerini ayarlar.

set işlevi aşağıdaki gibi görünür:
```
(details: object, callback?: function) => {...}
```
- ayrıntılar
  
  nesne
  
  Hangi ayarı değiştirmek istediğinizi.
  - kapsam
    
    ChromeSettingScope (isteğe bağlı)
    
    Ayarın yapılacağı yer (varsayılan: normal).
  - value
    
    S
    
    Ayarın değeri. Her ayarın, ayarla birlikte açıklanan belirli bir değer türüne sahip olduğunu unutmayın. Uzantı, farklı türde bir değer ayarlamamalıdır.
- geri çağırma
  
  işlev isteğe bağlı
  
  callback parametresi şu şekilde görünür:
```
() => void
```
- returns
  Taahhüt<void>
  
  Chrome 96 ve sonraki sürümler 'nı inceleyin.
  
  Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

ChromeSettingScope

Chrome 44 ve sonraki sürümler 'nı inceleyin.

ChromeSetting'in kapsamı. Şunlardan biri:

regular: Normal profil 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 ayardır (gizli profil tarafından devralınmaz),
incognito\_persistent: Tarayıcı yeniden başlatıldığında geçerli olan 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 gizli_persistent tercihlerini geçersiz kılar).

Enum

"regular" (normal)

"regular_only"

"gizli_kalıcı"

"gizli_oturum_yalnızca"

LevelOfControl

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Şunlardan biri:

not\_controllable: hiçbir uzantı tarafından kontrol edilemez
controlled\_by\_other\_extensions: Daha yüksek önceliğe sahip uzantılar tarafından kontrol edilir
controllable\_by\_this\_extension: bu uzantı tarafından kontrol edilebilir
controlled\_by\_this\_extension: bu uzantı tarafından kontrol ediliyor

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"