JSPM

  • Created
  • Published
  • Downloads 6902409
  • Score
    100M100P100Q227238F
  • License MIT

A minimal, functional history implementation for JavaScript

Package Exports

  • history
  • history/lib/Actions
  • history/lib/DOMStateStorage
  • history/lib/DOMUtils
  • history/lib/ExecutionEnvironment
  • history/lib/createBrowserHistory
  • history/lib/createDOMHistory
  • history/lib/createHashHistory
  • history/lib/createHistory
  • history/lib/createLocation
  • history/lib/createMemoryHistory
  • history/lib/useBasename
  • history/lib/useBasename.js
  • history/lib/useBeforeUnload
  • history/lib/useBeforeUnload.js
  • history/lib/useQueries

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (history) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

build status npm package react-router channel on slack

history

history is a JavaScript library that lets you easily manage session history in browsers, testing environments, and (soon, via React Native) native devices. history abstracts away the differences in these different platforms and provides a minimal API that lets you manage the history stack, navigate, confirm navigation, and persist state between sessions. history is library-agnostic and may easily be included in any JavaScript project.

Installation

$ npm install history

Basic Usage

A "history" encapsulates navigation between different screens in your app, and notifies listeners when the current screen changes.

import { createHistory } from 'history'

let history = createHistory()

// Listen for changes to the current location. The
// listener is called once immediately.
let unlisten = history.listen(function (location) {
  console.log(location.pathname)
})

history.pushState({ the: 'state' }, '/the/path?a=query')

// When you're finished, stop the listener.
unlisten()

Read more about getting started in the documentation!

Thanks

A big thank-you to Dan Shaw for letting us use the history npm package name! Thanks Dan!

Also, thanks to BrowserStack for providing the infrastructure that allows us to run our build in real browsers.