{"id":22258187,"url":"https://github.com/hanover-computing/canonicize-url","last_synced_at":"2025-07-28T07:32:12.556Z","repository":{"id":37790249,"uuid":"383999191","full_name":"hanover-computing/canonicize-url","owner":"hanover-computing","description":"Get a stable, canonical version of any URL, with DNS and HTTPS checks, redirects, tracker stripping, and canonical link extraction!","archived":false,"fork":false,"pushed_at":"2024-10-23T02:41:54.000Z","size":1471,"stargazers_count":12,"open_issues_count":14,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-06T23:17:12.731Z","etag":null,"topics":["amp","canonical","canonical-urls","compare-urls","javascript","normalize-url","npm-package","privacy","sanitize-url","ssrf","tracker","tracking","url-normalization"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hanover-computing.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-08T04:20:46.000Z","updated_at":"2024-09-01T18:31:33.000Z","dependencies_parsed_at":"2024-05-22T12:44:00.063Z","dependency_job_id":"c0ebc85c-8b4a-41b8-b468-b41c5f249176","html_url":"https://github.com/hanover-computing/canonicize-url","commit_stats":null,"previous_names":["janejeon/normalize-url-plus"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanover-computing%2Fcanonicize-url","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanover-computing%2Fcanonicize-url/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanover-computing%2Fcanonicize-url/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hanover-computing%2Fcanonicize-url/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hanover-computing","download_url":"https://codeload.github.com/hanover-computing/canonicize-url/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227877772,"owners_count":17833559,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amp","canonical","canonical-urls","compare-urls","javascript","normalize-url","npm-package","privacy","sanitize-url","ssrf","tracker","tracking","url-normalization"],"created_at":"2024-12-03T08:13:55.410Z","updated_at":"2024-12-03T08:13:56.204Z","avatar_url":"https://github.com/hanover-computing.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eWelcome to normalize-url-plus 👋\u003c/h1\u003e\n\n[![CircleCI](https://circleci.com/gh/JaneJeon/normalize-url-plus/tree/master.svg?style=shield)](https://circleci.com/gh/JaneJeon/normalize-url-plus/tree/master)\n[![codecov](https://codecov.io/gh/JaneJeon/normalize-url-plus/branch/master/graph/badge.svg)](https://codecov.io/gh/JaneJeon/normalize-url-plus)\n[![Version](https://img.shields.io/npm/v/normalize-url-plus)](https://www.npmjs.com/package/normalize-url-plus)\n[![Downloads](https://img.shields.io/npm/dt/normalize-url-plus)](https://www.npmjs.com/package/normalize-url-plus)\n\n\u003e normalize-url plus additional features to supercharge link normalization!\n\nWhile `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!\n\n### 🏠 [Homepage](https://github.com/JaneJeon/normalize-url-plus)\n\n## Install\n\n```sh\nnpm i normalize-url-plus\n```\n\n## Usage\n\nNote 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()`).\n\n```js\nimport gen from 'normalize-url-plus'\nconst normalizeUrl = gen(normalizeUrlOptions, gotOptions) // it is recommended to fill out the caching options for got\n\nconst longDisgustingTrackerFilledLink =\n  'https://www.amazon.com/Blanket-Fleece-Cartoon-Printing-Napping/dp/B089G4JDVB/ref=sr_1_1?keywords=hello%20kitty\u0026sr=8-1' // eww\nawait normalizeUrl(longDisgustingTrackerFilledLink) // https://amazon.com/Blanket-Fleece-Cartoon-Printing-Napping/dp/B089G4JDVB\n```\n\n## Run tests\n\n```sh\nnpm test\n```\n\n## Author\n\n👤 **Jane Jeon \u003cme@janejeon.dev\u003e**\n\n- Website: janejeon.dev\n- Github: [@JaneJeon](https://github.com/JaneJeon)\n\n## 🤝 Contributing\n\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](https://github.com/JaneJeon/normalize-url-plus/issues).\n\n## Show your support\n\nGive a ⭐️ if this project helped you!\n\n## 📝 License\n\nCopyright © 2022 [Jane Jeon \u003cme@janejeon.dev\u003e](https://github.com/JaneJeon).\u003cbr /\u003e\nThis project is [LGPL-3.0](https://github.com/JaneJeon/normalize-url-plus/blob/main/LICENSE) licensed.\n\nTL;DR: you are free to import and use this library \"as-is\" in your code, without needing to make your code source-available or to license it under the same license as this library; however, if you do change this library and you distribute it (directly or as part of your code consuming this library), please do contribute back any improvements for this library and this library alone.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanover-computing%2Fcanonicize-url","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhanover-computing%2Fcanonicize-url","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhanover-computing%2Fcanonicize-url/lists"}