URI parsing/validating/resolving library

Replacement for abandoned library uri-js aka "URI.js"

• Based on Node.js and browser URL api
• 99% compatible with original URI.js library
• Solves "The punycode module is deprecated" warning in Node
• Tested with libraries: ESLint, Webpack, Ajv

Usage

NPM

Add to your package.json

1{
2  "overrides": {
3    "uri-js": "npm:uri-js-replace"
4  }
5}

and run

1npm update

Yarn

1{
2  "overrides": {
3    "uri-js": "yarn:uri-js-replace"
4  }
5}

Library usage examples

Parsing

1import * as URI from "uri-js";
2
3URI.parse("uri://user:pass@example.com:123/one/two.three?q1=a1&q2=a2#body");
4//returns:
5//{
6//  scheme : "uri",
7//  userinfo : "user:pass",
8//  host : "example.com",
9//  port : 123,
10//  path : "/one/two.three",
11//  query : "q1=a1&q2=a2",
12//  fragment : "body"
13//}

Serializing

1URI.serialize({scheme : "http", host : "example.com", fragment : "footer"}) === "http://example.com/#footer"

Normalizing

1URI.normalize("URI://www.example.org/red%09ros\xE9#red") === "uri://www.example.org/red%09ros%C3%A9#red"

Tests

All tests copied from original repository

1vitest

Generating d.ts files

1npm i -g typescript
2tsc

NPM

https://www.npmjs.com/package/uri-js-replace