Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLMediaElement : méthode seekToNextFrame()

Obsolète

Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

La méthode seekToNextFrame() de l'interface HTMLMediaElement avance de manière asynchrone la position de lecture actuelle vers l'image suivante dans le média.

Attention : Cette méthode non standard fait partie d'un processus d'expérimentation autour du support de l'accès aux médias en dehors du temps réel pour des tâches telles que le filtrage, l'édition, etc. Vous ne devez pas utiliser cette méthode dans du code de production, car son implémentation peut changer ou être supprimée sans préavis. Vous êtes cependant invité à l'expérimenter.

Cette méthode permet d'accéder aux images d'un média vidéo sans que le média ne soit lu en temps réel. Elle permet également d'accéder au média en utilisant les images comme unité de recherche plutôt que les codes temporels (bien que seulement en recherchant une image à la fois jusqu'à atteindre l'image souhaitée). Les utilisations possibles de cette méthode incluent le filtrage et l'édition de contenu vidéo.

Cette méthode retourne immédiatement une promesse (Promise), dont le gestionnaire de résolution est appelé lorsque l'opération de recherche est terminée. De plus, un évènement seeked est envoyé pour informer les parties intéressées qu'une recherche a eu lieu. Si la recherche échoue parce que le média est déjà à la dernière image, un évènement seeked se produit, suivi immédiatement d'un évènement ended.

Si aucun média vidéo n'est présent sur l'élément média, ou si le média n'est pas consultable, rien ne se passe.

Syntaxe

js
seekToNextFrame()

Paramètres

Aucun.

Valeur de retour

Une promesse (Promise) qui est remplie une fois que l'opération de recherche est terminée.

Spécifications

Ne fait partie d'aucune spécification.

Compatibilité des navigateurs