chrome.contentSettings

refresh date: 2026-09-25 robots: noindex

Descripción

Usa la API de chrome.contentSettings para cambiar la configuración que controla si los sitios web pueden usar funciones como cookies, JavaScript y complementos. En términos más generales, la configuración de contenido te permite personalizar el comportamiento de Chrome en cada sitio, en lugar de hacerlo de forma global.

Permisos

contentSettings

Manifiesto

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

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

Patrones de configuración de contenido

Puedes usar patrones para especificar los sitios web que afecta cada parámetro de configuración de contenido. Por ejemplo, https://*.youtube.com/* especifica youtube.com y todos sus subdominios. La sintaxis de los patrones de configuración de contenido es la misma que la de los patrones de coincidencia, con algunas diferencias:

  • En el caso de las URLs http, https y ftp, la ruta debe ser un comodín (/*). En el caso de las URLs file, la ruta debe especificarse por completo y no debe contener comodines.
  • A diferencia de los patrones de coincidencia, los patrones de configuración de contenido pueden especificar un número de puerto. Si se especifica un número de puerto, el patrón solo coincide con los sitios web que tienen ese puerto. Si no se especifica un número de puerto, el patrón coincide con todos los puertos.

Prioridad de patrones

Cuando se aplica más de una regla de configuración de contenido para un sitio determinado, prevalece la regla con el patrón más específico.

Por ejemplo, los siguientes patrones se ordenan por prioridad:

  1. https://www.example.com/*
  2. https://*.example.com/* (coincide con example.com y todos los subdominios)
  3. <all_urls> (coincide con todas las URLs)

Hay tres tipos de comodines que afectan la especificidad de un patrón:

  • Comodines en el puerto (por ejemplo, https://www.example.com:*/*)
  • Comodines en el esquema (por ejemplo, *://www.example.com:123/*)
  • Comodines en el nombre de host (por ejemplo, https://*.example.com:123/*)

Si un patrón es más específico que otro en una parte, pero menos específico en otra, las diferentes partes se verifican en el siguiente orden: nombre de host, esquema y puerto. Por ejemplo, los siguientes patrones se ordenan según su precedencia:

  1. https://www.example.com:*/* Especifica el nombre de host y el esquema.
  2. *:/www.example.com:123/* No es tan alta, ya que, si bien especifica el nombre de host, no especifica el esquema.
  3. https://*.example.com:123/* Es más baja porque, aunque especifica el puerto y el esquema, tiene un comodín en el nombre de host.

Patrones principales y secundarios

La URL que se tiene en cuenta cuando se decide qué parámetro de configuración del contenido aplicar depende del tipo de contenido. Por ejemplo, la configuración de contentSettings.notifications se basa en la URL que se muestra en el cuadro multifunción. Esta URL se denomina URL "principal".

Algunos tipos de contenido pueden tener en cuenta URLs adicionales. Por ejemplo, si un sitio puede establecer una contentSettings.cookies, se decide en función de la URL de la solicitud HTTP (que es la URL principal en este caso) y de la URL que se muestra en el cuadro multifunción (que se denomina URL "secundaria").

Si varias reglas tienen patrones principales y secundarios, la regla con el patrón principal más específico tiene prioridad. Si varias reglas tienen el mismo patrón principal, la regla con el patrón secundario más específico tiene prioridad. Por ejemplo, la siguiente lista de pares de patrones primarios y secundarios se ordena según la precedencia:

PrioridadPatrón principalPatrón secundario
1https://www.moose.com/*,https://www.wombat.com/*
2https://www.moose.com/*,<all_urls>
3<all_urls>,https://www.wombat.com/*
4<all_urls>,<all_urls>

Identificadores de recursos

Los identificadores de recursos te permiten especificar la configuración de contenido para subtipos específicos de un tipo de contenido. Actualmente, el único tipo de contenido que admite identificadores de recursos es contentSettings.plugins, en el que un identificador de recurso identifica un complemento específico. Cuando se aplican parámetros de configuración del contenido, primero se verifican los parámetros de configuración del complemento específico. Si no se encuentra ningún parámetro de configuración para el complemento específico, se verifican los parámetros de configuración generales del contenido para los complementos.

Por ejemplo, si una regla de configuración de contenido tiene el identificador de recurso adobe-flash-player y el patrón <all_urls>, tiene prioridad sobre una regla sin un identificador de recurso y el patrón https://www.example.com/*, incluso si ese patrón es más específico.

Para obtener una lista de identificadores de recursos para un tipo de contenido, llama al método contentSettings.ContentSetting.getResourceIdentifiers. La lista que se devuelve puede cambiar con el conjunto de complementos instalados en la máquina del usuario, pero Chrome intenta mantener los identificadores estables en las actualizaciones de complementos.

Ejemplos

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

Tipos

AutoVerifyContentSetting

Chrome 113 y versiones posteriores

Enum

"allow"

"block"

CameraContentSetting

Chrome 46 y versiones posteriores

Enum

"allow"

"block"

"ask"

ClipboardContentSetting

Chrome 121 y versiones posteriores

Enum

"allow"

"block"

"ask"

ContentSetting

Propiedades

  • borrar

    void

    Promise

    Borra todos los parámetros de configuración de contenido establecidos por esta extensión.

    La función clear se ve de la siguiente manera: 

    (details: object, callback?: function) => {...}

    • detalles

      objeto

      • alcance

        Alcance opcional

        Dónde borrar el parámetro de configuración (el valor predeterminado es regular).

    • callback

      función opcional

      El parámetro callback se ve de la siguiente manera: 

      () => void

    • muestra

      Promise<void>

      Chrome 96 y versiones posteriores

      Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

  • get

    void

    Promise

    Obtiene el parámetro de configuración de contenido actual para un par de URLs determinado.

    La función get se ve de la siguiente manera: 

    (details: object, callback?: function) => {...}

    • detalles

      objeto

      • Incógnito

        booleano opcional

        Indica si se deben verificar los parámetros de configuración del contenido para una sesión de incógnito. (el valor predeterminado es falso)

      • primaryUrl

        string

        Es la URL principal para la que se debe recuperar el parámetro de configuración del contenido. Ten en cuenta que el significado de una URL principal depende del tipo de contenido.

      • resourceIdentifier

        ResourceIdentifier opcional

        Es un identificador más específico del tipo de contenido para el que se deben recuperar los parámetros de configuración.

      • secondaryUrl

        cadena opcional

        Es la URL secundaria para la que se debe recuperar el parámetro de configuración del contenido. El valor predeterminado es la URL principal. Ten en cuenta que el significado de una URL secundaria depende del tipo de contenido, y no todos los tipos de contenido usan URLs secundarias.

    • callback

      función opcional

      El parámetro callback se ve de la siguiente manera: 

      (details: object) => void

      • detalles

        objeto

        • Estableciendo

          T

          Es el parámetro de configuración de contenido. Consulta la descripción de los objetos ContentSetting individuales para conocer los valores posibles.

    • muestra

      Promise<object>

      Chrome 96 y versiones posteriores

      Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

  • getResourceIdentifiers

    void

    Promise

    La función getResourceIdentifiers se ve de la siguiente manera: 

    (callback?: function) => {...}

    • callback

      función opcional

      El parámetro callback se ve de la siguiente manera: 

      (resourceIdentifiers?: ResourceIdentifier[]) => void

      • resourceIdentifiers

        ResourceIdentifier[] opcional

        Es una lista de identificadores de recursos para este tipo de contenido o undefined si este tipo de contenido no usa identificadores de recursos.

    • muestra

      Promise<ResourceIdentifier[]>

      Chrome 96 y versiones posteriores

      Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

  • set

    void

    Promise

    Aplica una nueva regla de configuración de contenido.

    La función set se ve de la siguiente manera: 

    (details: object, callback?: function) => {...}

    • detalles

      objeto

      • primaryPattern

        string

        Es el patrón de la URL principal. Para obtener detalles sobre el formato de un patrón, consulta Patrones de configuración de contenido.

      • resourceIdentifier

        ResourceIdentifier opcional

        Es el identificador de recurso para el tipo de contenido.

      • alcance

        Alcance opcional

        Dónde establecer el parámetro de configuración (predeterminado: regular).

      • secondaryPattern

        cadena opcional

        Es el patrón de la URL secundaria. De forma predeterminada, se hace coincidir con todas las URLs. Para obtener detalles sobre el formato de un patrón, consulta Patrones de configuración de contenido.

      • Estableciendo

        cualquiera

        Es el parámetro de configuración que se aplica con esta regla. Consulta la descripción de los objetos ContentSetting individuales para conocer los valores posibles.

    • callback

      función opcional

      El parámetro callback se ve de la siguiente manera: 

      () => void

    • muestra

      Promise<void>

      Chrome 96 y versiones posteriores

      Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

CookiesContentSetting

Chrome 44 y versiones posteriores

Enum

"allow"

"block"

"session_only"

FullscreenContentSetting

Chrome 44 y versiones posteriores

Valor

"allow"

ImagesContentSetting

Chrome 44 y versiones posteriores

Enum

"allow"

"block"

JavascriptContentSetting

Chrome 44 y versiones posteriores

Enum

"allow"

"block"

LocationContentSetting

Chrome 44 y versiones posteriores

Enum

"allow"

"block"

"ask"

MicrophoneContentSetting

Chrome 46 y versiones posteriores

Enum

"allow"

"block"

"ask"

MouselockContentSetting

Chrome 44 y versiones posteriores

Valor

"allow"

MultipleAutomaticDownloadsContentSetting

Chrome 44 y versiones posteriores

Enum

"allow"

"block"

"ask"

NotificationsContentSetting

Chrome 44 y versiones posteriores

Enum

"allow"

"block"

"ask"

PluginsContentSetting

Chrome 44 y versiones posteriores

Valor

"block"

PopupsContentSetting

Chrome 44 y versiones posteriores

Enum

"allow"

"block"

PpapiBrokerContentSetting

Chrome 44 y versiones posteriores

Valor

"block"

ResourceIdentifier

El único tipo de contenido que usa identificadores de recursos es contentSettings.plugins. Para obtener más información, consulta Identificadores de recursos.

Propiedades

  • descripción

    cadena opcional

    Es una descripción legible por humanos del recurso.

  • id

    string

    Es el identificador del recurso para el tipo de contenido determinado.

Scope

Chrome 44 y versiones posteriores

Es el alcance de ContentSetting. Uno de los siguientes: regular: Es el parámetro de configuración del perfil normal (que hereda el perfil de incógnito si no se anula en otro lugar). incognito\_session\_only: Es el parámetro de configuración del perfil de incógnito que solo se puede establecer durante una sesión de incógnito y se borra cuando finaliza la sesión de incógnito (anula la configuración normal).

Enum

"regular"

"incognito_session_only"

SoundContentSetting

Chrome 141 y versiones posteriores

Enum

"allow"

"block"

Propiedades

automaticDownloads

Indica si se permite que los sitios descarguen varios archivos automáticamente. Uno de los siguientes: allow: Permite que los sitios descarguen varios archivos automáticamente. block: No permite que los sitios descarguen varios archivos automáticamente. ask: Pregunta cuando un sitio quiera descargar archivos automáticamente después del primer archivo. El valor predeterminado es ask. La URL principal es la URL del marco de nivel superior. No se usa la URL secundaria.

Tipo

ContentSetting<MultipleAutomaticDownloadsContentSetting>

autoVerify

Chrome 113 y versiones posteriores

Indica si se permite que los sitios usen la API de Private State Tokens. Uno de los siguientes: allow: Permite que los sitios usen la API de Private State Tokens. block: Bloquea el uso de la API de Private State Tokens en los sitios. El valor predeterminado es allow. Cuando se llama a set(), el patrón de URL principal debe ser <all_urls>. No se usa la URL secundaria.

Tipo

ContentSetting<AutoVerifyContentSetting>

camera

Chrome 46 y versiones posteriores

Indica si se permite que los sitios accedan a la cámara. Una de las siguientes opciones: allow: Permitir que los sitios accedan a la cámara block: No permitir que los sitios accedan a la cámara ask: Preguntar cuando un sitio quiera acceder a la cámara El valor predeterminado es ask. La URL principal es la URL del documento que solicitó acceso a la cámara. No se usa la URL secundaria. NOTA: El parámetro de configuración "allow" no es válido si ambos patrones son "<all_urls>".

Tipo

ContentSetting<CameraContentSetting>

clipboard

Chrome 121 y versiones posteriores

Indica si se permite que los sitios accedan al portapapeles a través de las capacidades avanzadas de la API de Async Clipboard. Las capacidades "avanzadas" incluyen todo lo que no sea escribir formatos integrados después de un gesto del usuario, es decir, la capacidad de leer, la capacidad de escribir formatos personalizados y la capacidad de escribir sin un gesto del usuario. Uno de los siguientes valores de allow: Permite que los sitios usen funciones avanzadas del portapapeles, block: No permite que los sitios usen funciones avanzadas del portapapeles, ask: Pregunta cuando un sitio quiera usar funciones avanzadas del portapapeles. El valor predeterminado es ask. La URL principal es la URL del documento que solicitó acceso al portapapeles. No se usa la URL secundaria.

Tipo

ContentSetting<ClipboardContentSetting>

cookies

Indica si los sitios web pueden establecer cookies y otros datos locales. Uno de los siguientes: allow: Aceptar cookies, block: Bloquear cookies, session\_only: Aceptar cookies solo para la sesión actual. El valor predeterminado es allow. La URL principal es la que representa el origen de la cookie. La URL secundaria es la URL del marco de nivel superior.

Tipo

ContentSetting<CookiesContentSetting>

fullscreen

Obsoleto. Ya no tiene ningún efecto. Ahora se otorga automáticamente el permiso de pantalla completa para todos los sitios. El valor siempre es allow.

Tipo

ContentSetting<FullscreenContentSetting>

images

Indica si se deben mostrar imágenes. Uno de los siguientes: allow: Mostrar imágenes block: No mostrar imágenes El valor predeterminado es allow. La URL principal es la URL del marco de nivel superior. La URL secundaria es la URL de la imagen.

Tipo

ContentSetting<ImagesContentSetting>

javascript

Indica si se debe ejecutar JavaScript. Uno de los siguientes valores: allow: Ejecuta JavaScript. block: No ejecuta JavaScript. El valor predeterminado es allow. La URL principal es la URL del marco de nivel superior. No se usa la URL secundaria.

Tipo

ContentSetting<JavascriptContentSetting>

location

Indica si se permite la ubicación geográfica. Una de las siguientes opciones: allow: Permite que los sitios hagan un seguimiento de tu ubicación física. block: No permite que los sitios hagan un seguimiento de tu ubicación física. ask: Pregunta antes de permitir que los sitios hagan un seguimiento de tu ubicación física. El valor predeterminado es ask. La URL principal es la URL del documento que solicitó datos de ubicación. La URL secundaria es la URL del marco de nivel superior (que puede diferir o no de la URL de solicitud).

Tipo

ContentSetting<LocationContentSetting>

microphone

Chrome 46 y versiones posteriores

Indica si se permite que los sitios accedan al micrófono. Uno de los siguientes: allow: Permite que los sitios accedan al micrófono. block: No permite que los sitios accedan al micrófono. ask: Pregunta cuando un sitio quiera acceder al micrófono. El valor predeterminado es ask. La URL principal es la URL del documento que solicitó acceso al micrófono. No se usa la URL secundaria. NOTA: El parámetro de configuración "allow" no es válido si ambos patrones son "<all_urls>".

Tipo

ContentSetting<MicrophoneContentSetting>

mouselock

Obsoleto. Ya no tiene ningún efecto. Ahora, el permiso de bloqueo del mouse se otorga automáticamente para todos los sitios. El valor siempre es allow.

Tipo

ContentSetting<MouselockContentSetting>

notifications

Indica si se permite que los sitios muestren notificaciones de escritorio. Una de las siguientes opciones: allow: Permite que los sitios muestren notificaciones de escritorio. block: No permite que los sitios muestren notificaciones de escritorio. ask: Pregunta cuando un sitio quiera mostrar notificaciones de escritorio. El valor predeterminado es ask. La URL principal es la URL del documento que desea mostrar la notificación. No se usa la URL secundaria.

Tipo

ContentSetting<NotificationsContentSetting>

plugins

Obsoleto. Dado que se quitó la compatibilidad con Flash en Chrome 88, este permiso ya no tiene ningún efecto. El valor siempre es block. Se ignorarán las llamadas a set() y clear().

Tipo

ContentSetting<PluginsContentSetting>

popups

Indica si se permite que los sitios muestren ventanas emergentes. Uno de los siguientes valores de allow: Permitir que los sitios muestren ventanas emergentes, block: No permitir que los sitios muestren ventanas emergentes El valor predeterminado es block. La URL principal es la URL del marco de nivel superior. No se usa la URL secundaria.

Tipo

ContentSetting<PopupsContentSetting>

unsandboxedPlugins

Obsoleto. Anteriormente, controlaba si se permitía que los sitios ejecutaran complementos sin zona de pruebas, pero, con la eliminación del proceso del agente de Flash en Chrome 88, este permiso ya no tiene ningún efecto. El valor siempre es block. Se ignorarán las llamadas a set() y clear().

Tipo

ContentSetting<PpapiBrokerContentSetting>