chrome.types

refresh date: 2026-09-25 robots: noindex

Açıklama

chrome.types API'si, Chrome için tür bildirimleri 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ılacağını gösterir.

Kapsam ve yaşam döngüsü

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

regular
regular kapsamı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_persistent
incognito_persistent kapsamında belirlenen ayarlar yalnızca gizli pencereler için geçerlidir. Bu durumlarda regular ayarları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_only
incognito_session_only kapsamında belirlenen ayarlar yalnızca gizli pencereler için geçerlidir. Bu durumlarda regular ve incognito_persistent ayarları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.

  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ğı ü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.

Yukarıda açıklandığı 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.addListener işlevi şu şekildedir: 

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

    • callback

      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 özgü olup olmadığı. Bu özellik yalnızca kullanıcı uzantıyı gizli modda etkinleştirdiyse mevcut olur.

        • levelOfControl

          LevelOfControl

          Ayarın kontrol seviyesi.

        • value

          T

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

  • temizle

    geçersiz

    Taahhüt

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

    clear işlevi şu şekildedir: 

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

    • ayrıntılar

      nesne

      Temizlenecek ayar.

      • kapsam

        ChromeSettingScope isteğe bağlı

        Ayarın temizleneceği yer (varsayılan: normal).

    • callback

      function isteğe bağlı

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

      () => void

    • returns

      Promise<void>

      Chrome 96+

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

      Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

  • get

    geçersiz

    Taahhüt

    Bir ayarın değerini alır.

    get işlevi şu şekildedir: 

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

    • 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).

    • callback

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

          Geçerli değerin gizli oturuma özel olup olmadığı. Bu özellik yalnızca get() parametresinin details parametresindeki incognito özelliği doğruysa mevcut olur.

        • levelOfControl

          LevelOfControl

          Ayarın kontrol seviyesi.

        • value

          T

          Ayarın değeri.

    • returns

      Promise<object>

      Chrome 96+

      Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

  • grup

    geçersiz

    Taahhüt

    Bir ayarın değerini belirler.

    set işlevi şu şekildedir: 

    (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. Uzantılar farklı türde bir değer ayarlamamalıdır.

    • callback

      function isteğe bağlı

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

      () => void

    • returns

      Promise<void>

      Chrome 96+

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

      Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

ChromeSettingScope

Chrome 44+

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

Chrome 44+

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