Simply path/URL building in JavaScript. Intelligently handles URL params and query strings.
This library owes thanks to urlcat, but unfortunately it seems to be abandoned. You can mostly use pathcat as a replacement.
- Very intuitive API
- Supports URL params and query string
- Avoids double slashes
- Zero dependencies
- Absolutely tiny install size
yarn add pathcatimport { pathcat } from "pathcat";
pathcat("https://example.com", "/:id", {
id: 123,
});
// => 'https://example.com/123'
pathcat("https://example.com", "/:id", {
id: "123",
foo: "bar",
});
// => 'https://example.com/123?foo=bar'
// Base URL is optional, works on just paths as well.
pathcat("/users/:user_id/posts/:post_id", {
user_id: "123",
post_id: 456,
cool_flag: true,
});
// => '/users/123/posts/456?cool_flag=true'
// You can also use arrays for query string values
pathcat("/users/:user_id/posts/:post_id", {
user_id: "123",
post_id: 456,
cool_flag: true,
fields: ["title", "body"],
});
// => '/users/123/posts/456?cool_flag=true&fields=title&fields=body'Results when running on an M3 Max
$ node --import=tsx benchmark.ts
With a base URL x 1,446,429 ops/sec ±0.55% (94 runs sampled)
With no base URL x 1,494,634 ops/sec ±0.43% (98 runs sampled)
With a base URL, and no params x 2,720,270 ops/sec ±0.36% (93 runs sampled)
- Any params or query string values that are
undefinedwill be omitted. - Params that were not specified in the object will be left as is.