normalize-url-plus

normalize-url plus additional features to supercharge link normalization!

Usage no npm install needed!

<script type="module">
  import normalizeUrlPlus from 'https://cdn.skypack.dev/normalize-url-plus';
</script>

README

Welcome to normalize-url-plus 👋

CI Version Downloads

normalize-url plus additional features to supercharge link normalization!

While normalize-url is good enough for many normalization use cases, this library is akin to prettier or black in that it ABSOLUTELY normalizes links, including features like default www-stripping and default https (both of which fall back should such links do not exist - unlike normalize-url), stripping ALL trackers (courtesy of clearURLs), following redirects (even those that can't normally be automatically redirected without manual user intervention such as youtube redirect links), and even extracting canonical URLs, all the while securing your servers from SSRF!

🏠 Homepage

Install

npm i normalize-url-plus

Usage

Note that this package is ESM-only; see https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c for what to do if you're using CJS (i.e. require()).

import gen from 'normalize-url-plus'
const normalizeUrl = gen(normalizeUrlOptions, gotOptions) // it is recommended to fill out the caching options for got

const longDisgustingTrackerFilledLink =
  'https://www.amazon.com/Blanket-Fleece-Cartoon-Printing-Napping/dp/B089G4JDVB/ref=sr_1_1?keywords=hello%20kitty&sr=8-1' // eww
await normalizeUrl(longDisgustingTrackerFilledLink) // https://amazon.com/Blanket-Fleece-Cartoon-Printing-Napping/dp/B089G4JDVB

Run tests

npm test

Author

👤 Jane Jeon me@janejeon.dev

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2021 Jane Jeon me@janejeon.dev.
This project is LGPL-3.0 licensed.


This README was generated with ❤️ by readme-md-generator