chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Descripción

Usa la API de chrome.wallpaper para cambiar el fondo de pantalla de ChromeOS.

Permisos

wallpaper

Disponibilidad

Chrome 43 y versiones posteriores Solo en ChromeOS

Manifiesto

Debes declarar el permiso "wallpaper" en el manifiesto de la app para usar la API de fondo de pantalla. Por ejemplo:

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

Ejemplos

Por ejemplo, para establecer el fondo de pantalla como la imagen en https://example.com/a_file.png, puedes llamar a chrome.wallpaper.setWallpaper de la siguiente manera:

chrome.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

Tipos

WallpaperLayout

Chrome 44 y versiones posteriores

Los diseños de fondo de pantalla admitidos.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Métodos

setWallpaper()

Promise 
chrome.wallpaper.setWallpaper(
  details: object,
  callback?: function,
): Promise<ArrayBuffer | undefined>

Establece el fondo de pantalla en la imagen en url o wallpaperData con el diseño especificado

Parámetros

  • detalles

    objeto

    • datos

      ArrayBuffer opcional

      Es la imagen de fondo de pantalla codificada en formato JPEG o PNG como un ArrayBuffer.

    • filename

      string

      Es el nombre del archivo del fondo de pantalla guardado.

    • diseño

      WallpaperLayout

      Los diseños de fondo de pantalla admitidos.

    • miniatura

      booleano opcional

      Es verdadero si se debe generar una miniatura de 128 x 60. Aún no se admiten el diseño ni la proporción.

    • url

      string opcional

      Es la URL del fondo de pantalla que se establecerá (puede ser relativa).

  • callback

    función opcional

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

    (thumbnail?: ArrayBuffer) => void

    • miniatura

      ArrayBuffer opcional

      La miniatura del fondo de pantalla codificada en JPEG. Se genera cambiando el tamaño del fondo de pantalla a 128 × 60.

Muestra

  • Promise<ArrayBuffer | undefined>

    Chrome 96 y versiones posteriores

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