dom / latest / mediametadata / mediametadata.html /

MediaMetadata()

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The MediaMetadata() constructor creates a new MediaMetadata object.

Syntax

new MediaMetadata()
new MediaMetadata(metadata)

Parameters

metadata Optional

The metadata parameters are as follows:

  • title: The title of the media to be played.
  • artist: The name of the artist, group, creator, etc. of the media to be played.
  • album: The name of the album, or collection, containing the media to be played.
  • artwork: An array of images associated with the playing media.

Example

The following example creates a new MediaMetadata object using the correct format of metadata.

if ('mediaSession' in navigator){
  navigator.mediaSession.metadata = new MediaMetadata({
    title: 'Unforgettable',
    artist: 'Nat King Cole',
    album: 'The Ultimate Collection (Remastered)',
    artwork: [
      { src: 'https://dummyimage.com/96x96',   sizes: '96x96',   type: 'image/png' },
      { src: 'https://dummyimage.com/128x128', sizes: '128x128', type: 'image/png' },
      { src: 'https://dummyimage.com/192x192', sizes: '192x192', type: 'image/png' },
      { src: 'https://dummyimage.com/256x256', sizes: '256x256', type: 'image/png' },
      { src: 'https://dummyimage.com/384x384', sizes: '384x384', type: 'image/png' },
      { src: 'https://dummyimage.com/512x512', sizes: '512x512', type: 'image/png' },
    ]
  });
}

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
MediaMetadata
57
79
71
No
44
15
No
57
82
No
15
7.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaMetadata/MediaMetadata