123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852 |
- "use strict";
- Object.defineProperty(exports, "__esModule", { value: true });
- exports.clone = exports.text = exports.toString = exports.html = exports.empty = exports.replaceWith = exports.remove = exports.insertBefore = exports.before = exports.insertAfter = exports.after = exports.wrapAll = exports.unwrap = exports.wrapInner = exports.wrap = exports.prepend = exports.append = exports.prependTo = exports.appendTo = exports._makeDomArray = void 0;
- var tslib_1 = require("tslib");
- var domhandler_1 = require("domhandler");
- /**
- * Methods for modifying the DOM structure.
- *
- * @module cheerio/manipulation
- */
- var domhandler_2 = require("domhandler");
- var parse_1 = tslib_1.__importStar(require("../parse"));
- var static_1 = require("../static");
- var utils_1 = require("../utils");
- var htmlparser2_1 = require("htmlparser2");
- /**
- * Create an array of nodes, recursing into arrays and parsing strings if necessary.
- *
- * @private
- * @category Manipulation
- * @param elem - Elements to make an array of.
- * @param clone - Optionally clone nodes.
- * @returns The array of nodes.
- */
- function _makeDomArray(elem, clone) {
- var _this = this;
- if (elem == null) {
- return [];
- }
- if (utils_1.isCheerio(elem)) {
- return clone ? utils_1.cloneDom(elem.get()) : elem.get();
- }
- if (Array.isArray(elem)) {
- return elem.reduce(function (newElems, el) { return newElems.concat(_this._makeDomArray(el, clone)); }, []);
- }
- if (typeof elem === 'string') {
- return parse_1.default(elem, this.options, false).children;
- }
- return clone ? utils_1.cloneDom([elem]) : [elem];
- }
- exports._makeDomArray = _makeDomArray;
- function _insert(concatenator) {
- return function () {
- var _this = this;
- var elems = [];
- for (var _i = 0; _i < arguments.length; _i++) {
- elems[_i] = arguments[_i];
- }
- var lastIdx = this.length - 1;
- return utils_1.domEach(this, function (el, i) {
- if (!domhandler_1.hasChildren(el))
- return;
- var domSrc = typeof elems[0] === 'function'
- ? elems[0].call(el, i, static_1.html(el.children))
- : elems;
- var dom = _this._makeDomArray(domSrc, i < lastIdx);
- concatenator(dom, el.children, el);
- });
- };
- }
- /**
- * Modify an array in-place, removing some number of elements and adding new
- * elements directly following them.
- *
- * @private
- * @category Manipulation
- * @param array - Target array to splice.
- * @param spliceIdx - Index at which to begin changing the array.
- * @param spliceCount - Number of elements to remove from the array.
- * @param newElems - Elements to insert into the array.
- * @param parent - The parent of the node.
- * @returns The spliced array.
- */
- function uniqueSplice(array, spliceIdx, spliceCount, newElems, parent) {
- var _a, _b;
- var spliceArgs = tslib_1.__spreadArray([
- spliceIdx,
- spliceCount
- ], newElems);
- var prev = array[spliceIdx - 1] || null;
- var next = array[spliceIdx + spliceCount] || null;
- /*
- * Before splicing in new elements, ensure they do not already appear in the
- * current array.
- */
- for (var idx = 0; idx < newElems.length; ++idx) {
- var node = newElems[idx];
- var oldParent = node.parent;
- if (oldParent) {
- var prevIdx = oldParent.children.indexOf(newElems[idx]);
- if (prevIdx > -1) {
- oldParent.children.splice(prevIdx, 1);
- if (parent === oldParent && spliceIdx > prevIdx) {
- spliceArgs[0]--;
- }
- }
- }
- node.parent = parent;
- if (node.prev) {
- node.prev.next = (_a = node.next) !== null && _a !== void 0 ? _a : null;
- }
- if (node.next) {
- node.next.prev = (_b = node.prev) !== null && _b !== void 0 ? _b : null;
- }
- node.prev = newElems[idx - 1] || prev;
- node.next = newElems[idx + 1] || next;
- }
- if (prev) {
- prev.next = newElems[0];
- }
- if (next) {
- next.prev = newElems[newElems.length - 1];
- }
- return array.splice.apply(array, spliceArgs);
- }
- /**
- * Insert every element in the set of matched elements to the end of the target.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('<li class="plum">Plum</li>').appendTo('#fruits');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // <li class="plum">Plum</li>
- * // </ul>
- * ```
- *
- * @param target - Element to append elements to.
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/appendTo/}
- */
- function appendTo(target) {
- var appendTarget = utils_1.isCheerio(target) ? target : this._make(target);
- appendTarget.append(this);
- return this;
- }
- exports.appendTo = appendTo;
- /**
- * Insert every element in the set of matched elements to the beginning of the target.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('<li class="plum">Plum</li>').prependTo('#fruits');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="plum">Plum</li>
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // </ul>
- * ```
- *
- * @param target - Element to prepend elements to.
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/prependTo/}
- */
- function prependTo(target) {
- var prependTarget = utils_1.isCheerio(target) ? target : this._make(target);
- prependTarget.prepend(this);
- return this;
- }
- exports.prependTo = prependTo;
- /**
- * Inserts content as the *last* child of each of the selected elements.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('ul').append('<li class="plum">Plum</li>');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // <li class="plum">Plum</li>
- * // </ul>
- * ```
- *
- * @see {@link https://api.jquery.com/append/}
- */
- exports.append = _insert(function (dom, children, parent) {
- uniqueSplice(children, children.length, 0, dom, parent);
- });
- /**
- * Inserts content as the *first* child of each of the selected elements.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('ul').prepend('<li class="plum">Plum</li>');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="plum">Plum</li>
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // </ul>
- * ```
- *
- * @see {@link https://api.jquery.com/prepend/}
- */
- exports.prepend = _insert(function (dom, children, parent) {
- uniqueSplice(children, 0, 0, dom, parent);
- });
- function _wrap(insert) {
- return function (wrapper) {
- var lastIdx = this.length - 1;
- var lastParent = this.parents().last();
- for (var i = 0; i < this.length; i++) {
- var el = this[i];
- var wrap_1 = typeof wrapper === 'function'
- ? wrapper.call(el, i, el)
- : typeof wrapper === 'string' && !utils_1.isHtml(wrapper)
- ? lastParent.find(wrapper).clone()
- : wrapper;
- var wrapperDom = this._makeDomArray(wrap_1, i < lastIdx)[0];
- if (!wrapperDom || !htmlparser2_1.DomUtils.hasChildren(wrapperDom))
- continue;
- var elInsertLocation = wrapperDom;
- /*
- * Find the deepest child. Only consider the first tag child of each node
- * (ignore text); stop if no children are found.
- */
- var j = 0;
- while (j < elInsertLocation.children.length) {
- var child = elInsertLocation.children[j];
- if (utils_1.isTag(child)) {
- elInsertLocation = child;
- j = 0;
- }
- else {
- j++;
- }
- }
- insert(el, elInsertLocation, [wrapperDom]);
- }
- return this;
- };
- }
- /**
- * The .wrap() function can take any string or object that could be passed to
- * the $() factory function to specify a DOM structure. This structure may be
- * nested several levels deep, but should contain only one inmost element. A
- * copy of this structure will be wrapped around each of the elements in the set
- * of matched elements. This method returns the original set of elements for
- * chaining purposes.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * const redFruit = $('<div class="red-fruit"></div>');
- * $('.apple').wrap(redFruit);
- *
- * //=> <ul id="fruits">
- * // <div class="red-fruit">
- * // <li class="apple">Apple</li>
- * // </div>
- * // <li class="orange">Orange</li>
- * // <li class="plum">Plum</li>
- * // </ul>
- *
- * const healthy = $('<div class="healthy"></div>');
- * $('li').wrap(healthy);
- *
- * //=> <ul id="fruits">
- * // <div class="healthy">
- * // <li class="apple">Apple</li>
- * // </div>
- * // <div class="healthy">
- * // <li class="orange">Orange</li>
- * // </div>
- * // <div class="healthy">
- * // <li class="plum">Plum</li>
- * // </div>
- * // </ul>
- * ```
- *
- * @param wrapper - The DOM structure to wrap around each element in the selection.
- * @see {@link https://api.jquery.com/wrap/}
- */
- exports.wrap = _wrap(function (el, elInsertLocation, wrapperDom) {
- var parent = el.parent;
- if (!parent)
- return;
- var siblings = parent.children;
- var index = siblings.indexOf(el);
- parse_1.update([el], elInsertLocation);
- /*
- * The previous operation removed the current element from the `siblings`
- * array, so the `dom` array can be inserted without removing any
- * additional elements.
- */
- uniqueSplice(siblings, index, 0, wrapperDom, parent);
- });
- /**
- * The .wrapInner() function can take any string or object that could be passed
- * to the $() factory function to specify a DOM structure. This structure may be
- * nested several levels deep, but should contain only one inmost element. The
- * structure will be wrapped around the content of each of the elements in the
- * set of matched elements.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * const redFruit = $('<div class="red-fruit"></div>');
- * $('.apple').wrapInner(redFruit);
- *
- * //=> <ul id="fruits">
- * // <li class="apple">
- * // <div class="red-fruit">Apple</div>
- * // </li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // </ul>
- *
- * const healthy = $('<div class="healthy"></div>');
- * $('li').wrapInner(healthy);
- *
- * //=> <ul id="fruits">
- * // <li class="apple">
- * // <div class="healthy">Apple</div>
- * // </li>
- * // <li class="orange">
- * // <div class="healthy">Orange</div>
- * // </li>
- * // <li class="pear">
- * // <div class="healthy">Pear</div>
- * // </li>
- * // </ul>
- * ```
- *
- * @param wrapper - The DOM structure to wrap around the content of each element
- * in the selection.
- * @returns The instance itself, for chaining.
- * @see {@link https://api.jquery.com/wrapInner/}
- */
- exports.wrapInner = _wrap(function (el, elInsertLocation, wrapperDom) {
- if (!domhandler_1.hasChildren(el))
- return;
- parse_1.update(el.children, elInsertLocation);
- parse_1.update(wrapperDom, el);
- });
- /**
- * The .unwrap() function, removes the parents of the set of matched elements
- * from the DOM, leaving the matched elements in their place.
- *
- * @category Manipulation
- * @example <caption>without selector</caption>
- *
- * ```js
- * const $ = cheerio.load(
- * '<div id=test>\n <div><p>Hello</p></div>\n <div><p>World</p></div>\n</div>'
- * );
- * $('#test p').unwrap();
- *
- * //=> <div id=test>
- * // <p>Hello</p>
- * // <p>World</p>
- * // </div>
- * ```
- *
- * @example <caption>with selector</caption>
- *
- * ```js
- * const $ = cheerio.load(
- * '<div id=test>\n <p>Hello</p>\n <b><p>World</p></b>\n</div>'
- * );
- * $('#test p').unwrap('b');
- *
- * //=> <div id=test>
- * // <p>Hello</p>
- * // <p>World</p>
- * // </div>
- * ```
- *
- * @param selector - A selector to check the parent element against. If an
- * element's parent does not match the selector, the element won't be unwrapped.
- * @returns The instance itself, for chaining.
- * @see {@link https://api.jquery.com/unwrap/}
- */
- function unwrap(selector) {
- var _this = this;
- this.parent(selector)
- .not('body')
- .each(function (_, el) {
- _this._make(el).replaceWith(el.children);
- });
- return this;
- }
- exports.unwrap = unwrap;
- /**
- * The .wrapAll() function can take any string or object that could be passed to
- * the $() function to specify a DOM structure. This structure may be nested
- * several levels deep, but should contain only one inmost element. The
- * structure will be wrapped around all of the elements in the set of matched
- * elements, as a single group.
- *
- * @category Manipulation
- * @example <caption>With markup passed to `wrapAll`</caption>
- *
- * ```js
- * const $ = cheerio.load(
- * '<div class="container"><div class="inner">First</div><div class="inner">Second</div></div>'
- * );
- * $('.inner').wrapAll("<div class='new'></div>");
- *
- * //=> <div class="container">
- * // <div class='new'>
- * // <div class="inner">First</div>
- * // <div class="inner">Second</div>
- * // </div>
- * // </div>
- * ```
- *
- * @example <caption>With an existing cheerio instance</caption>
- *
- * ```js
- * const $ = cheerio.load(
- * '<span>Span 1</span><strong>Strong</strong><span>Span 2</span>'
- * );
- * const wrap = $('<div><p><em><b></b></em></p></div>');
- * $('span').wrapAll(wrap);
- *
- * //=> <div>
- * // <p>
- * // <em>
- * // <b>
- * // <span>Span 1</span>
- * // <span>Span 2</span>
- * // </b>
- * // </em>
- * // </p>
- * // </div>
- * // <strong>Strong</strong>
- * ```
- *
- * @param wrapper - The DOM structure to wrap around all matched elements in the
- * selection.
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/wrapAll/}
- */
- function wrapAll(wrapper) {
- var el = this[0];
- if (el) {
- var wrap_2 = this._make(typeof wrapper === 'function' ? wrapper.call(el, 0, el) : wrapper).insertBefore(el);
- // If html is given as wrapper, wrap may contain text elements
- var elInsertLocation = void 0;
- for (var i = 0; i < wrap_2.length; i++) {
- if (wrap_2[i].type === 'tag')
- elInsertLocation = wrap_2[i];
- }
- var j = 0;
- /*
- * Find the deepest child. Only consider the first tag child of each node
- * (ignore text); stop if no children are found.
- */
- while (elInsertLocation && j < elInsertLocation.children.length) {
- var child = elInsertLocation.children[j];
- if (child.type === 'tag') {
- elInsertLocation = child;
- j = 0;
- }
- else {
- j++;
- }
- }
- if (elInsertLocation)
- this._make(elInsertLocation).append(this);
- }
- return this;
- }
- exports.wrapAll = wrapAll;
- /* eslint-disable jsdoc/check-param-names*/
- /**
- * Insert content next to each element in the set of matched elements.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('.apple').after('<li class="plum">Plum</li>');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="apple">Apple</li>
- * // <li class="plum">Plum</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // </ul>
- * ```
- *
- * @param content - HTML string, DOM element, array of DOM elements or Cheerio
- * to insert after each element in the set of matched elements.
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/after/}
- */
- function after() {
- var _this = this;
- var elems = [];
- for (var _i = 0; _i < arguments.length; _i++) {
- elems[_i] = arguments[_i];
- }
- var lastIdx = this.length - 1;
- return utils_1.domEach(this, function (el, i) {
- var parent = el.parent;
- if (!htmlparser2_1.DomUtils.hasChildren(el) || !parent) {
- return;
- }
- var siblings = parent.children;
- var index = siblings.indexOf(el);
- // If not found, move on
- /* istanbul ignore next */
- if (index < 0)
- return;
- var domSrc = typeof elems[0] === 'function'
- ? elems[0].call(el, i, static_1.html(el.children))
- : elems;
- var dom = _this._makeDomArray(domSrc, i < lastIdx);
- // Add element after `this` element
- uniqueSplice(siblings, index + 1, 0, dom, parent);
- });
- }
- exports.after = after;
- /* eslint-enable jsdoc/check-param-names*/
- /**
- * Insert every element in the set of matched elements after the target.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('<li class="plum">Plum</li>').insertAfter('.apple');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="apple">Apple</li>
- * // <li class="plum">Plum</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // </ul>
- * ```
- *
- * @param target - Element to insert elements after.
- * @returns The set of newly inserted elements.
- * @see {@link https://api.jquery.com/insertAfter/}
- */
- function insertAfter(target) {
- var _this = this;
- if (typeof target === 'string') {
- target = this._make(target);
- }
- this.remove();
- var clones = [];
- this._makeDomArray(target).forEach(function (el) {
- var clonedSelf = _this.clone().toArray();
- var parent = el.parent;
- if (!parent) {
- return;
- }
- var siblings = parent.children;
- var index = siblings.indexOf(el);
- // If not found, move on
- /* istanbul ignore next */
- if (index < 0)
- return;
- // Add cloned `this` element(s) after target element
- uniqueSplice(siblings, index + 1, 0, clonedSelf, parent);
- clones.push.apply(clones, clonedSelf);
- });
- return this._make(clones);
- }
- exports.insertAfter = insertAfter;
- /* eslint-disable jsdoc/check-param-names*/
- /**
- * Insert content previous to each element in the set of matched elements.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('.apple').before('<li class="plum">Plum</li>');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="plum">Plum</li>
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // </ul>
- * ```
- *
- * @param content - HTML string, DOM element, array of DOM elements or Cheerio
- * to insert before each element in the set of matched elements.
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/before/}
- */
- function before() {
- var _this = this;
- var elems = [];
- for (var _i = 0; _i < arguments.length; _i++) {
- elems[_i] = arguments[_i];
- }
- var lastIdx = this.length - 1;
- return utils_1.domEach(this, function (el, i) {
- var parent = el.parent;
- if (!htmlparser2_1.DomUtils.hasChildren(el) || !parent) {
- return;
- }
- var siblings = parent.children;
- var index = siblings.indexOf(el);
- // If not found, move on
- /* istanbul ignore next */
- if (index < 0)
- return;
- var domSrc = typeof elems[0] === 'function'
- ? elems[0].call(el, i, static_1.html(el.children))
- : elems;
- var dom = _this._makeDomArray(domSrc, i < lastIdx);
- // Add element before `el` element
- uniqueSplice(siblings, index, 0, dom, parent);
- });
- }
- exports.before = before;
- /* eslint-enable jsdoc/check-param-names*/
- /**
- * Insert every element in the set of matched elements before the target.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('<li class="plum">Plum</li>').insertBefore('.apple');
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="plum">Plum</li>
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // <li class="pear">Pear</li>
- * // </ul>
- * ```
- *
- * @param target - Element to insert elements before.
- * @returns The set of newly inserted elements.
- * @see {@link https://api.jquery.com/insertBefore/}
- */
- function insertBefore(target) {
- var _this = this;
- var targetArr = this._make(target);
- this.remove();
- var clones = [];
- utils_1.domEach(targetArr, function (el) {
- var clonedSelf = _this.clone().toArray();
- var parent = el.parent;
- if (!parent) {
- return;
- }
- var siblings = parent.children;
- var index = siblings.indexOf(el);
- // If not found, move on
- /* istanbul ignore next */
- if (index < 0)
- return;
- // Add cloned `this` element(s) after target element
- uniqueSplice(siblings, index, 0, clonedSelf, parent);
- clones.push.apply(clones, clonedSelf);
- });
- return this._make(clones);
- }
- exports.insertBefore = insertBefore;
- /**
- * Removes the set of matched elements from the DOM and all their children.
- * `selector` filters the set of matched elements to be removed.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('.pear').remove();
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // </ul>
- * ```
- *
- * @param selector - Optional selector for elements to remove.
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/remove/}
- */
- function remove(selector) {
- // Filter if we have selector
- var elems = selector ? this.filter(selector) : this;
- utils_1.domEach(elems, function (el) {
- htmlparser2_1.DomUtils.removeElement(el);
- el.prev = el.next = el.parent = null;
- });
- return this;
- }
- exports.remove = remove;
- /**
- * Replaces matched elements with `content`.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * const plum = $('<li class="plum">Plum</li>');
- * $('.pear').replaceWith(plum);
- * $.html();
- * //=> <ul id="fruits">
- * // <li class="apple">Apple</li>
- * // <li class="orange">Orange</li>
- * // <li class="plum">Plum</li>
- * // </ul>
- * ```
- *
- * @param content - Replacement for matched elements.
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/replaceWith/}
- */
- function replaceWith(content) {
- var _this = this;
- return utils_1.domEach(this, function (el, i) {
- var parent = el.parent;
- if (!parent) {
- return;
- }
- var siblings = parent.children;
- var cont = typeof content === 'function' ? content.call(el, i, el) : content;
- var dom = _this._makeDomArray(cont);
- /*
- * In the case that `dom` contains nodes that already exist in other
- * structures, ensure those nodes are properly removed.
- */
- parse_1.update(dom, null);
- var index = siblings.indexOf(el);
- // Completely remove old element
- uniqueSplice(siblings, index, 1, dom, parent);
- if (!dom.includes(el)) {
- el.parent = el.prev = el.next = null;
- }
- });
- }
- exports.replaceWith = replaceWith;
- /**
- * Empties an element, removing all its children.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * $('ul').empty();
- * $.html();
- * //=> <ul id="fruits"></ul>
- * ```
- *
- * @returns The instance itself.
- * @see {@link https://api.jquery.com/empty/}
- */
- function empty() {
- return utils_1.domEach(this, function (el) {
- if (!htmlparser2_1.DomUtils.hasChildren(el))
- return;
- el.children.forEach(function (child) {
- child.next = child.prev = child.parent = null;
- });
- el.children.length = 0;
- });
- }
- exports.empty = empty;
- function html(str) {
- if (str === undefined) {
- var el = this[0];
- if (!el || !htmlparser2_1.DomUtils.hasChildren(el))
- return null;
- return static_1.html(el.children, this.options);
- }
- // Keep main options unchanged
- var opts = tslib_1.__assign(tslib_1.__assign({}, this.options), { context: null });
- return utils_1.domEach(this, function (el) {
- if (!htmlparser2_1.DomUtils.hasChildren(el))
- return;
- el.children.forEach(function (child) {
- child.next = child.prev = child.parent = null;
- });
- opts.context = el;
- var content = utils_1.isCheerio(str)
- ? str.toArray()
- : parse_1.default("" + str, opts, false).children;
- parse_1.update(content, el);
- });
- }
- exports.html = html;
- /**
- * Turns the collection to a string. Alias for `.html()`.
- *
- * @category Manipulation
- * @returns The rendered document.
- */
- function toString() {
- return static_1.html(this, this.options);
- }
- exports.toString = toString;
- function text(str) {
- var _this = this;
- // If `str` is undefined, act as a "getter"
- if (str === undefined) {
- return static_1.text(this);
- }
- if (typeof str === 'function') {
- // Function support
- return utils_1.domEach(this, function (el, i) {
- text.call(_this._make(el), str.call(el, i, static_1.text([el])));
- });
- }
- // Append text node to each selected elements
- return utils_1.domEach(this, function (el) {
- if (!htmlparser2_1.DomUtils.hasChildren(el))
- return;
- el.children.forEach(function (child) {
- child.next = child.prev = child.parent = null;
- });
- var textNode = new domhandler_2.Text(str);
- parse_1.update(textNode, el);
- });
- }
- exports.text = text;
- /**
- * Clone the cheerio object.
- *
- * @category Manipulation
- * @example
- *
- * ```js
- * const moreFruit = $('#fruits').clone();
- * ```
- *
- * @returns The cloned object.
- * @see {@link https://api.jquery.com/clone/}
- */
- function clone() {
- return this._make(utils_1.cloneDom(this.get()));
- }
- exports.clone = clone;
|