fast-feed
所属分类：Node.js
开发工具：C++
文件大小：36KB
下载次数：0
上传日期：2019-08-23 17:19:35
上 传 者：
sh-1993
说明： 非常快速的基于RapidXML的Node.JS模块，用于解析新闻提要（RSS2和Atom）。
(Very fast RapidXML-based Node.JS module for parsing newsfeeds (RSS 2 and Atom).)
文件列表:
.eslintrc (252, 2019-08-24)
.travis.yml (145, 2019-08-24)
LICENSE (1139, 2019-08-24)
LICENSE.rapidxml (2752, 2019-08-24)
binding.gyp (873, 2019-08-24)
index.js (2445, 2019-08-24)
package.json (727, 2019-08-24)
src (0, 2019-08-24)
src\parser.cc (23334, 2019-08-24)
src\rapidxml.hpp (120937, 2019-08-24)
tests-leak (0, 2019-08-24)
tests-leak\cdata.js (1172, 2019-08-24)
tests (0, 2019-08-24)
tests\atom_author.js (1970, 2019-08-24)
tests\atom_links.js (1266, 2019-08-24)
tests\category.js (946, 2019-08-24)
tests\cdata.js (1119, 2019-08-24)
tests\content_encoded.js (590, 2019-08-24)
tests\empty_title.js (424, 2019-08-24)
tests\extensions.js (4997, 2019-08-24)
tests\invalid.js (449, 2019-08-24)
tests\options.js (2454, 2019-08-24)
tests\other_content.js (372, 2019-08-24)
tests\rss_enclosure.js (923, 2019-08-24)
# fast-feed
Node.JS module for parsing newsfeeds (RSS 2 and Atom). It should be one
of the fastest feed parsers. Uses [RapidXML](http://rapidxml.sourceforge.net/).
[](https://travis-ci.org/rla/fast-feed)
## Usage
Without callback (throws exception):
```javascript
var fastFeed = require('fast-feed');
fastFeed.parse(xml_string);
```
With callback:
```javascript
var fastFeed = require('fast-feed');
fastFeed.parse(xml_string, function(err, feed) {
if (err) throw err;
console.log(feed);
});
```
Do not parse content/description:
```javascript
var fastFeed = require('fast-feed');
fastFeed.parse(xml_string, { content: false });
```
Or:
```javascript
var fastFeed = require('fast-feed');
fastFeed.parse(xml_string, { content: false }, function(err, feed) {
if (err) throw err;
console.log(feed);
});
```
## Extracted feed attributes
For Atom feeds:
```javascript
{
type: "atom",
title: String,
id: String,
link: String,
author: String,
author_uri: String,
author_email: String,
extensions: [Extension],
items: [{
id: String,
title: String,
date: Date,
author: String,
author_uri: String,
author_email: String,
summary: String,
content: String,
links: [{
rel: String,
href: String,
type: String,
hreflang: String,
title: String,
length: String,
text: String
}],
link: String,
extensions: [Extension]
}]
}
```
Any attribute besides `type` might be missing. `summary` and `content` are missing when
the `content: false` option is used.
For RSS 2 feeds:
```javascript
{
type: "rss",
title: String,
description: String,
link: String,
author: String,
extensions: [Extension],
items: [{
id: String,
link: String,
date: Date,
title: String,
author: String,
description: String,
content: String,
extensions: [Extension],
categories: [Category],
enclosure: Enclosure
}]
}
```
Any attribute besides `type` might be missing. `description` is missing from items when
the `content: false` option is used.
The `content` property of an RSS 2 item is extracted when the item contains a `` element.
The information about the content module can be found on [MDN](https://developer.mozilla.org/en-US/docs/Web/RSS/Article/Why_RSS_Content_Module_is_Popular_-_Including_HTML_Contents).
### Item categories
The category object currently contains the following properties:
```javascript
{
name: String // RSS 2 category tag text contents
}
```
The `categories` property on the item is missing when it has no categories.
### Enclosure
The RSS 2 enclosure object contains the following properties:
```javascript
{
length: Number,
type: String,
url: String
}
```
The `enclosure` property on the item is missing when it has no enclosure.
Properties of the `enclosure` might be missing. If the original length attribute
cannot be parsed as a number, the corresponding property is missing.
### Feed extensions
Feed extensions are supported on the syntax level. Particulary, any element on the feed/channel/item using a namespace
and having no nested elements is considered an extension. Extensions contain the following data:
```javascript
{
name: String, // name of the element, such as dc:title
value: String, // string contents of the element
attributes: { String: String } // element attributes
}
```
Parsing feed extensions is not enabled by default. Use the `extensions: true` option
for the `parse` function to enable them. The `extensions`/`attributes` property will be missing instead
of being empty when the feed/item has no extension. This has been done to reduce the gc stress.
A single element can have multiple extensions with the same name. Extension names are
not normalized into lowercase.
## Supported Node/io.js versions
This package uses [NAN](https://github.com/rvagg/nan) and has been tested (install+running tests) on:
* Node 10.x
* Node 8.x
* Node 6.x
## Using on Windows
This package provides no prebuilt binaries. You need to install the
required tools and rebuild it yourself. Use the instructions from
https://github.com/nodejs/node-gyp
## Developing
Go to the project directory and install dependencies:
npm install
Run tests (this also rebuilds the code):
npm test
## Testing leaks
Leak testing uses assumption that RSS (not the feed but memory) set grows slowly. If it grows
fast then the extension (or something else) leaks.
Leak testing is started by running:
npm run test-leak
### Good
RSS grows slowly:
```
$ npm run test-leak
node --gc_global tests-leak/cdata.js
{ rss: 12419072, heapTotal: 6163968, heapUsed: 2259008 }
{ rss: 12955***8, heapTotal: 6163968, heapUsed: 2392424 }
{ rss: 12955***8, heapTotal: 6163968, heapUsed: 2257952 }
{ rss: 12955***8, heapTotal: 6163968, heapUsed: 2118152 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 1976096 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 3899040 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 3755944 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 3614592 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 3473584 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 3331376 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 3188704 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 3048720 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 2905936 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 27***424 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 2623784 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 2481888 }
{ rss: 14901248, heapTotal: 8261120, heapUsed: 2340056 }
```
### Bad
RSS grows rapidly:
```
$ npm run test-leak
node --gc_global tests-leak/cdata.js
{ rss: 79446016, heapTotal: 6163968, heapUsed: 2259008 }
{ rss: 146755584, heapTotal: 6163968, heapUsed: 2392424 }
{ rss: 2137***912, heapTotal: 6163968, heapUsed: 2257952 }
{ rss: 281112576, heapTotal: 6163968, heapUsed: 2118152 }
{ rss: 349970432, heapTotal: 8261120, heapUsed: 1976096 }
{ rss: 417284096, heapTotal: 8261120, heapUsed: 3899040 }
{ rss: 484597760, heapTotal: 8261120, heapUsed: 3755944 }
{ rss: 551***1088, heapTotal: 8261120, heapUsed: 3614592 }
{ rss: 618954752, heapTotal: 8261120, heapUsed: 3473584 }
{ rss: 6859***080, heapTotal: 8261120, heapUsed: 3331376 }
{ rss: 753311744, heapTotal: 8261120, heapUsed: 3188704 }
{ rss: 820625408, heapTotal: 8261120, heapUsed: 3048720 }
{ rss: 887668736, heapTotal: 8261120, heapUsed: 2905936 }
{ rss: 954***2400, heapTotal: 8261120, heapUsed: 27***424 }
{ rss: 1022025728, heapTotal: 8261120, heapUsed: 2623784 }
{ rss: 1089339392, heapTotal: 8261120, heapUsed: 2481888 }
```
## License
The binding code is covered with the MIT license. RapidXML is dual-licensed
(MIT and Boost Software License, see LICENSE.rapidxml).
近期下载者：
相关文件：
收藏者：