Relative vs absolute URL resolution in Node.js - When to Use Which

The Big Idea

Discover how a tiny URL mistake can break your whole app--and how Node.js saves you from it!

The Scenario

Imagine you have a website with many pages and links. You try to write every link manually, mixing full web addresses and short paths like "about" or "../contact".

The Problem

Manually managing URLs is confusing and error-prone. You might link to wrong pages, break navigation, or cause endless loops because you don't know how paths combine or resolve.

The Solution

Node.js URL resolution automatically figures out how to combine relative paths with base URLs to create correct absolute URLs, so your links always work as expected.

Before vs After

✗ Before

const url = base + '/' + relativePath;

✓ After

const url = new URL(relativePath, base).href;

What It Enables

This lets you build dynamic, reliable links and resources without worrying about path mistakes or broken navigation.

Real Life Example

When loading images or API endpoints dynamically in a Node.js app, resolving relative URLs ensures your app fetches the right data no matter where it runs.

Key Takeaways

Manual URL building is tricky and easy to break.

Node.js URL resolution handles path combining safely.

This makes your app's links and resources reliable and maintainable.

Practice

1. Which of the following is a correct description of a relative URL in Node.js?

easy

A. A URL that includes the protocol and domain name.

B. A URL that depends on a base URL to form a full address.

C. A URL that always starts with 'http://' or 'https://'.

D. A URL that cannot be resolved using the URL class.

Solution

1. Step 1: Understand relative URL meaning

   A relative URL does not include the full path and depends on a base URL to form a complete address.

2. Step 2: Compare options

   A URL that depends on a base URL to form a full address. correctly describes this. Options B and C describe absolute URLs. A URL that cannot be resolved using the URL class. is incorrect because Node.js URL class can resolve relative URLs with a base.

3. Final Answer:

   A URL that depends on a base URL to form a full address. -> Option B

4. Quick Check:

   Relative URL = depends on base URL [OK]

Hint: Relative URLs need a base URL to become complete [OK]

Common Mistakes:

• Confusing relative URLs with absolute URLs
• Thinking relative URLs include protocol
• Believing relative URLs cannot be resolved

2. Which of the following is the correct way to create a new URL object for a relative path '/images/photo.jpg' with base 'https://example.com/gallery/' in Node.js?

easy

A. new URL('/images/photo.jpg', 'https://example.com/gallery/')

B. new URL('https://example.com/gallery/' + '/images/photo.jpg')

C. new URL('images/photo.jpg')

D. new URL('https://example.com/gallery/images/photo.jpg')

Solution

1. Step 1: Understand URL constructor usage

   The URL constructor takes two arguments: the path and the base URL. For relative paths, the first argument is the relative path, and the second is the base.

2. Step 2: Check each option

   new URL('/images/photo.jpg', 'https://example.com/gallery/') correctly uses new URL(relativePath, baseURL). new URL('https://example.com/gallery/' + '/images/photo.jpg') concatenates strings but does not use the URL constructor properly. new URL('images/photo.jpg') misses the base URL. new URL('https://example.com/gallery/images/photo.jpg') uses an absolute URL, not relative.

3. Final Answer:

   new URL('/images/photo.jpg', 'https://example.com/gallery/') -> Option A

4. Quick Check:

   URL(relative, base) = correct syntax [OK]

Hint: Use new URL(relativePath, baseURL) for relative URLs [OK]

Common Mistakes:

• Concatenating strings instead of using URL constructor
• Omitting the base URL for relative paths
• Passing absolute URL as first argument when base is given

3. What will be the output of the following Node.js code?

const { URL } = require('url');
const base = 'https://example.com/folder/';
const relative = '../image.png';
const fullUrl = new URL(relative, base);
console.log(fullUrl.href);

medium

A. https://example.com/folder/../image.png

B. Error: Invalid URL

C. https://example.com/image.png

D. https://example.com/folder/image.png

Solution

1. Step 1: Understand relative path resolution

   The relative path '../image.png' means go one folder up from 'https://example.com/folder/' which leads to 'https://example.com/'.

2. Step 2: Resolve the full URL

   Combining base and relative path, the URL class normalizes the path to 'https://example.com/image.png'. https://example.com/image.png matches this.

3. Final Answer:

   https://example.com/image.png -> Option C

4. Quick Check:

   Relative '..' moves up one directory [OK]

Hint: Relative '..' moves up one folder in URL paths [OK]

Common Mistakes:

• Not normalizing '..' in URL paths
• Expecting '../' to stay in the URL string
• Confusing relative and absolute URL outputs

4. Identify the error in this Node.js code snippet that tries to resolve a relative URL:

const { URL } = require('url');
const base = 'https://example.com/path';
const relative = 'file.txt';
const url = new URL(relative, base);
console.log(url.href);

medium

A. Base URL is missing trailing slash, causing incorrect resolution.

B. Relative URL should start with a slash '/' to be valid.

C. URL constructor requires only one argument for relative URLs.

D. No error; code outputs 'https://example.com/path/file.txt' correctly.

Solution

1. Step 1: Check base URL format

   The base URL 'https://example.com/path' lacks a trailing slash, so it is treated as a file, not a folder.

2. Step 2: Understand URL resolution effect

   Appending 'file.txt' to a base treated as file replaces 'path' with 'file.txt', resulting in 'https://example.com/file.txt', not 'https://example.com/path/file.txt'.

3. Final Answer:

   Base URL is missing trailing slash, causing incorrect resolution. -> Option A

4. Quick Check:

   Base URL trailing slash affects relative URL resolution [OK]

Hint: Always add trailing slash to base URL if it's a folder [OK]

Common Mistakes:

• Omitting trailing slash on base URL
• Thinking relative URLs must start with '/'
• Passing wrong number of arguments to URL constructor

5. You want to combine a base URL 'https://example.com/api/v1/' with a relative URL '../../images/pic.jpg' in Node.js. What will be the resolved absolute URL?

hard

A. https://example.com/api/v1/images/pic.jpg

B. https://example.com/api/images/pic.jpg

C. https://example.com/api/v1/../../images/pic.jpg

D. https://example.com/images/pic.jpg

Solution

1. Step 1: Analyze relative path '../../images/pic.jpg'

   The '../../' means go up two folders from 'https://example.com/api/v1/'.

2. Step 2: Move up two levels from base URL

   Starting at 'https://example.com/api/v1/', going up one level is 'https://example.com/api/', and up another is 'https://example.com/'. Then append 'images/pic.jpg'.

3. Final Answer:

   https://example.com/images/pic.jpg -> Option D

4. Quick Check:

   Two '..' moves up two directories [OK]

Hint: Count '..' to move up folders in URL paths [OK]

Common Mistakes:

• Not moving up enough folders for multiple '..'
• Appending relative path without normalization
• Confusing base URL folder levels