Uploaded image for project: 'Apache Cordova'
  1. Apache Cordova
  2. CB-4596

Documentation is not consistent for timestamp types

    XMLWordPrintableJSON

Details

    Description

      Compare Codova documentation for these timestamps:

      • Accelerometer > Acceleration.timestamp - timestamp: Creation timestamp in milliseconds. (DOMTimeStamp)
      • Compass > CompassHeading.timestamp - timestamp: The time at which this heading was determined. (milliseconds)
      • Geolocation > Position.timestamp - timestamp: Creation timestamp for coords. (Date)

      It is confusing that documentation describes all these "timestamps" to have different types.

      On closer inspection, for some reason the Position.timestamp really is (inconsistent with the others) returned as a Date object.

      But at least Acceleration/Compass ones seem to have same units so perhaps the documentation for those ones ought to consistently say they are DOMTimeStamp.
      Ref http://dev.w3.org/2006/webapi/WebIDL/#common-DOMTimeStamp

      Attachments

        Activity

          People

            purplecabbage Jesse MacFadyen
            dinglemouse Peter
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: