chrome.privacy

Beschrijving

Gebruik de chrome.privacy API om het gebruik van Chrome-functies te beheren 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.

Machtigingen

privacy

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

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

Begrippen en gebruik

Het uitlezen van de huidige waarde van een Chrome-instelling is eenvoudig. Eerst moet u de gewenste eigenschap vinden en vervolgens roept u get() aan op dat object om de huidige waarde en het controleniveau van uw extensie op te halen. Om bijvoorbeeld te bepalen of de functie voor automatisch invullen van creditcardgegevens in Chrome is ingeschakeld, schrijft u:

chrome.privacy.services.autofillCreditCardEnabled.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 complexer, omdat u eerst moet verifiëren of uw extensie de instelling kan beheren. De gebruiker ziet geen wijziging in zijn of haar instellingen als uw extensie een instelling in- of uitschakelt die is vergrendeld op een specifieke waarde door het 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 slaagt, maar de instelling wordt onmiddellijk overschreven. Omdat dit verwarrend kan zijn, is het raadzaam de gebruiker te waarschuwen wanneer de gekozen instellingen niet in de praktijk worden toegepast.

Dit betekent dat u de get() -methode moet gebruiken om uw toegangsniveau te bepalen, en vervolgens set() alleen moet aanroepen als uw extensie de controle over de instelling kan overnemen (sterker nog, als uw 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, voegt u een listener toe aan de onChange -gebeurtenis. Dit stelt u onder andere in staat om de gebruiker te 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 het automatisch invullen van creditcards, is de volgende code voldoende:

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, installeert u het privacy API-voorbeeld uit de chrome-extension-samples repository.

Typen

IPHandlingPolicy

Chroom 48+

Het IP-verwerkingsbeleid van WebRTC.

Enum

"standaard"

"standaard_openbare_en_private_interfaces"

"standaard_openbare_interface_alleen"

"niet-geproxyde_udp_uitschakelen"

Eigenschappen

network

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

Type

voorwerp

Eigenschappen

  • netwerkPredictionEnabled

    typen.ChromeSetting <boolean>

    Indien ingeschakeld, probeert Chrome uw surfervaring te versnellen door DNS-vermeldingen vooraf op te lossen en preventief TCP- en SSL-verbindingen met servers te openen. Deze voorkeur is alleen van 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 Booleaanse waarde, standaard ingesteld op true .

  • webRTCIP-verwerkingsbeleid

    typen.ChromeSetting < IPHandlingPolicy >

    Chroom 48+

    Hiermee kunnen gebruikers de afwegingen tussen mediaprestaties en privacy specificeren die van invloed zijn op de routering van WebRTC-verkeer en de hoeveelheid lokale adresinformatie die wordt vrijgegeven. De waarde van deze voorkeur is van het type IPHandlingPolicy, standaard ingesteld op default .

services

Instellingen waarmee u functies kunt in- of uitschakelen waarvoor externe netwerkservices van Google en uw standaardzoekmachine vereist zijn.

Type

voorwerp

Eigenschappen

  • alternateErrorPagesEnabled

    typen.ChromeSetting <boolean>

    Indien ingeschakeld, gebruikt Chrome een webservice om navigatiefouten op te lossen. De waarde van deze voorkeur is een Booleaanse waarde, standaard ingesteld op true .

  • autofillAdresIngeschakeld

    typen.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 Booleaanse waarde, standaard ingesteld op true .

  • automatisch invullenCreditCardEnabled

    typen.ChromeSetting <boolean>

    Chroom 70+

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

  • automatisch invullen ingeschakeld

    typen.ChromeSetting <boolean>

    Verouderd sinds Chrome 70

    Gebruik privacy.services.autofillAddressEnabled en privacy.services.autofillCreditCardEnabled. Deze functionaliteit blijft in deze release aanwezig vanwege achterwaartse compatibiliteit en wordt in de toekomst verwijderd.

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

  • wachtwoordOpslaanIngeschakeld

    typen.ChromeSetting <boolean>

    Indien ingeschakeld, vraagt ​​de wachtwoordbeheerder of u wachtwoorden wilt opslaan. De waarde van deze voorkeur is een booleaanse waarde, standaard ingesteld op true .

  • veiligBrowsenIngeschakeld

    typen.ChromeSetting <boolean>

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

  • safeBrowsingExtendedReportingIngeschakeld

    typen.ChromeSetting <boolean>

    Indien ingeschakeld, stuurt Chrome aanvullende informatie naar Google wanneer Safe Browsing een pagina blokkeert, zoals de inhoud van de geblokkeerde pagina. De waarde van deze voorkeur is een booleaanse waarde, standaard ingesteld op false .

  • zoekenSuggestieIngeschakeld

    typen.ChromeSetting <boolean>

    Indien ingeschakeld, stuurt Chrome de tekst die u in de omnibox typt naar uw standaardzoekmachine. Deze zoekmachine geeft voorspellingen over websites en zoekopdrachten die waarschijnlijk een aanvulling zijn op wat u tot nu toe hebt getypt. De waarde van deze voorkeur is een Booleaanse waarde, standaard ingesteld op true .

  • spellingServiceEnabled

    typen.ChromeSetting <boolean>

    Indien ingeschakeld, gebruikt Chrome een webservice om spelfouten te corrigeren. De waarde van deze voorkeur is een Booleaanse waarde, standaard ingesteld op false .

  • vertalingServiceEnabled

    typen.ChromeSetting <boolean>

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

websites

Instellingen die bepalen welke informatie Chrome beschikbaar maakt voor websites.

Type

voorwerp

Eigenschappen

  • adMeasurementEnabled

    typen.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 , treedt er een foutmelding op.

  • doNotTrackEnabled

    typen.ChromeSetting <boolean>

    Chroom 65+

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

  • fledgeEnabled

    typen.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 , genereert dit een foutmelding.

  • hyperlinkAuditingEnabled

    typen.ChromeSetting <boolean>

    Als deze optie is ingeschakeld, verstuurt Chrome auditpings wanneer een website hierom vraagt ​​( <a ping> ). De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true .

  • beschermdeinhoud ingeschakeld

    typen.ChromeSetting <boolean>

    Alleen beschikbaar op Windows en ChromeOS : indien ingeschakeld, 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 .

  • referrersIngeschakeld

    typen.ChromeSetting <boolean>

    Indien ingeschakeld, stuurt Chrome referer 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 .

  • gerelateerdeWebsiteSetsIngeschakeld

    typen.ChromeSetting <boolean>

    Chroom 121+

    Indien uitgeschakeld, worden Gerelateerde Website Sets gedeactiveerd. De waarde van deze voorkeur is van het type Booleaans 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 , genereert dit een foutmelding.

  • Cookies van derden toegestaan

    typen.ChromeSetting <boolean>

    Als deze optie is uitgeschakeld, blokkeert Chrome het plaatsen van cookies door websites van derden. De waarde van deze voorkeur is van het type Booleaans en de standaardwaarde is true . Extensies schakelen deze API mogelijk niet in in de incognitomodus, waarin cookies van derden worden geblokkeerd en alleen op siteniveau kunnen worden toegestaan. Als u probeert deze API in te stellen op true in de incognitomodus, treedt er een foutmelding op.

    Let op: als deze API false retourneert, kunnen afzonderlijke sites mogelijk nog steeds toegang krijgen tot cookies van derden. Dit kan alleen als ze een geldige vrijstelling hebben of als ze de Storage Access API gebruiken.

  • onderwerpenIngeschakeld

    typen.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 , genereert dit een foutmelding.