TripSit_Suite/node_modules/stringify-entities/readme.md

stringify-entities

Encode HTML character references and character entities.

• Very fast
• Just the encoding part
• Reliable: '`' characters are escaped to ensure no scripts run in Internet Explorer 6 to 8. Additionally, only named entities recognized by HTML4 are encoded, meaning the infamous ' (which people think is a virus) won’t show up

Algorithm

By default, all dangerous, non-ASCII, and non-printable ASCII characters are encoded. A subset of characters can be given to encode just those characters. Alternatively, pass escapeOnly to escape just the dangerous characters (", ', <, >, &, `). By default, numeric entities are used. Pass useNamedReferences to use named entities when possible, or useShortestReferences to use them if that results in less bytes.

Install

npm:

npm install stringify-entities

Use

var stringify = require('stringify-entities')

stringify('alpha © bravo ≠ charlie 𝌆 delta')
// => 'alpha © bravo ≠ charlie 𝌆 delta'

stringify('alpha © bravo ≠ charlie 𝌆 delta', {useNamedReferences: true})
// => 'alpha © bravo ≠ charlie 𝌆 delta'

API

stringifyEntities(value[, options])

Encode special characters in value.

options

options.escapeOnly

Whether to only escape possibly dangerous characters (boolean, default: false). Those characters are ", ', <, > &, and `.

options.subset

Whether to only escape the given subset of characters (Array.<string>).

options.useNamedReferences

Whether to use named entities where possible (boolean?, default: false).

options.useShortestReferences

Whether to use named entities, where possible, if that results in less bytes (boolean?, default: false). Note: useNamedReferences can be omitted when using useShortestReferences.

options.omitOptionalSemicolons

Whether to omit semicolons when possible (boolean?, default: false). Note: This creates parse errors, don’t use this except when building a minifier.

Omitting semicolons is possible for certain legacy named references, and numeric entities, in some cases.

options.attribute

Only needed when operating dangerously with omitOptionalSemicolons: true. Create entities which don’t fail in attributes (boolean?, default: false).

Related

• parse-entities — Parse HTML character references
• character-entities — Info on character entities
• character-entities-html4 — Info on HTML4 character entities
• character-entities-legacy — Info on legacy character entities
• character-reference-invalid — Info on invalid numeric character references

License

MIT © Titus Wormer