HTMLMediaElement : méthode getStartDate()

Syntaxe

getStartDate()

Paramètres

Aucun.

Valeur de retour

Un objet Date représentant la date et l'heure de début du média. Si le média n'inclut pas d'informations de date et d'heure, l'objet Date retourné aura une valeur temporelle de NaN.

Description

En interne, chaque élément multimédia suit une date de début, qui commence comme NaN (non définie). Une fois que le navigateur a chargé suffisamment de données pour lire les métadonnées du média, il définit la date de début sur l'heure réelle correspondant au début du média — si le format en fournit une. Sinon, la date de début reste NaN.

Pour les médias qui définissent une heure et une date de début (par exemple, une diffusion télévisée en direct diffusée sur le web), getStartDate() retourne un objet Date correspondant à l'heure réelle à laquelle le média commence. Cela permet aux contrôles du lecteur multimédia d'afficher des heures absolues (comme « 14:30 ») plutôt que des heures relatives au début de la lecture (comme « 3 heures, 12 minutes »).

L'objet Date retourné aura une valeur temporelle de NaN (ce qui en fait une date invalide) dans l'un des cas suivants :

• Aucune donnée n'a encore été chargée (readyState est HAVE_NOTHING), donc la date de début n'a pas été définie.
• Le format du média n'inclut pas d'informations de date et d'heure.

La date de début n'est pas garantie d'être disponible dès que l'évènement loadedmetadata se déclenche. Par exemple, les flux HLS ^(angl.) transportent des dates dans des balises #EXT-X-PROGRAM-DATE-TIME au niveau des segments, qui peuvent ne pas avoir été lues à ce moment-là. Écouter plutôt l'évènement loadeddata est plus fiable à travers les formats, car à ce moment-là, le navigateur a chargé suffisamment de données pour déterminer la date de début.

Exemples

Afficher la date de début d'un flux en direct

Cet exemple récupère la date de début d'un flux en direct — la date et l'heure réelles auxquelles la diffusion a commencé, telles qu'elles sont intégrées dans le flux par le serveur — et l'affiche. Il écoute l'évènement loadeddata, qui se déclenche une fois que suffisamment de données ont été chargées pour que la date de début soit disponible.

HTML

<video src="livestream.m3u8" controls></video>
<output>Date de début&nbsp;: chargement…</output>

JavaScript

const video = document.querySelector("video");
const display = document.querySelector("output");

video.addEventListener("loadeddata", () => {
  const startDate = video.getStartDate();

  if (isNaN(startDate.getTime())) {
    display.textContent = "Date de début : non disponible";
  } else {
    display.textContent = `Date de début : ${startDate.toLocaleString()}`;
  }
});

Résultat

La sortie ci-dessous montre la date de début du média, telle que fournie par le serveur. Notez que cela est encodé dans les métadonnées d'exemple dans stream.m3u8 ^(angl.).

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'interface HTMLMediaElement
• La propriété HTMLMediaElement.currentTime
• La propriété HTMLMediaElement.duration