113 lines
No EOL
4.4 KiB
JavaScript
113 lines
No EOL
4.4 KiB
JavaScript
import { decodeXML, decodeHTML, decodeHTMLStrict } from "./decode.js";
|
|
import { encodeHTML, encodeNonAsciiHTML } from "./encode.js";
|
|
import { encodeXML, escapeUTF8, escapeAttribute, escapeText, } from "./escape.js";
|
|
/** The level of entities to support. */
|
|
export var EntityLevel;
|
|
(function (EntityLevel) {
|
|
/** Support only XML entities. */
|
|
EntityLevel[EntityLevel["XML"] = 0] = "XML";
|
|
/** Support HTML entities, which are a superset of XML entities. */
|
|
EntityLevel[EntityLevel["HTML"] = 1] = "HTML";
|
|
})(EntityLevel || (EntityLevel = {}));
|
|
/** Determines whether some entities are allowed to be written without a trailing `;`. */
|
|
export var DecodingMode;
|
|
(function (DecodingMode) {
|
|
/** Support legacy HTML entities. */
|
|
DecodingMode[DecodingMode["Legacy"] = 0] = "Legacy";
|
|
/** Do not support legacy HTML entities. */
|
|
DecodingMode[DecodingMode["Strict"] = 1] = "Strict";
|
|
})(DecodingMode || (DecodingMode = {}));
|
|
export var EncodingMode;
|
|
(function (EncodingMode) {
|
|
/**
|
|
* The output is UTF-8 encoded. Only characters that need escaping within
|
|
* XML will be escaped.
|
|
*/
|
|
EncodingMode[EncodingMode["UTF8"] = 0] = "UTF8";
|
|
/**
|
|
* The output consists only of ASCII characters. Characters that need
|
|
* escaping within HTML, and characters that aren't ASCII characters will
|
|
* be escaped.
|
|
*/
|
|
EncodingMode[EncodingMode["ASCII"] = 1] = "ASCII";
|
|
/**
|
|
* Encode all characters that have an equivalent entity, as well as all
|
|
* characters that are not ASCII characters.
|
|
*/
|
|
EncodingMode[EncodingMode["Extensive"] = 2] = "Extensive";
|
|
/**
|
|
* Encode all characters that have to be escaped in HTML attributes,
|
|
* following {@link https://html.spec.whatwg.org/multipage/parsing.html#escapingString}.
|
|
*/
|
|
EncodingMode[EncodingMode["Attribute"] = 3] = "Attribute";
|
|
/**
|
|
* Encode all characters that have to be escaped in HTML text,
|
|
* following {@link https://html.spec.whatwg.org/multipage/parsing.html#escapingString}.
|
|
*/
|
|
EncodingMode[EncodingMode["Text"] = 4] = "Text";
|
|
})(EncodingMode || (EncodingMode = {}));
|
|
/**
|
|
* Decodes a string with entities.
|
|
*
|
|
* @param data String to decode.
|
|
* @param options Decoding options.
|
|
*/
|
|
export function decode(data, options = EntityLevel.XML) {
|
|
const opts = typeof options === "number" ? { level: options } : options;
|
|
if (opts.level === EntityLevel.HTML) {
|
|
if (opts.mode === DecodingMode.Strict) {
|
|
return decodeHTMLStrict(data);
|
|
}
|
|
return decodeHTML(data);
|
|
}
|
|
return decodeXML(data);
|
|
}
|
|
/**
|
|
* Decodes a string with entities. Does not allow missing trailing semicolons for entities.
|
|
*
|
|
* @param data String to decode.
|
|
* @param options Decoding options.
|
|
* @deprecated Use `decode` with the `mode` set to `Strict`.
|
|
*/
|
|
export function decodeStrict(data, options = EntityLevel.XML) {
|
|
const opts = typeof options === "number" ? { level: options } : options;
|
|
if (opts.level === EntityLevel.HTML) {
|
|
if (opts.mode === DecodingMode.Legacy) {
|
|
return decodeHTML(data);
|
|
}
|
|
return decodeHTMLStrict(data);
|
|
}
|
|
return decodeXML(data);
|
|
}
|
|
/**
|
|
* Encodes a string with entities.
|
|
*
|
|
* @param data String to encode.
|
|
* @param options Encoding options.
|
|
*/
|
|
export function encode(data, options = EntityLevel.XML) {
|
|
const opts = typeof options === "number" ? { level: options } : options;
|
|
// Mode `UTF8` just escapes XML entities
|
|
if (opts.mode === EncodingMode.UTF8)
|
|
return escapeUTF8(data);
|
|
if (opts.mode === EncodingMode.Attribute)
|
|
return escapeAttribute(data);
|
|
if (opts.mode === EncodingMode.Text)
|
|
return escapeText(data);
|
|
if (opts.level === EntityLevel.HTML) {
|
|
if (opts.mode === EncodingMode.ASCII) {
|
|
return encodeNonAsciiHTML(data);
|
|
}
|
|
return encodeHTML(data);
|
|
}
|
|
// ASCII and Extensive are equivalent
|
|
return encodeXML(data);
|
|
}
|
|
export { encodeXML, escape, escapeUTF8, escapeAttribute, escapeText, } from "./escape.js";
|
|
export { encodeHTML, encodeNonAsciiHTML,
|
|
// Legacy aliases (deprecated)
|
|
encodeHTML as encodeHTML4, encodeHTML as encodeHTML5, } from "./encode.js";
|
|
export { decodeXML, decodeHTML, decodeHTMLStrict,
|
|
// Legacy aliases (deprecated)
|
|
decodeHTML as decodeHTML4, decodeHTML as decodeHTML5, decodeHTMLStrict as decodeHTML4Strict, decodeHTMLStrict as decodeHTML5Strict, decodeXML as decodeXMLStrict, } from "./decode.js";
|
|
//# sourceMappingURL=index.js.map
|