chrome.privacy

Descripción

Usa la API de chrome.privacy para controlar el uso de las funciones de Chrome que pueden afectar la privacidad de un usuario. Esta API se basa en el prototipo ChromeSetting de la API de types para obtener y establecer la configuración de Chrome.

Permisos

privacy

Manifiesto

Debes declarar el permiso "privacy" en el manifiesto de tu extensión para usar la API. Por ejemplo:

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

Uso

Leer el valor actual de una configuración de Chrome es sencillo. Primero, deberás encontrar la propiedad que te interesa y, luego, llamar a get() en ese objeto para recuperar su valor actual y el nivel de control de tu extensión. Por ejemplo, para determinar si la función Autocompletar de Chrome está habilitada, escribirías lo siguiente:

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

Cambiar el valor de una configuración es un poco más complejo, ya que primero debes verificar que tu extensión pueda controlar la configuración. El usuario no verá ningún cambio en su configuración si tu extensión activa o desactiva una configuración que está bloqueada en un valor específico por las políticas empresariales (levelOfControl se establecerá en "not_controllable") o si otra extensión controla el valor (levelOfControl se establecerá en "controlled_by_other_extensions"). La llamada set() se realizará correctamente, pero la configuración se anulará de inmediato. Como esto puede ser confuso, es recomendable advertir al usuario cuando la configuración que eligió no se aplica en la práctica.

Esto significa que debes usar el método get() para determinar tu nivel de acceso y, luego, solo llamar a set() si tu extensión puede tomar el control de la configuración (de hecho, si tu extensión no puede controlar la configuración, probablemente sea una buena idea inhabilitar visualmente la funcionalidad para reducir la confusión del usuario):

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

Si te interesan los cambios en el valor de una configuración, agrega un objeto de escucha a su evento onChange. Entre otros usos, esto te permitirá advertir al usuario si una extensión instalada recientemente toma el control de una configuración o si la política empresarial anula tu control. Para escuchar los cambios en el estado de Autocompletar, por ejemplo, el siguiente código sería suficiente:

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

Ejemplos

Para probar esta API, instala el ejemplo de la API de Privacy desde el repositorio chrome-extension-samples.

Tipos

IPHandlingPolicy

Chrome 48+

La política que controla la IP de WebRTC

Enum

"default"

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

Propiedades

network

Configuración que influye en el manejo de las conexiones de red de Chrome en general.

Tipo

objeto

Propiedades

  • networkPredictionEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome intenta acelerar tu experiencia de navegación web mediante la resolución previa de entradas DNS y la apertura preventiva de conexiones TCP y SSL a los servidores. Esta preferencia solo afecta las acciones que realiza el servicio de predicción interno de Chrome. No afecta las precargas ni las preconexiones iniciadas por la página web. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • webRTCIPHandlingPolicy

    types.ChromeSetting<IPHandlingPolicy>

    Chrome 48+

    Permite que los usuarios especifiquen las compensaciones de rendimiento/privacidad de los medios, lo que afecta la forma en que se enruta el tráfico de WebRTC y la cantidad de información de la dirección local que se expone. El valor de esta preferencia es del tipo IPHandlingPolicy, que se establece en default de forma predeterminada.

services

Configuración que habilita o inhabilita funciones que requieren servicios de red de terceros proporcionados por Google y tu proveedor de búsqueda predeterminado.

Tipo

objeto

Propiedades

  • alternateErrorPagesEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome usa un servicio web para ayudar a resolver errores de navegación. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • autofillAddressEnabled

    types.ChromeSetting<boolean>

    Chrome 70+

    Si está habilitado, Chrome ofrece completar automáticamente las direcciones y otros datos del formulario. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • autofillCreditCardEnabled

    types.ChromeSetting<boolean>

    Chrome 70+

    Si está habilitado, Chrome ofrece completar automáticamente los formularios de tarjetas de crédito. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • autofillEnabled

    types.ChromeSetting<boolean>

    Dejó de estar disponible desde Chrome 70

    Usa privacy.services.autofillAddressEnabled y privacy.services.autofillCreditCardEnabled. Esto sigue siendo compatible con versiones anteriores en esta versión y se quitará en el futuro.

    Si está habilitado, Chrome ofrece completar automáticamente los formularios. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • passwordSavingEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, el administrador de contraseñas te preguntará si quieres guardar contraseñas. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • safeBrowsingEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome hace todo lo posible para protegerte del phishing y el software malicioso. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • safeBrowsingExtendedReportingEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome enviará información adicional a Google cuando SafeBrowsing bloquee una página, como el contenido de la página bloqueada. El valor de esta preferencia es un valor booleano, que se establece en false de forma predeterminada.

  • searchSuggestEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome envía el texto que escribes en el cuadro multifunción a tu motor de búsqueda predeterminado, que proporciona predicciones de sitios web y búsquedas que probablemente completen lo que escribiste hasta el momento. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

  • spellingServiceEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome usa un servicio web para ayudar a corregir errores de ortografía. El valor de esta preferencia es un valor booleano, que se establece en false de forma predeterminada.

  • translationServiceEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome ofrece traducir las páginas que no están en un idioma que lees. El valor de esta preferencia es un valor booleano, que se establece en true de forma predeterminada.

websites

Configuración que determina qué información pone Chrome a disposición de los sitios web.

Tipo

objeto

Propiedades

  • adMeasurementEnabled

    types.ChromeSetting<boolean>

    Chrome 111+

    Si está inhabilitado, se desactivan la API de Attribution Reporting y la API de Private Aggregation. El valor de esta preferencia es de tipo booleano y el valor predeterminado es true. Las extensiones solo pueden inhabilitar estas APIs si establecen el valor en false. Si intentas establecer estas APIs en true, se generará un error.

  • doNotTrackEnabled

    types.ChromeSetting<boolean>

    Chrome 65+

    Si está habilitado, Chrome envía el encabezado "Do Not Track" (DNT: 1) con tus solicitudes. El valor de esta preferencia es de tipo booleano y el valor predeterminado es false.

  • fledgeEnabled

    types.ChromeSetting<boolean>

    Chrome 111+

    Si está inhabilitado, se desactiva la API de Fledge. El valor de esta preferencia es de tipo booleano y el valor predeterminado es true. Las extensiones solo pueden inhabilitar esta API si establecen el valor en false. Si intentas establecer esta API en true, se generará un error.

  • hyperlinkAuditingEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome envía pings de auditoría cuando un sitio web lo solicita (<a ping>). El valor de esta preferencia es de tipo booleano y el valor predeterminado es true.

  • protectedContentEnabled

    types.ChromeSetting<boolean>

    Solo disponible en Windows y ChromeOS: Si está habilitado, Chrome proporciona un ID único a los complementos para ejecutar contenido protegido. El valor de esta preferencia es de tipo booleano y el valor predeterminado es true.

  • referrersEnabled

    types.ChromeSetting<boolean>

    Si está habilitado, Chrome envía encabezados referer con tus solicitudes. Sí, el nombre de esta preferencia no coincide con el encabezado mal escrito. No, no lo vamos a cambiar. El valor de esta preferencia es de tipo booleano y el valor predeterminado es true.

  • relatedWebsiteSetsEnabled

    types.ChromeSetting<boolean>

    Chrome 121+

    Si está inhabilitado, se desactiva Conjuntos de sitios web relacionados. El valor de esta preferencia es de tipo booleano y el valor predeterminado es true. Las extensiones solo pueden inhabilitar esta API si establecen el valor en false. Si intentas establecer esta API en true, se generará un error.

  • thirdPartyCookiesAllowed

    types.ChromeSetting<boolean>

    Si está inhabilitado, Chrome impide que los sitios de terceros establezcan cookies. El valor de esta preferencia es de tipo booleano y el valor predeterminado es true. Es posible que las extensiones no habiliten esta API en el modo Incógnito, donde se bloquean las cookies de terceros y solo se pueden permitir a nivel del sitio. Si intentas establecer esta API en true en Incógnito, se generará un error.

    Nota: Es posible que los sitios individuales aún puedan acceder a cookies de terceros cuando esta API muestra false, si tienen una exención válida o usan la API de Storage Access en su lugar.

  • topicsEnabled

    types.ChromeSetting<boolean>

    Chrome 111+

    Si está inhabilitado, se desactiva la API de Topics. El valor de esta preferencia es de tipo booleano y el valor predeterminado es true. Las extensiones solo pueden inhabilitar esta API si establecen el valor en false. Si intentas establecer esta API en true, se generará un error.