chrome.privacy

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.privacy API om het gebruik van de functies in Chrome te beheren die de privacy van een gebruiker kunnen beïnvloeden. Deze API is afhankelijk van het ChromeSetting-prototype van de type-API om de configuratie van Chrome op te halen en in te stellen.

Rechten

privacy

Manifest

Je moet het recht Privacy definiëren in het manifest van je extensie om de API te gebruiken. Voorbeeld:

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

Gebruik

De huidige waarde van een Chrome-instelling lezen is eenvoudig. Zoek eerst de property waarin je geïnteresseerd bent en roep dan get() aan voor dat object om de huidige waarde en het controleniveau van je extensie op te halen. Als je bijvoorbeeld wilt bepalen of de functie Automatisch invullen van Chrome aanstaat, schrijf je:

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

De waarde van een instelling wijzigen is iets complexer, omdat je eerst moet verifiëren dat je extensie de instelling kan beheren. De gebruiker ziet geen wijziging in de instellingen als je extensie een instelling aan- of uitzet die is vergrendeld op een specifieke waarde door bedrijfsbeleid (levelOfControl wordt ingesteld op not_controllable) of als een andere extensie de waarde beheert (levelOfControl wordt ingesteld op controlled_by_other_extensions). De set()-aanroep lukt, maar de instelling wordt onmiddellijk overschreven. Omdat dit verwarrend kan zijn, is het raadzaam de gebruiker te waarschuwen als de gekozen instellingen niet worden toegepast.

Dit betekent dat je de methode get() moet gebruiken om je toegangsniveau te bepalen en daarna alleen set() moet aanroepen als je extensie de instelling kan beheren (als je extensie de instelling niet kan beheren, is het waarschijnlijk een goed idee om de functionaliteit visueel uit te zetten om verwarring bij gebruikers 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 je geïnteresseerd bent in wijzigingen in de waarde van een instelling, voeg je een listener toe aan de gebeurtenis onChange. Zo kun je de gebruiker bijvoorbeeld waarschuwen als een recenter geïnstalleerde extensie de controle over een instelling overneemt of als het bedrijfsbeleid je controle overschrijft. Als je wilt luisteren naar wijzigingen in de status van Automatisch invullen, is de volgende code bijvoorbeeld voldoende:

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

Als je deze API wilt proberen, installeer je het voorbeeld van de privacy-API uit de repository chrome-extension-samples.

Typen

AutofillBlockedType

Chrome 151+

Categorieën van gegevens voor automatisch invullen.

Enum

"contact_info"

"payments"

identity_docs

"travel"

"all"

IPHandlingPolicy

Chrome 48+

Het beleid voor IP-verwerking van WebRTC.

Enum

"default"

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

Eigenschappen

network

Instellingen die van invloed zijn op hoe Chrome netwerkverbindingen in het algemeen verwerkt.

Type

object

Eigenschappen

  • networkPredictionEnabled

    types.ChromeSetting<boolean>

    Als je dit beleid aanzet, probeert Chrome het browsen op internet te versnellen door DNS-vermeldingen vooraf op te lossen, TCP- en SSL-verbindingen met servers preventief te openen en pagina's vooraf te laden. Als je deze voorkeur uitzet, kunnen site-eigenaren geen content speculatief laden (zoals prefetching of prerendering via de Speculation Rules API). Dit heeft geen invloed op preconnects of DNS-prefetching die door webpagina's worden gestart. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • webRTCIPHandlingPolicy

    types.ChromeSetting<IPHandlingPolicy>

    Chrome 48+

    Gebruikers toestaan de afwegingen tussen mediaprestaties en privacy te specificeren die van invloed zijn op hoe WebRTC-verkeer wordt gerouteerd en hoeveel lokale adresgegevens worden getoond. De waarde van deze voorkeur is van het type IPHandlingPolicy, standaard ingesteld op default.

services

Instellingen waarmee je functies aan- of uitzet waarvoor netwerkservices van derden zijn vereist die worden geleverd door Google en je standaard zoekprovider.

Type

object

Eigenschappen

  • alternateErrorPagesEnabled

    types.ChromeSetting<boolean>

    Als je dit beleid aanzet, gebruikt Chrome een webservice om navigatiefouten op te lossen. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • autofillAddressEnabled

    types.ChromeSetting<boolean>

    Chrome 70+

    Als je dit aanzet, biedt Chrome aan om adressen en andere formuliergegevens automatisch in te vullen. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • autofillCreditCardEnabled

    types.ChromeSetting<boolean>

    Chrome 70+

    Als je dit beleid aanzet, biedt Chrome aan om creditcardformulieren automatisch in te vullen. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • autofillEnabled

    types.ChromeSetting<boolean>

    Beëindigd sinds Chrome 70

    Gebruik privacy.services.autofillAddressEnabled en privacy.services.autofillCreditCardEnabled. Deze blijft in deze release beschikbaar voor compatibiliteit met eerdere versies en wordt in de toekomst verwijderd.

    Als je dit beleid aanzet, biedt Chrome aan om formulieren automatisch in te vullen. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • passwordSavingEnabled

    types.ChromeSetting<boolean>

    Als je deze optie aanzet, vraagt de wachtwoordmanager of je wachtwoorden wilt opslaan. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • safeBrowsingEnabled

    types.ChromeSetting<boolean>

    Als deze optie aanstaat, doet Chrome zijn best om je te beschermen tegen phishing en malware. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • safeBrowsingExtendedReportingEnabled

    types.ChromeSetting<boolean>

    Als je dit aanzet, stuurt Chrome aanvullende informatie naar Google als Safe Browsing een pagina blokkeert, zoals de content van de geblokkeerde pagina. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op false.

  • searchSuggestEnabled

    types.ChromeSetting<boolean>

    Als je dit aanzet, stuurt Chrome de tekst die je in de omnibox typt naar je standaard zoekmachine. Deze biedt voorspellingen van websites en zoekopdrachten die waarschijnlijk aanvullingen zijn van wat je tot nu toe hebt getypt. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

  • spellingServiceEnabled

    types.ChromeSetting<boolean>

    Als je dit beleid aanzet, gebruikt Chrome een webservice om spelfouten te corrigeren. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op false.

  • translationServiceEnabled

    types.ChromeSetting<boolean>

    Als je deze functie aanzet, biedt Chrome aan om pagina's te vertalen die niet in een taal zijn die je leest. De waarde van deze voorkeur is een Booleaanse waarde, die standaard is ingesteld op true.

websites

Instellingen die bepalen welke informatie Chrome beschikbaar maakt voor websites.

Type

object

Eigenschappen

  • adMeasurementEnabled

    types.ChromeSetting<boolean>

    Chrome 111+

    Als je deze optie uitzet, worden de Attribution Reporting API en de Private Aggregation API gedeactiveerd. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true. Extensies kunnen deze API's alleen uitzetten door de waarde in te stellen op false. Als je deze API's probeert in te stellen op true, krijg je een foutmelding.

  • doNotTrackEnabled

    types.ChromeSetting<boolean>

    Chrome 65+

    Als je dit aanzet, stuurt Chrome de header Do Not Track (DNT: 1) mee met je verzoeken. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is false.

  • fledgeEnabled

    types.ChromeSetting<boolean>

    Chrome 111+

    Als je dit beleid niet toepast, wordt de Fledge API gedeactiveerd. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true. Extensies kunnen deze API alleen uitzetten door de waarde in te stellen op false. Als je deze API probeert in te stellen op true, krijg je een foutmelding.

  • hyperlinkAuditingEnabled

    types.ChromeSetting<boolean>

    Als dit beleid aanstaat, stuurt Chrome controlepings als een website hierom vraagt (<a ping>). De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true.

  • protectedContentEnabled

    types.ChromeSetting<boolean>

    Alleen beschikbaar in Windows en ChromeOS: Als deze optie aanstaat, geeft Chrome een unieke ID aan plug-ins om beveiligde content uit te voeren. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true.

  • referrersEnabled

    types.ChromeSetting<boolean>

    Als je dit aanzet, stuurt Chrome referer-headers met je verzoeken. Ja, de naam van deze voorkeur komt niet overeen met de verkeerd gespelde kop. Nee, we gaan het niet wijzigen. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true.

  • thirdPartyCookiesAllowed

    types.ChromeSetting<boolean>

    Als je dit beleid niet toepast, blokkeert Chrome dat sites van derden cookies instellen. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true. Extensies kunnen deze API misschien niet aanzetten in de incognitomodus, waar cookies van derden worden geblokkeerd en alleen op siteniveau kunnen worden toegestaan. Als je deze API probeert in te stellen op 'true' in de incognitomodus, wordt er een foutmelding weergegeven.

    Opmerking: Afzonderlijke sites hebben misschien nog steeds toegang tot cookies van derden als deze API false retourneert, als ze een geldige vrijstelling hebben of als ze in plaats daarvan de Storage Access API gebruiken.

  • topicsEnabled

    types.ChromeSetting<boolean>

    Chrome 111+

    Als je dit beleid uitzet, wordt de Topics API gedeactiveerd. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true. Extensies kunnen deze API alleen uitzetten door de waarde in te stellen op false. Als je deze API probeert in te stellen op true, krijg je een foutmelding.