DirList Event

Fired when a directory entry is received.

Syntax

ftp.on('DirList', [callback])

Callback

The 'callback' is called when the 'DirList' event is emited.

function(e){ }

The argument 'e' has the following properties:

e.dirEntry
e.fileName
e.isDir
e.fileSize
e.fileTime

Remarks

The DirList events are fired when a directory listing is received as a response to a ListDirectory or ListDirectoryLong call.

The StartTransfer and EndTransfer events mark the beginning and end of the event stream.

The DirEntry parameter contains the filename when ListDirectory is called, and extended file information when ListDirectoryLong is called.

The class tries to fill out the FileName, IsDir, FileSize, and FileTime parameters when calling the ListDirectoryLong method. Except for FileName, these parameters are empty when a short 'List Directory' is performed.

In Unix systems the date is given in two types of formats: If the date is in the last 12 months the exact time is specified and the year is omitted. Otherwise only the date and the year but not hours or minutes are given.