This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The timeline readonly property of the Document interface represents the default timeline of the current document. This timeline is a special instance of DocumentTimeline that is automatically created on page load. 

This timeline is unique to each document and persists for the lifetime of the document including calls to

The time values for this timeline are calculated as a fixed offset from the global clock such that the zero time corresponds to the navigationStart moment plus a signed delta known as the origin time. Prior to establishing the navigationStart moment, the document timeline is inactive.

Note: A document timeline that is associated with a non-active document is also considered to be inactive.


var pageTimeline = document.timeline;
var thisMoment = pageTimeline.currentTime;


A DocumentTimeline object.


Specification Status Comment
Web Animations
The definition of 'document.timeline' in that specification.
Working Draft Editor's draft.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support 48 (48)[1] No support No support No support
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support No support No support No support No support No support No support No support

[1] Currently supported only in Firefox Nightly.

See also

Document Tags and Contributors

Contributors to this page: chrisdavidmills, rachelnabors
Last updated by: chrisdavidmills,