node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

memento-client

memento-client

Build Status npm install npm version js-standard-style License

simple interface to memento services

usage

var memento = require('memento-client')
 
memento(url, listAll)
 
function listAll (err, mementos) {
  console.log(mementos) // [{href: url, rel: identifier, datetime: timestamp}] 
}
 
// provide an options object with time to narrow your search! 
memento(url, {time: '2010'}, list2010)
 
function list2010 (err, mementos) {
  console.log(mementos) // all found from 2010 
}
 
// also optionally provide your own host's timemap! (defaults to the wayback machine) 
 
memento(url, {host: 'http://some-other-memento-provider/timemap'}, getCustom)
 
function getCustom (err, mementos) {
  // ta-da! 
}

notes

  • identifier is one of: first memento, prev memento, next memento, memento, or last memento.
  • finds nearest available memento for url to opts.time
  • opts.time can be any reasonable approximation of a datetime and it should Just Work(tm)
  • filters out non-mementos from response (timegate and original url)
  • first and last entries in response will always be the first and last mementos available.

license

MIT