chrome.wallpaper

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.wallpaper API om de ChromeOS-achtergrond te wijzigen.

Rechten

wallpaper

Beschikbaarheid

Chrome 43 of hoger Alleen ChromeOS

Manifest

Je moet het recht 'wallpaper' definiëren in het manifest van de app om de wallpaper-API te gebruiken. Voorbeeld:

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

Voorbeelden

Als je bijvoorbeeld de achtergrond wilt instellen als de afbeelding op https://example.com/a_file.png, kun je chrome.wallpaper.setWallpaper zo aanroepen:

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

Typen

WallpaperLayout

Chrome 44+

De ondersteunde achtergrondindelingen.

Enum

"STRETCH"

"CENTER"

"CENTER_CROPPED"

Methoden

setWallpaper()

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

Stelt de achtergrond in op de afbeelding op url of wallpaperData met de opgegeven layout

Parameters

  • details

    object

    • gegevens

      ArrayBuffer optioneel

      De achtergrondafbeelding met jpeg- of png-codering als een ArrayBuffer.

    • bestandsnaam

      tekenreeks

      De bestandsnaam van de opgeslagen achtergrond.

    • indeling

      WallpaperLayout

      De ondersteunde achtergrondindelingen.

    • thumbnail

      booleaans optioneel

      Waar als er een thumbnail van 128 x 60 moet worden gegenereerd. Indeling en verhouding worden nog niet ondersteund.

    • url

      tekenreeks optioneel

      De URL van de achtergrond die moet worden ingesteld (kan relatief zijn).

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (thumbnail?: ArrayBuffer) => void

    • thumbnail

      ArrayBuffer optioneel

      De jpeg-gecodeerde thumbnail van de achtergrond. Deze wordt gegenereerd door het formaat van de achtergrond aan te passen naar 128 x 60.

Retourzendingen

  • Promise<ArrayBuffer | undefined>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.