main
Branches
main (6.22.3)dev
Versions
6.22.3v4/5.xv3.x
useLocation
On this page

useLocation

Type declaration
declare function useLocation(): Location;

interface Location<State = any> extends Path {
  state: State;
  key: string;
}

interface Path {
  pathname: string;
  search: string;
  hash: string;
}

This hook returns the current location object. This can be useful if you'd like to perform some side effect whenever the current location changes.

import * as React from 'react';
import { useLocation } from 'react-router-dom';

function App() {
  let location = useLocation();

  React.useEffect(() => {
    // Google Analytics
    ga('send', 'pageview');
  }, [location]);

  return (
    // ...
  );
}

Properties

location.hash

The hash of the current URL.

location.key

The unique key of this location.

location.pathname

The path of the current URL.

location.search

The query string of the current URL.

location.state

The state value of the location created by <Link state> or navigate.

Docs and examples CC 4.0
Edit