!build status

table-scraper

Simple utility for scraping data from html tables on a given website into a list of javascript objects.

$3

``
npm install --save table-scraper
`

$3

##### get(url)
Returns a promise that resolves to a list of tables found on the input website. HTML table rows are converted to
javascript objects

For example: suppose the website at http://www.some-fake-url.com consisted of the following:
`html
















State	Capital City	Pop.
Minnesota	Saint Paul	3
New York	Albany	Eight Million




`

The following code would result in the array displayed below:

`javascript
var scraper = require('table-scraper');
scraper
.get('http://www.some-fake-url.com')
.then(function(tableData) {
/*
tableData ===
[
[
{ State: 'Minnesota', 'Capital City': 'Saint Paul', 'Pop.': '3' },
{ State: 'New York', 'Capital City': 'Albany', 'Pop.': 'Eight Million' }
]
]
*/
});
`

Important to note: the tableData returned is a list of lists. So, if some-fake-url.com
contained three tables, the structure of the response would look like

`javascript
[
[ / list of data from the first table / ],
[ / list of data from the second table / ],
[ / list of data from the third table / ]
]
`

If a table has NO headings (no elements), the object keys are simply the column index:
`javascript
[
{'0': , '1': , .... }
]
`


##### Contributing
Feedback/PRs welcome! Please include tests around any new functionality, and make sure existing tests pass:
`
npm test
``

##### Credits
The following node libraries make this utility super easy:
* tabletojson
* x-ray
* request