Diese Seite wurde von der Cloud Translation API übersetzt.

chrome.privacy

Beschreibung

Mit der chrome.privacy API kannst du die Nutzung von Funktionen in Chrome steuern, die sich auf den Datenschutz für Nutzer auswirken können. Diese API basiert auf dem ChromeSetting-Prototyp des Typs API zum Abrufen und Festlegen der Chrome-Konfiguration.

Berechtigungen

privacy

Manifest

Sie müssen die „Datenschutz“ erklären im Manifest der Erweiterung die API verwenden. Beispiel:

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

Nutzung

Es ist ganz einfach, den aktuellen Wert einer Chrome-Einstellung abzulesen. Zunächst müssen Sie die Eigenschaft abrufen, rufen Sie get() für dieses Objekt auf, um seine und wie viel Kontrolle die Erweiterung hat. Um beispielsweise zu ermitteln, ob die Autofill-Funktion Funktion aktiviert ist, geben Sie Folgendes ein:

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

Das Ändern des Werts einer Einstellung ist etwas komplizierter. damit die Erweiterung die Einstellung steuern kann. Der Nutzer sieht keine Änderung an seinen Einstellungen, wenn Erweiterung schaltet eine Einstellung um, die entweder durch Unternehmensrichtlinien auf einen bestimmten Wert festgelegt ist (levelOfControl wird auf „not_controllable“) gesetzt oder wenn eine andere Erweiterung das Wert (levelOfControl wird auf "control_by_other_extensions" festgelegt.) Der set()-Aufruf führt aber die Einstellung wird sofort überschrieben. Da dies verwirrend sein kann, um den Nutzer zu warnen, wenn die von ihm gewählten Einstellungen nicht in der Praxis angewendet werden.

Hinweis:Weitere Informationen zu Erweiterungen Die Möglichkeit zur Steuerung von ChromeSetting finden Sie unter chrome.types.ChromeSetting

Sie sollten also die get()-Methode verwenden, um Ihre Zugriffsebene zu bestimmen, und dann nur Rufen Sie set() an, wenn die Erweiterung die Einstellung übernehmen kann. Einstellungen verwalten, empfiehlt es sich, die Funktion visuell zu deaktivieren, um Verwirrung):

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

Wenn Sie Änderungen am Wert einer Einstellung vornehmen möchten, fügen Sie dem zugehörigen onChange-Ereignis einen Listener hinzu. Unter kann der Nutzer gewarnt werden, wenn eine kürzlich installierte Erweiterung Kontrolle über eine Einstellung haben oder ob Unternehmensrichtlinien Ihre Kontrolle überschreiben. Um auf Änderungen zu warten, Für den Autofill-Status reicht beispielsweise der folgende Code aus:

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

Beispiele

Wenn Sie diese API ausprobieren möchten, installieren Sie das Privacy API-Beispiel aus chrome-extension-samples zu erstellen.

Typen

IPHandlingPolicy

Chrome (ab Version 48)

Die IP-Verarbeitungsrichtlinie von WebRTC.

Enum

„Standard“

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

Attribute

network

Einstellungen, die Einfluss darauf haben, wie Chrome Netzwerkverbindungen im Allgemeinen verarbeitet.

Typ

Objekt

Attribute

networkPredictionEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, versucht Chrome, das Surfen im Web zu beschleunigen, indem DNS-Einträge vorab aufgelöst und TCP- und SSL-Verbindungen zu Servern vorzeitig geöffnet werden. Diese Einstellung wirkt sich nur auf Aktionen der internen Vervollständigungsfunktion von Chrome aus. Sie hat keine Auswirkungen auf von Webseiten initiierte Präfekturen oder Preverbindungen. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
webRTCIPHandlingPolicy

types.ChromeSetting<IPHandlingPolicy>

Chrome (ab Version 48)

Nutzer können festlegen, welche Kompromisse bei der Medienleistung und beim Datenschutz eingehen sollen, was sich darauf auswirkt, wie WebRTC-Traffic weitergeleitet wird und wie viele lokale Adressinformationen offengelegt werden. Der Wert dieser Einstellung hat den Typ „IPHandlingPolicy“ und ist standardmäßig auf default festgelegt.

services

Einstellungen zum Aktivieren oder Deaktivieren von Funktionen, für die Drittanbieter-Werbenetzwerkdienste erforderlich sind, die von Google und Ihrem Standardsuchanbieter bereitgestellt werden.

Typ

Objekt

Attribute

alternateErrorPagesEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, verwendet Chrome einen Webdienst, um Navigationsfehler zu beheben. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
autofillAddressEnabled

types.ChromeSetting<boolean>

Chrome 70 oder höher

Wenn diese Option aktiviert ist, bietet Chrome an, Adressen und andere Formulardaten automatisch auszufüllen. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
autofillCreditCardEnabled

types.ChromeSetting<boolean>

Chrome 70 oder höher

Wenn diese Option aktiviert ist, bietet Chrome an, Kreditkartenformulare automatisch auszufüllen. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
autofillEnabled

types.ChromeSetting<boolean>

<ph type="x-smartling-placeholder"></ph> Seit Chrome 70 verworfen

Bitte verwende „privacy.services.autofillAddressEnabled“ und „privacy.services.autofillCreditCardEnabled“. Dies bleibt aus Gründen der Abwärtskompatibilität in dieser Version bestehen und wird in Zukunft entfernt.
Wenn diese Option aktiviert ist, bietet Chrome an, Formulare automatisch auszufüllen. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
passwordSavingEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, werden Sie vom Passwortmanager gefragt, ob Sie Passwörter speichern möchten. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
safeBrowsingEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, schützt Chrome Sie bestmöglich vor Phishing und Malware. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
safeBrowsingExtendedReportingEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, sendet Chrome zusätzliche Informationen an Google, wenn Safe Browsing eine Seite blockiert, z. B. den Inhalt der blockierten Seite. Der Wert dieser Einstellung ist ein boolescher Wert, der auf false eingestellt ist.
searchSuggestEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, sendet Chrome den von Ihnen in die Omnibox eingegebenen Text an Ihre Standardsuchmaschine. Diese schlägt Websites und Suchanfragen vor, die wahrscheinlich Ihren bisherigen Suchbegriffen vervollständigen. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.
spellingServiceEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, verwendet Chrome einen Webdienst, um Rechtschreibfehler zu korrigieren. Der Wert dieser Einstellung ist ein boolescher Wert, der auf false eingestellt ist.
translationServiceEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, bietet Chrome an, fremdsprachige Seiten zu übersetzen. Der Wert dieser Einstellung ist ein boolescher Wert, der auf true eingestellt ist.

websites

Einstellungen, mit denen festgelegt wird, welche Informationen Chrome Websites zur Verfügung stellt.

Typ

Objekt

Attribute

adMeasurementEnabled

types.ChromeSetting<boolean>

Chrome 111 und höher

Wenn sie deaktiviert ist, werden die Attribution Reporting API und die Private Aggregation API deaktiviert. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist true. Diese APIs können von Erweiterungen nur deaktiviert werden, wenn der Wert auf false gesetzt wird. Wenn Sie versuchen, diese APIs auf true festzulegen, wird ein Fehler ausgegeben.
doNotTrackEnabled

types.ChromeSetting<boolean>

Chrome 65 und höher

Wenn diese Option aktiviert ist, sendet Chrome „Do Not Track“ (DNT: 1)-Header mit Ihren Anfragen. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist false.
fledgeEnabled

types.ChromeSetting<boolean>

Chrome 111 und höher

Wenn diese Option deaktiviert ist, wird die Fledge API deaktiviert. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist true. Erweiterungen können diese API nur deaktivieren, indem sie den Wert auf false setzen. Wenn Sie versuchen, diese API auf true festzulegen, wird ein Fehler ausgegeben.
hyperlinkAuditingEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, sendet Chrome bei entsprechenden Anfragen von einer Website (<a ping>) Audit-Pings. Der Wert dieser Einstellung ist vom Typ boolescher Wert und der Standardwert ist true.
protectedContentEnabled

types.ChromeSetting<boolean>

Nur unter Windows und ChromeOS verfügbar: Wenn diese Option aktiviert ist, stellt Chrome Plug-ins eine eindeutige ID zur Verfügung, um geschützte Inhalte auszuführen. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist true.
referrersEnabled

types.ChromeSetting<boolean>

Wenn diese Option aktiviert ist, sendet Chrome mit Ihren Anfragen referer-Header. Ja. Der Name dieser Einstellung stimmt nicht mit dem falsch geschriebenen Header überein. Nein, wir werden es nicht ändern. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist true.
relatedWebsiteSetsEnabled

types.ChromeSetting<boolean>

Chrome 121 oder höher

Wenn die Option deaktiviert ist, wird Gruppen ähnlicher Websites deaktiviert. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist true. Erweiterungen können diese API nur deaktivieren, indem sie den Wert auf false setzen. Wenn Sie versuchen, diese API auf true festzulegen, wird ein Fehler ausgegeben.
thirdPartyCookiesAllowed

types.ChromeSetting<boolean>

Wenn diese Option deaktiviert ist, verhindert Chrome, dass Websites von Drittanbietern Cookies setzen. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist true.
topicsEnabled

types.ChromeSetting<boolean>

Chrome 111 und höher

Wenn diese Option deaktiviert ist, wird die Topics API deaktiviert. Der Wert dieser Einstellung ist vom Typ "boolesch" und der Standardwert ist true. Erweiterungen können diese API nur deaktivieren, indem sie den Wert auf false setzen. Wenn Sie versuchen, diese API auf true festzulegen, wird ein Fehler ausgegeben.