medialize/URI.js
URI.js
URI.js is a full-featured JavaScript library for parsing, building, normalizing, and mutating URLs and their components programmatically. It provides a mutable-component object model that exposes each URL part as a separate object with getter and setter methods, enabling direct manipulation of schemes, hosts, paths, query strings, and fragments. The library implements strict RFC 3986 compliance for encoding, decoding, and normalization of URI components, and includes a template expansion engine that substitutes variables using operator-specific rules.
The library distinguishes itself through comprehensive support for internationalized domain names via Punycode conversion, allowing encoding and decoding between Unicode and ASCII-compatible representations. It also includes IPv6 address normalization tools that compress and expand addresses by handling zero-segment shorthand and leading-zero removal. URI.js manages query parameters and fragment data as key-value stores with add, remove, check, and update operations, and provides relative URL resolution to convert relative paths to absolute URLs or compute relative paths between two URLs.
Beyond its core capabilities, the library offers URL normalization and comparison to standardize URLs and check semantic equality, along with URL classification to determine whether a URL is absolute, relative, an IP address, a domain name, or a URN. It supports path segment manipulation through an array-like interface, second-level domain parsing, and URL extraction from text. The library also provides common base path finding and URI component encoding and decoding with special handling for query string spaces.
Features
- URL Data Parsing - Provides a complete JavaScript library for parsing, building, and mutating URLs programmatically.
- URL Resolvers - Resolves relative URLs to absolute paths based on a given base URL.
- URL Fragment Managers - Manages query parameters and fragment data with add, remove, check, and update operations.
- URL Normalizers - Standardizes URLs by canonicalizing components and checking semantic equality.
- Punycode Conversion - Converts between Unicode and ASCII-compatible Punycode for internationalized domain names.
- URL Component Object Models - Provides a mutable-component object model for direct manipulation of URL parts.
- URI Compliance Layers - Implements strict RFC 3986 compliance for encoding, decoding, and normalization of URI components.
- URL Relative Path Resolvers - Resolves relative URLs to absolute paths and computes relative paths between two URLs.
- RFC 3986 URI Encoders and Decoders - Encodes and decodes URI components with strict RFC 3986 compliance and query string space handling.
- URI Template Mappings - Expands URI templates by substituting variables with data values using operator-specific rules.
- Expansion Engines - Ships a full RFC 6570 template expansion engine for substituting variables in URI patterns.
- Query Parameter Manipulators - Adds, removes, and normalizes query parameters individually or in bulk.
- Query Parameter Stores - Manages query parameters as a dictionary with add, remove, and update operations.
- URL Construction - Serializes individual URL components back into complete URL strings.
- URL Component Replacements - Modifies individual URL parts like query string, path, or domain without full reconstruction.
- Text Domain Internationalizations - Encodes and decodes Unicode domain names and email addresses using Punycode.
- Address Compressors - Shortens IPv6 addresses by replacing zero segments with '::' for compact representation.
- Address Normalization Tools - Compresses and normalizes IPv6 addresses for canonical representation.
- Address Normalizers - Ships IPv6 address compression and expansion utilities for canonical representation.
- Canonical Form Converters - Converts IPv6 addresses to canonical form by expanding shorthand and removing leading zeros.
- Punycode Decoders - Converts Punycode-encoded strings back into Unicode for human-readable display.
- Unicode Encoders - Converts Unicode domain names and email addresses into ASCII-compatible Punycode encoding.
- URI Template Expanders - Expands URI templates by substituting variables with data values using operator-specific rules.
- Fragment Data Serializers - Provides a key-value interface for encoding structured data into URL fragments.
- Parsing Utilities - URL mutation library.
- String Manipulation - Utility for URL manipulation.
- String Utilities - URL mutation and manipulation library.
- URL and Network Utilities - Comprehensive URL conversion and manipulation library.
- Utility Libraries - Comprehensive URL parsing and manipulation library.
- 路由和链接(Routing And URLs) - Listed in the “路由和链接(Routing And URLs)” section of the Awesome Frontend awesome list.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
