client for wayback machine data
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test
.gitignore
.travis.yml
LICENSE
README.md
index.js
package.json

README.md

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