Skip to main content

Type Alias: PositionDiscontinuityReason

type PositionDiscontinuityReason = "seek" | "auto-advance";

Defined in: packages/player/src/player.ts:817

Why the playback position jumped — the two causes this library can tell apart from mpv's own events, and no more.

  • 'seek' — mpv raised MPV_EVENT_SEEK, i.e. something asked for a new position in the current entry: Player.seekTo, Player.seekBy, a chapter jump, a lock-screen scrub, or a seek through the raw Player.command hatch.
  • 'auto-advance' — the current entry changed (playlist-pos moved), so the position restarted somewhere else entirely. It covers a natural queue advance, a playlist.next()/jumpTo(), a repeat wrap and a retry.

There is deliberately no third value for "a new file was loaded" or "the user did it": mpv does not report intent, and inventing a distinction that the event stream cannot support is how a typed API starts lying.