【cheerio】nodejs的抓取頁面模塊

http://baike.baidu.com/link?url=8V1CZsEzNE05ujOzISquom_pvFj16sWu1rRb8js11pmd9HNq7ePW_aKfG9oyXj6Txuu5K_KVpDDmX7_PwQJdz_

 

得到和修改屬性

.attr(name,value)

得到和修改屬性。在匹配的元素中只能得到第一元素的屬性。若是設置一個屬性的值爲null，則移除這個屬性。你也能夠傳遞一對鍵值，或者一個函數。

$('ul').attr('id')

//=> fruits

$('.apple').attr('id', 'favorite').html()

//=> <li class="apple" id="favorite">Apple</li>

value([value])

得到和修改input,select,textarea的value.注意: 對於傳遞鍵值和函數的支持尚未被加進去。

$('input[type="text"]').val()

=> input_text

$('input[type="text"]').val('test').html()

=> <input type="text" value="test"/>

.removeAttr(name)

經過name刪除屬性

$('.pear').removeAttr('class').html()

//=> <li>Pear</li>

.hasClass( className )

檢查匹配的元素是否有給出的類名

$('.pear').hasClass('pear')

//=> true

$('apple').hasClass('fruit')

//=> false

$('li').hasClass('pear')

//=> true

.addClass(className)

增長class(es)給全部匹配的elements.也能夠傳函數。

$('.pear').addClass('fruit').html()

//=> <li class="pear fruit">Pear</li>

$('.apple').addClass('fruit red').html()

//=> <li class="apple fruit red">Apple</li>

.removeClass([className])

從選擇的elements裏去除一個或多個有空格分開的class。若是className 沒有定義，全部的classes將會被去除，也能夠傳函數。

$('.pear').removeClass('pear').html()

//=> <li class="">Pear</li>

$('.apple').addClass('red').removeClass().html()

//=> <li class="">Apple</li>

.is.(selector)

.is(function(index))

有任何元素匹配selector就返回true。若是使用斷定函數，斷定函數在選中的元素中執行，因此this指向當前的元素。

篩選

.find(selector)

得到一個在匹配的元素中由選擇器濾過的後代。

$('#fruits').find('li').length

//=> 3

.parent([selector])

得到每一個匹配元素的parent,可選擇性的經過selector篩選。

$('.pear').parent().attr('id')

//=> fruits

.parents([selector])

得到經過選擇器篩選匹配的元素的parent集合。

$('.orange').parents().length

// => 2

$('.orange').parents('#fruits').length

// => 1

.closest([selector])

對於每一個集合內的元素，經過測試這個元素和DOM層級關係上的祖先元素，得到第一個匹配的元素

$('.orange').closest()

// => []

$('.orange').closest('.apple')

// => []

$('.orange').closest('li')

// => [<li class="orange">Orange</li>]

$('.orange').closest('#fruits')

// => [<ul id="fruits"> ... </ul>]

.next()得到第一個本元素以後的同級元素

$('.apple').next().hasClass('orange')

//=> true

.nextAll()

得到本元素以後的全部同級元素

$('.apple').nextAll()

//=> [<li class="orange">Orange</li>, <li class="pear">Pear</li>]

.prev()

得到本元素以前的第一個同級元素

$('.orange').prev().hasClass('apple')

//=> true

.preAll()

$('.pear').prevAll()

//=> [<li class="orange">Orange</li>, <li class="apple">Apple</li>]

得到本元素前的全部同級元素

.slice(start,[end])

得到選定範圍內的元素

$('li').slice(1).eq(0).text()

//=> 'Orange'$('li').slice(1, 2).length

//=> 1

.siblings(selector)

得到被選擇元素的同級元素，本元素除外

$('.pear').siblings().length

//=> 2

$('.pear').siblings('.orange').length

//=> 1

.children(selector)

獲被選擇元素的子元素

$('#fruits').children().length

//=> 3

$('#fruits').children('.pear').text()

//=> Pear

.each(function(index,element))

迭代一個cheerio對象，爲每一個匹配元素執行一個函數。When the callback is fired, the function is fired in the context of the DOM element, so this refers to the current element, which is equivalent to the function parameter element.要提前跳出循環，返回false.

var fruits = [];

$('li').each(function(i, elem) { fruits[i] = $(this).text();});fruits.join(', ');

//=> Apple, Orange, Pear

.map(function(index,element))

迭代一個cheerio對象，爲每一個匹配元素執行一個函數。Map會返回一個迭代結果的數組。the function is fired in the context of the DOM element, so this refers to the current element, which is equivalent to the function parameter element

$('li').map(function(i, el) {

// this === el return

$(this).attr('class');}).join(', ');

//=> apple, orange, pear

.filter(selector)

.filter(function(index))

迭代一個cheerio對象，濾出匹配選擇器或者是傳進去的函數的元素。若是使用函數方法，這個函數在被選擇的元素中執行，因此this指向的手勢當前元素。

Selector:

$('li').filter('.orange').attr('class');

//=> orange

Function:

$('li').filter(function(i, el) {

// this === el return

$(this).attr('class') === 'orange';}).attr('class')

//=> orange

.first()

會選擇chreeio對象的第一個元素

$('#fruits').children().first().text()

//=> Apple

.last()

$('#fruits').children().last().text()

//=> Pear

會選擇chreeio對象的最後一個元素

.eq(i)

經過索引篩選匹配的元素。使用.eq(-i)就從最後一個元素向前數。

$('li').eq(0).text()

//=> Apple

$('li').eq(-1).text()

//=> Pear

Manipulation

改變DOM結構的方法

.append(content,[content…])

在每一個元素最後插入一個子元素

$('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>

.prepend(content,[content,…])

在每一個元素最前插入一個子元素

$('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>

.after(content,[content,…])

在每一個匹配元素以後插入一個元素

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

.before(content,[content,…])

在每一個匹配的元素以前插入一個元素

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

.remove( [selector] )

從DOM中去除匹配的元素和它們的子元素。選擇器用來篩選要刪除的元素。

$('.pear').remove()

$.html()

//=> <ul id="fruits">

// <li class="apple">Apple</li>

// <li class="orange">Orange</li>

// </ul>

.replaceWith( content )

替換匹配的的元素

var 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>

.empty()

清空一個元素，移除全部的子元素

$('ul').empty()

$.html()

//=> <ul id="fruits"></ul>

.html( [htmlString] )

得到元素的HTML字符串。若是htmlString有內容的話，將會替代原來的HTML

$('.orange').html()

//=> Orange

$('#fruits').html('<li class="mango">Mango</li>').html()

//=> <li class="mango">Mango</li>

.text( [textString] )

得到元素的text內容，包括子元素。若是textString被指定的話，每一個元素的text內容都會被替換。

$('.orange').text()

//=> Orange$('ul').text()

//=> Apple

// Orange

// Pear

Rendering

若是你想呈送document，你能使用html多效用函數。

$.html()

//=> <ul id="fruits">

// <li class="apple">Apple</li>

// <li class="orange">Orange</li>

// <li class="pear">Pear</li>

// </ul>

若是你想呈送outerHTML,你可使用 $.html(selector)

$.html('.pear')

//=> <li class="pear">Pear</li>

默認的,html會讓一些標籤保持開標籤的狀態.有時候你想呈現一個有效的XML文檔.例以下面這個:

$ = cheerio.load('<media:thumbnail url="xxx.jpg" width="75" height="50" time="12:05:01.123"/>');

而後爲了呈現這個XML,你須要使用xml這個函數:

$.xml()

//=> <media:thumbnail url="xxx.jpg" width="75" height="50" time="12:05:01.123"/>

Miscellaneous

不屬於其它地方的DOM 元素方法

.toArray()

取得全部的在DOM元素，轉化爲數組、

$('li').toArray()

//=> [ {...}, {...}, {...} ]

.clone()

克隆cheerio對象

var moreFruit = $('#fruits').clone()

Utilities

$.root有時候你想找到最上層的root元素,那麼$.root()就能得到:

$.root().append('<ul id="vegetables"></ul>').html();

//=> <ul id="fruits">...</ul><ul id="vegetables"></ul>

$.contains( container, contained )

查看cotained元素是不是container元素的子元素

$.parseHTML( data [, context ] [, keepScripts ] )

將字符串解析爲DOM節點數組。context參數對chreeio沒有意義，可是用來維護APi的兼容性。