Téléchargement de cheerio - Téléchargement de la source cheerio

cheerio

Autre code source

v1.0.0

Télécharger

rafale

La bibliothèque rapide, flexible et élégante pour analyser et manipuler le HTML et le XML.

中文文档 (Readme chinois)

 import * as cheerio from 'cheerio' ;
const $ = cheerio . load ( '<h2 class="title">Hello world</h2>' ) ;

$ ( 'h2.title' ) . text ( 'Hello there!' ) ;
$ ( 'h2' ) . addClass ( 'welcome' ) ;

$ . html ( ) ;
//=> <html><head></head><body><h2 class="title welcome">Hello there!</h2></body></html>

Installation

npm install cheerio

Caractéristiques

❤ Syntaxe éprouvée: Cheerio met en œuvre un sous-ensemble de Core JQuery. Cheerio supprime toutes les incohérences Dom et le navigateur Cruft de la bibliothèque JQuery, révélant son API vraiment magnifique.

ϟ Tolie rapide: Cheerio fonctionne avec un modèle DOM très simple et cohérent. En conséquence, l'analyse, la manipulation et le rendu sont incroyablement efficaces.

❁ Incroyablement flexible: Cheerio s'enroule autour de Parse5 pour l'analyse de HTML et peut éventuellement utiliser le HTMLParser2 pardonnant. Cheerio peut analyser presque tous les documents HTML ou XML. Cheerio fonctionne dans les environnements du navigateur et du serveur.

API

Chargement

Vous devez d'abord charger dans le HTML. Cette étape dans jQuery est implicite, car JQuery fonctionne sur celui-ci, le Dom au four. Avec Cheerio, nous devons passer dans le document HTML.

 // ESM or TypeScript:
import * as cheerio from 'cheerio' ;

// In other environments:
const cheerio = require ( 'cheerio' ) ;

const $ = cheerio . load ( '<ul id="fruits">...</ul>' ) ;

$ . html ( ) ;
//=> <html><head></head><body><ul id="fruits">...</ul></body></html>

Sélecteurs

Une fois que vous avez chargé le HTML, vous pouvez utiliser des sélecteurs de style jQuery pour trouver des éléments dans le document.

$ (sélecteur, [contexte], [root])

selector recherche dans la portée context qui recherche dans la portée root . selector et context peuvent être une expression de chaîne, un élément DOM, un tableau d'éléments DOM ou un objet Cheerio. root , si elle est fournie, est généralement la chaîne de document HTML.

Cette méthode de sélecteur est le point de départ pour traverser et manipuler le document. Comme dans jQuery, c'est la principale méthode pour sélectionner des éléments dans le document.

 $ ( '.apple' , '#fruits' ) . text ( ) ;
//=> Apple

$ ( 'ul .pear' ) . attr ( 'class' ) ;
//=> pear

$ ( 'li[class=orange]' ) . html ( ) ;
//=> Orange

Rendu

Lorsque vous êtes prêt à rendre le document, vous pouvez appeler la méthode html sur la sélection "racine":

 $ . root ( ) . html ( ) ;
//=>  <html>
//      <head></head>
//      <body>
//        <ul id="fruits">
//          <li class="apple">Apple</li>
//          <li class="orange">Orange</li>
//          <li class="pear">Pear</li>
//        </ul>
//      </body>
//    </html>

Si vous souhaitez rendre l' outerHTML d'une sélection, vous pouvez utiliser l'hélice outerHTML :

 $ ( '.pear' ) . prop ( 'outerHTML' ) ;
//=> <li class="pear">Pear</li>

Vous pouvez également rendre le contenu texte d'un objet Cheerio en utilisant la méthode text :

 const $ = cheerio . load ( 'This is <em>content</em>.' ) ;
$ ( 'body' ) . text ( ) ;
//=> This is content.

L'objet "nœud Dom"

Les collections Cheerio sont constituées d'objets qui ressemblent à des nœuds DOM basés sur le navigateur. Vous pouvez vous attendre à ce qu'ils définissent les propriétés suivantes:

tagName
parentNode
previousSibling
nextSibling
nodeValue
firstChild
childNodes
lastChild

Screencasts

https://vimeo.com/31950192

Ce didacticiel vidéo est un suivi de "Comment faire des pages Web de NetTut avec Node.js et jQuery", en utilisant Cheerio au lieu de JSDom + jQuery. Cette vidéo montre à quel point il est facile d'utiliser Cheerio et à quel point Cheerio est plus rapide que JSDOD + jQuery.