dynamicTyping
step: function(results, handle) {
+ step: function(results, parser) {
console.log("Row data:", results.data);
console.log("Row errors:", results.errors);
}
- Streaming is necessary for large files which would otherwise crash the browser. Except when using a Web Worker, you can call handle.abort() to stop parsing, handle.pause() to pause it, or handle.resume() to resume.
+ Streaming is necessary for large files which would otherwise crash the browser. You can call parser.abort() to abort parsing. And, except when using a Web Worker, you can call parser.pause() to pause it, and parser.resume() to resume.
fastMode
" characters appear in the input. You can force fast mode either way by setting it to true or false.
Papa.SCRIPT_PATHPapa.DefaultDelimiter| Internal Property | -Explanation | -
|---|---|
Papa.Parser |
- - The core parsing component. Careful, it's fast and under rigorous test. - | -
Papa.ParserHandle |
- - A wrapper over the Parser which provides dynamic typing and header row support. - | -
Papa.NetworkStreamer |
- - Facilitates downloading and parsing files in chunks over the network with XMLHttpRequest. - | -
Papa.FileStreamer |
- - Similar to NetworkStreamer, but for local files, and using the HTML5 FileReader. - | -
Yes, please! I don't want to do this all by myself. Head over to the GitHub project page and hack away. If you're making a significant change, open an issue first so we can talk about it. @@ -108,9 +107,9 @@ -
- Fast mode makes Papa Parse screaming fast, but you wouldn't want to use it if there are (or may be) quoted fields in your input. Fast mode is fast because it makes one major assumption: no quoted fields. But if you know that your input has no quotes, turn that sucker on. With fast mode on, 1 GB files can be parsed in about 20 seconds. + Fast mode makes Papa Parse screaming fast, but you wouldn't want to use it if there are quoted fields in your input. Fast mode is fast because it makes one major assumption: no quoted fields. If you don't specify fastMode either way, fast mode will be turned on automatically if there are no quote characters in the input. With fast mode on, 1 GB files can be parsed in about 20 seconds.
@@ -126,7 +125,7 @@
- Yes. Parsing huge text files is facilitated by streaming, where the file is loaded a little bit at a time, parsed, and the results are sent to your step callback function, row-by-row.
+ Yes. Parsing huge text files is facilitated by streaming, where the file is loaded a little bit at a time, parsed, and the results are sent to your step callback function, row-by-row. You can also get results chunk-by-chunk (which is usually faster) by using the chunk callback function in the same way.
+ Use the chunk callback instead. It works just like step, but you get an entire chunk of the file at a time, rather than a single row. Don't try to use step and chunk together (the behavior is undefined).
+
A stream is a unique data structure which, given infinite time, gives you infinite space. @@ -172,7 +176,7 @@
- Yes, as long as you are streaming and not using a worker. Your step callback is passed a ParserHandle which has pause, resume, and abort functions.
+ Yes, as long as you are streaming and not using a worker. Your step callback (same with the chunk callback) is passed a parser which has pause, resume, and abort functions. This is exceptionally useful when performing asynchronous actions during parsing, for example, AJAX requests. You can always abort parsing in your callback, even when using workers, but pause and resume is only available without a worker.
Yup. If the input is too large to fit in memory (or large enough to crash the browser), streaming is always the answer, even in a worker thread. Workers keep the page reactive. Streaming makes it able to fit in memory. Use both if you need to.
+ +
+ No. This would drastically slow down parsing, as it would require the worker to wait after every chunk for a "continue" signal from the main thread. But you can abort workers by calling .abort() on the parser that gets passed to your callback function.
+