Chrome ondersteunt nu de gestandaardiseerde browser.* -naamruimte (beschikbaar vanaf Chrome 148). We werken de documentatie geleidelijk bij. Lees meer in onze overgangshandleiding .

Deze pagina is vertaald door de Cloud Translation API.

chrome.privacy

Beschrijving

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

Toestemmingen

privacy

Om de API te kunnen gebruiken, moet u de "privacy"-toestemming in het manifest van uw extensie declareren. Bijvoorbeeld:

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

Concepten en gebruik

Het uitlezen van de huidige waarde van een Chrome-instelling is eenvoudig. Je moet eerst de eigenschap vinden waarin je geïnteresseerd bent, en vervolgens roep je de get() -methode aan op dat object om de huidige waarde en het controleniveau van je extensie op te halen. Om bijvoorbeeld te bepalen of de automatische invulfunctie voor creditcardgegevens in Chrome is ingeschakeld, schrijf je het volgende:

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

Changing the value of a setting is a little bit more complex, because you first must verify that your extension can control the setting. The user won't see any change to their settings if your extension toggles a setting that is either locked to a specific value by enterprise policies ( levelOfControl will be set to "not_controllable"), or if another extension is controlling the value ( levelOfControl will be set to "controlled_by_other_extensions"). The set() call will succeed, but the setting will be immediately overridden. As this might be confusing, it is advisable to warn the user when the settings they've chosen aren't practically applied.

Opmerking: Volledige details over de mogelijkheid van extensies om ChromeSetting te beheren, zijn te vinden onder chrome.types.ChromeSetting .

Dit betekent dat je de get() -methode moet gebruiken om je toegangsniveau te bepalen, en vervolgens alleen set() moet aanroepen als je extensie de instelling kan beheren (sterker nog, als je extensie de instelling niet kan beheren, is het waarschijnlijk een goed idee om de functie visueel uit te schakelen om verwarring bij de gebruiker te voorkomen):

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);
      }
    });
  }
});

Als u geïnteresseerd bent in wijzigingen in de waarde van een instelling, voeg dan een listener toe aan de onChange gebeurtenis. Dit stelt u onder andere in staat om de gebruiker te waarschuwen als een recent 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 het automatisch invullen van creditcardgegevens, volstaat de volgende code:

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.
  }
);

Voorbeelden

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

Soorten

AutofillBlockedType

Chrome 151+

Categorieën van automatisch invulgegevens.

Enum

"contact_info"

"betalingen"

"identity_docs"

"reis"

"alle"

IPHandlingPolicy

Chrome 48+

Het IP-adresbeleid van WebRTC.

Enum

"standaard"

"standaard_openbare_en_privé_interfaces"

"standaard_openbare_interface_alleen"

"disable_non_proxied_udp"

Eigenschappen

network

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

Type

voorwerp

Eigenschappen

netwerkvoorspelling ingeschakeld
types.ChromeSetting <boolean>
If enabled, Chrome attempts to speed up your web browsing experience by pre-resolving DNS entries, preemptively opening TCP and SSL connections to servers, and preloading pages. Disabling this preference overrides site owners' ability to speculatively load content (such as prefetching or prerendering via the Speculation Rules API ). It does not affect webpage-initiated preconnects or DNS prefetches. This preference's value is a boolean, defaulting to true .
webRTCIPHandlingPolicy
types.ChromeSetting < IPHandlingPolicy >
Chrome 48+
Hiermee kunnen gebruikers de afwegingen tussen mediaprestaties en privacy specificeren die van invloed zijn op hoe WebRTC-verkeer wordt gerouteerd en hoeveel lokale adresinformatie wordt blootgesteld. De waarde van deze voorkeur is van het type IPHandlingPolicy, met als default .

services

Instellingen waarmee u functies kunt in- of uitschakelen die gebruikmaken van netwerkdiensten van derden, geleverd door Google en uw standaardzoekprovider.

Type

voorwerp

Eigenschappen

alternateErrorPagesEnabled
types.ChromeSetting <boolean>
Indien ingeschakeld, gebruikt Chrome een webservice om navigatiefouten op te lossen. De waarde van deze voorkeur is een boolean, met als standaardwaarde true .
automatisch invullen van adres ingeschakeld
types.ChromeSetting <boolean>
Chrome 70+
Indien ingeschakeld, biedt Chrome aan om adressen en andere formuliergegevens automatisch in te vullen. De waarde van deze voorkeur is een boolean, met als standaardwaarde true .
automatisch invullenCreditCardIngeschakeld
types.ChromeSetting <boolean>
Chrome 70+
Indien ingeschakeld, biedt Chrome aan om creditcardformulieren automatisch in te vullen. De waarde van deze voorkeur is een boolean, met als standaardwaarde ' true .
automatisch invullen ingeschakeld
types.ChromeSetting <boolean>
Niet meer bruikbaar sinds Chrome 70.
Gebruik alstublieft privacy.services.autofillAddressEnabled en privacy.services.autofillCreditCardEnabled. Deze instellingen zijn in deze release behouden voor achterwaartse compatibiliteit en zullen in de toekomst worden verwijderd.
Indien ingeschakeld, biedt Chrome aan om formulieren automatisch in te vullen. De waarde van deze voorkeur is een boolean, met als standaardwaarde true .
wachtwoordopslag ingeschakeld
types.ChromeSetting <boolean>
Indien ingeschakeld, zal de wachtwoordmanager vragen of u wachtwoorden wilt opslaan. De waarde van deze voorkeur is een boolean, met als standaardwaarde ' true .
veilig browsen ingeschakeld
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, met de standaardwaarde ' true .
safeBrowsingExtendedReportingEnabled
types.ChromeSetting <boolean>
Indien ingeschakeld, stuurt Chrome extra informatie naar Google wanneer SafeBrowsing een pagina blokkeert, zoals de inhoud van de geblokkeerde pagina. De waarde van deze voorkeur is een boolean, met een standaardwaarde van false .
zoeksuggestie ingeschakeld
types.ChromeSetting <boolean>
Indien ingeschakeld, stuurt Chrome de tekst die u in de Omnibox typt naar uw standaard zoekmachine. Deze zoekmachine geeft vervolgens suggesties voor websites en zoekopdrachten die waarschijnlijk een aanvulling zijn op wat u tot nu toe hebt getypt. De waarde van deze voorkeur is een boolean, met de standaardwaarde ' true .
spellingServiceEnabled
types.ChromeSetting <boolean>
Indien ingeschakeld, gebruikt Chrome een webservice om spelfouten te corrigeren. De waarde van deze voorkeur is een boolean, met als standaardwaarde false .
translationServiceEnabled
types.ChromeSetting <boolean>
Indien ingeschakeld, biedt Chrome aan om pagina's te vertalen die niet in een door u gelezen taal zijn. De waarde van deze voorkeur is een boolean, met als standaardwaarde true .

websites

Instellingen die bepalen welke informatie Chrome beschikbaar stelt aan websites.

Type

voorwerp

Eigenschappen

adMeasurementEnabled
types.ChromeSetting <boolean>
Chrome 111+
Indien uitgeschakeld, worden de Attribution Reporting API en de 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 op false in te stellen. Als u probeert deze API's op true in te stellen, wordt er een foutmelding gegenereerd.
doNotTrackEnabled
types.ChromeSetting <boolean>
Chrome 65+
Indien ingeschakeld, stuurt Chrome de header 'Do Not Track' ( DNT: 1 ) mee met uw verzoeken. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is false .
fledgeEnabled
types.ChromeSetting <boolean>
Chrome 111+
Als deze optie is uitgeschakeld, wordt 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 op false in te stellen. Als u probeert deze API op true in te stellen, wordt er een foutmelding gegenereerd.
hyperlinkAuditingEnabled
types.ChromeSetting <boolean>
Indien ingeschakeld, verzendt Chrome controlepings wanneer een website daarom vraagt ( <a ping> 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, kent Chrome een unieke ID toe aan plug-ins om beveiligde inhoud te kunnen uitvoeren. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true .
verwijzers ingeschakeld
types.ChromeSetting <boolean>
Indien ingeschakeld, stuurt Chrome referer headers mee met uw verzoeken. Ja, de naam van deze voorkeur komt niet overeen met de verkeerd gespelde header. Nee, we gaan deze niet wijzigen. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true .
Cookies van derden toegestaan
types.ChromeSetting <boolean>
Indien uitgeschakeld, voorkomt Chrome dat websites van derden cookies plaatsen. De waarde van deze voorkeur is van het type boolean en de standaardwaarde is true . Extensies kunnen deze API niet inschakelen in de incognitomodus, waar cookies van derden worden geblokkeerd en alleen op siteniveau kunnen worden toegestaan. Als u deze API in de incognitomodus op true probeert in te stellen, krijgt u een foutmelding.
Let op: Individuele sites kunnen mogelijk nog steeds toegang krijgen tot cookies van derden, zelfs als deze API false retourneert, als ze een geldige uitzondering hebben of in plaats daarvan de Storage Access API gebruiken.
onderwerpenIngeschakeld
types.ChromeSetting <boolean>
Chrome 111+
Als deze optie is uitgeschakeld, wordt 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 op false in te stellen. Als u probeert deze API op true in te stellen, wordt er een foutmelding gegenereerd.

chrome.privacy Stay organized with collections Save and categorize content based on your preferences.

Beschrijving

Toestemmingen

Concepten en gebruik

Voorbeelden

Soorten

AutofillBlockedType

Enum

IPHandlingPolicy

Enum

Eigenschappen

network

Type

Eigenschappen

services

Type

Eigenschappen

websites

Type

Eigenschappen

chrome.privacy