chrome.types

Açıklama

chrome.types API, Chrome için tür bildirimlerini 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ılmasının amaçlandığını gösterir.

Kapsam ve yaşam döngüsü

Chrome, tarayıcı ayarlarında üç farklı kapsamı ayırt eder:

regular
regular kapsamında ayarlanan 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 geçerli kalır.
incognito_persistent
incognito_persistent kapsamındaki ayarlar yalnızca gizli pencereler için geçerlidir. Bu ayarlar, regular ayarlarını geçersiz kılar. Bu ayarlar diske kaydedilir ve yönetici uzantısı tarafından temizlenene veya yönetici uzantısı devre dışı bırakılana ya da kaldırılana kadar geçerli kalır.
incognito_session_only
incognito_session_only kapsamındaki ayarlar yalnızca gizli pencereler için geçerlidir. Bu ayarlar, regular ve incognito_persistent ayarlarını geçersiz kılar. Bu ayarlar diske kaydedilmez ve son Gizli pencere kapatıldığında temizlenir. Bu ayarlar yalnızca en az bir gizli pencere açıkken belirlenebilir.

Öncelik

Chrome, ayarları farklı katmanlarda yönetir. Aşağıdaki listede, etkili ayarları etkileyebilecek katmanlar öncelik sırasına göre açıklanmıştır.

  1. İşletim sistemi tarafından sağlanan sistem ayarları
  2. Komut satırı parametreleri
  3. Uzantılar tarafından sağlanan ayarlar
  4. Politikalar

Listeden de anlaşılacağı gibi, politikalar uzantınızla belirttiğiniz 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 kullanmanıza olanak tanır. 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) için ayarlar ve gizli pencereler (I) için ayarlar belirleyebildiğini varsayalım.

  • Yalnızca (R) ayarlanmışsa bu ayarlar hem normal hem de gizli pencereler için geçerlidir.
  • Yalnızca (I) ayarlanırsa bu ayarlar yalnızca gizli pencerelerde geçerli olur. Normal pencereler, alt katmanlar (komut satırı seçenekleri ve sistem ayarları) tarafından belirlenen 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) ayarını yaparsa normal pencerelerin ayarları daha önce yüklenen uzantılar tarafından tanımlanabilir.

Bir ayarın etkili değeri, öncelik kuralları dikkate alınarak belirlenir. Chrome tarafından kullanılır.

Türler

ChromeSetting

Chrome tarayıcı ayarına erişime izin veren bir arayüz. Örnek için accessibilityFeatures bölümüne bakın.

Özellikler

  • onChange

    Event<functionvoidvoid>

    Ayarlar değiştirildikten sonra tetiklenir.

    onChange.addListener işlevi şu şekilde görünür: 

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

    • callback

      işlev

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

      (details: object) => void

      • ayrıntılar

        nesne

        • incognitoSpecific

          boolean 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 bulunur.

        • levelOfControl

          LevelOfControl

          Ayarın kontrol düzeyi.

        • value

          T

          Değişiklikten sonraki ayarın değeri.

  • temizle

    geçersiz

    Ayarı temizler ve varsayılan değerleri geri yükler.

    clear işlevi şu şekilde görünür: 

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

    • ayrıntılar

      nesne

      Hangi ayarın temizleneceği.

      • kapsam

        ChromeSettingScope isteğe bağlı

        Ayarı temizleyeceğiniz yer (varsayılan: normal).

    • returns

      Promise<void>

      Chrome 96 veya daha yeni bir sürüm
  • get

    geçersiz

    Bir ayarın değerini alır.

    get işlevi şu şekilde görünür: 

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

    • ayrıntılar

      nesne

      Hangi ayarın dikkate alınacağı.

      • gizli

        boolean 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ış).

    • returns

      Promise<object>

      Chrome 96 veya daha yeni bir sürüm
  • grup

    geçersiz

    Bir ayarın değerini belirler.

    set işlevi şu şekilde görünür: 

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

    • ayrıntılar

      nesne

      Hangi ayarın değiştirileceği

      • kapsam

        ChromeSettingScope isteğe bağlı

        Ayarı nerede ayarlayacağınız (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 veya daha yeni bir sürüm

ChromeSettingScope

Chrome 44 veya daha yeni bir sürüm

ChromeSetting'in kapsamı. Şunlardan biri:

  • regular: Normal profilin 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 geçerli olan ayar (gizli profil tarafından devralınmaz),
  • incognito\_persistent: Tarayıcı yeniden başlatıldığında geçerliliğini koruyan (normal tercihleri geçersiz kılan) gizli profil ayarı,
  • incognito\_session\_only: Yalnızca bir Gizli oturum sırasında ayarlanabilen ve Gizli oturum sona erdiğinde silinen Gizli profil ayarıdır (normal ve incognito_persistent tercihlerini geçersiz kılar).

Enum

"regular"

"regular_only"

"incognito_persistent"

"incognito_session_only"

LevelOfControl

Chrome 44 veya daha yeni bir sürüm

Ş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"