chrome.tabs

Nota: Las páginas de service worker y de extensión pueden usar la API de Tabs, pero no las secuencias de comandos del contenido.

Descripción

Usa la API de chrome.tabs para interactuar con el sistema de pestañas del navegador. Puedes usar esta API para crear, modificar y reorganizar pestañas en el navegador.

La API de Tabs no solo ofrece funciones para manipular y administrar pestañas, sino que también puede detectar el idioma de la pestaña, tomar una captura de pantalla y comunicarse con la secuencia de comandos del contenido de una pestaña.

Permisos

La mayoría de las funciones no requieren ningún permiso para usarse. Por ejemplo, crea una pestaña nueva, vuelve a cargar una pestaña, navega a otra URL, etcétera.

Hay tres permisos que los desarrolladores deben tener en cuenta cuando trabajen con la API de pestañas.

El permiso de "pestañas"

Este permiso no otorga acceso al espacio de nombres chrome.tabs. En cambio, otorga a una extensión la capacidad de llamar a tabs.query() con cuatro propiedades sensibles en instancias de tabs.Tab: url, pendingUrl, title y favIconUrl.

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

Permisos de host

Los permisos de host permiten que una extensión lea y consulte las cuatro propiedades sensibles tabs.Tab de una pestaña que coincide. También pueden interactuar directamente con las pestañas coincidentes mediante métodos como tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() y tabs.removeCSS().

{
  "name": "My extension",
  ...
  "host_permissions": [
    "http://*/*",
    "https://*/*"
  ],
  ...
}

El permiso "activeTab"

activeTab otorga a una extensión permiso de host temporal para la pestaña actual en respuesta a una invocación del usuario. A diferencia de los permisos de host, activeTab no activa ninguna advertencia.

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

Casos de uso

En las siguientes secciones, se muestran algunos casos de uso comunes.

Abrir la página de una extensión en una pestaña nueva

Un patrón común para las extensiones es abrir una página de integración en una pestaña nueva cuando se instala la extensión. En el siguiente ejemplo, se muestra cómo hacerlo.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

Nota: En este ejemplo, no se requiere ningún permiso.

Cómo obtener la pestaña actual

En este ejemplo, se muestra cómo el service worker de una extensión puede recuperar la pestaña activa desde la ventana enfocada actualmente (o la más reciente, si no hay ninguna ventana de Chrome enfocada). Por lo general, se puede considerar la pestaña actual del usuario.

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }

  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

Silenciar la pestaña especificada

En este ejemplo, se muestra cómo una extensión puede activar o desactivar el estado silenciado de una pestaña determinada.

  async function toggleMuteState(tabId) {
    const tab = await chrome.tabs.get(tabId);
    const muted = !tab.mutedInfo.muted;
    await chrome.tabs.update(tabId, {muted});
    console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
  }

  function toggleMuteState(tabId) {
    chrome.tabs.get(tabId, async (tab) => {
      let muted = !tab.mutedInfo.muted;
      await chrome.tabs.update(tabId, { muted });
      console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
    });
  }

Mueve la pestaña actual a la primera posición al hacer clic en ella

En este ejemplo, se muestra cómo mover una pestaña mientras se está arrastrando o no. Si bien en este ejemplo se usa chrome.tabs.move, puedes usar el mismo patrón de espera para otras llamadas que modifican pestañas mientras se realiza un arrastre.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }

Importante: Usar catch(error) en una promesa es una forma de garantizar que no se desmarca un error que, de lo contrario, propaga “chrome.runtime.lastError”.

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

Cómo pasar un mensaje a la secuencia de comandos del contenido de una pestaña seleccionada

En este ejemplo, se muestra cómo el service worker de una extensión puede comunicarse con secuencias de comandos de contenido en pestañas específicas del navegador mediante tabs.sendMessage().

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

Ejemplos de extensiones

Para ver más demostraciones de extensiones de la API de pestañas, explora cualquiera de las siguientes opciones:

• Manifest V2: Extensiones de la API de Tabs.
• Manifest V3: Administrador de pestañas.

Tipos

MutedInfo

Chrome 46 y versiones posteriores

El estado silenciado de la pestaña y el motivo del último cambio de estado.

Propiedades

• extensionId

  cadena opcional

  Es el ID de la extensión que cambió el estado silenciado. No se establece si una extensión no era el motivo por el que cambió por última vez el estado de silencio.

• silenciado

  boolean

  Si la pestaña está silenciada (evitado que reproduzca sonido) Es posible que la pestaña esté silenciada, incluso si no se ha reproducido o no está reproduciendo sonido. Equivale a si se muestra el indicador de audio "silencioso".

• Reason

  MutedInfoReason opcional

  El motivo por el que se silenció o dejó de silenciar la pestaña. No se establece si nunca se cambió el estado de silencio de la pestaña.

MutedInfoReason

Chrome 46 y versiones posteriores

Un evento que causó un cambio de estado silenciado.

Enum

"user"
Una acción de entrada del usuario estableció el estado silenciado.

"capture"
Se inició la captura de pestaña, lo que forzó un cambio de estado silenciado.

"extension"
Una extensión, identificada por el campo extensionId, establece el estado silenciado.

Tab

Propiedades

• activo

  boolean

  Si la pestaña está activa en su ventana. No necesariamente significa que la ventana está enfocada.

• Audible

  booleano opcional

  Chrome 45 y versiones posteriores

  Indica si la pestaña produjo sonido durante los últimos segundos (pero es posible que no se escuche si también está silenciada). Equivale a si se muestra el indicador "audio de la bocina".

• autoDiscardable

  boolean

  Chrome 54 y versiones posteriores

  Si el navegador puede descartar automáticamente la pestaña cuando los recursos son bajos

• descartado

  boolean

  Chrome 54 y versiones posteriores

  Si se descarta la pestaña. Una pestaña descartada es aquella cuyo contenido se descargó de la memoria, pero aún está visible en la barra de pestañas. Su contenido se volverá a cargar la próxima vez que se active.

• favIconUrl

  cadena opcional

  La URL del ícono de página de la pestaña. Esta propiedad solo está presente si el manifiesto de la extensión incluye el permiso "tabs". También puede ser una cadena vacía si se está cargando la pestaña.

• groupId

  número

  Chrome 88 y versiones posteriores

  ID del grupo al que pertenece la pestaña.

• alto

  número opcional

  Es la altura de la pestaña en píxeles.

• destacado

  boolean

  Si la pestaña está destacada.

• id

  número opcional

  El ID de la pestaña. Los IDs de pestaña son únicos dentro de la sesión del navegador. En algunas circunstancias, es posible que no se le asigne un ID a una pestaña; por ejemplo, cuando se consultan pestañas externas con la API de sessions, en cuyo caso es posible que haya un ID de sesión. El ID de pestaña también se puede establecer en chrome.tabs.TAB_ID_NONE para las ventanas de apps y Herramientas para desarrolladores.

• incógnito

  boolean

  Si la pestaña está en una ventana de incógnito.

• index

  número

  El índice basado en cero de la pestaña dentro de su ventana.

• lastAccessed

  número opcional

  Chrome 121 y versiones posteriores

  La última vez que se accedió a la pestaña como el número de milisegundos desde el ciclo de entrenamiento.

• mutedInfo

  MutedInfo opcional

  Chrome 46 y versiones posteriores

  El estado silenciado de la pestaña y el motivo del último cambio de estado.

• openerTabId

  número opcional

  El ID de la pestaña que abrió esta pestaña, si corresponde. Esta propiedad solo está presente si todavía existe la pestaña de apertura.

• pendingUrl

  cadena opcional

  Chrome 79 y versiones posteriores

  La URL a la que navega la pestaña, antes de que se confirme. Esta propiedad solo está presente si el manifiesto de la extensión incluye el permiso "tabs" y hay una navegación pendiente.

• marcada

  boolean

  Si la pestaña está fijada.

• seleccionados

  boolean

  Obsoleto

  Usa tabs.Tab.highlighted.

  Si la pestaña está seleccionada.

• sessionId

  cadena opcional

  Es el ID de sesión que se usa para identificar de forma única una pestaña obtenida de la API de sessions.

• status

  TabStatus opcional

  Estado de carga de la pestaña

• título

  cadena opcional

  Es el título de la pestaña. Esta propiedad solo está presente si el manifiesto de la extensión incluye el permiso "tabs".

• url

  cadena opcional

  Es la última URL confirmada del marco principal de la pestaña. Esta propiedad solo está presente si el manifiesto de la extensión incluye el permiso "tabs" y puede ser una cadena vacía si la pestaña aún no se confirmó. Consulta también Tab.pendingUrl.

• ancho

  número opcional

  Es el ancho de la pestaña en píxeles.

• windowId

  número

  El ID de la ventana que contiene la pestaña.

TabStatus

Chrome 44 y versiones posteriores

Estado de carga de la pestaña

Enum

WindowType

Chrome 44 y versiones posteriores

Es el tipo de ventana.

Enum

"panel"

ZoomSettings

Define cómo se controlan los cambios de zoom en una pestaña y en qué alcance.

Propiedades

• defaultZoomFactor

  número opcional

  Chrome 43 y versiones posteriores

  Se usa para mostrar el nivel de zoom predeterminado de la pestaña actual en las llamadas a orders.getZoomSettings.

• Standard

  ZoomSettingsMode opcional

  Define cómo se controlan los cambios de zoom, es decir, qué entidad es responsable del escalamiento real de la página. El valor predeterminado es automatic.

• permiso

  ZoomSettingsScope opcional

  Define si los cambios de zoom persisten para el origen de la página o si solo se aplican en esta pestaña. El valor predeterminado es per-origin cuando se utiliza el modo automatic y per-tab en el caso contrario.

ZoomSettingsMode

Chrome 44 y versiones posteriores

Define cómo se controlan los cambios de zoom, es decir, qué entidad es responsable del escalamiento real de la página. El valor predeterminado es automatic.

Enum

"automático"
El navegador controla automáticamente los cambios de zoom.

"manual"
Anula el control automático de los cambios de zoom. El evento onZoomChange aún se enviará, y es responsabilidad de la extensión escuchar este evento y escalar la página de forma manual. Este modo no admite el zoom de per-origin y, por lo tanto, ignora la configuración de zoom de scope y usa per-tab.

"inhabilitado"
Inhabilita el zoom en la pestaña. La pestaña vuelve al nivel de zoom predeterminado y se ignoran todos los cambios de zoom que se intentaron realizar.

ZoomSettingsScope

Chrome 44 y versiones posteriores

Define si los cambios de zoom persisten para el origen de la página o si solo se aplican en esta pestaña. El valor predeterminado es per-origin cuando se utiliza el modo automatic y per-tab en el caso contrario.

Enum

"por origen"
Los cambios en el zoom persisten en el origen de la página ampliada; es decir, en todas las demás pestañas que se hayan navegado a ese origen también se ampliarán. Además, los cambios de zoom de per-origin se guardan con el origen, lo que significa que, cuando navegas a otras páginas del mismo origen, todos se acercan al mismo factor de zoom. El permiso per-origin solo está disponible en el modo automatic.

"por pestaña"
Los cambios de zoom solo se aplican en esta pestaña, y los cambios de zoom en otras pestañas no afectan el zoom de esta pestaña. Además, los cambios de zoom de per-tab se restablecen durante la navegación. Cuando se navega por una pestaña, siempre se cargan páginas con sus factores de zoom per-origin.

Propiedades

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 y versiones posteriores

La cantidad máxima de veces por segundo que se puede llamar a captureVisibleTab. captureVisibleTab es costoso y no debes llamarlo con demasiada frecuencia.

Valor

2

TAB_ID_NONE

Chrome 46 y versiones posteriores

Un ID que representa la ausencia de una pestaña del navegador.

Valor

-1

TAB_INDEX_NONE

Chrome 123 y versiones posteriores

Un índice que representa la ausencia de un índice de tabulación en un tab_strip.

Valor

-1

Métodos

captureVisibleTab()

Promesa

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

Captura el área visible de la pestaña activa en la ventana especificada. Para invocar este método, la extensión debe tener los permisos <all_urls> o activeTab. Además de los sitios a los que normalmente pueden acceder las extensiones, este método permite que las extensiones capturen sitios sensibles que, de otro modo, están restringidos, incluidas las páginas de chrome:-scheme, las páginas de otras extensiones y las URLs de datos. Estos sitios sensibles solo se pueden capturar con el permiso activeTab. Las URLs de los archivos solo se pueden capturar si la extensión tiene acceso al archivo.

Parámetros

• windowId

  número opcional

  La ventana de destino La configuración predeterminada es la ventana actual.

• Opciones

  ImageDetails opcional

• callback

  Función opcional

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

  (dataUrl: string)=>void

  • dataUrl

    cadena

    Una URL de datos que codifica una imagen del área visible de la pestaña capturada. Se puede asignar a la propiedad "src" de un elemento HTML img para mostrarse.

Devuelve

• Promesa<string>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
)

Se conecta a las secuencias de comandos del contenido en la pestaña especificada. Se activa el evento runtime.onConnect en cada secuencia de comandos de contenido que se ejecuta en la pestaña especificada para la extensión actual. Para obtener más detalles, consulta Mensajes de Content Script.

Parámetros

• tabId

  número

• connectInfo

  objeto opcional

  • documentId

    cadena opcional

    Chrome 106 y versiones posteriores

    Abre un puerto a un documento específico identificado por documentId en lugar de todos los marcos de la pestaña.

  • frameId

    número opcional

    Abre un puerto a un marco específico identificado por frameId en lugar de todos los marcos de la pestaña.

  • name

    cadena opcional

    Se pasa a onConnect para las secuencias de comandos de contenido que están a la escucha del evento de conexión.

Devuelve

• runtime.Port

  Un puerto que se puede usar para comunicarse con las secuencias de comandos de contenido que se ejecutan en la pestaña especificada. Si la pestaña se cierra o no existe, se activa el evento runtime.Port del puerto.

create()

Promesa

chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

Crea una pestaña nueva.

Parámetros

• createProperties

  objeto

  • activo

    booleano opcional

    Indica si la pestaña debe convertirse en la pestaña activa de la ventana. No afecta si la ventana está enfocada (consulta windows.update). El valor predeterminado es true.

  • index

    número opcional

    La posición que debe tener la pestaña en la ventana. El valor proporcionado se fija entre cero y el número de pestañas en la ventana.

  • openerTabId

    número opcional

    El ID de la pestaña que la abrió. Si se especifica, la pestaña del abridor debe estar en la misma ventana que la pestaña recién creada.

  • marcada

    booleano opcional

    Si se debe fijar la pestaña. La configuración predeterminada es false.

  • seleccionados

    booleano opcional

    Obsoleto

    Usa active.

    Indica si la pestaña debe convertirse en la pestaña seleccionada en la ventana. La configuración predeterminada es true.

  • url

    cadena opcional

    La URL a la que se debe navegar inicialmente la pestaña. Las URLs completamente calificadas deben incluir un esquema (es decir, "http://www.google.com" y no "www.google.com"). Las URLs relativas están relacionadas con la página actual dentro de la extensión. La configuración predeterminada es la página Nueva pestaña.

  • windowId

    número opcional

    La ventana en la que se crea la pestaña nueva. La configuración predeterminada es la ventana actual.

• callback

  Función opcional

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

  (tab: Tab)=>void

  • tab

    Tab

    La pestaña creada.

Devuelve

• Promise<Tab>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

detectLanguage()

Promesa

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

Detecta el idioma principal del contenido en una pestaña.

Parámetros

• tabId

  número opcional

  El valor predeterminado es la pestaña activa de la ventana actual.

• callback

  Función opcional

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

  (language: string)=>void

  • language

    cadena

    Un código de idioma ISO, como en o fr. Para obtener una lista completa de los idiomas compatibles con este método, consulta kLanguageInfoTable. Se marcan la segunda a la cuarta columna y se muestra el primer valor que no es NULL, excepto en el caso del chino simplificado, para el que se muestra zh-CN. Para un idioma desconocido o indefinido, se muestra und.

Devuelve

• Promesa<string>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

discard()

Promesa Chrome 54 y versiones posteriores

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

Descarta una pestaña de la memoria. Las pestañas descartadas siguen visibles en la barra de pestañas y se vuelven a cargar cuando se activan.

Parámetros

• tabId

  número opcional

  El ID de la pestaña que se descartará. Si se especifica, la pestaña se descarta, a menos que esté activa o ya se descarte. Si se omite, el navegador descarta la pestaña menos importante. Esta acción puede fallar si no existen pestañas descartables.

• callback

  Función opcional

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

  (tab?: Tab)=>void

  • tab

    Tab opcional

    La pestaña descartada, si se descartó correctamente; de lo contrario, no se definió.

Devuelve

• Promesa<Tab|undefined>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

duplicate()

Promesa

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

Duplica una pestaña.

Parámetros

• tabId

  número

  El ID de la pestaña que se duplicará.

• callback

  Función opcional

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

  (tab?: Tab)=>void

  • tab

    Tab opcional

    Detalles sobre la pestaña duplicada. El objeto tabs.Tab no contiene url, pendingUrl, title ni favIconUrl si no se solicitó el permiso "tabs".

Devuelve

• Promesa<Tab|undefined>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

executeScript()

Promise &leq; MV2 Obsoleta a partir de Chrome 91

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Se reemplazó por scripting.executeScript en Manifest V3.

Inyecta código JavaScript en una página. Para obtener información detallada, consulta la sección sobre inserción programática del documento sobre secuencias de comandos de contenido.

Parámetros

• tabId

  número opcional

  El ID de la pestaña en la que se ejecutará la secuencia de comandos. El valor predeterminado es la pestaña activa de la ventana actual.

• detalles

  InjectDetails

  Detalles de la secuencia de comandos que se ejecutará. Se deben configurar el código o la propiedad del archivo, pero no ambos al mismo tiempo.

• callback

  Función opcional

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

  (result?: any[])=>void

  • resultado

    any[] opcional

    El resultado de la secuencia de comandos en cada fotograma insertado.

Devuelve

• Promesa<cualquier[]|no definido>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

get()

Promesa

chrome.tabs.get(
  tabId: number,
  callback?: function,
)

Recupera detalles sobre la pestaña especificada.

Parámetros

• tabId

  número

• callback

  Función opcional

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

  (tab: Tab)=>void

  • tab

    Tab

Devuelve

• Promise<Tab>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getAllInWindow()

Promise &leq; MV2 Obsoleto

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Usa tabs.query {windowId: windowId}.

Obtiene detalles sobre todas las pestañas en la ventana especificada.

Parámetros

• windowId

  número opcional

  La configuración predeterminada es la ventana actual.

• callback

  Función opcional

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

  (tabs: Tab[])=>void

  • pestañas

    Tabulador

Devuelve

• Promise<Tab[]>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getCurrent()

Promesa

chrome.tabs.getCurrent(
  callback?: function,
)

Obtiene la pestaña desde la que se realiza esta llamada a la secuencia de comandos. Muestra undefined si se llama desde un contexto que no es de pestaña (por ejemplo, una página en segundo plano o una vista emergente).

Parámetros

• callback

  Función opcional

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

  (tab?: Tab)=>void

  • tab

    Tab opcional

Devuelve

• Promesa<Tab|undefined>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getSelected()

Promise &leq; MV2 Obsoleto

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Usa tabs.query {active: true}.

Obtiene la pestaña seleccionada en la ventana especificada.

Parámetros

• windowId

  número opcional

  La configuración predeterminada es la ventana actual.

• callback

  Función opcional

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

  (tab: Tab)=>void

  • tab

    Tab

Devuelve

• Promise<Tab>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getZoom()

Promesa

chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
)

Obtiene el factor de zoom actual de una pestaña especificada.

Parámetros

• tabId

  número opcional

  El ID de la pestaña de la que se obtendrá el factor de zoom actual; de forma predeterminada, se muestra la pestaña activa de la ventana actual.

• callback

  Función opcional

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

  (zoomFactor: number)=>void

  • zoomFactor

    número

    El factor de zoom actual de la pestaña.

Devuelve

• Promesa<number>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getZoomSettings()

Promesa

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

Obtiene la configuración de zoom actual de una pestaña especificada.

Parámetros

• tabId

  número opcional

  ID de la pestaña de la que se obtendrá la configuración de zoom actual; de manera predeterminada, es la pestaña activa de la ventana actual.

• callback

  Función opcional

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

  (zoomSettings: ZoomSettings)=>void

  • zoomSettings

    ZoomSettings

    La configuración de zoom actual de la pestaña.

Devuelve

• Promise<ZoomSettings>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

goBack()

Promesa Chrome 72 y versiones posteriores

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Vuelve a la página anterior si hay una disponible.

Parámetros

• tabId

  número opcional

  ID de la pestaña a la que se debe navegar atrás; de forma predeterminada, se muestra la pestaña seleccionada de la ventana actual.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

goForward()

Promesa Chrome 72 y versiones posteriores

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Avanza a la página siguiente si hay una disponible.

Parámetros

• tabId

  número opcional

  ID de la pestaña por la que se navegará; el valor predeterminado es la pestaña seleccionada de la ventana actual.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

group()

Promesa Chrome 88 y versiones posteriores

chrome.tabs.group(
  options: object,
  callback?: function,
)

Agrega una o más pestañas a un grupo especificado o, si no se especifica ningún grupo, agrega las pestañas dadas a un grupo recién creado.

Parámetros

• Opciones

  objeto

  • createProperties

    objeto opcional

    Configuraciones para crear un grupo. No se puede usar si ya se especificó el ID de grupo.

    • windowId

      número opcional

      La ventana del grupo nuevo. El valor predeterminado es la ventana actual.

  • groupId

    número opcional

    El ID del grupo al que se agregarán las pestañas. Si no se especifica, se creará un grupo nuevo.

  • tabIds

    número|[número,...número[]]

    El ID de pestaña o la lista de ID de pestaña que se agregarán al grupo especificado.

• callback

  Función opcional

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

  (groupId: number)=>void

  • groupId

    número

    El ID del grupo al que se agregaron las pestañas.

Devuelve

• Promesa<number>

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

highlight()

Promesa

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

Destaca las pestañas proporcionadas y se enfoca en la primera del grupo. No parecerá hacer nada si la pestaña especificada está activa en este momento.

Parámetros

• highlightInfo

  objeto

  • pestañas

    número|número[]

    Uno o más índices de pestañas para destacar.

  • windowId

    número opcional

    La ventana que contiene las pestañas.

• callback

  Función opcional

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

  (window: Window)=>void

  • ventana

    Ventana

    Contiene detalles sobre la ventana cuyas pestañas se destacaron.

Devuelve

• Promesa<windows.Window>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

insertCSS()

Promise &leq; MV2 Obsoleta a partir de Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Se reemplazó por scripting.insertCSS en Manifest V3.

Inyecta CSS en una página. Los diseños insertados con este método se pueden quitar con scripting.removeCSS. Para obtener información detallada, consulta la sección sobre inserción programática del documento sobre secuencias de comandos de contenido.

Parámetros

• tabId

  número opcional

  ID de la pestaña en la que se insertará el CSS; de forma predeterminada, se muestra la pestaña activa de la ventana actual.

• detalles

  InjectDetails

  Detalles del texto CSS que se insertará Se deben configurar el código o la propiedad del archivo, pero no ambos al mismo tiempo.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

move()

Promesa

chrome.tabs.move(
  tabIds: number|number[],
  moveProperties: object,
  callback?: function,
)

Mueve una o más pestañas a una nueva posición dentro de su ventana, o a una nueva ventana. Ten en cuenta que las pestañas solo se pueden mover hacia y desde ventanas normales (window.type === "normal").

Parámetros

• tabIds

  número|número[]

  El ID de pestaña o la lista de ID de pestaña que se moverá.

• moveProperties

  objeto

  • index

    número

    La posición a la que se moverá la ventana. Usa -1 para colocar la pestaña al final de la ventana.

  • windowId

    número opcional

    La configuración predeterminada es la ventana en la que se encuentra la pestaña actualmente.

• callback

  Función opcional

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

  (tabs: Tab|Tab[])=>void

  • pestañas

    Tab|Tab[]

    Detalles sobre las pestañas movidas.

Devuelve

• Promesa<Tab|Tab[]>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

query()

Promesa

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

Obtiene todas las pestañas que tienen las propiedades especificadas o todas las pestañas si no se especificaron propiedades.

Parámetros

• queryInfo

  objeto

  • activo

    booleano opcional

    Si las pestañas están activas en sus ventanas

  • Audible

    booleano opcional

    Chrome 45 y versiones posteriores

    Indica si las pestañas tienen sonido.

  • autoDiscardable

    booleano opcional

    Chrome 54 y versiones posteriores

    Si el navegador puede descartar automáticamente las pestañas cuando los recursos son bajos

  • currentWindow

    booleano opcional

    Si las pestañas se encuentran en la ventana actual.

  • descartado

    booleano opcional

    Chrome 54 y versiones posteriores

    Si se descartan las pestañas. Una pestaña descartada es aquella cuyo contenido se descargó de la memoria, pero aún está visible en la barra de pestañas. Su contenido se volverá a cargar la próxima vez que se active.

  • groupId

    número opcional

    Chrome 88 y versiones posteriores

    El ID del grupo en el que se encuentran las pestañas, o tabGroups.TAB_GROUP_ID_NONE para las pestañas no agrupadas.

  • destacado

    booleano opcional

    Si las pestañas están destacadas.

  • index

    número opcional

    La posición de las pestañas dentro de sus ventanas

  • lastFocusedWindow

    booleano opcional

    Si las pestañas se encuentran en la última ventana enfocada.

  • silenciado

    booleano opcional

    Chrome 45 y versiones posteriores

    Si las pestañas están silenciadas.

  • marcada

    booleano opcional

    Si las pestañas están fijadas.

  • status

    TabStatus opcional

    Estado de carga de la pestaña

  • título

    cadena opcional

    Haz coincidir los títulos de las páginas con un patrón. Esta propiedad se ignora si la extensión no tiene el permiso "tabs".

  • url

    string|string[] optional

    Haz coincidir las pestañas con uno o más patrones de URL. Los identificadores de fragmentos no coinciden. Esta propiedad se ignora si la extensión no tiene el permiso "tabs".

  • windowId

    número opcional

    El ID de la ventana superior o windows.WINDOW_ID_CURRENT para la ventana actual.

  • windowType

    WindowType opcional

    El tipo de ventana en la que se encuentran las pestañas.

• callback

  Función opcional

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

  (result: Tab[])=>void

  • resultado

    Tabulador

Devuelve

• Promise<Tab[]>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

reload()

Promesa

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Vuelve a cargar una pestaña.

Parámetros

• tabId

  número opcional

  El ID de la pestaña que se volverá a cargar; el valor predeterminado es la pestaña seleccionada de la ventana actual.

• reloadProperties

  objeto opcional

  • bypassCache

    booleano opcional

    Determina si se debe omitir el almacenamiento en caché local. La configuración predeterminada es false.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

remove()

Promesa

chrome.tabs.remove(
  tabIds: number|number[],
  callback?: function,
)

Cierra una o más pestañas.

Parámetros

• tabIds

  número|número[]

  El ID de pestaña o la lista de ID de pestaña que se cerrará.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

removeCSS()

Promise Chrome 87 y versiones posteriores &leq; MV2 Obsoleto a partir de Chrome 91

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Se reemplazó por scripting.removeCSS en Manifest V3.

Se quita de una página CSS que se insertó anteriormente mediante una llamada a scripting.insertCSS.

Parámetros

• tabId

  número opcional

  Indica el ID de la pestaña de la que se quitará el CSS. De forma predeterminada, se muestra la pestaña activa de la ventana actual.

• detalles

  DeleteInjectionDetails

  Detalles del texto CSS que se quitará Se deben configurar el código o la propiedad del archivo, pero no ambos al mismo tiempo.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

sendMessage()

Promesa

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
)

Envía un solo mensaje a las secuencias de comandos de contenido de la pestaña especificada, con una devolución de llamada opcional para que se ejecute cuando se devuelva una respuesta. Se activa el evento runtime.onMessage en cada secuencia de comandos de contenido que se ejecuta en la pestaña especificada para la extensión actual.

Parámetros

• tabId

  número

• message

  cualquiera

  El mensaje que se enviará. Este mensaje debe ser un objeto que admita JSON.

• Opciones

  objeto opcional

  • documentId

    cadena opcional

    Chrome 106 y versiones posteriores

    Envía un mensaje a un documento específico que identifique documentId, en lugar de enviar un mensaje a todos los marcos de la pestaña.

  • frameId

    número opcional

    Envía un mensaje a un marco específico identificado por frameId en lugar de a todos los marcos de la pestaña.

• callback

  Función opcional

  Chrome 99 y versiones posteriores

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

  (response: any)=>void

  • respuesta

    cualquiera

    Objeto de respuesta JSON enviado por el controlador del mensaje. Si se produce un error durante la conexión a la pestaña especificada, se llama a la devolución de llamada sin argumentos y se establece runtime.lastError en el mensaje de error.

Devuelve

• Promesa<cualquiera>

  Chrome 99 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

sendRequest()

Promise &leq; MV2 Obsoleto

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Usa runtime.sendMessage.

Envía una sola solicitud a las secuencias de comandos de contenido de la pestaña especificada, con una devolución de llamada opcional para que se ejecute cuando se devuelve una respuesta. Se activa el evento extension.onRequest en cada secuencia de comandos de contenido que se ejecuta en la pestaña especificada para la extensión actual.

Parámetros

• tabId

  número

• request

  cualquiera

• callback

  Función opcional

  Chrome 99 y versiones posteriores

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

  (response: any)=>void

  • respuesta

    cualquiera

    Objeto de respuesta JSON enviado por el controlador de la solicitud. Si se produce un error durante la conexión a la pestaña especificada, se llama a la devolución de llamada sin argumentos y se establece runtime.lastError en el mensaje de error.

Devuelve

• Promesa<cualquiera>

  Chrome 99 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

setZoom()

Promesa

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Acerca el zoom a una pestaña especificada.

Parámetros

• tabId

  número opcional

  ID de la pestaña a acercar; valor predeterminado a la pestaña activa de la ventana actual.

• zoomFactor

  número

  El nuevo factor de zoom. Un valor de 0 establece el factor de zoom predeterminado actual en la pestaña. Los valores superiores a 0 especifican un factor de zoom (posiblemente no predeterminado) para la pestaña.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

setZoomSettings()

Promesa

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

Establece los ajustes de zoom para una pestaña específica, lo cual define la manera en que se controlan los cambios de zoom. Cuando navegues por la pestaña, esta configuración se restablecerá a la configuración predeterminada.

Parámetros

• tabId

  número opcional

  ID de la pestaña para la que se cambiará la configuración de zoom; de manera predeterminada, se muestra la pestaña activa de la ventana actual.

• zoomSettings

  ZoomSettings

  Define cómo se manejan los cambios de zoom y en qué alcance.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

ungroup()

Promesa Chrome 88 y versiones posteriores

chrome.tabs.ungroup(
  tabIds: number|[number,...number[]],
  callback?: function,
)

Elimina una o más pestañas de sus respectivos grupos. Si algún grupo se deja vacío, se borrará.

Parámetros

• tabIds

  número|[número,...número[]]

  El ID de pestaña o la lista de ID de pestaña que se quitarán de sus respectivos grupos.

• callback

  Función opcional

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

  ()=>void

Devuelve

• Promise<void>

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

update()

Promesa

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

Modifica las propiedades de una pestaña. No se modifican las propiedades que no se especifican en updateProperties.

Parámetros

• tabId

  número opcional

  El valor predeterminado es la pestaña seleccionada de la ventana actual.

• updateProperties

  objeto

  • activo

    booleano opcional

    Si la pestaña debe estar activa. No afecta si la ventana está enfocada (consulta windows.update).

  • autoDiscardable

    booleano opcional

    Chrome 54 y versiones posteriores

    Si el navegador debe descartar automáticamente la pestaña cuando los recursos son bajos

  • destacado

    booleano opcional

    Agrega o quita la pestaña de la selección actual.

  • silenciado

    booleano opcional

    Chrome 45 y versiones posteriores

    Si se debe silenciar la pestaña.

  • openerTabId

    número opcional

    El ID de la pestaña que la abrió. Si se especifica, la pestaña del abridor debe estar en la misma ventana que esta pestaña.

  • marcada

    booleano opcional

    Si se debe fijar la pestaña.

  • seleccionados

    booleano opcional

    Obsoleto

    Usa resaltados.

    Si se debe seleccionar la pestaña.

  • url

    cadena opcional

    Una URL a la que navegar en la pestaña. No se admiten las URLs de JavaScript. En su lugar, usa scripting.executeScript.

• callback

  Función opcional

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

  (tab?: Tab)=>void

  • tab

    Tab opcional

    Detalles sobre la pestaña actualizada. El objeto tabs.Tab no contiene url, pendingUrl, title ni favIconUrl si no se solicitó el permiso "tabs".

Devuelve

• Promesa<Tab|undefined>

  Chrome 88 y versiones posteriores

  Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

Eventos

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

Se activa cuando cambia la pestaña activa en una ventana. Ten en cuenta que es posible que la URL de la pestaña no esté configurada en el momento en que se activó este evento, pero puedes escuchar los eventos onUpdated para recibir una notificación cuando se configure una URL.

Parámetros

• callback

  la función

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

  (activeInfo: object)=>void

  • activeInfo

    objeto

    • tabId

      número

      El ID de la pestaña que se activó.

    • windowId

      número

      El ID de la ventana en la que cambió la pestaña activa

onActiveChanged

&leq; MV2 Obsoleto

chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Usa tabs.onActivated.

Se activa cuando cambia la pestaña seleccionada en una ventana. Ten en cuenta que es posible que la URL de la pestaña no esté configurada en el momento en que se activó este evento, pero puedes escuchar los eventos tabs.onUpdated para recibir una notificación cuando se configure una URL.

Parámetros

• callback

  la función

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

  (tabId: number,selectInfo: object)=>void

  • tabId

    número

  • selectInfo

    objeto

    • windowId

      número

      El ID de la ventana en la que cambió la pestaña seleccionada

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

Se activa cuando una pestaña se adjunta a una ventana; por ejemplo, porque se movió entre ventanas

Parámetros

• callback

  la función

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

  (tabId: number,attachInfo: object)=>void

  • tabId

    número

  • attachInfo

    objeto

    • newPosition

      número

    • newWindowId

      número

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

Se activa cuando se crea una pestaña. Ten en cuenta que es posible que la URL de la pestaña y la pertenencia a un grupo de pestañas no se establezcan cuando se active el evento, pero puedes escuchar los eventos onUpdated para recibir una notificación cuando se configure una URL o se agregue la pestaña a un grupo de pestañas.

Parámetros

• callback

  la función

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

  (tab: Tab)=>void

  • tab

    Tab

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

Se activa cuando se separa una pestaña de una ventana; por ejemplo, porque se movió entre ventanas.

Parámetros

• callback

  la función

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

  (tabId: number,detachInfo: object)=>void

  • tabId

    número

  • detachInfo

    objeto

    • oldPosition

      número

    • oldWindowId

      número

onHighlightChanged

&leq; MV2 Obsoleto

chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Usa tabs.onHighlighted.

Se activa cuando cambian las pestañas destacadas o seleccionadas en una ventana.

Parámetros

• callback

  la función

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

  (selectInfo: object)=>void

  • selectInfo

    objeto

    • tabIds

      número

      Todas las pestañas destacadas en la ventana.

    • windowId

      número

      La ventana cuyas pestañas cambiaron.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

Se activa cuando cambian las pestañas destacadas o seleccionadas en una ventana.

Parámetros

• callback

  la función

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

  (highlightInfo: object)=>void

  • highlightInfo

    objeto

    • tabIds

      número

      Todas las pestañas destacadas en la ventana.

    • windowId

      número

      La ventana cuyas pestañas cambiaron.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

Se activa cuando una pestaña se mueve dentro de una ventana. Solo se activa un evento de movimiento, que representa la pestaña que el usuario movió directamente. Los eventos de movimiento no se activan para las demás pestañas que se deben mover en respuesta a la pestaña que se movió manualmente. Este evento no se activa cuando se mueve una pestaña entre ventanas. Para obtener más información, consulta tabs.onDetached.

Parámetros

• callback

  la función

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

  (tabId: number,moveInfo: object)=>void

  • tabId

    número

  • moveInfo

    objeto

    • fromIndex

      número

    • toIndex

      número

    • windowId

      número

onRemoved

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

Se activa cuando se cierra una pestaña.

Parámetros

• callback

  la función

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

  (tabId: number,removeInfo: object)=>void

  • tabId

    número

  • removeInfo

    objeto

    • isWindowClosing

      boolean

      Es verdadero cuando se cerró la pestaña porque se cerró su ventana superior.

    • windowId

      número

      La ventana cuya pestaña está cerrada.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

Se activa cuando una pestaña se reemplaza por otra debido a la renderización previa o instantánea.

Parámetros

• callback

  la función

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

  (addedTabId: number,removedTabId: number)=>void

  • addedTabId

    número

  • removedTabId

    número

onSelectionChanged

&leq; MV2 Obsoleto

chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Usa tabs.onActivated.

Se activa cuando cambia la pestaña seleccionada en una ventana.

Parámetros

• callback

  la función

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

  (tabId: number,selectInfo: object)=>void

  • tabId

    número

  • selectInfo

    objeto

    • windowId

      número

      El ID de la ventana en la que cambió la pestaña seleccionada

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

Se activa cuando se actualiza una pestaña.

Parámetros

• callback

  la función

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

  (tabId: number,changeInfo: object,tab: Tab)=>void

  • tabId

    número

  • changeInfo

    objeto

    • Audible

      booleano opcional

      Chrome 45 y versiones posteriores

      Nuevo estado audible de la pestaña.

    • autoDiscardable

      booleano opcional

      Chrome 54 y versiones posteriores

      El nuevo estado de la pestaña se puede descartar automáticamente.

    • descartado

      booleano opcional

      Chrome 54 y versiones posteriores

      El nuevo estado descartado de la pestaña.

    • favIconUrl

      cadena opcional

      La nueva URL del ícono de página de la pestaña.

    • groupId

      número opcional

      Chrome 88 y versiones posteriores

      El nuevo grupo de la pestaña.

    • mutedInfo

      MutedInfo opcional

      Chrome 46 y versiones posteriores

      El nuevo estado silenciado de la pestaña y el motivo del cambio.

    • marcada

      booleano opcional

      El nuevo estado fijado de la pestaña.

    • status

      TabStatus opcional

      Estado de carga de la pestaña

    • título

      cadena opcional

      Chrome 48 y versiones posteriores

      Nuevo título de la pestaña.

    • url

      cadena opcional

      Es la URL de la pestaña si cambió.

  • tab

    Tab

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

Se activa cuando se hace zoom en una pestaña.

Parámetros

• callback

  la función

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

  (ZoomChangeInfo: object)=>void

  • ZoomChangeInfo

    objeto

    • newZoomFactor

      número

    • oldZoomFactor

      número

    • tabId

      número

    • zoomSettings

      ZoomSettings