333

schangxiang@126.com

2025-09-19 18966e02fb573c7e2bb0c6426ed792b38b910940

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# MapStream
 
Refactored out of [event-stream](https://github.com/dominictarr/event-stream)
 
##map (asyncFunction[, options])
 
Create a through stream from an asyncronous function.  
 
``` js
var map = require('map-stream')
 
map(function (data, callback) {
  //transform data
  // ...
  callback(null, data)
})
 
```
 
Each map MUST call the callback. It may callback with data, with an error or with no arguments, 
 
  * `callback()` drop this data.  
    this makes the map work like `filter`,  
    note:`callback(null,null)` is not the same, and will emit `null`
 
  * `callback(null, newData)` turn data into newData
    
  * `callback(error)` emit an error for this item.
 
>Note: if a callback is not called, `map` will think that it is still being processed,   
>every call must be answered or the stream will not know when to end.  
>
>Also, if the callback is called more than once, every call but the first will be ignored.
 
##Options 
 
 * `failures` - `boolean` continue mapping even if error occured. On error `map-stream` will emit `failure` event. (default: `false`)