History API

history.

void search(HistoryQuery query, void callback(HistoryItem[] results))

void clear(HistoryQuery query) // defaults to clearing all. Should we prompt?

// NOTE: these could be done in a v2 -- I don't see huge use cases for them, except perhaps for synchronization.

void create({int date, string url, string title, [string favIconUrl], [int fromId]}, [void callback(HistoryItem result)])

event onHistoryItemCreated(HistoryItem new)

event onHistoryItemRemoved(HistoryItem removed)

struct HistoryItem {

int id

int date

string url

string title

string favIconUrl

int fromId

int totalVisitCount

int totalTypedCount

}

struct HistoryQuery {

// limited to 100, defaults to current day.

optional int[] ids

optional string search

optional Date startDate

optional Date endDate

}