html (slug)

slug.html

slug.html — basic HTML utilities

Lightweight helpers for working with HTML fragments. Not a full HTML parser — intended for simple extraction and unescaping tasks on well-formed markup.

TOC

• extractInnerText(html, tag, start)
• htmlUnescape(str)

Functions

extractInnerText(html, tag, start)

fn slug.html#extractInnerText(html, tag, start = 0) -> @str

extracts the inner content of the first matching tag in an HTML string.

Handles nested tags of the same type correctly — the inner content is everything between the outermost opening and closing tag. Returns an empty string if the tag is not found or start is negative.

The start parameter can be used to search from a specific character offset, enabling successive extractions from the same document.

extractInnerText("<div><p>hello</p></div>", "p")
// => "hello"

extractInnerText("<a href='h'><a>hi</a></a>", "a")
// => "<a>hi</a>"

Examples

extractInnerText("<a>hi</a>", "a", -1)  // => ""
extractInnerText("<a>hi</a>", "div")  // => ""
extractInnerText("<a>hi</a>", "a")  // => "hi"
extractInnerText("<a href='h'><a>hi</a></a>", "a")  // => "<a>hi</a>"
extractInnerText("<a><a href='h'>hi</a></a>", "a")  // => "<a href='h'>hi</a>"

htmlUnescape(str)

fn slug.html#htmlUnescape(str) -> @str

decodes common HTML entities in a string.

Handles &, <, >, ", and '. Does not handle numeric entities beyond ' or named entities beyond the five listed above.

Examples

htmlUnescape("E & S")  // => "E & S"