Sign inDemoInstall


Package Overview
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies



Minify URLs by converting them from absolute to relative.

Version published
Weekly downloads
decreased by-1.93%
Install size
31.4 kB
Weekly downloads

Package description

What is relateurl?

The relateurl npm package is designed to simplify the process of converting absolute URLs to relative URLs, based on the current page's URL. It can be particularly useful in web development scenarios where you need to optimize link references within your site or application.

What are relateurl's main functionalities?

Convert absolute URL to relative URL

This feature allows you to convert an absolute URL to a relative URL based on a base URL. It's useful for reducing the length of URLs in your HTML or CSS files.

"const RelateUrl = require('relateurl');\nconst absoluteUrl = '';\nconst options = { output: RelateUrl.SHORTEST };\nconst relativeUrl = RelateUrl.relate('', absoluteUrl, options);\nconsole.log(relativeUrl); // Outputs: 'dir/file'"

Customize output with options

This feature demonstrates how you can customize the output of the relative URL using various options, such as making it scheme-relative or choosing the type of relative path.

"const RelateUrl = require('relateurl');\nconst absoluteUrl = '';\nconst options = {\n  output: RelateUrl.PATH_RELATIVE,\n  schemeRelative: true\n};\nconst relativeUrl = RelateUrl.relate('', absoluteUrl, options);\nconsole.log(relativeUrl); // Outputs: '../../dir/file'"

Other packages similar to relateurl



relateurl NPM Version Build Status Dependency Status

Minify URLs by converting them from absolute to relative.

If you were to use this library on a website like, you would get results such as:


All string parsing. No directory browsing. It is thoroughly tested, very fast and lightweight with zero external dependencies.

Getting Started

This utility requires Node.js >= 0.10. To install, type this at the command line:

npm install relateurl --save-dev



Type: Object
Default value: {ftp:21, http:80, https:443}

Extend the list with any ports you need. Any URLs containing these default ports will have them removed. Example: will become


Type: Array
Default value: ["index.html"]

Extend the list with any resources you need. Works with options.removeDirectoryIndexes.


Type: Boolean
Default value: false

This will, for example, consider any domains containing to be related to any that contain


Type: constant or String
Choices: "absolute","pathRelative","rootRelative","shortest"
Default value: RelateUrl.SHORTEST

RelateUrl.ABSOLUTE will produce an absolute URL. Overrides options.schemeRelative with a value of false.
RelateUrl.PATH_RELATIVE will produce something like ../child-of-parent/etc/.
RelateUrl.ROOT_RELATIVE will produce something like /child-of-root/etc/.
RelateUrl.SHORTEST will choose whichever is shortest between root- and path-relative.


Type: Array
Default value: ["data","javascript","mailto"]

Extend the list with any additional schemes. Example: javascript:something will not be modified.


Type: Boolean
Default value: false

Remove user authentication information from the output URL.


Type: Boolean
Default value: true

Remove any resources that match any found in options.directoryIndexes.


Type: Boolean
Default value: false

Remove empty query variables. Example: will become This does not apply to unrelated URLs (with other protocols, auths, hosts and/or ports).


Type: Boolean
Default value: true

Remove trailing slashes from root paths. Example: will become while will not be modified.


Type: Boolean
Default value: true

Output URLs relative to the scheme. Example: will become //

Type: String
Default value: undefined

An options-based version of the from argument. If both are specified, from takes priority.


Type: Boolean
Default value: true

Passed to Node's url.parse.


This library can be used as a function for single-use or as a class for multiple conversions.

Upon successful conversion, a String will be returned. If an issue is encountered while parsing from, an error will be thrown.

Single Instance
var RelateUrl = require("relateurl");

var result = RelateUrl.relate(from, to, options);
Reusable Instances
var RelateUrl = require("relateurl");

var instance = new RelateUrl(from, options);

var result1 = instance.relate(to1);
var result2 = instance.relate(to2, customOptions);
var result3 = instance.relate(to3);


  1. Why bother writing/using this?
    To aid in further minifying HTML, mainly for the purpose of faster page loads and SEO. It's been integrated into HTMLMinifier.

  2. Why not just use Node's url.parse, url.resolve and path.relative?
    url.parse is used, but url.resolve and path.relative are both slower and less powerful than this library.

Release History

  • 0.2.7 Node v6 support
  • 0.2.6 minor enhancements
  • 0.2.5 added options.removeRootTrailingSlash
  • 0.2.4 added
  • 0.2.3 added browserify npm-script
  • 0.2.2 removed task runner
  • 0.2.1 shorten resource- and query-relative URLs, test variations list with other site URLs
  • 0.2.0 code cleanup, options.removeEmptyQueries=true only applied to unrelated URLs
  • 0.1.0 initial release


  • 0.2.8 check if queries are the same, regardless of param order
  • 0.2.8 possible scheme exclusions such as tel:
  • 0.2.8 decipher and return invalid input (special cases) to complete test suite
  • 0.3.0 test options.slashesDenoteHost=false, add something like options.externalDirectoryIndexes=[] for external sites



Last updated on 14 Jul 2016

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.


Related posts

SocketSocket SOC 2 Logo


  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc