chrome.types

refresh date: 2026-09-25 robots: noindex

Açıklama

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

Chrome ayarları

ChromeSetting prototipi, 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ındaki ayarlar normal tarayıcı pencereleri için geçerlidir ve geçersiz kılınmadıkları 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çerliliğini korur.
incognito_persistent
incognito_persistent kapsamındaki ayarlar yalnızca Gizli pencereler için geçerlidir. Bu durumlarda regular ayarları geçersiz kılı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_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. 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çıklanmaktadı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.

Yukarıda 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 pencereler (I) için ayar 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 (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ı yapıyorsa 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

    void

    Promise

    Ayarı temizler ve varsayılan değeri 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ı temizleyeceğiniz yer (varsayılan: normal).

    • callback

      işlev isteğe bağlı

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

      () => void

    • returns

      Promise<void>

      Chrome 96 ve sonraki sürümler

      Temizleme işlemi tamamlandığında çağrılır.

      Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

  • get

    void

    Promise

    Bir ayarın değerini alır.

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

    (details: object, callback?: function) => {...}

    • ayrıntılar

      nesne

      Hangi ayarın dikkate alınacağı.

      • incognito

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

    • callback

      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

          boolean isteğe bağlı

          Etkili değerin gizli oturuma özgü olup olmadığı. Bu özellik get() parametresinin details parametresindeki incognito özelliği doğruysa yalnızca mevcut olur.

        • levelOfControl

          LevelOfControl

          Ayarın kontrol düzeyi.

        • value

          T

          Ayarın değeri.

    • returns

      Promise<object>

      Chrome 96 ve sonraki sürümler

      Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

  • grup

    void

    Promise

    Bir 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ı belirleyeceğiniz 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.

    • callback

      işlev isteğe bağlı

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

      () => void

    • returns

      Promise<void>

      Chrome 96 ve sonraki sürümler

      Ayarlama işlemi tamamlandığında çağrılır.

      Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

ChromeSettingScope

Chrome 44 ve sonraki sürümler

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

"regular"

"regular_only"

"incognito_persistent"

"incognito_session_only"

LevelOfControl

Chrome 44 ve sonraki sürümler

Şunlardan biri:

  • not\_controllable: Herhangi 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"