add useRouter hook

packages/react-router-dom/.size-snapshot.json

@@ -14,13 +14,13 @@
     }
   },
   "umd/react-router-dom.js": {
-    "bundled": 131334,
-    "minified": 46991,
-    "gzipped": 14275
+    "bundled": 131656,
+    "minified": 47150,
+    "gzipped": 14295
   },
   "umd/react-router-dom.min.js": {
-    "bundled": 87085,
-    "minified": 29827,
-    "gzipped": 9885
+    "bundled": 87264,
+    "minified": 29901,
+    "gzipped": 9899
   }
 }

packages/react-router/.size-snapshot.json

@@ -1,8 +1,8 @@
 {
   "esm/react-router.js": {
-    "bundled": 24890,
-    "minified": 14513,
-    "gzipped": 3839,
+    "bundled": 25272,
+    "minified": 14825,
+    "gzipped": 3868,
     "treeshaked": {
       "rollup": {
         "code": 2389,
@@ -14,13 +14,13 @@
     }
   },
   "umd/react-router.js": {
-    "bundled": 103056,
-    "minified": 36690,
-    "gzipped": 11666
+    "bundled": 103377,
+    "minified": 36847,
+    "gzipped": 11687
   },
   "umd/react-router.min.js": {
-    "bundled": 62526,
-    "minified": 22088,
-    "gzipped": 7748
+    "bundled": 62704,
+    "minified": 22160,
+    "gzipped": 7762
   }
 }

packages/react-router/modules/__tests__/useRouter-test.js

@@ -0,0 +1,45 @@
+import React from "react";
+import ReactDOM from "react-dom";
+import { MemoryRouter, Route, useRouter } from "react-router";
+
+import renderStrict from "./utils/renderStrict.js";
+
+describe("useRouter", () => {
+  const node = document.createElement("div");
+
+  afterEach(() => {
+    ReactDOM.unmountComponentAtNode(node);
+  });
+
+  it("returns the current location, match and history objects", () => {
+    let routeComponentProps = {};
+
+    function HomePage() {
+      routeComponentProps = useRouter();
+      return null;
+    }
+
+    renderStrict(
+      <MemoryRouter initialEntries={["/home"]}>
+        <Route path="/home">
+          <HomePage />
+        </Route>
+      </MemoryRouter>,
+      node
+    );
+
+    expect(typeof routeComponentProps.location).toBe("object");
+    expect(routeComponentProps.location).toMatchObject({
+      pathname: "/home"
+    });
+    expect(typeof routeComponentProps.history).toBe("object");
+    expect(typeof routeComponentProps.history.push).toBe("function");
+
+    expect(typeof routeComponentProps.match).toBe("object");
+    expect(routeComponentProps.match).toMatchObject({
+      path: "/home",
+      url: "/home",
+      isExact: true
+    });
+  });
+});

packages/react-router/modules/hooks.js

@@ -51,3 +51,14 @@ export function useRouteMatch(path) {
     ? matchPath(useLocation().pathname, path)
     : useContext(Context).match;
 }
+
+export function useRouter() {
+  if (__DEV__) {
+    invariant(
+      typeof useContext === "function",
+      "You must use React >= 16.8 in order to use useRouter()"
+    );
+  }
+
+  return useContext(Context);
+}

packages/react-router/modules/index.js

@@ -32,7 +32,13 @@ export { default as generatePath } from "./generatePath";
 export { default as matchPath } from "./matchPath";
 export { default as withRouter } from "./withRouter";
 
-import { useHistory, useLocation, useParams, useRouteMatch } from "./hooks.js";
-export { useHistory, useLocation, useParams, useRouteMatch };
+import {
+  useHistory,
+  useLocation,
+  useParams,
+  useRouteMatch,
+  useRouter
+} from "./hooks.js";
+export { useHistory, useLocation, useParams, useRouteMatch, useRouter };
 
 export { default as __RouterContext } from "./RouterContext";