chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Description

Utilisez l'API chrome.wallpaper pour modifier le fond d'écran ChromeOS.

Autorisations

wallpaper

Disponibilité

Chrome 43 ou version ultérieure ChromeOS uniquement

Fichier manifeste

Vous devez déclarer l'autorisation "wallpaper" dans le fichier manifeste de l'application pour utiliser l'API Wallpaper. Exemple :

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

Exemples

Par exemple, pour définir le fond d'écran sur l'image à l'adresse https://example.com/a_file.png, vous pouvez appeler chrome.wallpaper.setWallpaper de la manière suivante :

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

Types

WallpaperLayout

Chrome 44 ou version ultérieure

Mises en page de fond d'écran compatibles.

Énumération

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Méthodes

setWallpaper()

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

Définit le fond d'écran sur l'image à l'url ou sur wallpaperData avec la mise en page spécifiée.

Paramètres

  • détails

    objet

    • données

      ArrayBuffer facultatif

      Image de fond d'écran encodée au format JPEG ou PNG sous la forme d'un ArrayBuffer.

    • filename

      chaîne

      Nom du fichier du fond d'écran enregistré.

    • mise en page

      WallpaperLayout

      Mises en page de fond d'écran compatibles.

    • vignette

      boolean facultatif

      "True" si une miniature de 128 x 60 doit être générée. La mise en page et le ratio ne sont pas encore pris en charge.

    • url

      chaîne facultatif

      URL du fond d'écran à définir (peut être relative).

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (thumbnail?: ArrayBuffer) => void

    • vignette

      ArrayBuffer facultatif

      Vignette du fond d'écran encodée au format JPEG. Il est généré en redimensionnant le fond d'écran à 128 x 60.

Renvoie

  • Promise<ArrayBuffer | undefined>

    Chrome 96 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.