Chrome Historian

A better wrapper for the Chrome History API that also merges in downloads from the Chrome Download API.

This is the secret sauce behind Better History

Managing a day's history

The Chrome History API has been known to return visits that do not fall between the requested dates and visits that are out of order. Querying a day's history via Chrome Historian will guarantee all returned visits occured on the requested day and are in descending order.

  dayHistorian = new Historian.Day(new Date())
 
  dayHistorian.fetch (visits) ->
    if visits
      console.log(visits)
    else
      console.log('Feature is not supported in your browser version')
 
  dayHistorian.destroy()
 
  dayHistorian.destroyHour(22)

Searching history

The Chrome History API has been known to return very generous matches (not in a good way). Searching via Chrome Historian will guarantee all returned visits have a title or url that partially matches the query.

  searchHistorian = new Historian.Search('gmail')
 
  searchHistorian.fetch maxResults: 10000, (visits) ->
    console.log(visits)
 
  # The search historian caches the last search via chrome's local storage api 
  searchHistorian.expireCache()
 
  # It's important to use these to delete because they both update the 
  # previous search cache to reflect the removals 
  searchHistorian.deleteUrl()
  searchHistorian.destroy()

Device Sessions

Easily interaction with Device browser sessions that are logged into the same Google account

  historian = new Historian.Devices()
 
  historian.fetch (devices) ->
    if devices
      console.log(devices) # ['Nexus 5', 'Desktop', 'Nexus 7'] 
    else
      console.log('Feature is not supported in your browser version')
 
    # ...a bit later 
 
    if devices
      historian.fetchSessions(devices[0], (sessions) ->
        console.log(sessions)
        # [{ 
        #   sessionId: 'session_sync43908482591051-257446.1' 
        #   sites: [] 
        # }] 

Simple deleting

  Historian.deleteUrl('http://google.com')
 
  Historian.deleteDownload('http://google.com/file.zip')
 
  Historian.deleteRange
    startTime: new Date('Aug 20, 2014')
    endTime: new Date('Aug 30, 2014')
 
  Historian.deleteAll()