cheeriojs/cheerio
### [`v1.0.0-rc.10`](https://togithub.com/cheeriojs/cheerio/releases/v1.0.0-rc.10)
[Compare Source](https://togithub.com/cheeriojs/cheerio/compare/v1.0.0-rc.9...v1.0.0-rc.10)
**Fixes:**
- `.html(node)` now moves passed nodes ([#1923](https://togithub.com/cheeriojs/cheerio/issues/1923), fixes [#940](https://togithub.com/cheeriojs/cheerio/issues/940)) [`258b26b`](https://togithub.com/cheeriojs/cheerio/commit/258b26b)
- Boolean attributes are no longer special in xmlMode ([#1903](https://togithub.com/cheeriojs/cheerio/issues/1903), fixes [#1805](https://togithub.com/cheeriojs/cheerio/issues/1805)) [`b393e4a`](https://togithub.com/cheeriojs/cheerio/commit/b393e4a)
- Rename parser adapter files ([#1873](https://togithub.com/cheeriojs/cheerio/issues/1873), fixes [#1847](https://togithub.com/cheeriojs/cheerio/issues/1847)) [`8f55dd8`](https://togithub.com/cheeriojs/cheerio/commit/8f55dd8)
- Make `filter` work on all collections ([#1870](https://togithub.com/cheeriojs/cheerio/issues/1870), fixes [#1867](https://togithub.com/cheeriojs/cheerio/issues/1867)) [`fb8d31e`](https://togithub.com/cheeriojs/cheerio/commit/fb8d31e)
- Bump cheerio-select ([#1922](https://togithub.com/cheeriojs/cheerio/issues/1922), fixes https://www.npmjs.com/advisories/1754) [`5cd2b9c`](https://togithub.com/cheeriojs/cheerio/commit/5cd2b9c)
**Documentation:**
- Document how to define TS types for Plug-Ins ([#1915](https://togithub.com/cheeriojs/cheerio/issues/1915), fixes [#1778](https://togithub.com/cheeriojs/cheerio/issues/1778)) [`880fd2c`](https://togithub.com/cheeriojs/cheerio/commit/880fd2c)
- Remove obsolete Testing section [`e0c7cbb`](https://togithub.com/cheeriojs/cheerio/commit/e0c7cbb)
- Remove now-invalid `require` [`5dfbd35`](https://togithub.com/cheeriojs/cheerio/commit/5dfbd35)
**Refactors:**
- Wrap shared behavior in `traversing` ([#1909](https://togithub.com/cheeriojs/cheerio/issues/1909)) [`58e090a`](https://togithub.com/cheeriojs/cheerio/commit/58e090a)
- Move `is` to `traversing`, optimize ([#1908](https://togithub.com/cheeriojs/cheerio/issues/1908)) [`1c6fa3e`](https://togithub.com/cheeriojs/cheerio/commit/1c6fa3e)
- Change order of arguments of internal `domEach` ([#1892](https://togithub.com/cheeriojs/cheerio/issues/1892)) [`feda230`](https://togithub.com/cheeriojs/cheerio/commit/feda230)
- Have `load` export a function ([#1869](https://togithub.com/cheeriojs/cheerio/issues/1869)) [`c370f4e`](https://togithub.com/cheeriojs/cheerio/commit/c370f4e)
### [`v1.0.0-rc.9`](https://togithub.com/cheeriojs/cheerio/releases/v1.0.0-rc.9)
[Compare Source](https://togithub.com/cheeriojs/cheerio/compare/v1.0.0-rc.8...v1.0.0-rc.9)
**Port to TypeScript**
Cheerio has been ported entirely to TypeScript (in [#1816](https://togithub.com/cheeriojs/cheerio/issues/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.
```diff
- 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:
```js
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` 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 `$('
')`, it will product a `Cheerio` 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`, as only `Element`s 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`.
***
This release does not contain other changes to functionality. Feedback is greatly appreciated; if you encounter a problem, please [file an issue](https://togithub.com/cheeriojs/cheerio/issues)!
### [`v1.0.0-rc.8`](https://togithub.com/cheeriojs/cheerio/releases/v1.0.0-rc.8)
[Compare Source](https://togithub.com/cheeriojs/cheerio/compare/v1.0.0-rc.7...v1.0.0-rc.8)
*Second botched release. Please use `v1.0.0-rc.9` instead.*
### [`v1.0.0-rc.7`](https://togithub.com/cheeriojs/cheerio/releases/v1.0.0-rc.7)
[Compare Source](https://togithub.com/cheeriojs/cheerio/compare/v1.0.0-rc.6...v1.0.0-rc.7)
*Published without a `lib` directory — please ignore.*
### [`v1.0.0-rc.6`](https://togithub.com/cheeriojs/cheerio/releases/v1.0.0-rc.6)
[Compare Source](https://togithub.com/cheeriojs/cheerio/compare/v1.0.0-rc.5...v1.0.0-rc.6)
**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](https://togithub.com/fb55/css-select/releases/tag/v4.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:**
- Add `.unwrap` ([#1651](https://togithub.com/cheeriojs/cheerio/issues/1651) by [@5saviahv](https://togithub.com/5saviahv)) [`2037d83`](https://togithub.com/cheeriojs/cheerio/commit/2037d83)
- Add `.wrapAll` ([#1590](https://togithub.com/cheeriojs/cheerio/issues/1590) by [@5saviahv](https://togithub.com/5saviahv)) [`cd4a4d9`](https://togithub.com/cheeriojs/cheerio/commit/cd4a4d9)
- Support `prop('innerHTML')` ([#1578](https://togithub.com/cheeriojs/cheerio/issues/1578) by [@fb55](https://togithub.com/fb55)) [`c58258f`](https://togithub.com/cheeriojs/cheerio/commit/c58258f)
- Expose the `scriptingEnabled` parse5 option ([#1707](https://togithub.com/cheeriojs/cheerio/issues/1707) by [@5saviahv](https://togithub.com/5saviahv)) [`7eb4cc4`](https://togithub.com/cheeriojs/cheerio/commit/7eb4cc4)
- By setting `scriptingEnabled` to `false`, it is now possible to parse the contents of `
This PR contains the following updates:
1.0.0-rc.5
->1.0.0-rc.10
Release Notes
cheeriojs/cheerio
### [`v1.0.0-rc.10`](https://togithub.com/cheeriojs/cheerio/releases/v1.0.0-rc.10) [Compare Source](https://togithub.com/cheeriojs/cheerio/compare/v1.0.0-rc.9...v1.0.0-rc.10) **Fixes:** - `.html(node)` now moves passed nodes ([#1923](https://togithub.com/cheeriojs/cheerio/issues/1923), fixes [#940](https://togithub.com/cheeriojs/cheerio/issues/940)) [`258b26b`](https://togithub.com/cheeriojs/cheerio/commit/258b26b) - Boolean attributes are no longer special in xmlMode ([#1903](https://togithub.com/cheeriojs/cheerio/issues/1903), fixes [#1805](https://togithub.com/cheeriojs/cheerio/issues/1805)) [`b393e4a`](https://togithub.com/cheeriojs/cheerio/commit/b393e4a) - Rename parser adapter files ([#1873](https://togithub.com/cheeriojs/cheerio/issues/1873), fixes [#1847](https://togithub.com/cheeriojs/cheerio/issues/1847)) [`8f55dd8`](https://togithub.com/cheeriojs/cheerio/commit/8f55dd8) - Make `filter` work on all collections ([#1870](https://togithub.com/cheeriojs/cheerio/issues/1870), fixes [#1867](https://togithub.com/cheeriojs/cheerio/issues/1867)) [`fb8d31e`](https://togithub.com/cheeriojs/cheerio/commit/fb8d31e) - Bump cheerio-select ([#1922](https://togithub.com/cheeriojs/cheerio/issues/1922), fixes https://www.npmjs.com/advisories/1754) [`5cd2b9c`](https://togithub.com/cheeriojs/cheerio/commit/5cd2b9c) **Documentation:** - Document how to define TS types for Plug-Ins ([#1915](https://togithub.com/cheeriojs/cheerio/issues/1915), fixes [#1778](https://togithub.com/cheeriojs/cheerio/issues/1778)) [`880fd2c`](https://togithub.com/cheeriojs/cheerio/commit/880fd2c) - Remove obsolete Testing section [`e0c7cbb`](https://togithub.com/cheeriojs/cheerio/commit/e0c7cbb) - Remove now-invalid `require` [`5dfbd35`](https://togithub.com/cheeriojs/cheerio/commit/5dfbd35) **Refactors:** - Wrap shared behavior in `traversing` ([#1909](https://togithub.com/cheeriojs/cheerio/issues/1909)) [`58e090a`](https://togithub.com/cheeriojs/cheerio/commit/58e090a) - Move `is` to `traversing`, optimize ([#1908](https://togithub.com/cheeriojs/cheerio/issues/1908)) [`1c6fa3e`](https://togithub.com/cheeriojs/cheerio/commit/1c6fa3e) - Change order of arguments of internal `domEach` ([#1892](https://togithub.com/cheeriojs/cheerio/issues/1892)) [`feda230`](https://togithub.com/cheeriojs/cheerio/commit/feda230) - Have `load` export a function ([#1869](https://togithub.com/cheeriojs/cheerio/issues/1869)) [`c370f4e`](https://togithub.com/cheeriojs/cheerio/commit/c370f4e) ### [`v1.0.0-rc.9`](https://togithub.com/cheeriojs/cheerio/releases/v1.0.0-rc.9) [Compare Source](https://togithub.com/cheeriojs/cheerio/compare/v1.0.0-rc.8...v1.0.0-rc.9) **Port to TypeScript** Cheerio has been ported entirely to TypeScript (in [#1816](https://togithub.com/cheeriojs/cheerio/issues/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. ```diff - 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: ```js 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 `ArrayLikeCodecov Report
Continue to review full report at Codecov.