Options
All
  • Public
  • Public/Protected
  • All
Menu

cheerio

Index

References

Classes Cheerio

Classes DOM Node

Interfaces

Type aliases DOM Node

Type aliases Other

Variables

Functions

References

html

Re-exports html

text

Re-exports text

xml

Re-exports xml

DOM Node Type aliases

AnyNode

AnyNode: ParentNode | ChildNode

Re-exporting all of the node types.

ParentNode

ParentNode: Document | Element | CDATA

Re-exporting all of the node types.

Other Type aliases

AcceptedElems

AcceptedElems<T>: BasicAcceptedElems<T> | ((this: T, i: number, el: T) => BasicAcceptedElems<T>)

Elements that can be passed to manipulation methods, including functions.

Type parameters

AcceptedFilters

AcceptedFilters<T>: string | FilterFunction<T> | T | Cheerio<T>

Supported filter types, for traversal methods.

Type parameters

  • T

BasicAcceptedElems

BasicAcceptedElems<T>: Cheerio<T> | T[] | T | string

Elements that can be passed to manipulation methods.

Type parameters

FilterFunction

FilterFunction<T>: (this: T, i: number, el: T) => boolean

Type parameters

  • T

Type declaration

    • (this: T, i: number, el: T): boolean

    • Function signature, for traversal methods.

      Parameters

      • this: T
      • i: number
      • el: T

      Returns boolean

SelectorType

SelectorType: `${SelectorSpecial}${AlphaNumeric}${string}` | `${AlphaNumeric}${string}`

Type for identifying selectors. Allows us to "upgrade" queries using selectors to return Elements.

Variables

default

default: CheerioAPI

The default cheerio instance.

deprecated

Use the function returned by load instead.

Const select

select: { aliases: Record<string, string>; filters: Record<string, Filter>; pseudos: Record<string, Pseudo> } = ...

Extension points for adding custom pseudo selectors.

deprecated

Use the options.pseudos option instead.

example

Adds a custom pseudo selector :classic, which matches some fun HTML elements that are no more.

import { load, select } from 'cheerio';

// Aliases are short hands for longer HTML selectors
select.aliases.classic = 'marquee,blink';

const $ = load(doc);
$(':classic').html();

Type declaration

  • aliases: Record<string, string>
  • filters: Record<string, Filter>
  • pseudos: Record<string, Pseudo>

Functions

contains

load

  • Create a querying function, bound to a document created from the provided markup.

    Note that similar to web browser contexts, this operation may introduce <html>, <head>, and <body> elements; set isDocument to false to switch to fragment mode and disable this.

    see

    https://cheerio.js.org#loading for additional usage information.

    Parameters

    • content: string | AnyNode | AnyNode[] | Buffer

      Markup to be loaded.

    • Optional options: null | CheerioOptions

      Options for the created instance.

    • isDocument: boolean = true

      Allows parser to be switched to fragment mode.

    Returns CheerioAPI

    The loaded document.

merge

  • merge<T>(arr1: WritableArrayLike<T>, arr2: ArrayLike<T>): ArrayLike<T> | undefined

  • $.merge().

    alias

    Cheerio.merge

    see

    https://api.jquery.com/jQuery.merge/

    Type parameters

    • T

    Parameters

    • arr1: WritableArrayLike<T>

      First array.

    • arr2: ArrayLike<T>

      Second array.

    Returns ArrayLike<T> | undefined

    arr1, with elements of arr2 inserted.

parseHTML

  • parseHTML(this: CheerioAPI, data: string, context?: unknown, keepScripts?: boolean): AnyNode[]
  • parseHTML(this: CheerioAPI, data?: null | ""): null

  • Parses a string into an array of DOM nodes. The context argument has no meaning for Cheerio, but it is maintained for API compatibility with jQuery.

    alias

    Cheerio.parseHTML

    see

    https://api.jquery.com/jQuery.parseHTML/

    Parameters

    • this: CheerioAPI
    • data: string

      Markup that will be parsed.

    • Optional context: unknown

      Will be ignored. If it is a boolean it will be used as the value of keepScripts.

    • Optional keepScripts: boolean

      If false all scripts will be removed.

    Returns AnyNode[]

    The parsed DOM.

  • Parameters

    Returns null

root

  • Sometimes you need to work with the top-level root element. To query it, you can use $.root().

    example
    $.root().append('<ul id="vegetables"></ul>').html();
    //=> <ul id="fruits">...</ul><ul id="vegetables"></ul>
    alias

    Cheerio.root

    Parameters

    Returns Cheerio<Document>

    Cheerio instance wrapping the root node.