URI.js - 简化 JavaScript 中的 URL 处理

URI.js - 简化 JavaScript 中的 URL 处理

项目简介

URI.js 是一个轻量级的 JavaScript 库，用于处理和解析 URLs 和 URIs（统一资源标识符）。它提供了一套强大而易于使用的 API，帮助开发者轻松地操作 URL，包括编码、解码、拼接、解析和验证等。

功能特性

URL 拼接与解析

URI.js 提供了 URI 构造函数，可以方便地创建新的 URI 对象，并提供了丰富的 API 来进行 URL 的拼接和解析：

var uri = new URI("http://example.com/path/to/page.html");
uri.path("another/path").search({ key: "value" }).toString();
// 输出：'http://example.com/another/path?key=value'

编码与解码

URI.js 支持对 URI 的各个部分进行编码和解码，避免由于特殊字符导致的问题：

var uri = new URI("http://example.com/?key=value&another-key=");
uri.encodeQuery("a special value with spaces");
// 输出：'http://example.com/?key=value&another-key=a%20special%20value%20with%20spaces'

解析与验证

URI.js 可以解析 URI 并返回详细的组件对象，同时还提供了检查 URI 合法性的方法：

var uri = new URI("http://user:pass@example.com:80/path/to/page.html?key1=value1&key2=value2#fragment");
uri.scheme(); // 输出：'http'
uri.username(); // 输出：'user'
uri.password(); // 输出：'pass'
uri.host(); // 输出：'example.com'
uri.port(); // 输出：'80'
uri.directory(); // 输出：'/path/to/page.html'
uri.filename(); // 输出：'page.html'
uri.searchParams().get('key1'); // 输出：'value1'
uri.fragmentIdentifier(); // 输出：'fragment'

URI.isAbsolute("http://example.com"); // 输出：true
URI.isRelative("/path/to/page.html"); // 输出：false

使用案例

自定义短网址服务

使用 URI.js，您可以快速实现一个自定义的短网址服务，将长网址缩短为简短的哈希值。通过 URL 编码和解码功能，可以轻松地在短网址和原始网址之间转换。

function encodeLongUrl(longUrl) {
  var hash = CryptoJS.MD5(longUrl).toString(CryptoJS.enc.Hex);
  return hash.substring(0, 8); // 截取前 8 个字符作为短网址
}

function decodeShortUrl(shortHash) {
  var longUrl = localStorage.getItem(shortHash);
  if (longUrl) {
    return longUrl;
  } else {
    throw new Error("Invalid short URL");
  }
}

社交媒体分享链接生成器

您可以利用 URI.js 提供的功能，构建一个简单的社交媒体分享链接生成器。用户输入要分享的内容和目标平台，程序自动生成对应的分享链接。

function generateShareLink(text, platform) {
  switch (platform) {
    case 'twitter':
      return `https://twitter.com/share?url=${encodeURIComponent(window.location.href)}&text=${encodeURIComponent(text)}`;
    case 'facebook':
      return `https://www.facebook.com/sharer/sharer.php?u=${encodeURIComponent(window.location.href)}&quote=${encodeURIComponent(text)}`;
    default:
      throw new Error("Unsupported platform");
  }
}

结论

URI.js 提供了一个简单易用的 API，让开发者能够轻松处理和解析 URL 和 URIs。无论您需要实现自定义短网址服务还是构建社交媒体分享链接生成器，URI.js 都是一个值得信赖的工具。开始探索 URI.js 的强大功能吧！