parseurl

What is parseurl?

The parseurl npm package is used to parse URLs. It provides utilities for URL resolution and parsing to work with the components of URLs. It can be particularly useful in HTTP server handling to extract parts of the request URL.

What are parseurl's main functionalities?

Parse the URL of an HTTP request

This feature allows you to parse the URL of an incoming HTTP request and obtain components such as pathname, query, etc. The code sample creates an HTTP server that responds with the pathname of the request URL.

const parseurl = require('parseurl');
const http = require('http');

http.createServer(function (req, res) {
  const parsedUrl = parseurl(req);
  res.end('Pathname: ' + parsedUrl.pathname);
}).listen(3000);

Parse the same URL only once

This feature ensures that the URL is only parsed once and the result is cached. Subsequent calls to parseurl with the same request object will return the cached parsed URL object, improving performance.

const parseurl = require('parseurl');
const http = require('http');

http.createServer(function (req, res) {
  const parsedUrl = parseurl(req);
  // parseurl caches the parsed object in req._parsedUrl
  // Subsequent calls will return the cached version
  const sameParsedUrl = parseurl(req);
  res.end('Pathname: ' + sameParsedUrl.pathname);
}).listen(3000);

Other packages similar to parseurl

url-parse

The url-parse package is similar to parseurl but offers more features, such as the ability to parse relative URLs and more detailed parsing of the query string. It can be used both in Node.js and in the browser.

qs

While qs is not a direct alternative to parseurl, it provides advanced query string parsing and stringifying capabilities. It can be used in combination with parseurl to handle complex query string scenarios.

README

parseurl

Parse a URL with memoization.

API

var parsedUrl = parseurl(req)

parsedUrl is basically a url.parse() object.

LICENSE

(The MIT License)

Copyright (c) 2014 Jonathan Ong [e-mail]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.