JavaScript中的unescape函数为什么被弃用_解码用什么替代

秋墨酱_5118

秋墨酱_5118

2026-01-02

462人浏览

原创

unescape 已被彻底移除,现代浏览器执行会抛出 ReferenceError;应根据编码来源选用 decodeURIComponent(对应 encodeURIComponent)或 decodeURI(对应 encodeURI),处理 %uXXXX 需手动兼容,Node.js 中应使用 URLSearchParams 或 decodeURIComponent 而非 querystring.unescape。

javascript中的unescape函数为什么被弃用_解码用什么替代

unescape 已被彻底移除,现代浏览器直接报 ReferenceError

在 ECMAScript 5(2009)中,unescape 就被标记为**废弃(deprecated)**;到 ECMAScript 2015(ES6)起,它被从标准中**正式删除**。现在所有主流浏览器(Chrome、Firefox、Safari、Edge)执行 unescape('abc') 都会抛出 ReferenceError: unescape is not defined。这不是兼容性问题,是语言层面的移除——你不能指望它“偶尔还能用”。

该用 decodeURIComponent 还是 decodeURI?看编码来源

unescape 原本对任何 %xx 形式都解码,不管是否符合 URI 编码规范,这导致它在处理中文、特殊符号时行为不一致且不安全。替代方案必须匹配编码方式:

  • 如果你的字符串来自 encodeURIComponent(比如拼在 URL 查询参数里),必须用 decodeURIComponent
  • 如果来自 encodeURI(比如整个 URL 路径或完整 URL),用 decodeURI
  • 绝不要用 decodeURI 去解 encodeURIComponent 的结果——会抛 URIError
decodeURIComponent('%E4%BD%A0%E5%A5%BD'); // "你好"
decodeURI('%E4%BD%A0%E5%A5%BD');          // URIError: malformed URI sequence
decodeURI('https%3A%2F%2Fexample.com%2Fpath%3Fq=%E4%BD%A0'); // OK

遇到 legacy 字符串(含 %uXXXX)怎么办?自己写兼容解码

老系统可能输出类似 %u4F60%u597D(Unicode 转义),这是 IE 时代非标准写法,decodeURIComponent 完全不识别。需手动转换:

Reading & Knowledge
Reading & Knowledge

博学的好奇伙伴,精通太空、宇宙与历史。不带评判地回答任何问题,擅长解释各种概念。

下载
  • 先用正则匹配 %u[0-9A-Fa-f]{4}
  • 用 parseInt(hex, 16) 转成码点,再用 String.fromCodePoint()
  • 注意:仅当确认输入含 %u 才走此逻辑,避免污染正常 URI 解码
function decodeLegacy(str) {
  return str.replace(/%u([0-9A-Fa-f]{4})/g, (_, hex) =>
    String.fromCodePoint(parseInt(hex, 16))
  );
}
decodeLegacy('%u4F60%u597D'); // "你好"

Node.js 环境下没有全局 unescape,但有人误用 querystring.unescape

Node.js v10+ 的 querystring 模块已弃用,其 unescape 方法实际等价于 decodeURIComponent,且模块本身被标记为 DEP0052。你应该:

  • 用内置 URLSearchParams 解析查询字符串(推荐)
  • 或直接调用 decodeURIComponent,不依赖过时模块
  • 避免在新项目中引入 querystring,尤其不要混用它的 unescape 和浏览器端逻辑
const params = new URLSearchParams('name=%E4%BD%A0&age=25');
console.log(params.get('name')); // "你好"

真正麻烦的不是选哪个函数,而是得先搞清原始字符串是怎么编码出来的——URI 编码、表单提交、JSON 序列化、还是某个古早 API 的私有格式。没看清源头就硬套 decodeURIComponent,反而容易解出乱码或触发异常。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2255

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3622

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1216

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4179

7

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2886

5

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.06

5879

7

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

2026.03.24

4187

22

es6新特性
es6新特性

es6新特性有:1、块级作用域变量;2、箭头函数;3、模板字符串;4、解构赋值;5、默认参数;6、 扩展运算符;7、 类和继承;8、Promise。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

305

5

es6新特性有哪些
es6新特性有哪些

es6的新特性有:1、块级作用域;2、箭头函数;3、解构赋值;4、默认参数;5、扩展运算符;6、模板字符串;7、类和模块;8、迭代器和生成器;9、Promise对象;10、模块化导入和导出等等。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.04

406

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.4万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习