chrome.privacy

Açıklama

Chrome'da kullanıcı gizliliğini etkileyebilecek özelliklerin kullanımını kontrol etmek için chrome.privacy API'yi kullanın. Bu API, Chrome'un yapılandırmasını almak ve ayarlamak için API türünün ChromeSetting prototipini kullanır.

İzinler

privacy

"Gizlilik" uzantınızın manifest'inde API'yi kullanma izni olduğundan emin olun. Örneğin:

{
  "name": "My extension",
  ...
  "permissions": [
    "privacy"
  ],
  ...
}

Kavramlar ve kullanım

Bir Chrome ayarının geçerli değerini okumak oldukça kolaydır. İlk olarak yapmanız gereken çağırırsanız ilgili nesnede get() yöntemini çağırarak bu öğenin ve uzantınızın kontrol düzeyini kontrol edebilirsiniz. Örneğin, Chrome'un kredi kartı otomatik doldurma özelliğinin özelliği etkinleştirildiğinde şunları yazabilirsiniz:

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.value) {
    console.log('Autofill is on!');
  } else {
    console.log('Autofill is off!');
  }
});

Bir ayarın değerini değiştirmek biraz daha karmaşıktır, çünkü önce uzantınızın ayarı kontrol edebilmesini sağlar. Aşağıdaki durumlarda kullanıcı ayarlarında herhangi bir değişiklik olmaz. uzantısı, kurumsal politikalar tarafından belirli bir değere kilitlenen bir ayarı açar/kapatır (levelOfControl "not_controllable" olarak ayarlanır) veya değeri (levelOfControl "controlled_by_other_extensions" olarak ayarlanır). set() görüşmesinde başarılı olur, ancak ayar hemen geçersiz kılınır. Kafa karıştırıcı olabileceğinden, uyarlayarak kullanıcıyı uyarmasını sağlayabilirsiniz.

Bu durumda, erişim düzeyinizi belirlemek için get() yöntemini kullanmanız ve sonrasında yalnızca Uzantınız ayarı kontrol edebiliyorsa set() komutunu çağırın (aslında uzantınız ayarı kontrol edin. Kullanıcı sayısını azaltmak için bu özelliği görsel olarak devre dışı konfüzyon):

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
      if (chrome.runtime.lastError === undefined) {
        console.log("Hooray, it worked!");
      } else {
        console.log("Sadness!", chrome.runtime.lastError);
      }
    });
  }
});

Bir ayarın değerinde değişiklik yapmak istiyorsanız ilgili onChange etkinliğine bir işleyici ekleyin. Arasında Bu şekilde, daha yeni yüklenen bir uzantı yakalanırsa kullanıcıyı uyarabilirsiniz olup olmadığını veya kurumsal politikanın sizin denetiminizi geçersiz kılıp kılmadığını öğrenebilirsiniz. Şu öğede yapılan değişiklikleri dinlemek için: kredi kartı otomatik doldurma durumu, örneğin, aşağıdaki kod yeterlidir:

chrome.privacy.services.autofillCreditCardEnabled.onChange.addListener(
  function (details) {
    // The new value is stored in `details.value`, the new level of control
    // in `details.levelOfControl`, and `details.incognitoSpecific` will be
    // `true` if the value is specific to Incognito mode.
  }
);

Örnekler

Bu API'yi denemek için chrome-extension-samples bölümünden gizlilik API'si örneğini yükleyin. depodur.

Türler

IPHandlingPolicy

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

WebRTC'nin IP işleme politikası.

Enum

"default"

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

Özellikler

network

Chrome'un genel olarak ağ bağlantılarını işlemesini etkileyen ayarlar.

Tür

nesne

Özellikler

  • networkPredictionEnabled

    types.ChromeSetting<boolean>

    Etkinleştirilirse Chrome, DNS girişlerini önceden çözümleyerek ve önceden TCP ve SSL bağlantılarını sunuculara açarak web'e göz atma deneyiminizi hızlandırmaya çalışır. Bu tercih yalnızca Chrome'un dahili tahmin hizmeti tarafından gerçekleştirilen işlemleri etkiler. Web sayfası tarafından başlatılan idari yerleri veya önceden bağlantıları etkilemez. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • webRTCIPHandlingPolicy

    types.ChromeSetting<IPHandlingPolicy>

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

    Kullanıcıların, WebRTC trafiğinin nasıl yönlendirileceğini ve ne kadar yerel adres bilgisinin gösterileceğini etkileyen medya performansı/gizlilik dengelerini belirtmesine izin ver. Bu tercihin değeri, varsayılan olarak default değerine ayarlanan IPprocessingPolicy türündedir.

services

Google ve varsayılan arama sağlayıcınız tarafından sağlanan üçüncü taraf ağ hizmetlerini gerektiren özellikleri etkinleştiren veya devre dışı bırakan ayarlar.

Tür

nesne

Özellikler

  • alternateErrorPagesEnabled

    types.ChromeSetting<boolean>

    Etkinleştirilirse Chrome, gezinme hatalarının çözülmesine yardımcı olmak için bir web hizmeti kullanır. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • autofillAddressEnabled

    types.ChromeSetting<boolean>

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

    Etkinleştirilirse Chrome, adresleri ve diğer form verilerini otomatik olarak doldurmayı teklif eder. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • autofillCreditCardEnabled

    types.ChromeSetting<boolean>

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

    Etkinleştirilirse Chrome, kredi kartı formlarını otomatik olarak doldurmayı teklif eder. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • autofillEnabled

    types.ChromeSetting<boolean>

    Chrome 70'ten bu yana desteği sonlandırıldı

    Lütfen privacy.services.autofillAddressEnabled ve privacy.services.autofillCreditCardEnabled kullanın. Bu ayar, bu sürümde geriye dönük uyumluluk için kullanılmaya devam eder ve gelecekte kaldırılacaktır.

    Etkinleştirilirse Chrome, formları otomatik olarak doldurmayı teklif eder. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • passwordSavingEnabled

    types.ChromeSetting<boolean>

    Bu ayar etkinleştirilirse şifre yöneticisi, şifreleri kaydetmek isteyip istemediğinizi sorar. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • safeBrowsingEnabled

    types.ChromeSetting<boolean>

    Etkinleştirilirse Chrome, sizi kimlik avına ve kötü amaçlı yazılımlara karşı korumak için elinden geleni yapar. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • safeBrowsingExtendedReportingEnabled

    types.ChromeSetting<boolean>

    Etkinleştirilirse, Güvenli Tarama bir sayfayı engellediğinde Chrome, engellenen sayfanın içeriği gibi ek bilgileri Google'a gönderir. Bu tercihin değeri, varsayılan olarak false değerine ayarlanan bir boole değeridir.

  • searchSuggestEnabled

    types.ChromeSetting<boolean>

    Bu ayar etkinleştirilirse Chrome, Çok Amaçlı Adres Çubuğu'na yazdığınız metni varsayılan arama motorunuza gönderir ve arama motoru, o ana kadar yazdıklarınızın tamamlanmış olması muhtemel web sitesi ve arama tahminlerini sunar. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

  • spellingServiceEnabled

    types.ChromeSetting<boolean>

    Etkinleştirilirse Chrome, yazım hatalarının düzeltilmesine yardımcı olmak için bir web hizmeti kullanır. Bu tercihin değeri, varsayılan olarak false değerine ayarlanan bir boole değeridir.

  • translationServiceEnabled

    types.ChromeSetting<boolean>

    Bu ayar etkinleştirilirse Chrome, okuduğum dilde olmayan sayfaları çevirmeyi önerir. Bu tercihin değeri, varsayılan olarak true değerine ayarlanan bir boole değeridir.

websites

Chrome'un web sitelerinde hangi bilgileri kullanabileceğini belirleyen ayarlar.

Tür

nesne

Özellikler

  • adMeasurementEnabled

    types.ChromeSetting<boolean>

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

    Devre dışı bırakılırsa Attribution Reporting API ve Private Aggregation API devre dışı bırakılır. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir. Uzantılar, bu API'leri yalnızca değeri false olarak ayarlayarak devre dışı bırakabilir. Bu API'leri true olarak ayarlamayı denerseniz hata mesajı alırsınız.

  • doNotTrackEnabled

    types.ChromeSetting<boolean>

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

    Etkinleştirilirse Chrome, "Do Not Track" değerini gönderir (DNT: 1) üstbilgisine ekleyin. Bu tercihin değeri boole türünde, varsayılan değer ise false şeklindedir.

  • fledgeEnabled

    types.ChromeSetting<boolean>

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

    Fledge API, devre dışı bırakılırsa devre dışı bırakılır. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir. Uzantılar, bu API'yi yalnızca değeri false olarak ayarlayarak devre dışı bırakabilir. Bu API'yi true olarak ayarlamayı denerseniz hata mesajı alırsınız.

  • hyperlinkAuditingEnabled

    types.ChromeSetting<boolean>

    Bu ayar etkinleştirilirse Chrome, bir web sitesi (<a ping>) tarafından istendiğinde denetleme ping'leri gönderir. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir.

  • protectedContentEnabled

    types.ChromeSetting&lt;boolean&gt;

    Yalnızca Windows ve ChromeOS'te kullanılabilir: Etkinleştirildiğinde, Chrome korumalı içeriği çalıştırmak için eklentilere benzersiz bir kimlik sağlar. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir.

  • referrersEnabled

    types.ChromeSetting&lt;boolean&gt;

    Etkinleştirildiğinde Chrome, isteklerinizle birlikte referer üstbilgileri gönderir. Evet, bu tercihin adı, yanlış yazılmış başlıkla eşleşmiyor. Hayır, bu durumu değiştirmeyeceğiz. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir.

  • relatedWebsiteSetsEnabled

    types.ChromeSetting&lt;boolean&gt;

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

    İlgili Web Sitesi Grupları devre dışı bırakılırsa devre dışı bırakılır. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir. Uzantılar, bu API'yi yalnızca değeri false olarak ayarlayarak devre dışı bırakabilir. Bu API'yi true olarak ayarlamayı denerseniz hata mesajı alırsınız.

  • thirdPartyCookiesAllowed

    types.ChromeSetting&lt;boolean&gt;

    Devre dışı bırakılırsa Chrome, üçüncü taraf sitelerin çerez ayarlamasını engeller. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir.

  • topicsEnabled

    types.ChromeSetting&lt;boolean&gt;

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

    Topics API devre dışı bırakılırsa devre dışı bırakılır. Bu tercihin değeri boole türünde, varsayılan değer ise true şeklindedir. Uzantılar, bu API'yi yalnızca değeri false olarak ayarlayarak devre dışı bırakabilir. Bu API'yi true olarak ayarlamayı denerseniz hata mesajı alırsınız.