decodeURIComponent() 函数详解

decodeURIComponent() 是 JavaScript 中的一个全局函数，用于解码由 encodeURIComponent() 方法或其他类似方法编码的部分统一资源标识符（URI）。该函数能够将编码后的 URI 字符串还原为原始格式，特别适用于处理包含特殊字符的 URL。

语法

使用 decodeURIComponent() 函数的基本语法如下：

decodeURIComponent(encodedURI)

参数说明

该函数接受一个参数：

• encodedURI：编码后的部分 URI 字符串，需要被解码为原始格式

返回值

函数返回一个解码后的统一资源标识符（URI）字符串，该字符串是经过编码处理的原始 URI。

异常处理

当传入的参数包含无效的 URI 编码序列时，decodeURIComponent() 函数会抛出一个 URIError 异常，提示"格式错误的 URI 序列"。因此，在实际应用中，建议使用 try-catch 语句来捕获可能的异常。

功能描述

decodeURIComponent() 函数会将已编码 URI 中所有能识别的转义序列转换回原字符。与 decodeURI() 不同，decodeURIComponent() 会解码所有百分号编码的字符，包括那些在 URI 中具有特殊含义的字符。

使用示例

示例1：解码包含西里尔字母的 URL

以下示例展示了如何解码包含西里尔字母的 URL：

decodeURIComponent("JavaScript_%D1%88%D0%B5%D0%BB%D0%BB%D1%8B");
// 返回 "JavaScript_шеллы"

示例2：异常捕获

当遇到无效的编码序列时，函数会抛出异常。下面的代码演示了如何捕获这种异常：

try {
  var a = decodeURIComponent("%E0%A4%A");
} catch (e) {
  console.error(e);
}
// 输出: URIError: malformed URI sequence

相关函数

在处理 URI 编码和解码时，decodeURIComponent() 通常与其他函数配合使用：

• decodeURI()：解码整个 URI，但保留某些特殊字符的编码状态
• encodeURI()：编码整个 URI，保留 URI 中的有效字符
• encodeURIComponent()：编码 URI 的组成部分，对所有非标准字符进行编码

浏览器兼容性

decodeURIComponent() 函数在现代浏览器中得到了广泛支持，自 2015 年 7 月起，所有主流浏览器（Chrome、Firefox、Safari、Edge 等）都已支持此功能。