Skip to content
Faster html entities library
JavaScript
Branch: master
Clone or download
mdevils Merge pull request #41 from jennifer-shehane/patch-1
Change README title node-html-entities -> html-entities
Latest commit fb9cce4 Aug 1, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
benchmark Fix code style Sep 13, 2014
lib Fix typo Oct 27, 2018
test Add support for static methods Sep 24, 2015
.gitignore Add unit coverage Oct 20, 2014
.travis.yml Disable sudo for travis Aug 26, 2015
LICENSE Version 1.0.10. License. Feb 23, 2013
README.md Change README title node-html-entities -> html-entities Aug 1, 2019
index.js Coffee-script to javascript Sep 6, 2014
package.json 1.2.1 Apr 24, 2017

README.md

html-entities

Build Status Coverage Status

Fast html entities library.

Installation

$ npm install html-entities

Usage

XML entities

HTML validity and XSS attack prevention you can achieve from XmlEntities class.

const Entities = require('html-entities').XmlEntities;

const entities = new Entities();

console.log(entities.encode('<>"\'&©®')); // &lt;&gt;&quot;&apos;&amp;©®
console.log(entities.encodeNonUTF('<>"\'&©®')); // &lt;&gt;&quot;&apos;&amp;&#169;&#174;
console.log(entities.encodeNonASCII('<>"\'&©®')); // <>"\'&©®
console.log(entities.decode('&lt;&gt;&quot;&apos;&amp;&copy;&reg;&#8710;')); // <>"'&&copy;&reg;∆

All HTML entities encoding/decoding

const Entities = require('html-entities').AllHtmlEntities;

const entities = new Entities();

console.log(entities.encode('<>"&©®∆')); // &lt;&gt;&quot;&amp;&copy;&reg;∆
console.log(entities.encodeNonUTF('<>"&©®∆')); // &lt;&gt;&quot;&amp;&copy;&reg;&#8710;
console.log(entities.encodeNonASCII('<>"&©®∆')); // <>"&©®&#8710;
console.log(entities.decode('&lt;&gt;&quot;&amp;&copy;&reg;')); // <>"&©®

Available classes

const XmlEntities = require('html-entities').XmlEntities, // <>"'& + &#...; decoding
      Html4Entities = require('html-entities').Html4Entities, // HTML4 entities.
      Html5Entities = require('html-entities').Html5Entities, // HTML5 entities.
      AllHtmlEntities = require('html-entities').AllHtmlEntities; // Synonym for HTML5 entities.

Supports four methods for every class:

  • encode — encodes, replacing characters to its entity representations. Ignores UTF characters with no entity representation.
  • encodeNonUTF — encodes, replacing characters to its entity representations. Inserts numeric entities for UTF characters.
  • encodeNonASCII — encodes, replacing only non-ASCII characters to its numeric entity representations.
  • decode — decodes, replacing entities to characters. Unknown entities are left as is.
You can’t perform that action at this time.