chrome.privacy

Beschrijving

Gebruik de chrome.privacy API om het gebruik van de functies in Chrome te beheren die van invloed kunnen zijn op de privacy van een gebruiker. Deze API is afhankelijk van het ChromeSetting-prototype van het type API voor het ophalen en instellen van de Chrome-configuratie.

Machtigingen

privacy

Manifest

U moet de 'privacy'-toestemming in het manifest van uw extensie aangeven om de API te kunnen gebruiken. Bijvoorbeeld: 

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

Gebruik

Het lezen van de huidige waarde van een Chrome-instelling is eenvoudig. U moet eerst de eigenschap vinden waarin u geïnteresseerd bent, en vervolgens get() aanroepen voor dat object om de huidige waarde en het controleniveau van uw extensie op te halen. Om bijvoorbeeld te bepalen of de functie Automatisch aanvullen van Chrome is ingeschakeld, schrijft u het volgende:

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

Het wijzigen van de waarde van een instelling is iets ingewikkelder, simpelweg omdat u eerst moet verifiëren dat uw extensie de instelling kan beheren. De gebruiker ziet geen enkele wijziging in de instellingen als uw extensie een instelling omschakelt die ofwel is vergrendeld op een specifieke waarde door bedrijfsbeleid ( levelOfControl wordt ingesteld op "not_controllable"), of als een andere extensie de waarde beheert ( levelOfControl zal worden ingesteld op "gecontroleerd_door_andere_extensies"). De set() -aanroep zal slagen, maar de instelling zal onmiddellijk worden overschreven. Omdat dit verwarrend kan zijn, is het raadzaam de gebruiker te waarschuwen wanneer de door hem gekozen instellingen in de praktijk niet worden toegepast.

Dit betekent dat u de methode get() moet gebruiken om uw toegangsniveau te bepalen, en dan alleen set() moet aanroepen als uw extensie de controle over de instelling kan overnemen (als uw extensie de instelling niet kan controleren, is dit waarschijnlijk een goed idee om de functionaliteit visueel uit te schakelen om verwarring bij de gebruiker te verminderen):

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

Als u geïnteresseerd bent in wijzigingen in de waarde van een instelling, voegt u een luisteraar toe aan de onChange gebeurtenis ervan. Hiermee kunt u onder andere de gebruiker waarschuwen als een recenter geïnstalleerde extensie de controle over een instelling overneemt, of als het bedrijfsbeleid uw controle overschrijft. Om bijvoorbeeld te luisteren naar wijzigingen in de status van Automatisch aanvullen, zou de volgende code voldoende zijn: 

chrome.privacy.services.autofillEnabled.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.
  }
);

Voorbeelden

Om deze API te proberen, installeert u het privacy-API-voorbeeld uit de chrome-extension-samples- repository.

Soorten

IPHandlingPolicy

Chroom 48+

Het IP-verwerkingsbeleid van WebRTC.

Enum

"standaard"

"standaard_openbare_en_privé_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

Eigenschappen

network

Instellingen die van invloed zijn op de manier waarop Chrome omgaat met netwerkverbindingen in het algemeen.

Type

voorwerp

Eigenschappen

  • netwerkPredictionEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, probeert Chrome uw surfervaring op het internet te versnellen door DNS-gegevens vooraf om te zetten en preventief TCP- en SSL-verbindingen met servers te openen. Deze voorkeur heeft alleen invloed op acties die worden uitgevoerd door de interne voorspellingsservice van Chrome. Het heeft geen invloed op door webpagina's geïnitieerde prefectches of preconnects. De waarde van deze voorkeur is een boolean en is standaard true .

  • webRTCIPHandlingPolicy

    types.ChromeSetting <IPHandlingPolicy>

    Chroom 48+

    Sta gebruikers toe de afwegingen tussen mediaprestaties en privacy te specificeren die van invloed zijn op de manier waarop WebRTC-verkeer wordt gerouteerd en hoeveel lokale adresinformatie wordt vrijgegeven. De waarde van deze voorkeur is van het type IPHandlingPolicy, standaard ingesteld op default .

services

Instellingen die functies in- of uitschakelen waarvoor netwerkservices van derden nodig zijn, geleverd door Google en uw standaardzoekmachine.

Type

voorwerp

Eigenschappen

  • alternatieveErrorPagesEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, gebruikt Chrome een webservice om navigatiefouten te helpen oplossen. De waarde van deze voorkeur is een boolean en is standaard true .

  • autofillAddressEnabled

    types.ChromeSetting <boolean>

    Chroom 70+

    Indien ingeschakeld, biedt Chrome aan om adressen en andere formuliergegevens automatisch in te vullen. De waarde van deze voorkeur is een boolean en is standaard true .

  • autofillCreditCardEnabled

    types.ChromeSetting <boolean>

    Chroom 70+

    Indien ingeschakeld, biedt Chrome aan om automatisch creditcardformulieren in te vullen. De waarde van deze voorkeur is een boolean en is standaard true .

  • automatisch aanvullenIngeschakeld

    types.ChromeSetting <boolean>

    Verouderd sinds Chrome 70

    Gebruik privacy.services.autofillAddressEnabled en privacy.services.autofillCreditCardEnabled. Dit blijft voor achterwaartse compatibiliteit in deze release en zal in de toekomst worden verwijderd.

    Indien ingeschakeld, biedt Chrome aan om formulieren automatisch in te vullen. De waarde van deze voorkeur is een boolean en is standaard true .

  • wachtwoordOpslaanEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, zal de wachtwoordbeheerder vragen of u wachtwoorden wilt opslaan. De waarde van deze voorkeur is een boolean en is standaard true .

  • safeBrowsingEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, doet Chrome zijn best om u te beschermen tegen phishing en malware. De waarde van deze voorkeur is een boolean en is standaard true .

  • safeBrowsingExtendedReportingEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, stuurt Chrome aanvullende informatie naar Google wanneer SafeBrowsing een pagina blokkeert, zoals de inhoud van de geblokkeerde pagina. De waarde van deze voorkeur is een boolean en is standaard false .

  • zoekSuggestEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, verzendt Chrome de tekst die u in de omnibox typt naar uw standaardzoekmachine, die voorspellingen geeft van websites en zoekopdrachten die waarschijnlijk een aanvulling zijn op wat u tot nu toe heeft getypt. De waarde van deze voorkeur is een boolean en is standaard true .

  • spellingServiceEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, gebruikt Chrome een webservice om spelfouten te helpen corrigeren. De waarde van deze voorkeur is een boolean en is standaard false .

  • translationServiceIngeschakeld

    types.ChromeSetting <boolean>

    Indien ingeschakeld, biedt Chrome aan om pagina's te vertalen die niet zijn geschreven in de taal die u leest. De waarde van deze voorkeur is een boolean en is standaard true .

websites

Instellingen die bepalen welke informatie Chrome beschikbaar stelt aan websites.

Type

voorwerp

Eigenschappen

  • adMeasurementEnabled

    types.ChromeSetting <boolean>

    Chroom 111+

    Indien uitgeschakeld, zijn de Attribution Reporting API en Private Aggregation API gedeactiveerd. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true . Extensies kunnen deze API's alleen uitschakelen door de waarde in te stellen op false . Als u probeert deze API's in te stellen op true , zal er een fout optreden.

  • doNotTrackEnabled

    types.ChromeSetting <boolean>

    Chroom 65+

    Indien ingeschakeld, verzendt Chrome de header 'Do Not Track' ( DNT: 1 ) met uw verzoeken. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is false .

  • fledgeEnabled

    types.ChromeSetting <boolean>

    Chroom 111+

    Indien uitgeschakeld, is de Fledge API gedeactiveerd. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true . Extensies kunnen deze API alleen uitschakelen door de waarde in te stellen op false . Als u probeert deze API in te stellen op true , zal er een fout optreden.

  • hyperlinkAuditingEnabled

    types.ChromeSetting <boolean>

    Indien ingeschakeld, verzendt Chrome controlepings wanneer daarom wordt gevraagd door een website ( <a ping> ). De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true .

  • protectedContentEnabled

    types.ChromeSetting <boolean>

    Alleen beschikbaar op Windows en ChromeOS : Indien ingeschakeld, geeft Chrome een unieke ID aan plug-ins om beveiligde inhoud uit te voeren. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true .

  • verwijzingenIngeschakeld

    types.ChromeSetting <boolean>

    Indien ingeschakeld, verzendt Chrome referer headers met uw verzoeken. Ja, de naam van deze voorkeur komt niet overeen met de verkeerd gespelde koptekst. Nee, we gaan het niet veranderen. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true .

  • gerelateerdeWebsiteSetsEnabled

    types.ChromeSetting <boolean>

    Chroom 121+

    Indien uitgeschakeld, zijn Gerelateerde websitesets gedeactiveerd. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true . Extensies kunnen deze API alleen uitschakelen door de waarde in te stellen op false . Als u probeert deze API in te stellen op true , zal er een fout optreden.

  • thirdPartyCookiesToegestaan

    types.ChromeSetting <boolean>

    Indien uitgeschakeld, blokkeert Chrome sites van derden om cookies in te stellen. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true .

  • onderwerpenIngeschakeld

    types.ChromeSetting <boolean>

    Chroom 111+

    Indien uitgeschakeld, is de Topics API gedeactiveerd. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true . Extensies kunnen deze API alleen uitschakelen door de waarde in te stellen op false . Als u probeert deze API in te stellen op true , zal er een fout optreden.