imap-scan-box
This module takes an instance of the imap module, and a box name (also known as a "folder"), and returns an emitter which emits for each message in the box.
general use
const Imap = const scanBox = const imap = user: 'me@gmail.com' password: 'abc123' host: 'imap.gmail.com' port: 993 tls: true const boxName = 'INBOX'const range = '1:10' // earliest 10 messagesconst fetch = // data to include in message bodies bodies: 'HEADER.FIELDS (FROM TO SUBJECT DATE)' // must wait until imap is readyimap
imap
The instance of imap
provided must be instantiated and
have already emitted the ready
event.
Note also that the imap module does not support opening multiple boxes at one time. You will need to establish a single-thread queue to process multiple boxes.
boxName
The name of the box to scan.
range
(string, default 1:*
)
The range string for which messages to return.
fetch
(object, optional)
The fetch
object expected by the imap module.
Default value is:
optionsfetch = bodies: 'HEADER.FIELDS (FROM TO SUBJECT DATE)' struct: true
emitted events
The returned emitter will emit the following events:
error
(object)
Each error object emitted has the following properties:
action
(string) The action which caused the error.error
(object|string) The thrown error for that action.
The following error actions exist:
open
: Opening the IMAP box threw an error.fetch
: Opened the box, but fetching the messages threw an error.error
: Closing the IMAP box after fetching completed threw an error.
opened
(object)
Emitted after the IMAP box is opened. The emitted object
is the box
object given by the imap module.
closed
(object)
Emitted after the IMAP box is closed. The emitted object
is the box
object given by the imap module.
message
(object)
Each message found during the fetch
will be emitted with the
following properties:
sequenceNumber
(integer): The sequence number of that fetch.stream
(stream): The message data, as a stream object.
The stream object is the actual streamed message object as given by the imap module.
end
Emitted after all actions have completed. Either by way of the box scan completing, or an error occuring which prevents further scanning.
license
Published and released under the VOL.