chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Important : Cette API ne fonctionne que sur ChromeOS.

Description

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

Autorisations

wallpaper

Disponibilité

Chrome 43 et versions ultérieures ChromeOS uniquement

Fichier manifeste

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

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

Exemples

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

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

Types

WallpaperLayout

Chrome 44 et versions ultérieures

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'adresse url ou 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 forme d'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

    booléen facultatif

    True si une miniature de 128 x 60 doit être générée. La mise en page et le format 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 et versions ultérieures

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