Skip to content

Commit

Permalink
zh-cn: update the translation of unescape() (#17975)
Browse files Browse the repository at this point in the history
Co-authored-by: skyclouds2001 <[email protected]>
  • Loading branch information
yin1999 and skyclouds2001 authored Jan 20, 2024
1 parent 3a31376 commit abbb188
Showing 1 changed file with 14 additions and 5 deletions.
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
---
title: unescape()
slug: Web/JavaScript/Reference/Global_Objects/unescape
l10n:
sourceCommit: cb8b34d86ff9326a72c421dcf4430b450e6c8d5d
---

{{jsSidebar("Objects")}}{{Deprecated_Header}}

已废弃的**`unescape()`** 方法计算生成一个新的字符串,其中的十六进制转义序列将被其表示的字符替换。上述的转义序列就像{{jsxref("escape")}}里介绍的一样。因为 `unescape` 已经废弃,建议使用 {{jsxref("decodeURI")}}或者{{jsxref("decodeURIComponent")}} 替代本方法
> **备注:** `unescape()` 是由浏览器实现的非标准函数,其仅针对跨引擎兼容性而进行了标准化。并不要求所有的 JavaScript 引擎都实现它,并且可能无法在所有地方都正常工作。如果可能的话,请使用 {{jsxref("decodeURIComponent()")}}{{jsxref("decodeURI()")}}。
> **备注:** 不要使用 `unescape` 去解码 URL,请使用 {{jsxref("decodeURI()")}} 或 {{jsxref("decodeURIComponent()")}} 替代
**`unescape()`** 函数计算一个新的字符串,将其中的十六进制转义序列替换为它们所代表的字符。转义序列可能是由 {{jsxref("escape()")}} 等函数引入的

## 语法

Expand All @@ -18,18 +20,24 @@ unescape(str)
### 参数

- `str`
- : 被编码过的字符串
- : 要解码的字符串

### 返回值

一个未被转义的新字符串
一个其中的某些字符已被解码的新的字符串

## 描述

`unescape`函数是*全局对象*的一个属性。
`unescape` 函数是全局对象的函数属性。

`unescape()` 函数将任何转移序列替换为它所代表的字符。具体来说,它将任何形式为 `%XX``%uXXXX`(其中 `X` 代表一个十六进制数字)的转义序列替换为十六进制值为 `XX`/`XXXX` 的字符。如果转义序列无效(例如,如果 `%` 后面跟着一个或未跟十六进制数字),则保持不变。

> **备注:** 该函数主要用于 [URL 编码](https://zh.wikipedia.org/wiki/百分号编码),其部分基于 {{rfc(1738)}} 中的转义格式。`unescape()` 函数*不会*对字符串字面量中的[转义序列](/zh-CN/docs/Web/JavaScript/Reference/Lexical_grammar#转义序列)进行求值。你可以将 `\xXX` 替换为 `%XX`,将 `\uXXXX` 替换为 `%uXXXX`,以获得一个可以被 `unescape()` 处理的字符串。
## 示例

### 使用 unescape()

```js
unescape("abc123"); // "abc123"
unescape("%E4%F6%FC"); // "äöü"
Expand All @@ -46,6 +54,7 @@ unescape("%u0107"); // "ć"

## 参见

- [`core-js``unescape` 的 polyfill](https://github.com/zloirock/core-js#ecmascript-string-and-regexp)
- {{jsxref("decodeURI")}}
- {{jsxref("decodeURIComponent")}}
- {{jsxref("escape")}}

0 comments on commit abbb188

Please sign in to comment.