Installation
Quick Take
Examples
allNamedEntities- Decode a named HTML entity
entEndsWith- Find entity names by a case-insensitive suffix
entStartsWithentStartsWithCaseInsensitive- Inspect entity-name metadata
- Test whether a name is a known entity
Purpose
This package exports a plain object with the following keys:
| Key | Type | Purpose |
|---|---|---|
allNamedEntitiesType: plain object | ||
allNamedEntities | plain object | all named HTML entities, key is entity’s name, value is raw decoded entity. 2125 in total. |
entStartsWithType: plain object | ||
entStartsWith | plain object | all named HTML entities, grouped by first character, then by second |
entEndsWithType: plain object | ||
entEndsWith | plain object | all named HTML entities, grouped by last character, then by second-to-last |
entStartsWithCaseInsensitiveType: plain object | ||
entStartsWithCaseInsensitive | plain object | all named HTML entities, grouped by first character, then by second, both case-insensitive |
entEndsWithCaseInsensitiveType: plain object | ||
entEndsWithCaseInsensitive | plain object | all named HTML entities, grouped by last character, then by second-to-last, both case insensitive |
brokenNamedEntitiesType: plain object | ||
brokenNamedEntities | plain object | key-value pairs of common mistyped named HTML entities and their corrections |
uncertainType: plain object | ||
uncertain | plain object | all named HTML entities which could be interpreted as words if entity was malformed (missing ampersand for example) |
allNamedEntitiesSetOnlyType: Set | ||
allNamedEntitiesSetOnly | Set | Set of all named entities, think of array of strings, only unique and faster. Case sensitive list. |
allNamedEntitiesSetOnlyCaseInsensitiveType: Set | ||
allNamedEntitiesSetOnlyCaseInsensitive | Set | Set of all named entities, think of array of strings, only unique and faster. Case in-sensitive list. |
decodeType: function | ||
decode | function | decodes named HTML entities (&...; format) |
minLengthType: integer | ||
minLength | integer | length of the shortest of all named HTML entities (currently 2) |
maxLengthType: integer | ||
maxLength | integer | length of the longest of all named HTML entities (currently 31) |
versionType: string | ||
version | string | as per package.json, for example, 1.4.0 |
API — entStartsWith
entStartsWith is a plain object:
{
"A": {
"E": [
"AElig"
],
"M": [
"AMP"
],
"a": [
"Aacute"
],
...
The point of entStartsWith is that you don’t have to iterate through up to 2,127 entities to match. Instead, you match by first and second letter and match against that list, which varies but is on average tens of strings long.
Let’s tap it.
For example, imagine you have to check, is there a named HTML entity to the right of string index 2 in string 123Aacute456:
import { entStartsWith } from "all-named-html-entities";
// is there a named HTML entity to the right of index 2?
const input = "123Aacute456";
// first, slice the string from third index onwards; you get "Aacute456"
const workingSlice = input.slice(3);
// this is very verbose and exaggerated code but it's for illustrative purposes
// in real life it would be shorter than all this
// define default answer, false:
let result = false;
if (workingSlice && entStartsWith.hasOwnProperty(workingSlice[0]) && entStartsWith[workingSlice[0]].hasOwnProperty(workingSlice[1]) && entStartsWith[workingSlice[0]][workingSlice[1]].some((entity) => workingSlice.startsWith(entity))) {
result = true;
}
console.log(`result: ${result}`);
import { all } from "all-named-html-entities";
console.log(Array.isArray(all));
API — decode()
import { decode } from "all-named-html-entities";
console.log(decode("ℵ"));
// => ℵ
If the given input is not a string, or is an empty string or does not start with ampersand or does not end with semicolon, error is thrown.
Else, check is performed and if it’s not found among known entities, a null is returned.