Optional_Whether to use htmlparser2.
This is set to true if xml is set to true.
OptionalbaseThe base URI for the document. Used to resolve the href and src props.
OptionaldecodeOption inherited from parsing; will be used as the default value for encodeEntities.
OptionalemptyPrint an empty attribute's value.
OptionalencodeEncode characters that are either reserved in HTML or XML.
If xmlMode is true or the value not 'utf8', characters outside of the utf8 range will be encoded as well.
OptionallowerIf set to true, all attribute names will be lowercased. This has noticeable impact on speed.
OptionallowerIf set to true, all tags will be lowercased.
OptionalonCallback for parse errors.
OptionalpseudosExtension point for pseudo-classes.
Maps from names to either strings of functions.
const $ = cheerio.load(
'<div class="foo"></div><div data-bar="boo"></div>',
{
pseudos: {
// `:foo` is an alias for `div.foo`
foo: 'div.foo',
// `:bar(val)` is equivalent to `[data-bar=val s]`
bar: (el, val) => el.attribs['data-bar'] === val,
},
},
);
$(':foo').length; // 1
$('div:bar(boo)').length; // 1
$('div:bar(baz)').length; // 0
OptionalquirksIs the document in quirks mode?
This will lead to .className and #id being case-insensitive.
OptionalrecognizeIf set to true, CDATA sections will be recognized as text even if the xmlMode option is not enabled.
NOTE: If xmlMode is set to true then CDATA sections will always be recognized as text.
OptionalrecognizeIf set to true, self-closing tags will trigger the onclosetag event even if xmlMode is not set to true.
NOTE: If xmlMode is set to true then self-closing tags will always be recognized.
OptionalscriptingThe scripting flag. If set
to true, noscript element content will be parsed as text.
OptionalselfPrint self-closing tags for tags without contents.
OptionalsourceEnables source code location information. When enabled, each node (except the root node)
will have a sourceCodeLocation property. If the node is not an empty element, sourceCodeLocation will
be a ElementLocation object, otherwise it will be Location.
If the element was implicitly created by the parser (as part of
tree correction),
its sourceCodeLocation property will be undefined.
OptionalTokenizerAllows the default tokenizer to be overwritten.
OptionaltreeSpecifies the resulting tree format.
OptionalwithAdd an endIndex property to nodes.
When the parser is used in a non-streaming fashion, endIndex is an integer
indicating the position of the end of the node in the document.
OptionalwithAdd a startIndex property to nodes.
When the parser is used in a non-streaming fashion, startIndex is an integer
indicating the position of the start of the node in the document.
OptionalxmlTreat the input as an XML document.
Internal options for Cheerio.