DocumentTimeline()

options Optional

An object specifying options for the new timeline. The following properties are available:

originTime Optional

A number that specifies the zero time for the DocumentTimeline as a number of milliseconds relative to Performance.timeOrigin. Defaults to 0.

A DocumentTimeline with an originTime of zero counts time starting from Performance.timeOrigin. This is the same behavior as Document.timeline.

const timeline = new DocumentTimeline();
console.log(timeline.currentTime === document.timeline.currentTime); // true

Setting a non-zero originTime will offset the DocumentTimeline from Document.timeline by that amount:

const offsetTimeline = new DocumentTimeline({ originTime: 500 });
console.log(document.timeline.currentTime - offsetTimeline.currentTime); // 500

A DocumentTimeline relative to the current moment can be constructed with:

const nowTimeline = new DocumentTimeline({
  originTime: document.timeline.currentTime,
});
console.log(nowTimeline.currentTime); // 0

• Web Animations API
• AnimationTimeline
• DocumentTimeline