🏃‍♂️ Encode Entities 🍁

🏃‍♂️ Fast and simple Map and RegExp based HTML entities encoder.🍁

This package has been deprecated, please use @igor.dvlpr/encode-entities instead.

Fast and simple Map and RegExp based HTML entities encoder. In order to overcome different methods of possible XSS attacks, it by default encodes the following characters: <, >, ", ', &, =, `, !, @, $, %, (, ), +, {, }, [, ].
You can however remove any of these rules and/or add your own.

Uses the MappedReplacer package.

✨Since version 1.1.0 Encode Entities is a hybrid module that supports both CommonJS (legacy) and ES modules, thanks to Modern Module.

Table of Contents

• Install
• API
  • resetRules()
  • addRule()
  • addRules()
  • removeRule()
  • rulesCount()
  • encode()
• Test

Install

1npm i encode-entities

API

resetRules(): void

Resets the rules to the default ones.

1const Encoder = require('encode-entities')
2
3const encoder = new Encoder()
4
5encoder.addRule('<', '😀')
6encoder.addRule('>', '😂')
7encoder.resetRules()
8
9console.log(encoder.encode('<strong>')) // outputs '&#60;strong&#62;'

addRule(key: string, value: string): boolean

Adds a new rule or updates the existing rule for entities encoding. Returns true if the rule was added successfully or false if not.

1const Encoder = require('encode-entities')
2
3const encoder = new Encoder()
4
5encoder.addRule('→', '→')
6console.log(encoder.encode('<a href="#">→</a>')) // outputs '&#60;a href&#61;&#34;#&#34;&#62;&#8594;&#60;/a&#62;'

addRules(rules: Object): boolean

Adds rules or updates the existing rules for entity encoding.
Passed object is a simple key-value object, i.e. { '<': '&#60;', '>': '&#62;' }
Returns true if the rules were added successfully or false if not.

1const Encoder = require('encode-entities')
2
3const encoder = new Encoder()
4
5encoder.addRules({
6  '𝕋': '𝕋',
7  '≈': '≈',
8  '𝔱': '𝔱',
9})
10
11console.log(encoder.encode('<span>𝕋 ≈ 𝔱</span>')) // outputs '&#60;span&#62;&#120139; &#8776; &#120113;&#60;/span&#62;'

removeRule(key: string): boolean

Removes the rule that matches the provided key. Returns true if the rule was removed successfully or false if not.

1const Encoder = require('encode-entities')
2
3const encoder = new Encoder()
4
5encoder.addRules({
6  '𝕋': '𝕋',
7  '≈': '≈',
8  '𝔱': '𝔱',
9})
10encoder.removeRule('≈')
11
12console.log(encoder.rulesCount()) // outputs 20

rulesCount(): number

Gets the number of rules for entity encoding.

1const Encoder = require('encode-entities')
2
3const encoder = new Encoder()
4
5encoder.addRules({
6  '𝕋': '𝕋',
7  '≈': '≈',
8  '𝔱': '𝔱',
9})
10
11console.log(encoder.rulesCount()) // outputs 21

encode()

Encodes special characters in the given string to HTML entities.

1const Encoder = require('encode-entities')
2
3const encoder = new Encoder()
4
5console.log(encoder.encode('<strong>')) // outputs '&#60;strong&#62;'

Test

1npm test