Las extensiones de Manifest V2 se quitaron de Chrome Web Store el 31 de agosto de 2026. Migra tu extensión a Manifest V3 para que vuelva a estar disponible para los usuarios.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

chrome.permissions

refresh date: 2026-09-25 robots: noindex

Descripción

Usa la API de chrome.permissions para solicitar permisos opcionales declarados en el tiempo de ejecución, en lugar de en el momento de la instalación, de modo que los usuarios comprendan por qué se necesitan los permisos y otorguen solo los necesarios.

Descripción general

Las advertencias de permisos existen para describir las capacidades que otorga una API, pero es posible que algunas de estas advertencias no sean obvias. La API de Permissions permite que los desarrolladores expliquen las advertencias de permisos y presenten funciones nuevas de forma gradual, lo que les brinda a los usuarios una introducción sin riesgos a la extensión. De esta manera, los usuarios pueden especificar cuánto acceso están dispuestos a otorgar y qué funciones quieren habilitar.

Por ejemplo, la funcionalidad principal de la extensión de permisos opcionales es anular la página de nueva pestaña. Una de las funciones es mostrar el objetivo del día del usuario. Esta función solo requiere el permiso storage, que no incluye una advertencia. La extensión tiene una función adicional que los usuarios pueden habilitar haciendo clic en el siguiente botón:

Para mostrar los sitios principales del usuario, se requiere el permiso topSites, que tiene la siguiente advertencia.

Advertencia de extensión para la API de topSites

Implementa permisos opcionales

Paso 1: Decide qué permisos son obligatorios y cuáles son opcionales

Una extensión puede declarar permisos obligatorios y opcionales. En general, debes hacer lo siguiente:

Usa los permisos obligatorios cuando sean necesarios para la funcionalidad básica de tu extensión.
Usa permisos opcionales cuando sean necesarios para las funciones opcionales de tu extensión.

Ventajas de los permisos obligatorios:

Menos mensajes: Una extensión puede pedirle al usuario una vez que acepte todos los permisos.
Desarrollo más simple: Se garantiza que los permisos requeridos estén presentes.

Ventajas de los permisos opcionales:

Mejor seguridad: Las extensiones se ejecutan con menos permisos, ya que los usuarios solo habilitan los permisos que se necesitan.
Mejor información para los usuarios: Una extensión puede explicar por qué necesita un permiso en particular cuando el usuario habilita la función correspondiente.
Actualizaciones más sencillas: Cuando actualices tu extensión, Chrome no la inhabilitará para tus usuarios si la actualización agrega permisos opcionales en lugar de obligatorios.

Paso 2: Declara permisos opcionales en el manifiesto

Declara los permisos opcionales en el manifiesto de la extensión con la clave optional_permissions, con el mismo formato que el campo permissions:

{
  "name": "My extension",
  ...
  "optional_permissions": ["tabs"],
  "optional_host_permissions": ["https://www.google.com/"],
  ...
}

Si quieres solicitar hosts que solo descubras durante el tiempo de ejecución, incluye "https://*/*" en el campo optional_host_permissions de tu extensión. Esto te permite especificar cualquier origen en Permissions.origins, siempre que tenga un esquema coincidente.

Permisos que no se pueden especificar como opcionales

La mayoría de los permisos de las extensiones de Chrome se pueden especificar como opcionales, con las siguientes excepciones.

Permiso	Descripción
`"debugger"`	La API de chrome.debugger funciona como un transporte alternativo para el protocolo de depuración remota de Chrome.
`"declarativeNetRequest"`	Otorga a la extensión acceso a la API de chrome.declarativeNetRequest.
`"devtools"`	Permite que la extensión expanda la funcionalidad de las Herramientas para desarrolladores de Chrome.
`"experimental"`	Solo para los canales Canary y para desarrolladores. Otorga a la extensión acceso a las APIs de chrome.experimental.
`"geolocation"`	Permite que la extensión use la API de ubicación geográfica de HTML5.
`"mdns"`	Otorga a la extensión acceso a la API de chrome.mdns.
`"proxy"`	Otorga a la extensión acceso a la API de chrome.proxy para administrar la configuración de proxy de Chrome.
`"tts"`	La API de chrome.tts reproduce texto a voz (TTS) sintetizado.
`"ttsEngine"`	La API de chrome.ttsEngine implementa un motor de texto a voz (TTS) con una extensión.
`"wallpaper"`	Solo en ChromeOS. Usa la API de chrome.wallpaper para cambiar el fondo de pantalla de ChromeOS.

Consulta Declara permisos y advierte a los usuarios para obtener más información sobre los permisos disponibles y sus advertencias.

Paso 3: Solicita permisos opcionales

Solicita los permisos desde un gesto del usuario con permissions.request():

document.querySelector('#my-button').addEventListener('click', (event) => {
  // Permissions must be requested from inside a user gesture, like a button's
  // click handler.
  chrome.permissions.request({
    permissions: ['tabs'],
    origins: ['https://www.google.com/']
  }, (granted) => {
    // The callback argument will be true if the user granted the permissions.
    if (granted) {
      doSomething();
    } else {
      doSomethingElse();
    }
  });
});

Chrome le pregunta al usuario si agregar los permisos genera mensajes de advertencia diferentes de los que el usuario ya vio y aceptó. Por ejemplo, el código anterior podría dar como resultado un mensaje como este:

ejemplo de mensaje de confirmación de permiso

Paso 4: Verifica los permisos actuales de la extensión

Para verificar si tu extensión tiene un permiso o un conjunto de permisos específicos, usa permission.contains():

chrome.permissions.contains({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (result) => {
  if (result) {
    // The extension has the permissions.
  } else {
    // The extension doesn't have the permissions.
  }
});

Paso 5: Quita los permisos

Debes quitar los permisos cuando ya no los necesites. Después de que se quita un permiso, por lo general, llamar a permissions.request() vuelve a agregar el permiso sin preguntarle al usuario.

chrome.permissions.remove({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (removed) => {
  if (removed) {
    // The permissions have been removed.
  } else {
    // The permissions have not been removed (e.g., you tried to remove
    // required permissions).
  }
});

Tipos

Permissions

Propiedades

orígenes

string[] opcional

Es la lista de permisos de host, incluidos los especificados en las claves optional_permissions o permissions del manifiesto, y los asociados con las secuencias de comandos de contenido.
permisos

string[] opcional

Es la lista de permisos con nombre (no incluye hosts ni orígenes).

Métodos

contains()

Promise

chrome.permissions.contains(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

Verifica si la extensión tiene los permisos especificados.

Parámetros

permisos

Permisos
callback

función opcional

El parámetro callback se ve de la siguiente manera:
```
(result: boolean) => void
```
- resultado
  
  booleano
  
  Es verdadero si la extensión tiene los permisos especificados. Si se especifica un origen como un permiso opcional y un patrón de coincidencia de secuencia de comandos de contenido, se devolverá false, a menos que se otorguen ambos permisos.

Muestra

Promise<boolean>

Chrome 96 y versiones posteriores

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

getAll()

Promise

chrome.permissions.getAll(
  callback?: function,
): Promise<Permissions>

Obtiene el conjunto de permisos actual de la extensión.

Parámetros

callback

función opcional

El parámetro callback se ve de la siguiente manera:
```
(permissions: Permissions) => void
```
- permisos
  
  Permisos
  
  Los permisos activos de la extensión. Ten en cuenta que la propiedad origins contendrá los orígenes otorgados de los especificados en las claves permissions y optional_permissions del manifiesto y los asociados con los guiones de contenido.

Muestra

Promise<Permissions>

Chrome 96 y versiones posteriores

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

remove()

Promise

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

Quita el acceso a los permisos especificados. Si hay algún problema para quitar los permisos, se rechazará la promesa.

Parámetros

permisos

Permisos
callback

función opcional

El parámetro callback se ve de la siguiente manera:
```
(removed: boolean) => void
```
- quitado
  
  booleano
  
  Es verdadero si se quitaron los permisos.

Muestra

Promise<boolean>

Chrome 96 y versiones posteriores

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

request()

Promise

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

Solicita acceso a los permisos especificados y, si es necesario, muestra un mensaje al usuario. Estos permisos deben definirse en el campo optional_permissions del manifiesto o deben ser permisos obligatorios que el usuario retuvo. Se ignorarán las rutas de acceso en los patrones de origen. Puedes solicitar subconjuntos de permisos de origen opcionales. Por ejemplo, si especificas *://*\/* en la sección optional_permissions del manifiesto, puedes solicitar http://example.com/. Si hay algún problema para solicitar los permisos, se rechazará la promesa.

Parámetros

permisos

Permisos
callback

función opcional

El parámetro callback se ve de la siguiente manera:
```
(granted: boolean) => void
```
- concedido
  
  booleano
  
  Es verdadero si el usuario otorgó los permisos especificados.

Muestra

Promise<boolean>

Chrome 96 y versiones posteriores

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

Eventos

onAdded

chrome.permissions.onAdded.addListener(
  callback: function,
)

Se activa cuando la extensión adquiere permisos nuevos.

Parámetros

callback

función

El parámetro callback se ve de la siguiente manera:
```
(permissions: Permissions) => void
```
- permisos
  
  Permisos

onRemoved

chrome.permissions.onRemoved.addListener(
  callback: function,
)

Se activa cuando se quita el acceso a los permisos de la extensión.

Parámetros

callback

función

El parámetro callback se ve de la siguiente manera:
```
(permissions: Permissions) => void
```
- permisos
  
  Permisos

chrome.permissions Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Descripción

Descripción general

Implementa permisos opcionales

Paso 1: Decide qué permisos son obligatorios y cuáles son opcionales

Paso 2: Declara permisos opcionales en el manifiesto

Paso 3: Solicita permisos opcionales

Paso 4: Verifica los permisos actuales de la extensión

Paso 5: Quita los permisos

Tipos

Permissions

Propiedades

Métodos

contains()

Parámetros

Muestra

getAll()

Parámetros

Muestra

remove()

Parámetros

Muestra

request()

Parámetros

Muestra

Eventos

onAdded

Parámetros

onRemoved

Parámetros

chrome.permissions