');
$.html();
@@ -131,7 +133,7 @@ The options in the `xml` object are taken directly from [htmlparser2](https://gi
}
```
-For a full list of options and their effects, see [this](https://github.com/fb55/DomHandler) and
+For a full list of options and their effects, see [domhandler](https://github.com/fb55/DomHandler) and
[htmlparser2's options](https://github.com/fb55/htmlparser2/wiki/Parser-options).
Some users may wish to parse markup with the `htmlparser2` library, and
@@ -149,9 +151,9 @@ structure as its first argument. Users may install `htmlparser2`, use it to
parse input, and pass the result to `load`:
```js
-// Usage as of htmlparser2 version 3:
+// Usage as of htmlparser2 version 6:
const htmlparser2 = require('htmlparser2');
-const dom = htmlparser2.parseDOM(document, options);
+const dom = htmlparser2.parseDocument(document, options);
const $ = cheerio.load(dom);
```
diff --git a/benchmark/benchmark.js b/benchmark/benchmark.js
deleted file mode 100755
index 2d614b03bf..0000000000
--- a/benchmark/benchmark.js
+++ /dev/null
@@ -1,337 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-var Suites = require('./suite');
-var suites = new Suites();
-
-var regexIdx = process.argv.indexOf('--regex') + 1;
-if (regexIdx > 0) {
- if (regexIdx === process.argv.length) {
- throw new Error('Error: the "--regex" option requires a value');
- }
- suites.filter(process.argv[regexIdx]);
-}
-if (process.argv.indexOf('--cheerio-only') >= 0) {
- suites.cheerioOnly();
-}
-
-suites.add('Select all', 'jquery.html', {
- test: function ($) {
- return $('*').length;
- },
-});
-suites.add('Select some', 'jquery.html', {
- test: function ($) {
- return $('li').length;
- },
-});
-
-/*
- * Manipulation Tests
- */
-suites.add('manipulation - append', 'jquery.html', {
- setup: function ($) {
- return $('body');
- },
- test: function ($, $body) {
- $body.append(new Array(50).join('
'));
- },
-});
-
-// These tests run out of memory in jsdom
-suites.add('manipulation - prepend - highmem', 'jquery.html', {
- setup: function ($) {
- return $('body');
- },
- test: function ($, $body) {
- $body.prepend(new Array(50).join('
'));
- },
-});
-suites.add('manipulation - after - highmem', 'jquery.html', {
- setup: function ($) {
- return $('body');
- },
- test: function ($, $body) {
- $body.after(new Array(50).join('
'));
- },
-});
-suites.add('manipulation - before - highmem', 'jquery.html', {
- setup: function ($) {
- return $('body');
- },
- test: function ($, $body) {
- $body.before(new Array(50).join('
');
- * $.contains($('div').get(0), $('p').get(0)); // true
- * $.contains($('p').get(0), $('div').get(0)); // false
- *
- * @function
- * @returns {boolean}
- */
-exports.contains = staticMethods.contains;
-
-/**
- * In order to promote consistency with the jQuery library, users are encouraged
- * to instead use the static method of the same name.
- *
- * @deprecated
- * @example
- * var $ = cheerio.load('');
- * $.merge([1, 2], [3, 4]); // [1, 2, 3, 4]
- *
- * @function
- */
-exports.merge = staticMethods.merge;
-
-/**
- * In order to promote consistency with the jQuery library, users are encouraged
- * to instead use the static method of the same name as it is defined on the
- * "loaded" Cheerio factory function.
- *
- * @deprecated See {@link static/parseHTML}.
- * @example
- * var $ = cheerio.load('');
- * $.parseHTML('markup');
- *
- * @function
- */
-exports.parseHTML = staticMethods.parseHTML;
-
-/**
- * Users seeking to access the top-level element of a parsed document should
- * instead use the `root` static method of a "loaded" Cheerio function.
- *
- * @deprecated
- * @example
- * var $ = cheerio.load('');
- * $.root();
- *
- * @function
- */
-exports.root = staticMethods.root;
diff --git a/lib/api/attributes.js b/lib/api/attributes.js
deleted file mode 100644
index 46c30741da..0000000000
--- a/lib/api/attributes.js
+++ /dev/null
@@ -1,691 +0,0 @@
-'use strict';
-/**
- * Methods for getting and modifying attributes.
- *
- * @module cheerio/attributes
- */
-
-var text = require('../static').text;
-var utils = require('../utils');
-var isTag = utils.isTag;
-var domEach = utils.domEach;
-var hasOwn = Object.prototype.hasOwnProperty;
-var camelCase = utils.camelCase;
-var cssCase = utils.cssCase;
-var rspace = /\s+/;
-var dataAttrPrefix = 'data-';
-// Lookup table for coercing string data-* attributes to their corresponding
-// JavaScript primitives
-var primitives = {
- null: null,
- true: true,
- false: false,
-};
-// Attributes that are booleans
-var rboolean = /^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i;
-// Matches strings that look like JSON objects or arrays
-var rbrace = /^(?:{[\w\W]*}|\[[\w\W]*])$/;
-
-/**
- * Gets a node's attribute. For boolean attributes, it will return the value's
- * name should it be set.
- *
- * Also supports getting the `value` of several form elements.
- *
- * @private
- * @param {Element} elem - Elenent to get the attribute of.
- * @param {string} name - Name of the attribute.
- * @returns {object | string | undefined} The attribute's value.
- */
-function getAttr(elem, name) {
- if (!elem || !isTag(elem)) return;
-
- if (!elem.attribs) {
- elem.attribs = {};
- }
-
- // Return the entire attribs object if no attribute specified
- if (!name) {
- return elem.attribs;
- }
-
- if (hasOwn.call(elem.attribs, name)) {
- // Get the (decoded) attribute
- return rboolean.test(name) ? name : elem.attribs[name];
- }
-
- // Mimic the DOM and return text content as value for `option's`
- if (elem.name === 'option' && name === 'value') {
- return text(elem.children);
- }
-
- // Mimic DOM with default value for radios/checkboxes
- if (
- elem.name === 'input' &&
- (elem.attribs.type === 'radio' || elem.attribs.type === 'checkbox') &&
- name === 'value'
- ) {
- return 'on';
- }
-}
-
-/**
- * Sets the value of an attribute. The attribute will be deleted if the value is `null`.
- *
- * @private
- * @param {Element} el - The element to set the attribute on.
- * @param {string} name - The attribute's name.
- * @param {string | null} value - The attribute's value.
- */
-function setAttr(el, name, value) {
- if (value === null) {
- removeAttribute(el, name);
- } else {
- el.attribs[name] = value + '';
- }
-}
-
-/**
- * Method for getting and setting attributes. Gets the attribute value for only
- * the first element in the matched set. If you set an attribute's value to
- * `null`, you remove that attribute. You may also pass a `map` and `function`
- * like jQuery.
- *
- * @example
- * $('ul').attr('id');
- * //=> fruits
- *
- * $('.apple').attr('id', 'favorite').html();
- * //=>
Apple
- *
- * @param {string} name - Name of the attribute.
- * @param {string | Function} [value] - If specified sets the value of the attribute.
- * @returns {string | Cheerio} If `value` is specified the instance itself,
- * otherwise the attribute's value.
- * @see {@link https://api.jquery.com/attr/}
- */
-exports.attr = function (name, value) {
- // Set the value (with attr map support)
- if (typeof name === 'object' || value !== undefined) {
- if (typeof value === 'function') {
- return domEach(this, function (i, el) {
- setAttr(el, name, value.call(el, i, el.attribs[name]));
- });
- }
- return domEach(this, function (i, el) {
- if (!isTag(el)) return;
-
- if (typeof name === 'object') {
- Object.keys(name).forEach(function (objName) {
- var objValue = name[objName];
- setAttr(el, objName, objValue);
- });
- } else {
- setAttr(el, name, value);
- }
- });
- }
-
- return arguments.length > 1 ? this : getAttr(this[0], name);
-};
-
-/**
- * Gets a node's prop.
- *
- * @private
- * @param {Node} el - Elenent to get the prop of.
- * @param {string} name - Name of the prop.
- * @returns {string | undefined} The prop's value.
- */
-function getProp(el, name) {
- if (!el || !isTag(el)) return;
-
- return name in el
- ? el[name]
- : rboolean.test(name)
- ? getAttr(el, name) !== undefined
- : getAttr(el, name);
-}
-
-/**
- * Sets the value of a prop.
- *
- * @private
- * @param {Element} el - The element to set the prop on.
- * @param {string} name - The prop's name.
- * @param {string | null} value - The prop's value.
- */
-function setProp(el, name, value) {
- if (name in el) {
- el[name] = value;
- } else {
- setAttr(el, name, rboolean.test(name) ? (value ? '' : null) : value);
- }
-}
-
-/**
- * Method for getting and setting properties. Gets the property value for only
- * the first element in the matched set.
- *
- * @example
- * $('input[type="checkbox"]').prop('checked');
- * //=> false
- *
- * $('input[type="checkbox"]').prop('checked', true).val();
- * //=> ok
- *
- * @param {string} name - Name of the property.
- * @param {any} [value] - If specified set the property to this.
- * @returns {string | Cheerio} If `value` is specified the instance itself,
- * otherwise the prop's value.
- * @see {@link https://api.jquery.com/prop/}
- */
-exports.prop = function (name, value) {
- if (typeof name === 'string' && value === undefined) {
- switch (name) {
- case 'style': {
- var property = this.css();
- var keys = Object.keys(property);
- keys.forEach(function (p, i) {
- property[i] = p;
- });
-
- property.length = keys.length;
-
- return property;
- }
- case 'tagName':
- case 'nodeName':
- return this[0].name.toUpperCase();
-
- case 'outerHTML':
- return this.clone().wrap('').parent().html();
-
- case 'innerHTML':
- return this.html();
-
- default:
- return getProp(this[0], name);
- }
- }
-
- if (typeof name === 'object' || value !== undefined) {
- if (typeof value === 'function') {
- return domEach(this, function (j, el) {
- setProp(el, name, value.call(el, j, getProp(el, name)));
- });
- }
-
- return domEach(this, function (__, el) {
- if (!isTag(el)) return;
-
- if (typeof name === 'object') {
- Object.keys(name).forEach(function (key) {
- var val = name[key];
- setProp(el, key, val);
- });
- } else {
- setProp(el, name, value);
- }
- });
- }
-};
-
-/**
- * Sets the value of a data attribute.
- *
- * @private
- * @param {Element} el - The element to set the data attribute on.
- * @param {string | object} name - The data attribute's name.
- * @param {string | null} value - The data attribute's value.
- */
-function setData(el, name, value) {
- if (!el.data) {
- el.data = {};
- }
-
- if (typeof name === 'object') Object.assign(el.data, name);
- else if (typeof name === 'string' && value !== undefined) {
- el.data[name] = value;
- }
-}
-
-/**
- * Read the specified attribute from the equivalent HTML5 `data-*` attribute,
- * and (if present) cache the value in the node's internal data store. If no
- * attribute name is specified, read *all* HTML5 `data-*` attributes in this manner.
- *
- * @private
- * @param {Element} el - Elenent to get the data attribute of.
- * @param {string} [name] - Name of the data attribute.
- * @returns {any} The data attribute's value, or a map with all of the data attribute.
- */
-function readData(el, name) {
- var readAll = arguments.length === 1;
- var domNames;
- var jsNames;
- var value;
-
- if (readAll) {
- domNames = Object.keys(el.attribs).filter(function (attrName) {
- return attrName.slice(0, dataAttrPrefix.length) === dataAttrPrefix;
- });
- jsNames = domNames.map(function (_domName) {
- return camelCase(_domName.slice(dataAttrPrefix.length));
- });
- } else {
- domNames = [dataAttrPrefix + cssCase(name)];
- jsNames = [name];
- }
-
- for (var idx = 0; idx < domNames.length; ++idx) {
- var domName = domNames[idx];
- var jsName = jsNames[idx];
- if (hasOwn.call(el.attribs, domName) && !hasOwn.call(el.data, jsName)) {
- value = el.attribs[domName];
-
- if (hasOwn.call(primitives, value)) {
- value = primitives[value];
- } else if (value === String(Number(value))) {
- value = Number(value);
- } else if (rbrace.test(value)) {
- try {
- value = JSON.parse(value);
- } catch (e) {
- /* ignore */
- }
- }
-
- el.data[jsName] = value;
- }
- }
-
- return readAll ? el.data : value;
-}
-
-/**
- * Method for getting and setting data attributes. Gets or sets the data
- * attribute value for only the first element in the matched set.
- *
- * @example
- * $('').data();
- * //=> { appleColor: 'red' }
- *
- * $('').data('apple-color');
- * //=> 'red'
- *
- * const apple = $('.apple').data('kind', 'mac');
- * apple.data('kind');
- * //=> 'mac'
- *
- * @param {string} name - Name of the attribute.
- * @param {any} [value] - If specified new value.
- * @returns {string | Cheerio | undefined} If `value` is specified the instance
- * itself, otherwise the data attribute's value.
- * @see {@link https://api.jquery.com/data/}
- */
-exports.data = function (name, value) {
- var elem = this[0];
-
- if (!elem || !isTag(elem)) return;
-
- if (!elem.data) {
- elem.data = {};
- }
-
- // Return the entire data object if no data specified
- if (!name) {
- return readData(elem);
- }
-
- // Set the value (with attr map support)
- if (typeof name === 'object' || value !== undefined) {
- domEach(this, function (i, el) {
- setData(el, name, value);
- });
- return this;
- }
- if (hasOwn.call(elem.data, name)) {
- return elem.data[name];
- }
-
- return readData(elem, name);
-};
-
-/**
- * Method for getting and setting the value of input, select, and textarea.
- * Note: Support for `map`, and `function` has not been added yet.
- *
- * @example
- * $('input[type="text"]').val();
- * //=> input_text
- *
- * $('input[type="text"]').val('test').html();
- * //=>
- *
- * @param {string | string[]} [value] - If specified new value.
- * @returns {string | Cheerio | undefined} If a new `value` is specified the
- * instance itself, otherwise the value.
- * @see {@link https://api.jquery.com/val/}
- */
-exports.val = function (value) {
- var querying = arguments.length === 0;
- var element = this[0];
-
- if (!element) return;
-
- switch (element.name) {
- case 'textarea':
- return this.text(value);
- case 'select': {
- var option = this.find('option:selected');
- if (!option) return;
- if (!querying) {
- if (this.attr('multiple') == null && typeof value === 'object') {
- return this;
- }
- if (typeof value !== 'object') {
- value = [value];
- }
- this.find('option').removeAttr('selected');
- for (var i = 0; i < value.length; i++) {
- this.find('option[value="' + value[i] + '"]').attr('selected', '');
- }
- return this;
- }
-
- return this.attr('multiple')
- ? option.toArray().map(function (el) {
- return getAttr(el, 'value');
- })
- : option.attr('value');
- }
- case 'input':
- case 'option':
- return querying ? this.attr('value') : this.attr('value', value);
- }
-};
-
-/**
- * Remove an attribute.
- *
- * @private
- * @param {Element} elem - Node to remove attribute from.
- * @param {string} name - Name of the attribute to remove.
- */
-function removeAttribute(elem, name) {
- if (!elem.attribs || !hasOwn.call(elem.attribs, name)) return;
-
- delete elem.attribs[name];
-}
-
-/**
- * Splits a space-separated list of names to individual names.
- *
- * @param {string} names - Names to split.
- * @returns {string[]} - Split names.
- */
-function splitNames(names) {
- return names ? names.trim().split(rspace) : [];
-}
-
-/**
- * Method for removing attributes by `name`.
- *
- * @example
- * $('.pear').removeAttr('class').html();
- * //=>
- *
- * @param {string | Function} value - Name of new class.
- * @returns {Cheerio} The instance itself.
- * @see {@link https://api.jquery.com/addClass/}
- */
-exports.addClass = function (value) {
- // Support functions
- if (typeof value === 'function') {
- return domEach(this, function (i, el) {
- var className = el.attribs['class'] || '';
- exports.addClass.call([el], value.call(el, i, className));
- });
- }
-
- // Return if no value or not a string or function
- if (!value || typeof value !== 'string') return this;
-
- var classNames = value.split(rspace);
- var numElements = this.length;
-
- for (var i = 0; i < numElements; i++) {
- // If selected element isn't a tag, move on
- if (!isTag(this[i])) continue;
-
- // If we don't already have classes
- var className = getAttr(this[i], 'class');
-
- if (!className) {
- setAttr(this[i], 'class', classNames.join(' ').trim());
- } else {
- var setClass = ' ' + className + ' ';
-
- // Check if class already exists
- for (var j = 0; j < classNames.length; j++) {
- var appendClass = classNames[j] + ' ';
- if (setClass.indexOf(' ' + appendClass) < 0) setClass += appendClass;
- }
-
- setAttr(this[i], 'class', setClass.trim());
- }
- }
-
- return this;
-};
-
-/**
- * Removes one or more space-separated classes from the selected elements. If no
- * `className` is defined, all classes will be removed. Also accepts a
- * `function` like jQuery.
- *
- * @example
- * $('.pear').removeClass('pear').html();
- * //=>
- *
- * @param {string | Function} value - Name of the class.
- * @returns {Cheerio} The instance itself.
- * @see {@link https://api.jquery.com/removeClass/}
- */
-exports.removeClass = function (value) {
- // Handle if value is a function
- if (typeof value === 'function') {
- return domEach(this, function (i, el) {
- exports.removeClass.call(
- [el],
- value.call(el, i, el.attribs['class'] || '')
- );
- });
- }
-
- var classes = splitNames(value);
- var numClasses = classes.length;
- var removeAll = arguments.length === 0;
-
- return domEach(this, function (_, el) {
- if (!isTag(el)) return;
-
- if (removeAll) {
- // Short circuit the remove all case as this is the nice one
- el.attribs.class = '';
- } else {
- var elClasses = splitNames(el.attribs.class);
- var changed = false;
-
- for (var j = 0; j < numClasses; j++) {
- var index = elClasses.indexOf(classes[j]);
-
- if (index >= 0) {
- elClasses.splice(index, 1);
- changed = true;
-
- // We have to do another pass to ensure that there are not duplicate
- // classes listed
- j--;
- }
- }
- if (changed) {
- el.attribs.class = elClasses.join(' ');
- }
- }
- });
-};
-
-/**
- * Add or remove class(es) from the matched elements, depending on either the
- * class's presence or the value of the switch argument. Also accepts a
- * `function` like jQuery.
- *
- * @example
- * $('.apple.green').toggleClass('fruit green red').html();
- * //=>
- *
- * @param {string | Function} value - Name of the class. Can also be a function.
- * @param {boolean} [stateVal] - If specified the state of the class.
- * @returns {Cheerio} The instance itself.
- * @see {@link https://api.jquery.com/toggleClass/}
- */
-exports.toggleClass = function (value, stateVal) {
- // Support functions
- if (typeof value === 'function') {
- return domEach(this, function (i, el) {
- exports.toggleClass.call(
- [el],
- value.call(el, i, el.attribs['class'] || '', stateVal),
- stateVal
- );
- });
- }
-
- // Return if no value or not a string or function
- if (!value || typeof value !== 'string') return this;
-
- var classNames = value.split(rspace);
- var numClasses = classNames.length;
- var state = typeof stateVal === 'boolean' ? (stateVal ? 1 : -1) : 0;
- var numElements = this.length;
-
- for (var i = 0; i < numElements; i++) {
- // If selected element isn't a tag, move on
- if (!isTag(this[i])) continue;
-
- var elementClasses = splitNames(this[i].attribs.class);
-
- // Check if class already exists
- for (var j = 0; j < numClasses; j++) {
- // Check if the class name is currently defined
- var index = elementClasses.indexOf(classNames[j]);
-
- // Add if stateValue === true or we are toggling and there is no value
- if (state >= 0 && index < 0) {
- elementClasses.push(classNames[j]);
- } else if (state <= 0 && index >= 0) {
- // Otherwise remove but only if the item exists
- elementClasses.splice(index, 1);
- }
- }
-
- this[i].attribs.class = elementClasses.join(' ');
- }
-
- return this;
-};
-
-/**
- * Checks the current list of elements and returns `true` if _any_ of the
- * elements match the selector. If using an element or Cheerio selection,
- * returns `true` if _any_ of the elements match. If using a predicate function,
- * the function is executed in the context of the selected element, so `this`
- * refers to the current element.
- *
- * @param {string | Function | Cheerio | Node} selector - Selector for the selection.
- * @returns {boolean} Whether or not the selector matches an element of the instance.
- * @see {@link https://api.jquery.com/is/}
- */
-exports.is = function (selector) {
- if (selector) {
- return this.filter(selector).length > 0;
- }
- return false;
-};
diff --git a/lib/api/css.js b/lib/api/css.js
deleted file mode 100644
index 970b52f821..0000000000
--- a/lib/api/css.js
+++ /dev/null
@@ -1,119 +0,0 @@
-'use strict';
-/** @module cheerio/css */
-
-var domEach = require('../utils').domEach;
-
-var toString = Object.prototype.toString;
-
-/**
- * Get the value of a style property for the first element in the set of matched
- * elements or set one or more CSS properties for every matched element.
- *
- * @param {string | object} prop - The name of the property.
- * @param {string} [val] - If specified the new value.
- * @returns {Cheerio} The instance itself.
- * @see {@link https://api.jquery.com/css/}
- */
-exports.css = function (prop, val) {
- if (
- arguments.length === 2 ||
- // When `prop` is a "plain" object
- toString.call(prop) === '[object Object]'
- ) {
- return domEach(this, function (idx, el) {
- setCss(el, prop, val, idx);
- });
- }
- return getCss(this[0], prop);
-};
-
-/**
- * Set styles of all elements.
- *
- * @private
- * @param {Element} el - Element to set style of.
- * @param {string | object} prop - Name of property.
- * @param {string | Function} val - Value to set property to.
- * @param {number} [idx] - Optional index within the selection.
- */
-function setCss(el, prop, val, idx) {
- if (typeof prop === 'string') {
- var styles = getCss(el);
- if (typeof val === 'function') {
- val = val.call(el, idx, styles[prop]);
- }
-
- if (val === '') {
- delete styles[prop];
- } else if (val != null) {
- styles[prop] = val;
- }
-
- el.attribs.style = stringify(styles);
- } else if (typeof prop === 'object') {
- Object.keys(prop).forEach(function (k) {
- setCss(el, k, prop[k]);
- });
- }
-}
-
-/**
- * Get parsed styles of the first element.
- *
- * @private
- * @param {Element} el - Element to get styles from.
- * @param {string | string[]} [prop] - Name of the prop.
- * @returns {object | undefined} The parsed styles.
- */
-function getCss(el, prop) {
- if (!el || !el.attribs) return;
-
- var styles = parse(el.attribs.style);
- if (typeof prop === 'string') {
- return styles[prop];
- }
- if (Array.isArray(prop)) {
- var newStyles = {};
- prop.forEach(function (item) {
- if (styles[item] != null) {
- newStyles[item] = styles[item];
- }
- });
- return newStyles;
- }
- return styles;
-}
-
-/**
- * Stringify `obj` to styles.
- *
- * @private
- * @param {object} obj - Object to stringify.
- * @returns {string} The serialized styles.
- */
-function stringify(obj) {
- return Object.keys(obj || {}).reduce(function (str, prop) {
- return (str += '' + (str ? ' ' : '') + prop + ': ' + obj[prop] + ';');
- }, '');
-}
-
-/**
- * Parse `styles`.
- *
- * @private
- * @param {string} styles - Styles to be parsed.
- * @returns {object} The parsed styles.
- */
-function parse(styles) {
- styles = (styles || '').trim();
-
- if (!styles) return {};
-
- return styles.split(';').reduce(function (obj, str) {
- var n = str.indexOf(':');
- // skip if there is no :, or if it is the first/last character
- if (n < 1 || n === str.length - 1) return obj;
- obj[str.slice(0, n).trim()] = str.slice(n + 1).trim();
- return obj;
- }, {});
-}
diff --git a/lib/api/forms.js b/lib/api/forms.js
deleted file mode 100644
index f0bedc068e..0000000000
--- a/lib/api/forms.js
+++ /dev/null
@@ -1,83 +0,0 @@
-'use strict';
-/** @module cheerio/forms */
-
-// https://github.com/jquery/jquery/blob/2.1.3/src/manipulation/var/rcheckableType.js
-// https://github.com/jquery/jquery/blob/2.1.3/src/serialize.js
-var submittableSelector = 'input,select,textarea,keygen';
-var r20 = /%20/g;
-var rCRLF = /\r?\n/g;
-
-/**
- * Encode a set of form elements as a string for submission.
- *
- * @returns {string} The serialized form.
- * @see {@link https://api.jquery.com/serialize/}
- */
-exports.serialize = function () {
- // Convert form elements into name/value objects
- var arr = this.serializeArray();
-
- // Serialize each element into a key/value string
- var retArr = arr.map(function (data) {
- return encodeURIComponent(data.name) + '=' + encodeURIComponent(data.value);
- });
-
- // Return the resulting serialization
- return retArr.join('&').replace(r20, '+');
-};
-
-/**
- * Encode a set of form elements as an array of names and values.
- *
- * @example
- * $('').serializeArray();
- * //=> [ { name: 'foo', value: 'bar' } ]
- *
- * @returns {object[]} The serialized form.
- * @this {Cheerio}
- * @see {@link https://api.jquery.com/serializeArray/}
- */
-exports.serializeArray = function () {
- // Resolve all form elements from either forms or collections of form elements
- var Cheerio = this.constructor;
- return this.map(function (_, elem) {
- var $elem = Cheerio(elem);
- if (elem.name === 'form') {
- return $elem.find(submittableSelector).toArray();
- }
- return $elem.filter(submittableSelector).toArray();
- })
- .filter(
- // Verify elements have a name (`attr.name`) and are not disabled (`:enabled`)
- '[name!=""]:enabled' +
- // and cannot be clicked (`[type=submit]`) or are used in `x-www-form-urlencoded` (`[type=file]`)
- ':not(:submit, :button, :image, :reset, :file)' +
- // and are either checked/don't have a checkable state
- ':matches([checked], :not(:checkbox, :radio))'
- // Convert each of the elements to its value(s)
- )
- .map(function (_, elem) {
- var $elem = Cheerio(elem);
- var name = $elem.attr('name');
- var value = $elem.val();
-
- // If there is no value set (e.g. `undefined`, `null`), then default value to empty
- if (value == null) {
- value = '';
- }
-
- // If we have an array of values (e.g. `
', {
- xml: true,
- });
- expect($('script')[0].children[0].type).toBe('tag');
- });
-
- it('(buffer) : should accept a buffer', function () {
- var html = '
-
@@ -79,7 +76,12 @@ First you need to load in the HTML. This step in jQuery is implicit, since jQuer
This is the _preferred_ method:
```js
+// ES6 or TypeScript:
+import * as cheerio from 'cheerio';
+
+// In other environments:
const cheerio = require('cheerio');
+
const $ = cheerio.load('