Unduh cheerio - Download Sumber cheerio

cheerio

Kode sumber lainnya

v1.0.0

Unduh

Cheerio

Perpustakaan yang cepat, fleksibel, dan elegan untuk parsing dan memanipulasi HTML dan XML.

中文文档 (readme Cina)

 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>

Instalasi

npm install cheerio

Fitur

❤ Sintaks yang terbukti: Cheerio mengimplementasikan subset dari inti jQuery. Cheerio menghapus semua inkonsistensi Dom dan browser Cruft dari Perpustakaan JQuery, mengungkapkan API yang benar -benar cantik.

ϟ Sangat cepat: Cheerio bekerja dengan model DOM yang sangat sederhana dan konsisten. Akibatnya parsing, memanipulasi, dan rendering sangat efisien.

❁ Sangat fleksibel: Cheerio membungkus Parse5 untuk parsing html dan secara opsional dapat menggunakan htmlparser2 yang memaafkan. Cheerio dapat menguraikan hampir semua dokumen HTML atau XML. Cheerio bekerja di lingkungan browser dan server.

API

Memuat

Pertama, Anda perlu memuat di HTML. Langkah di jQuery ini implisit, karena jQuery beroperasi pada satu, dom yang dipanggang. Dengan Cheerio, kita perlu lulus dalam dokumen 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>

Pemilih

Setelah Anda memuat HTML, Anda dapat menggunakan pemilih gaya jQuery untuk menemukan elemen dalam dokumen.

$ (pemilih, [konteks], [root])

Pencarian selector dalam ruang lingkup context yang mencari dalam ruang lingkup root . selector dan context dapat berupa ekspresi string, elemen DOM, array elemen DOM, atau objek Cheerio. root , jika disediakan, biasanya string dokumen HTML.

Metode pemilih ini adalah titik awal untuk melintasi dan memanipulasi dokumen. Seperti di jQuery, ini adalah metode utama untuk memilih elemen dalam dokumen.

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

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

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

Rendering

Saat Anda siap untuk merender dokumen, Anda dapat menghubungi metode html pada pemilihan "root":

 $ . 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>

Jika Anda ingin outerHTML pilihan, Anda dapat menggunakan prop outerHTML :

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

Anda juga dapat membuat konten teks dari objek Cheerio menggunakan metode text :

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

Objek "Dom Node"

Koleksi Cheerio terdiri dari benda-benda yang memiliki kemiripan dengan node DOM berbasis browser. Anda dapat mengharapkan mereka untuk menentukan sifat -sifat berikut:

tagName
parentNode
previousSibling
nextSibling
nodeValue
firstChild
childNodes
lastChild

Screencasts

https://vimeo.com/31950192

Tutorial video ini adalah tindak lanjut dari Nettut's "Cara Mengikis Halaman Web dengan Node.js dan JQuery", menggunakan Cheerio, bukan JSDOM + JQuery. Video ini menunjukkan betapa mudahnya menggunakan Cheerio dan seberapa cepat Cheerio daripada JSDOM + JQuery.

Cheerio di dunia nyata

Apakah Anda menggunakan Cheerio dalam produksi? Tambahkan ke wiki!

Sponsor

Apakah perusahaan Anda menggunakan Cheerio dalam produksi? Harap pertimbangkan untuk mensponsori proyek ini! Bantuan Anda akan memungkinkan pengelola untuk mendedikasikan lebih banyak waktu dan sumber daya untuk pengembangan dan dukungannya.

Sponsor utama

Sponsor lainnya