Skip to content

Update dependency cheerio to v1.2.0 - #1246

Open
renovate[bot] wants to merge 1 commit into
masterfrom
renovate/cheerio-1.x
Open

Update dependency cheerio to v1.2.0#1246
renovate[bot] wants to merge 1 commit into
masterfrom
renovate/cheerio-1.x

Conversation

@renovate

@renovate renovate Bot commented Jun 21, 2025 •
edited
Loading

Copy link
Copy Markdown
Contributor

This PR contains the following updates:

Package Change Age Confidence
cheerio (source) 1.0.0-rc.2 → 1.2.0 age confidence

Release Notes

cheeriojs/cheerio (cheerio)

v1.2.0

Compare Source

What's Changed

New Contributors

Full Changelog: cheeriojs/cheerio@v1.1.2...v1.2.0

v1.1.2

Compare Source

What's Changed

Full Changelog: cheeriojs/cheerio@v1.1.1...v1.1.2

v1.1.1

Compare Source

v1.1.0

Compare Source

What's Changed

Doc Improvements

New Contributors

Full Changelog: cheeriojs/cheerio@v1.0.0...v1.1.0

v1.0.0

Compare Source

Cheerio 1.0 is here! 🎉

Announcement Blog Post

Breaking Changes

  • The minimum NodeJS version is now 18.17 or higher #​3959

  • Import paths were simplified. For example, use cheerio/slim instead of
    cheerio/lib/slim. #​3970

  • The deprecated default Cheerio instance and static methods were removed. #​3974

    Before, it was possible to write code like this:

    import cheerio, { html } from 'cheerio';

html(cheerio('<test></test>')); // ~ '<test></test>' -- NO LONGER WORKS

    Make sure to always load documents first:

    import * as cheerio from 'cheerio';

cheerio.load('<test></test>').html();

  • Node types previously re-exported by Cheerio must now be imported directly
    from (domhandler)(https://github.com/fb55/domhandler). #​3969

  • htmlparser2 options now reside exclusively under the xml key (#​2916):

    const $ = cheerio.load('<html>', {
  xml: {
    withStartIndices: true,
  },
});

New Features

Fixes

Other

Full Changelog: cheeriojs/cheerio@v1.0.0-rc.12...v1.0.0

v1.0.0-rc.12

Compare Source

Bugfix release. Fixed issues:

New Contributors

Full Changelog: cheeriojs/cheerio@v1.0.0-rc.11...v1.0.0-rc.12

v1.0.0-rc.11

Compare Source

cheerio@1.0.0-rc.11 is hopefully the last RC before the 1.0.0 release of Cheerio. There are two APIs that will be added for the next major release: An exract method (#​2523) and NodeJS specific loader methods (#​2051). These are still in flux and I'd appreciate feedback on the proposals.

A big thank you to everyone that contributed to this release! This includes code contributors, as well as the amazing financial support on GitHub Sponsors!

Under the hood, a lot of work for this release went into updating parse5, cheerio's default HTML parser. Have a look at parse5's release notes to see what has changed there.

Breaking

  • Cheerio is now a dual CommonJS and ESM module. That means that deep imports will now fail in newer versions of Node. #​2508
  • script and style contents are added again in .text() #​2509
    • To keep the old behavior, switch .text() to .prop('innerText')
  • The TypeScript types inherited from upstream dependencies have changed. #​2503
    • Node types are now using tagged unions, which will make consumption a bit easier.

Features

  • Relevant options are now forwarded to cheerio-select #​2511
  • For the .prop() method:
    • Add textContent and innerText props #​2214
    • Users can now specify a baseURI option, which will lead to href and src props to be resolved as URLs. #​2510
  • Added a slim export, which will always use htmlparser2 #​1960

Fixes

  • Have text turn passed values to strings #​2047
  • Include undefined in the return type of get by @​glen-84 in #​2392
  • Recognise comments as HTML #​2504
  • Add missing undefined return value #​2505
  • Export missing static methods #​2506
  • Have style parsing add malformed fields to previous field #​2521

Refactor

Development Experience

Docs

New Contributors

Full Changelog: cheeriojs/cheerio@v1.0.0-rc.10...v1.0.0-rc.11

v1.0.0-rc.10

Compare Source

Fixes:

Documentation:

Refactors:

v1.0.0-rc.9

Compare Source

Port to TypeScript

Cheerio has been ported entirely to TypeScript (in #​1816)! This eliminates a lot of edge-cases within Cheerio and will allow you to use Cheerio with confidence. This release also features a new documentation website based on TypeDoc, allowing you to quickly navigate all available methods: https://cheerio.js.org

Breaking change: If you were using the function exported by Cheerio directly instead of first load()ing a document, you will now have to update the require to use the default export.

- const cheerio = require("cheerio");
+ const cheerio = require("cheerio").default;

cheerio('div', dom)

Please note that this way of using Cheerio is deprecated and might be removed in a future version. Please consider updating your code to:

const cheerio = require("cheerio");

const $ = cheerio.load(dom)
$('div')

Note: Cheerio uses template literal types to determine return types. These are available starting with TypeScript 4.1, so you might have to bump your TypeScript version.

For TypeScript types, Cheerio now implements the ArrayLike<T> interface. That means that Cheerio instances can contain objects of arbitrary types, but not all methods can be called on them.

The TypeScript compiler will figure out what structures you are operating on:

  • When calling a loaded Cheerio instance with an HTML string like $('<div>'), it will product a Cheerio<Node> type.
    • Node is the base class for DOM elements and includes eg. comment and text nodes.
  • When calling Cheerio with a selector like $('.foo'), it will produce a Cheerio<Element>, as only Elements can be part of the result set.
    • Element is the class representing tags.
  • You can still use $('...').map() to map to arbitrary values, and will get a compiler error when trying to call method that are not supported.
    • Eg. $('.foo').map((i, el) => $(el).text()).attr('test') will no longer be possible, as .attr is not allowed to be called on a Cheerio<string>.

This release does not contain other changes to functionality. Feedback is greatly appreciated; if you encounter a problem, please file an issue!

v1.0.0-rc.8

Compare Source

Second botched release. Please use v1.0.0-rc.9 instead.

v1.0.0-rc.7

Compare Source

Published without a lib directory — please ignore.

v1.0.0-rc.6

Compare Source

Breaking:

  • Fixed the ordering of the output of several methods, including prevAll, prevUntil and parentsUntil. The new order matches jQuery.

This release contains three breaking changes inherited from dependencies.

  • Selectors (see css-select@4.0.0):
    • Several pseudo selectors are now stricter, in line with the HTML spec.
    • Some attributes are now case-insensitive based on the HTML spec.
  • DOM:
    • In XML mode, all elements will have type: 'tag'.

New features:

Types:

Bug fixes:

Documentation updates:

Refactors:

CI:

Test changes:

Commit Range:

v1.0.0-rc.5

Compare Source

Hotfix release

  • fix(package): Use cheerio-select-tmp until naming issue is resolved 3751929

v1.0.0-rc.4

Compare Source

Welcome to cheerio@1.0.0-rc.4! This is the last pre-release before a full 1.0.0 release — please make sure to test this release and report any issues you might find.

This release was made possible by our supporters on Open Collective. If you want to support this project going forward, have a look at sponsorship options!

Breaking:

  • After upgrading parse5, cheerio temporarily has a minimum Node version of Node 6. See #​1585 for details.
  • Use the parser's DOM without modifications (#​1559 by @​fb55)
    • Nodes no longer have a root reference. The root node is now referenced by the parent property.
  • Use parse5 to serialize the DOM (04091a4 by @​fb55)
    • We will no longer encode non-ASCII characters by default. Please make sure that you pass on the appropriate content encoding.

New Features:

Bug Fixes:

Other notable changes:

v1.0.0-rc.3

Compare Source

This release corrects a test expectation that was fixed by one of the project's dependencies.

Configuration

📅 Schedule: (in timezone US/Eastern)

  • Branch creation
    • "every weekend"
  • Automerge
    • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

renovate-approve[bot]
renovate-approve Bot previously approved these changes Jun 21, 2025
View reviewed changes
@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 5 times, most recently from 2eccd9a to 937d5b5 Compare June 25, 2025 10:23
@marslanabdulrauf

marslanabdulrauf commented Jun 25, 2025

Copy link
Copy Markdown
Contributor

Cannot upgrade cheerio, Enzyme requires cheerio.

Enzyme is at latest version, we might have to migrate to react-testing-library from enzyme

@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 12 times, most recently from 3baa17f to d49d4f5 Compare July 1, 2025 16:52
@marslanabdulrauf marslanabdulrauf self-assigned this Jul 2, 2025
@marslanabdulrauf

marslanabdulrauf commented Jul 2, 2025

Copy link
Copy Markdown
Contributor

We are on the most latest version of Enzyme and that does not support cheerio v1.1

We might need to move from enzyme to jest or react-testing-library

@marslanabdulrauf marslanabdulrauf removed their assignment Jul 2, 2025
@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 2 times, most recently from 13c8af3 to f337200 Compare July 2, 2025 14:13
@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 5 times, most recently from 78e640b to 2cfc1ae Compare July 7, 2025 11:56
@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 9 times, most recently from bfada55 to dd7ff52 Compare July 20, 2025 23:53
@renovate renovate Bot changed the title chore(deps): update dependency cheerio to v1.1.0 chore(deps): update dependency cheerio to v1.1.1 Jul 20, 2025
@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 2 times, most recently from 48458e1 to 5105464 Compare July 21, 2025 13:05
@renovate renovate Bot changed the title chore(deps): update dependency cheerio to v1.1.1 chore(deps): update dependency cheerio to v1.1.2 Jul 21, 2025
@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 11 times, most recently from 95f2d06 to 028e1ba Compare July 29, 2025 12:41
@renovate
renovate Bot force-pushed the renovate/cheerio-1.x branch 2 times, most recently from 607d326 to 06825f6 Compare July 30, 2025 12:56
sentry[bot]
sentry Bot reviewed Feb 26, 2026
View reviewed changes
Comment thread package.json
sentry[bot]
sentry Bot reviewed Feb 27, 2026
View reviewed changes
Comment thread package.json
"**/acorn": "^8.0.0",
"**/material-components-web": "^0.33.0",
"**/cheerio": "1.0.0-rc.2"
"**/cheerio": "1.2.0"

@sentry sentry Bot Feb 27, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Updating cheerio to 1.2.0 is incompatible with enzyme@^3.11.0, which relies on an internal cheerio/lib/utils module that is no longer exported. This will break all tests.
Severity: HIGH

Suggested Fix

Either update enzyme to a version that is compatible with cheerio@1.2.0, or revert the cheerio resolution back to a compatible version like 1.0.0-rc.2 or 1.0.0-rc.3.

Prompt for AI Agent 
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: package.json#L119

Potential issue: The update of the `cheerio` dependency to version `1.2.0` will break
the test suite. The project uses `enzyme@^3.11.0`, which is only compatible with
`cheerio` versions up to `1.0.0-rc.3`. `enzyme` internally requires the
`cheerio/lib/utils` module, but this module is no longer exposed in `cheerio` versions
`1.0.0` and newer. As a result, running tests will trigger a "Module not found" error
when `enzyme` attempts to initialize, causing all tests to fail.

sentry[bot]
sentry Bot reviewed Mar 5, 2026
View reviewed changes
Comment thread package.json
"**/acorn": "^8.0.0",
"**/material-components-web": "^0.33.0",
"**/cheerio": "1.0.0-rc.2"
"**/cheerio": "1.2.0"

@sentry sentry Bot Mar 5, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Updating the cheerio resolution to 1.2.0 will break all JavaScript tests because the project's version of enzyme is incompatible with cheerio versions above 1.0.0-rc.3.
Severity: CRITICAL

Suggested Fix

Revert the cheerio resolution in package.json back to "**/cheerio": "1.0.0-rc.2". This will restore the workaround that keeps the test suite functional. A more permanent solution would involve upgrading enzyme and its related packages to versions compatible with modern cheerio.

Prompt for AI Agent 
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: package.json#L119

Potential issue: The project's test suite uses `enzyme` and `enzyme-adapter-react-15`,
which have a dependency on `cheerio`. These specific versions of `enzyme` rely on an
internal API path, `cheerio/lib/utils`, that was removed as an export in `cheerio`
version `1.0.0` and later. The previous `package.json` deliberately pinned `cheerio` to
version `1.0.0-rc.2` to maintain compatibility. This pull request updates the `cheerio`
resolution to `1.2.0`, which reintroduces the incompatibility. This will cause a module
resolution error at runtime when `enzyme` is initialized, leading to the failure of the
entire JavaScript test suite.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@sentry sentry[bot] sentry[bot] left review comments
@renovate-approve renovate-approve[bot] renovate-approve[bot] left review comments

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

Blocked

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@marslanabdulrauf