Tim van der Lippe
6d109a9d45
This also adds Python-2.0 to the list of accepted licenses. Lastly, it fixes a bug where the package.json files were incorrectly reordered. For the `exports` of a particular package, the order that the entrypoints are defined in is crucial. Therefore, we should not alter the order of entrypoints and instead maintain the originally defined ordering. We can use an `OrderedDict` to ensure that Python always loads the JSON files in the same order. DISABLE_THIRD_PARTY_CHECK=NPM update R=jacktfranklin@chromium.org Bug: none Change-Id: I5a309782de6015edea6ba3b502aa0db1f008d973 Reviewed-on: https://chromium-review.googlesource.com/c/devtools/devtools-frontend/+/2692909 Auto-Submit: Tim van der Lippe <tvanderlippe@chromium.org> Reviewed-by: Jack Franklin <jacktfranklin@chromium.org> Commit-Queue: Tim van der Lippe <tvanderlippe@chromium.org>
parse-entities
Parse HTML character references: fast, spec-compliant, positional information.
Install
npm:
npm install parse-entities
Use
var decode = require('parse-entities')
decode('alpha & bravo')
// => alpha & bravo
decode('charlie ©cat; delta')
// => charlie ©cat; delta
decode('echo © foxtrot ≠ golf 𝌆 hotel')
// => echo © foxtrot ≠ golf 𝌆 hotel
API
parseEntities(value[, options])
options
options.additional
Additional character to accept (string?, default: '').
This allows other characters, without error, when following an ampersand.
options.attribute
Whether to parse value as an attribute value (boolean?, default:
false).
options.nonTerminated
Whether to allow non-terminated entities (boolean, default: true).
For example, ©cat for ©cat. This behaviour is spec-compliant but
can lead to unexpected results.
options.warning
Error handler (Function?).
options.text
Text handler (Function?).
options.reference
Reference handler (Function?).
options.warningContext
Context used when invoking warning ('*', optional).
options.textContext
Context used when invoking text ('*', optional).
options.referenceContext
Context used when invoking reference ('*', optional)
options.position
Starting position of value (Location or Position, optional). Useful
when dealing with values nested in some sort of syntax tree. The default is:
{
start: {line: 1, column: 1, offset: 0},
indent: []
}
Returns
string — Decoded value.
function warning(reason, position, code)
Error handler.
Context
this refers to warningContext when given to parseEntities.
Parameters
reason
Human-readable reason for triggering a parse error (string).
position
Place at which the parse error occurred (Position).
code
Identifier of reason for triggering a parse error (number).
The following codes are used:
| Code | Example | Note |
|---|---|---|
1 |
foo & bar |
Missing semicolon (named) |
2 |
foo { bar |
Missing semicolon (numeric) |
3 |
Foo &bar baz |
Ampersand did not start a reference |
4 |
Foo &# |
Empty reference |
5 |
Foo &bar; baz |
Unknown entity |
6 |
Foo € baz |
Disallowed reference |
7 |
Foo � baz |
Prohibited: outside permissible unicode range |
function text(value, location)
Text handler.
Context
this refers to textContext when given to parseEntities.
Parameters
value
String of content (string).
location
Location at which value starts and ends (Location).
function reference(value, location, source)
Character reference handler.
Context
this refers to referenceContext when given to parseEntities.
Parameters
value
Encoded character reference (string).
location
Location at which value starts and ends (Location).
source
Source of character reference (Location).
Related
stringify-entities— Encode HTML character referencescharacter-entities— Info on character entitiescharacter-entities-html4— Info on HTML4 character entitiescharacter-entities-legacy— Info on legacy character entitiescharacter-reference-invalid— Info on invalid numeric character references