url-join

What is url-join?

The url-join npm package is a utility for joining and normalizing URLs. It is particularly useful when constructing URLs dynamically, ensuring that the resulting URL is correctly formatted without duplicated slashes or missing segments. This package can handle various scenarios, including joining multiple parts of a URL, handling query strings, and ensuring the correct inclusion of protocols.

What are url-join's main functionalities?

Joining URL segments

This feature allows for the concatenation of multiple segments into a single, well-formed URL. It automatically handles the insertion or removal of slashes as needed between segments.

"const urlJoin = require('url-join');\nconst fullUrl = urlJoin('http://example.com', 'a', '/b/cd', '?foo=123');\nconsole.log(fullUrl); // Outputs: http://example.com/a/b/cd?foo=123"

Handling trailing slashes

This feature ensures that trailing slashes are correctly handled, either preserving them or removing them based on the input segments, thus maintaining the intended URL structure.

"const urlJoin = require('url-join');\nconst fullUrl = urlJoin('http://example.com/', '/a/b/', '/');\nconsole.log(fullUrl); // Outputs: http://example.com/a/b/"

Combining URL with query parameters

This feature demonstrates how url-join can be used to append query parameters to a base URL, ensuring that the '?' character is correctly placed and that the overall URL remains well-formed.

"const urlJoin = require('url-join');\nconst fullUrl = urlJoin('http://example.com', 'search', '?q=url+join');\nconsole.log(fullUrl); // Outputs: http://example.com/search?q=url+join"

Other packages similar to url-join

path-to-regexp

While primarily focused on converting paths to regex, path-to-regexp can be used to construct URLs in a more controlled manner. It differs from url-join by offering more complex pattern matching and parameter handling, making it more suitable for routing purposes rather than simple URL concatenation.

urijs

URI.js is a more comprehensive URL manipulation library that offers functionality similar to url-join but extends far beyond it. It includes parsing, manipulation, and normalization of URLs, query string manipulation, and much more. Compared to url-join, URI.js is better suited for applications requiring extensive URL manipulation capabilities.

README

Join all arguments together and normalize the resulting URL.

Install

npm install url-join

If you want to use it directly in a browser use a CDN like Skypack.

Usage

import urlJoin from 'url-join';

const fullUrl = urlJoin('http://www.google.com', 'a', '/b/cd', '?foo=123');

console.log(fullUrl);

Prints:

'http://www.google.com/a/b/cd?foo=123'

License

MIT

Changelog

5.0.0 - 2022-03-23

• Add Dependabot config to keep dependencies up-to-date (#67) (e29fd4c9f6a3a1c29f50262c9323f1a4d8173de4), closes #67
• Add type definitions for TypeScript users (#74) (2cd46bcaff009a6701b33e16b1b9788c9a09130d), closes #74
• Bump mocha from 3.5.3 to 9.2.2 (ab6a39a2170083ebcefecfa0abcf80fc25a103ef)
• Change distributed code to use ECMAScript modules (#76) (caaafed544786b63b8db78d7df6d238ca1f0c6cb), closes #76
• Mark package as free of side-effects (#75) (86eeb03980b166572e02c7bbaf11c98656d04831), closes #75
• Reduce package size by adding "files" field (#65) (be56f575c9b723b83cfb066f5649f2cd83efb137), closes #65
• Regenerate package lockfile (#73) (b85aec29057ba269618781618e48dc173b941f9b), closes #73
• Rename master branch to 'main' (ea22d9342d6ad2de68a0132d176bf332507dc189)
• Replace Travis with Github Actions (#66) (2c0f6951939b86e7d1194fb21cf54cdfb8d9b1cf), closes #66
• update travis file (02991d8d220339d2073b1e5c1bcd069284c5372a)