Time

Playback position and duration state for the player store

Tracks playback position and duration.

State

State	Type	Description
`currentTime`	`number`	Current playback position in seconds
`duration`	`number`	Total duration in seconds (0 if unknown)
`seeking`	`boolean`	Whether a seek operation is in progress

Actions

Action	Description
`seek(time)`	Seek to a position in seconds (returns a `Promise`)

Selector

Pass selectTime to usePlayer to subscribe to time state. Returns undefined if the time feature is not configured.

import { selectTime, usePlayer } from '@videojs/react';

function TimeDisplay() {
  const time = usePlayer(selectTime);
  if (!time) return null;

  return (
    <span>
      {Math.floor(time.currentTime)} / {Math.floor(time.duration)}
    </span>
  );
}

import { createPlayer, MediaElement, selectTime } from '@videojs/html';
import { videoFeatures } from '@videojs/html/video';

const { PlayerController, context } = createPlayer({ features: videoFeatures });

class TimeDisplay extends MediaElement {
  readonly #time = new PlayerController(this, context, selectTime);
}

API Reference

Parameters

Parameter	Type	Default
`state*`	`object`	`—`

Return Value

MediaTimeState | undefined