Back to React Router

matchPath

docs/api/utils/matchPath.md

7.6.21.3 KB
Original Source

matchPath

<!-- ⚠️ ⚠️ IMPORTANT ⚠️ ⚠️ Thank you for helping improve our documentation! This file is auto-generated from the JSDoc comments in the source code, so please edit the JSDoc comments in the file below and this file will be re-generated once those changes are merged. https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/router/utils.ts -->

[MODES: framework, data, declarative]

Summary

Reference Documentation ↗

Performs pattern matching on a URL pathname and returns information about the match.

Signature

tsx
function matchPath<ParamKey extends ParamParseKey<Path>, Path extends string>(
  pattern: PathPattern<Path> | Path,
  pathname: string,
): PathMatch<ParamKey> | null

Params

pattern

The pattern to match against the URL pathname. This can be a string or a PathPattern object. If a string is provided, it will be treated as a pattern with caseSensitive set to false and end set to true.

pathname

The URL pathname to match against the pattern.

Returns

A path match object if the pattern matches the pathname, or null if it does not match.