use-back

Use Back

React Router DOM hook for navigating back without leaving your website

Description

A native ESModule React hook for navigating back one location using React Router DOM, defaulting to navigating home instead of leaving your web application.

Installation

npm install use-back

Note: This package is a native ESModule that requires React Router DOM v6 as a peer dependency.

Usage

import {useBack} from "use-back";

const BackButton = () => {
	const {hasBack, handleBack} = useBack();
	return (
		<button type="button" onClick={handleBack}>
			{hasBack ? "Go Back" : "Go Home"}
		</button>
	);
};

useBack([defaultPath])

Returns: {handleBack, hasBack} Object containing an event handler that navigates back, and a boolean that indicates whether the handler will navigate back or to the default path

Parameter	Type	Default	Description
defaultPath	string	"/"	Fallback path to navigate to for when there is not a previous history entry

License

Copyright Evelyn Hathaway, MIT License

Changelog

v1.0.1

v1.0.0...v1.0.1 - 2022-08-21

📦 Package

• prod: Expand React peer support range 0a031e0

🧹 Internal

• CI workflow, TS config improvements 5e65e89