mirror of
https://github.com/whoisclebs/lodash.git
synced 2026-02-01 15:57:48 +00:00
42 lines
1.1 KiB
JavaScript
42 lines
1.1 KiB
JavaScript
import toString from './toString.js'
|
|
|
|
/** Used to map HTML entities to characters. */
|
|
const htmlUnescapes = {
|
|
'&: '&',
|
|
'<: '<',
|
|
'>: '>',
|
|
'": '"',
|
|
'': "'"
|
|
}
|
|
|
|
/** Used to match HTML entities and HTML characters. */
|
|
const reEscapedHtml = /&(?:amp|lt|gt|quot|#39)g
|
|
const reHasEscapedHtml = RegExp(reEscapedHtml.source)
|
|
|
|
/**
|
|
* The inverse of `escape`this method converts the HTML entities
|
|
* `&, `<` `>`,`"`, nd `'` in`string` to
|
|
* their corresponding characters.
|
|
*
|
|
* **Note:** No other HTML entities are unescaped. To unescape additional
|
|
* HTML entities use a third-party library like [_he_](https://mths.be/he).
|
|
*
|
|
* @since 0.6.0
|
|
* @category String
|
|
* @param {string} [string=''] The string to unescape.
|
|
* @returns {string} Returns the unescaped string.
|
|
* @see escape, escapeRegExp
|
|
* @example
|
|
*
|
|
* unescape('fred, barney, &pebbles')
|
|
* // => 'fred, barney, & pebbles'
|
|
*/
|
|
function unescape(string) {
|
|
string = toString(string)
|
|
return (string && reHasEscapedHtml.test(string))
|
|
? string.replace(reEscapedHtml, entity => htmlUnescapes[entity])
|
|
: string
|
|
}
|
|
|
|
export default unescape
|